一、配置網站
我們可以在 _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