Hexo最佳实践推荐

该实践其实是一个目录操作规范,以易于使用为最终目的,将需要个性化和经常会变动的目录或文件独立出来,借助简单的 Shell 脚本进行 Hexo 的初始化及 NexT 主题的升级。

说明:来源于个人使用过程中的总结,可能并不适合所有人,仅供参考。

1. 最终目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
.
├── config_hexo.yml # 软链接到 Hexo 配置文件
├── config_next.yml # 软链接到 NexT 主题配置文件
├── core # Hexo 根目录,可自定义
│   ├── _config.yml -> ../config_hexo.yml # 个人修改后的配置文件
│   ├── _config.yml.bak # 原 Hexo 配置文件
│   ├── db.json
│   ├── node_modules
│   ├── package-lock.json
│   ├── package.json
│   ├── public
│   ├── scaffolds
│   ├── source -> ../source_hexo # 个人变动后的资源目录
│   ├── source_bak # 原 Hexo 资源目录的备份
│   └── themes
│   ├── landscape # Hexo 默认主题根目录
│   └── next # NexT 主题根目录
│ ├── LICENSE.md
│ ├── README.md
│ ├── _config.yml -> ../../../config_next.yml # 个人修改后的配置文件
│ ├── _config.yml.bak # 原主题配置文件的备份
│ ├── crowdin.yml
│ ├── docs
│ ├── gulpfile.js
│ ├── languages
│ ├── layout
│ ├── package.json
│ ├── scripts
│ └── source # 主题下的资源目录
├── deploy.sh # 3. 同步远程服务器脚本
├── init.sh # 1. Hexo 初始化脚本
├── source_hexo # 软链接到 Hexo 下的资源目录
├── source_next # 需要添加到 NexT 下资源目录的文件放这里
└── update_next.sh # 2. NexT 主题升级脚本

1.1. 在 Github 上我们需要建立两个仓库

  • username/username.github.io 对应 Hexo 部署的目标目录,在 Hexo 根目录下的配置文件中进行设置。
  • username/blog.xxx.com 名字随意,对应上面的目录。其中 core 目录需要添加到 .gitignore 文件。

1.2. 如何使用

⚠️ 说明:每次写文章只需要步骤 3 ~ 5,只有当切换到一个新的工作环境时,才需要执行完整的步骤 1 ~ 5。

  1. 从 Github 拉下来环境仓库

    1
    ➜  git clone https://github.com/username/blog.xxx.com.git
  2. 初始化 Hexo 环境

    1
    2
    3
    4
    # ⚠️ 前提:你已经安装好了 NodeJS 环境 和 hexo-cli
    # 如果需要,可以自行修改 shell 文件
    chmod u+x init.sh
    ➜ ./init.sh
  3. 进入 Hexo 根目录

    1
    2
    3
    4
    5
    # core 的名字可以在脚本 init.sh 中修改
    cd core

    # 创建一篇文章
    ➜ hexo new post "一篇新文章"
  4. Hexo 发布部署

    1
    ➜  hexo clean && hexo g -d
  5. 将本次修改推送到仓库

    1
    2
    3
    4
    # 先退回到 core 目录到上一级,即仓库根目录
    ➜ git add .
    ➜ git commit -m "新增文章"
    ➜ git push

2. 脚本文件

init.sh

当切换到一个新的工作环境时,使用该脚本初始化 Hexo 及基于原数据的工作环境,之后便可以继续写文章、发布了。

示例文件内容如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 初始化 Hexo
# 注意,这里并没有检查 NodeJS 环境 和 hexo-cli
# 如果需要,可自行扩展
hexo init core

# 安装依赖,修改配置
cd core
npm install
npm install hexo-deployer-git --save
npm install hexo-generator-searchdb --save
npm install hexo-abbrlink --save
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save
npm install hexo-filter-nofollow --save
mv _config.yml _config.yml.bak
ln -s ../config_hexo.yml _config.yml
mv source source_bak
ln -s ../source_hexo source

# 安装、配置主题
git clone https://github.com/theme-next/hexo-theme-next themes/next
cd themes/next
mv _config.yml _config.yml.bak
ln -s ../../../config_next.yml _config.yml
\cp -rp ../../../source_next/* source

update_next.sh

当需要升级 NexT 主题时使用,示例文件内容如下:

1
2
3
4
5
6
7
8
9
10
11
# 还原本地修改
cd core/themes/next
git checkout . && git clean -xdf

# 更新源码
git pull

# 恢复修改
mv _config.yml _config.yml.bak
ln -s ../../../config_next.yml _config.yml
\cp -rp ../../../source_next/* source

deploy.sh

该脚本非必须,只有需要将最终部署好的文件分发到不同服务器时才用得到。

同步方式推荐使用 rsync 命令,这里不再具体举例。关于该工具到使用,可以参阅:rsync 的基本使用入门