Hexo 使用教程

安装

首先需要安装 node.js，node.js 安装教程可参看 https://www.runoob.com/nodejs/nodejs-install-setup.html
然后执行npm install -g hexo 或 yarn global add hexo 安装 Hexo。

建站

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

$ hexo init <folder>
$ cd <folder>
$ npm i 或 yarn install

目录结构如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

在执行 hexo init 的时候可能git会报错，可以到 https://github.com/hexojs/hexo-starter.git 这个地址直接把 Hexo 项目下载下来，然后改成自己项目名字。

scaffolds

模版 文件夹。当您新建文章时，Hexo 会根据 scaffold 来建立文件。
Hexo 的模板是指在新建的文章文件中默认填充的内容。例如，如果您修改 scaffold/post.md 中的 Front-matter 内容，那么每次新建一篇文章时都会包含这个修改。

_config.yml

网站的配置信息，可以配置网站名称、关键字、语言、作者、时区等信息。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes

主题文件夹。可以去 https://hexo.io/themes/ 寻找喜欢的主题。

安装主题

我使用的主题是 pure

启用主题

在你的 hexo 项目文件夹下执行：

git clone https://github.com/cofess/hexo-theme-pure.git themes/pure

修改配置文件 hexo/_config.yml 中 theme 为 pure。

gitalk 评论

Gitalk 是一个基于 Github Issue 的评论插件，每增加一条评论相应的在 GitHub 项目增加一条 Issue。

注册 GitHub Application

到 https://github.com/settings/applications/new 注册 GitHub Application
填写 Application name（项目名称），Homepage URL（博客链接），Application description（描述），authorization callback URL（回调地址，博客链接）等信息，完成注册，获取到 Client ID 和 Client Secret。
如果项目在 Organization 下，需要进入到相应的 Organization，点击 Settings > OAuth Apps，注册 GitHub Application。

配置 _config.yml

配置文件位置 themes/pure/_config.yml。
修改 comment > type 为：gitalk，将 Client ID 和 Client Secret 填写的相应位置，并填写 owner，admin，repo。owner 为项目所有者，如果是 Organization，这填写 Organization 名称。admin 为你的用户名，repo 对应 GitHub 中的项目名。

常用命令

创建一个新网站

hexo init [folder]

新建一篇文章

$ hexo new [layout] <title>

layout 可选，如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。如：

$ hexo new "post title with whitespace"

参数	描述
-p, –path	自定义新文章的路径
-r, –replace	如果存在同名文章，将其替换
-s, –slug	文章的 Slug，作为新文章的文件名和发布后的 URL

默认情况下，Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说，Hexo 会创建一个以标题为名字的目录，并在目录中放置一个 index.md 文件。你可以使用 –path 参数来覆盖上述行为、自行决定文件的目录：

hexo new page --path about/me "About me"

生成静态文件

$ hexo generate 或 g

参数	描述
-d, –deploy	文件生成后立即部署网站
-w, –watch	监视文件变动

示例
检测文件变动实时预览：

$ hexo g -w

生成文件自动部署：

$ hexo g -d

启动服务器

$ hexo server 或 s

默认情况下，访问网址为： http://localhost:4000/。

部署

$ hexo deploy

部署方式请看 https://hexo.io/zh-cn/docs/one-command-deployment

清除缓存文件

$ hexo clean