一、配置网站
我们可以在 _config.yml 文件中修改大部份的配置。
注意：此篇博文中讲解的是配置的含义，而详细的配置将在接下来的博文中进行介绍。
1.1 网站
| 参数 | 描述 |
|---|---|
| title | 网站标题 |
| subtitle | 网站副标题 |
| description | 网站描述 |
| author | 您的名字 |
| language | 网站使用的语言 |
| timezone | 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说：America/New_York, Japan, 和 UTC 。 |
其中， description 主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。 author 参数用于主题显示文章的作者。 timezone 建议保持默认即可。
1.2 网址
| 参数 | 描述 | 默认值 |
|---|---|---|
| url | 网址 | |
| root | 网站根目录 | |
| permalink | 文章的 永久链接 格式 | :year/:month/:day/:title/ |
| permalink_defaults | 永久链接中各部分的默认值 |
网站存放在子目录：如果您的网站存放在子目录中，例如
http://yoursite.com/blog，则请将您的 url 设为http://yoursite.com/blog并把 root 设为/blog/。
1.3 目录
| 参数 | 描述 | 默认值 |
|---|---|---|
| source_dir | 资源文件夹，这个文件夹用来存放内容。 | source |
| public_dir | 公共文件夹，这个文件夹用于存放生成的站点文件。 | public |
| tag_dir | 标签文件夹 | tags |
| archive_dir | 归档文件夹 | archives |
| category_dir | 分类文件夹 | categories |
| code_dir | Include code 文件夹 | downloads/code |
| i18n_dir | 国际化（i18n）文件夹 | :lang |
| skip_render | 跳过指定文件的渲染，您可使用 glob 表达式来匹配路径。 |
提示:如果您刚刚开始接触Hexo，通常没有必要修改这一部分的值。
1.4 文章
| 参数 | 描述 | 默认值 |
|---|---|---|
| new_post_name | 新文章的文件名称 | :title.md |
| default_layout | 预设布局 | post |
| auto_spacing | 在中文和英文之间加入空格 | false |
| titlecase | 把标题转换为 title case | false |
| external_link | 在新标签中打开链接 | true |
| filename_case | 把文件名称转换为 (1) 小写或 (2) 大写 | 0 |
| render_drafts | 显示草稿 | false |
| post_asset_folder | 启动 Asset 文件夹 | false |
| relative_link | 把链接改为与根目录的相对位址 | false |
| future | 显示未来的文章 | true |
| highlight | 代码块的设置 |
相对地址：默认情况下，
Hexo生成的超链接都是绝对地址。例如，如果您的网站域名为example.com,您有一篇文章名为hello，那么绝对链接可能像这样：http://example.com/hello.html，它是绝对于域名的。相对链接像这样：/hello.html，也就是说，无论用什么域名访问该站点，都没有关系，这在进行反向代理时可能用到。通常情况下，建议使用绝对地址。
1.5 分类 & 标签
| 参数 | 描述 | 默认值 |
|---|---|---|
| default_category | 默认分类 | uncategorized |
| category_map | 分类别名 | |
| tag_map | 标签别名 |
1.6 日期 / 时间格式
Hexo使用 Moment.js 来解析和显示时间。
| 参数 | 描述 | 默认值 |
|---|---|---|
| date_format | 日期格式 | YYYY-MM-DD |
| time_format | 时间格式 | H:mm:ss |
1.7 分页
| 参数 | 描述 | 默认值 |
|---|---|---|
| per_page | 每页显示的文章量 (0 = 关闭分页功能) | 10 |
| pagination_dir | 分页目录 | page |
1.8 扩展
| 参数 | 描述 |
|---|---|
| theme | 当前主题名称。值为false时禁用主题 |
| deploy | 部署部分的设置 |
二、指令
2.1 init
$ hexo init [folder]新建一个网站。如果没有设置 folder ，Hexo默认在当前文件夹下建立网站。需要注意的的是目标文件夹必须是空的。
2.2 new
$ hexo new [layout] <title>新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。
2.3 generate
$ hexo generate生成静态文件。
| 选项 | 描述 |
|---|---|
| -d, –deploy | 文件生成后立即部署网站 |
| -w, –watch | 监视文件变动 |
该命令可以简写为：
$ hexo g2.4 publish
$ hexo publish [layout] <filename>发表草稿。
2.5 server
$ hexo server启动服务器。默认情况下，访问网址为： http://localhost:4000/。
| 选项 | 描述 |
|---|---|
| -p, –port | 重设端口 |
| -s, –static | 只使用静态文件 |
| -l, –log | 启动日记记录，使用覆盖记录格式 |
2.6 deploy
$ hexo deploy部署网站。
| 参数 | 描述 |
|---|---|
| -g, –generate | 部署之前预先生成静态文件 |
该命令可以简写为：
$ hexo d2.7 render
$ hexo render <file1> [file2] ...渲染文件。
| 参数 | 描述 |
|---|---|
| -o, –output | 设置输出路径 |
2.8 migrate
$ hexo migrate <type>从其他博客系统 迁移内容。
2.9 clean
$ hexo clean清除缓存文件 (db.json) 和已生成的静态文件 (public)。
在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。
2.10 list
$ hexo list <type>列出网站资料。
2.11 version
$ hexo version显示Hexo版本。
三、选项
3.1 安全模式
$ hexo --safe在安全模式下，不会载入插件和脚本。当您在安装新插件遭遇问题时，可以尝试以安全模式重新执行。
3.2 调试模式
$ hexo --debug在终端中显示调试信息并记录到 debug.log。当您碰到问题时，可以尝试用调试模式重新执行一次，并 提交调试信息到 GitHub。
3.3 简洁模式
$ hexo --silent隐藏终端信息。
3.4 自定义配置文件的路径
$ hexo --config custom.yml自定义配置文件的路径，执行后将不再使用 _config.yml。
3.5 显示草稿
$ hexo --draft显示 source/_drafts 文件夹中的草稿文章。
3.6 自定义 CWD
$ hexo --cwd /path/to/cwd自定义当前工作目录（Current working directory）的路径。
四、博客迁移
注意：我只接触过Jekyll，其它的没有接触，因此在此只写明迁移Jekyll的方法，更多详见《迁移》。
把 _posts 文件夹内的所有文件复制到 source/_posts 文件夹，并在 _config.yml 中修改 new_post_name 参数。
new_post_name: :year-:month-:day-:title.md