Hexo 是一个快速、简洁且高效的博客框架。

安装 Hexo

在安装 Hexo 之前，需要安装以下两个工具：

• Git
• Node.js

安装好后，使用 npm 完成 Hexo 的安装
npm install -g hexo-cli

建立网站

首先建立一个文件夹。
mkdir <folder
然后向此文件夹安装Hexo。
hexo init <folder>

部署

部署到Github

1. 在 Github 新建一个名称为 username.github.io 的仓库。

2. 安装部署插件

   npm install hexo-deployer-git --save
   npm install hexo-server --save

3. 配置站点 _config.yml 文件

   deploy:
       type: git
       repo: <repository url>
       branch: master
       message: #提交信息，默认为提交时间

4. 发布到 Github

   在 Hexo 站点根目录下执行以下命令：hexo clean && d -g

---

hexo 命令

Hexo 是一个快速、简洁且高效的博客框架。

init

hexo init [folder] 新建一个网站。如果没有 folder，Hexo默认在当前文件夹建立网站。

new

hexo new [layout] <title>

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

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

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

generate

hexo generate 生成静态文件。

选项	描述
-d,--deploy	文件生成后立即部署网站
-w,--watch	监视文件变动
-b,--bail	生成过程中如果发生任何未处理的异常则抛出异常
-f,--force	强制重新生成文件 Hexo 引入了差分机制，如果 public 目录存在，那么 hexo g 只会重新生成改动的文件。使用该参数的效果接近 hexo clean && hexo generate
-c,--concurrency	最大同时生成文件的数量，默认无限制

publish

hexo publish [laytout] <filename> 发表草稿。

server

hexo server 启动服务器。默认情况下，访问网址为：http://localhost:4000/。

选项	描述
-p,--port	重设端口
-s,--static	只使用静态文件
-l,--log	启动日记记录，使用覆盖记录格式

deploy

hexo deploy 部署网站。

参数	描述
-g,--generate	部署之前预先生成静态文件

render

hexo render <file1> [file2] ... 渲染文件。

参数	描述
-o,--output	设置输出路径

migrate

hexo migrate <type> 从其他博客迁移内容。

clean

hexo clean 清除缓存文件(db.json)和已生成的静态文件(public)。
在某些情况（尤其是更新主题后），如果对站点的更改无论如何也不生效，可能需要运行该命令。

list

hexo list <type> 列出网站资料。

version

hexo version 显示 Hexo 版本。

选项

安全模式

hexo --safe 在安全模式下，不会载入插件和脚本。在新安装插件遭遇问题时，可以尝试以安全模式重新执行。

调试模式

hexo --debug 在终端中显示调试信息并记录到 debug.log。当您碰到问题时，可以尝试用调试模式重新执行一次，并 提交调试信息到 GitHub。

简洁模式

hexo --silent 隐藏终端信息。

自定义配置文件的路径

# 使用 custom.yml 代替默认的 _config.yml
$ hexo server --config custom.yml

# 使用 custom.yml 和 custom2.json，其中 custom2.json 优先级更高
$ hexo generate --config custom.yml,custom2.json,custom3.yml

当指定了多个配置文件以后，Hexo 会按顺序将这部分配置文件合并成一个 _multiconfig.yml。如果遇到重复的配置，排在后面的文件的配置会覆盖排在前面的文件的配置。这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。

显示草稿

hexo --draft 显示 source/_drafts 文件夹中的草稿文章。

自定义CWD

hexo -cwd/path/to/cwd 自定义当前工作目录（Current working directory）的路径。

注意

• 此教程，只是为了自己记录，略有缩减，详见:
• 国内使用 npm 有时会很慢，可以转为淘宝镜像，命令除 npm 转为 cnpm 外，别无二样。
  npm install -g cnpm --registry=https://registry.npm.taobao.org