安装 Hexo

对应的hexo官网的文档教程是非常完善的。https://hexo.io/zh-cn/docs/ 。

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

1
2
$ npm install -g hexo-cli
# 如果发现网速很慢，Name需要参考上一篇文档来切换npm源或者使用pnpm来进行提速。这很重要。

此时最好不要按照官网教程去只安装hexo，这会给新手带来很多困难，可能会有很多包没有同时进行导入。

Node.js 版本限制

如果你坚持使用旧的 Node.js，你可以考虑安装 Hexo 的过去版本。

请注意，官方不提供对过去版本 Hexo 的错误修复。

官方强烈建议永远安装 最新版本 的 Hexo，以及 推荐的 Node.js 版本。

Hexo 版本 最低版本 (Node.js 版本) 最高版本 (Node.js 版本)
8.0+ 20.19.0 latest
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 未知
3.0 - 3.1 0.10 或 iojs 未知
0.0.1 - 2.8 0.10 未知

关于nodejs的版本管理也可以参考上一篇文档来进行实际的操作，这样会让hexo和nodejs进行实际的匹配。

博客初始化

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install

如果npm初始化相当缓慢可以清除掉node_modules目录，然后清除缓存，使用pnpm进行安装。这可以提高速度提高效率。

1
2
3
$ rm -rf node_modules
$ npm cache clean --force
$ pnpm install

初始化后，您的项目文件夹将如下所示：

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

_config.yml

网站的 配置 文件。 您可以在此配置大部分的参数。

package.json

应用程序的信息。 EJS, Stylus 和 Markdown 渲染引擎 已默认安装，您可以自由移除。 如果您想，可以稍后卸载它们。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
package.json{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "hexo": {
    "version": ""
  },
  "dependencies": {
    "hexo": "^7.0.0",
    "hexo-generator-archive": "^2.0.0",
    "hexo-generator-category": "^2.0.0",
    "hexo-generator-index": "^3.0.0",
    "hexo-generator-tag": "^2.0.0",
    "hexo-renderer-ejs": "^2.0.0",
    "hexo-renderer-stylus": "^3.0.0",
    "hexo-renderer-marked": "^6.0.0",
    "hexo-server": "^3.0.0",
    "hexo-theme-landscape": "^1.0.0"
  }
}

hexo常用命令

1
2
3
4
5
6
7
8
# 博客文档生成命令，全称是hexo generate
$ hexo g

# 博客文档清空命令，
$ hexo clean

# 博客文档运行命令，全称是hexo server，运行完成之后就可以浏览器访问http://localhost:4000。查看landscape主题的初始化博客文档
$ hexo s