Hexo 的使用介绍

主要介绍 Hexo 的使用和一些基本的命令操作，主题设置和一些高级配置本文没有介绍，有兴趣可以参考官方文档

此文来自 Hexo 官方，为了对 Hexo 表示感谢所以把此文放在这里,更多信息参考官方文档: Writing

1. Hexo 简介

Hexo是一款基于Node.js的静态博客框架，依赖少易于安装使用，可以方便的生成静态网页托管在GitHub和Coding上，是搭建博客的首选框架。大家可以进入hexo官网进行详细查看，因为Hexo的创建者是台湾人，对中文的支持很友好，可以选择中文进行查看。

2. 快速开始

2.1 环境说明

环境说明：Mac + node + git + Homebrew

2.2 安装 Hexo

$ npm install -g hexo-cli  // 安装客户端
$ npm install hexo-server  // 安装服务端

2.3 初始化Hexo

$ hexo init hexo
$ cd hexo
$ npm install

2.4 然后生成静态页面并打开hexo本地服务

$ hexo g && hexo s

3. 一些其它命令

init

新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

$ hexo init [folder]

new

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

$ hexo new [layout] <title>

$ hexo new "post title with whitespace"

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

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

以上命令会创建一个 source/about/me.md 文件，同时 Front Matter 中的 title 为 "About me"

注意！title 是必须指定的！如果你这么做并不能达到你的目的：

$ hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md，同时 me.md 的 Front Matter 中的 title 为 "page"。这是因为在上述命令中，hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout。

generate

生成静态文件

$ hexo generate 或 hexo g

publish

发表草稿

$ hexo publish [layout] <filename>

server

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

$ hexo server

deploy

部署网站。

$ hexo deploy 或 hexo d

render

渲染文件

$ hexo render <file1> [file2] ...

migrate

从其他博客系统 迁移内容。

$ hexo migrate <type>

clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

$ hexo clean

list

列出网站资料

$ hexo list <type>

version

显示 Hexo 版本

$ hexo version

4. 命令可选项

安全模式

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

$ hexo --safe

调试模式

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

$ hexo --debug

简洁模式

隐藏终端信息

$ 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

自定义配置文件的路径，指定这个参数后将不再使用默认的 _config.yml。
你可以使用一个 YAML 或 JSON 文件的路径，也可以使用逗号分隔（无空格）的多个 YAML 或 JSON 文件的路径。例如：

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

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

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

显示草稿

显示 source/_drafts 文件夹中的草稿文章

$ hexo --draft

自定义 CWD

自定义当前工作目录（Current working directory）的路径。

$ hexo --cwd /path/to/cwd