安装#

友情链接：Hexo安装文档

其实一开始和官网的教程差不多，可以直接 npm 全局安装。

如果有不了解 Node.js 的同学，我以后会单独出一篇教程来详细解说……

1
npm install -g hexo-cli

此外，如果你对 npm 熟悉一点，那么你可以仅局部安装 Hexo。

1
npm install hexo

初始化#

hexo-cli 中初始化一个博客项目的命令为 hexo init <folder>，其中 <folder> 为目录名（亦为项目名）。

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

接下来更详细的初始化步骤见 建站 | Hexo。

启动#

通过 hexo s 命令启动本地博客。

1
hexo s

安装#

1
npm install hexo-theme-redefine@latest

启用#

在 Hexo 根目录下（也就是刚才所说的<folder>）的 _config.yml，把 theme 值修改为 redefine。

1
theme: redefine

配置#

在 Hexo 根目录下创建 _config.redefine.yml 文件，并将 此处 的所有内容复制进去。

本文件会自动覆盖主题的配置项，创建本文件的目的是为了方便你在升级主题时，不会丢失你的配置。

主题初始化完成#

接下来你可以启动 Hexo 看看效果。

Hexo 版本#

Hexo 的版本一定要不能升到最新版（@7.0.0），就目前作者试验，最高可以升到 @6.3.0 版本，否则 tags 可能会报错 site.tags.date is not iterable，可以通过 npm list 查看当前所有包的版本，如果需要升级的，可以执行以下指令。

1
npm install hexo@6.3.0

LaTeX 渲染#

如果想要完整显示所有 LaTeX 公式，首先需要安装插件 hexo-filter-mathjax。

1
npm install hexo-filter-mathjax

然后在 Hexo 配置文件 _config.yml 最底下增加如下配置。

1
mathjax:
2
  tags: none               # 或 'ams' 或 'all'
3
  single_dollars: true     # 启用单个美元符号作为内联（行内）数学公式定界符
4
  cjk_width: 0.9           # 相对 CJK 字符宽度
5
  normal_width: 0.6        # 相对正常（等宽）宽度
6
  append_css: true         # 将 CSS 添加到每个页面
7
  every_page: true         # 如果为 true，那么无论每篇文章的前题中的 `mathjax` 设置如何，每页都将由 mathjax 呈现

接着必须把 Hexo 原先内置的 Markdown 渲染工具 hexo-renderer-marked 卸载，其次安装 hexo-renderer-pandoc 。

1
npm uninstall hexo-renderer-marked
2
npm install hexo-renderer-pandoc

此时你可以尝试启动 Hexo 本地服务器看看效果，如果执行到 hexo g 时报错，那么你需要额外安装一个开源项目 Pandoc，仓库地址为 Pandoc，最后启动 Hexo 服务器，可以看到所有 LaTeX 及 数学公式 都显示出来了。

最后祝大家避过所有坑，走向成功！