Hexo安装和配置

安装

Hexo的安装比较简单,其中不太友好的点就是nodejs的安装。这里强烈推荐Scoop

我是参照中文版官方文档进行安装,文中要求nodejs和git,git早早就安装了,安装nodejs时遇到一点小问题,就是nodejs版本太多、更新太快。

Git

  • Win:建议通过winget,微软官方的包管理工具,现在win10和win11应该都已经内置。如果安装太慢,可以使用国内镜像下载安装。当然了,也可以使用前面推荐的scoop进行安装。
  • Mac:HomebrewMacPorts或下载安装程序
  • Linux:用Linux的用户这一步应该就不用说了。。

Mac用户

如果安装安装过程遇到问题,可以先安装Xcode,安装后启动并进入Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

Node.js

下载官方安装程序,可以用国内镜像加速下载。版本实在太多了,建议scoop install nodejs-lts进行安装,省心省力。

Hexo

进行到这里,前戏结束,进入正题。安装完nodejs之后,最重要的事情就是给nodejs的包管理工具npm换源,默认的源很不稳定。

  • 单次使用:
1
npm install -g hexo-cli --registry=http://registry.npmmirror.com
  • 永久:
1
2
npm config set registry http://registry.npmmirror.com
npm install -g hexo-cli

建议直接永久替换为国内源。

也可以使用阿里的cnpm命令行工具代替默认的npm:

1
npm install -g cnpm --registry=http://registry.npmmirror.com

检查是否安装成功:

1
cnpm -v

安装成功后,再安装依赖包的时候把npm命令替换成cnpm就可以了:

1
cnpm install -g hexo-cli

官方文档中写的局部安装hexo包没太大意义,大家酌情考虑。建议安装最新版本的Hexo。

配置

安装成功后,配置相对来说简单但繁琐。正常情况下使用默认配置就可以运行起来。hexo更新也比较快,这里写的配置不一定一直适用,我目前安装的最新版是6.3.0,建议还是参照官方文档进行配置,修改前可以备份下当前配置。也可以另存一个配置文件,然后用--config参数指定自定义的配置文件。例如:

1
2
3
4
5
# 用 'custom.yml' 代替 '_config.yml'
hexo server --config custom.yml

# 使用 'custom.yml' 和 'custom2.json',优先使用 'custom3.yml',然后是 'custom2.json'
hexo generate --config custom.yml,custom2.json,custom3.yml

这里重点说一下关于主题的配置问题,传统上通常在主题目录下有一个_config.yml文件,可以在这里进行配置。但是hexo的主题通常是一个独立项目,这样更新主题后,配置文件可能就会冲突或被覆盖,所以现在hexo推荐采用代替主题配置文件的方法。

  • 使用配置文件中的theme_config

该特性自Hexo 2.8.2起提供

1
2
3
4
5
6
# _config.yml
theme: "my-theme"
theme_config:
bio: "My awesome bio"
foo:
bar: 'a'
1
2
3
4
5
# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
foo:
baz: 'b'

则最终主题配置是:

1
2
3
4
5
6
7
8
{
bio: "My awesome bio",
logo: "a-cool-image.png",
foo: {
bar: "a",
baz: "b"
}
}

从中也可以看出hexo中配置的优先顺序。

  • 使用独立的_config.[theme].yml文件

该特性自Hexo 5.0.0起提供

独立的主题配置文件应放在站点根目录下,支持ymljson格式,需要配置站点_config.yml文件中的theme以供hexo寻找相应配置文件。

主题

主题设置见仁见智,自己喜欢就好。本站选用的是Next主题。github上有两个Next主题的仓库,可能是迁移到8.0之后重新建库了。具体配置直接参照官方文档就可以,目前还没发现什么坑。