Hexo 博客 github.io MD

時間 2019-11-20

原文原文鏈接

Markdown版本筆記	個人GitHub首頁	個人博客	個人微信	個人郵箱
MyAndroidBlogs	baiqiantao	baiqiantao	bqt20094	baiqiantao@sina.com

Hexo

Hexo 官網中文文檔
 個人首頁
 使用技巧css

Hexo 是一個快速、簡潔且高效的博客框架。Hexo 使用 Markdown（或其餘渲染引擎）解析文章，在幾秒內，便可利用靚麗的主題生成靜態網頁。html

Hexo 是高效的靜態站點生成框架，她基於 Node.js。經過 Hexo 你能夠輕鬆地使用 Markdown 編寫文章，除了 Markdown 自己的語法以外，還可使用 Hexo 提供的標籤插件來快速的插入特定形式的內容。前端

標籤插件和 Front-matter 中的標籤不一樣，它們是用於在文章中快速插入特定內容的插件。node

博客網站搭建

使用 hexo + github 搭建博客網站過程ios

本地環境配置

環境配置git

打開cmd，輸入git --version，能夠看到打印的Git版本信息。若是沒有，請配置Git環境變量。
打開cmd，輸入node -v和npm -v，能夠看到打印的Node和npm版本信息。若是沒有，請配置Node環境變量。
打開cmd，輸入hexo -v，檢查hexo是否安裝成功，若沒有安裝，可輸入npm install hexo -g安裝。

因爲Hexo的不少操做都涉及到命令行，您能夠考慮始終使用Git Bash來進行操做。程序員

項目配置github

在任意目錄建立一個文件夾，而後經過命令行進入到該文件夾裏面
輸入hexo init初始化，最後會看到成功提示INFO Start blogging with Hexo!
輸入npm install安裝所須要的組件
輸入hexo g或hexo generate生成html、js、css、png等網頁相關的文件
輸入hexo s或hexo server開啓服務器，在瀏覽器中輸入 http://localhost:4000 即可正式體驗 Hexo

在服務器啓動期間，Hexo 會監視文件變更(包括文件內容變動以及新增刪除文件變動)並自動更新，您無須重啓服務器
咱們能夠經過Ctrl+c中止服務器，
若是您想要更改端口，或是在執行時遇到了 EADDRINUSE 錯誤，能夠輸入hexo server -p 端口號來改變端口號web

配置 SSH keys

建立 SSH Keys面試

在任意目錄右鍵，點擊git bash here，而後經過cd ~/.ssh命令可快速定位到C盤->用戶->本身的用戶名->.ssh目錄
若是C盤->用戶->本身的用戶名下沒有.ssh目錄，可經過cd ~而後mkdir .ssh命令建立
查看.ssh目錄下是否有id_rsa、id_rsa.pub文件，也可經過ls命令查看，若是沒有須要按如下步驟生成
輸入ssh-keygen -t rsa -C "baiqiantao@sina.com"生成密鑰，密鑰類型能夠用-t選項指定，這裏使用的是rsa；-C用來指定註釋，這裏輸入本身的郵箱或者其餘都行。
以後會讓你確認文件名和輸入密語(passphrase)，空表示沒有密語；什麼都不要輸入，連輸三個回車就行。
而後會發如今當前目錄中生成了兩個文件，其中id_rsa是私鑰文件，id_rsa.pub文件是公鑰文件
打開你的id_rsa.pub文件，複製下里面的內容

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCy8mYQSRxSi3RdisKxEPM2QUDcuyEI5KR3XS7pLhO9nXqKCRSCZk+MPdQQiIGW56Y7zNz5eUvzIOSW79OReZoEVHqLD5z4L56n13HhvCfFO/HXujOBYsWB1pzI6Lj25MHMZDyUtnJXzbvs8Kiqh3rFi9gy0ogdOEETG6WuTlkOijGE4ly7Ll6KyWRJRBm7X7Sof4jyOuNwholLiU0Zidaykac41/OXVyp/MpX6PeCyv1h5f36Uhsgut82olAOUN+AsYsVOrN9ab/C24jS1BmTXcjGlw8wHUQ9h/URMnOGk8jsJ+fJQf2MIv7LpdpPFANEx6nNW0IrIgFzttPm4wfWR baiqiantao@sina.com

配置到 GitHub

進入Github首頁，右上角頭像旁邊的三角形 -> Settings -> SSH and GPG keys -> New SSH key
在Title處填入任意的標識，在Key部分裏面添加剛纔複製的id_rsa.pub文件裏的內容，點擊添加便可
驗證 SSH Keys 是否添加成功：ssh -T git@github.com

若是是第一次的會提示是否continue，輸入Yes後若是看到以下提示就表示已成功連上Github：
Hi baiqiantao! You've successfully authenticated, but GitHub does not provide shell access.

發佈項目

建立 GitHub 項目

新建項目(New repositor)，項目名稱必需要嚴格遵照以下格式：帳戶名.github.io，好比個人爲baiqiantao.github.io，否則接下來會有不少麻煩。
建立完以後點擊Settings並找到GitHub Pages一欄，你會看到那邊有個網址，點擊訪問它，你將會驚奇的發現該項目已經被部署到網絡上，可以經過外網來訪問它。
點擊Choose a theme，還能夠選擇本身喜歡的主題，選擇以後保存，再訪問剛纔那個網站，會發現選擇已經生效了。

將 Hexo 部署到 Github
先安裝git插件：

npm install hexo-deployer-git --save

而後在項目文件夾根目錄中，找到_config.yml文件，修改末尾的deploy爲以下：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:baiqiantao/baiqiantao.github.io.git
  branch: master

而後輸入hexo d或hexo deploy，完成之後，你就能在你的Github上看到上傳的代碼了，這時看到的應該是純靜態的一個站點。能夠發現，GitHub上上傳的僅僅是public目錄下的文件。

注意，hexo d 只會上傳 public 目錄中生成的文件，而不會生成靜態文件，因此你可能須要先執行 hexo g 命令生成靜態文件。

而後等待幾分鐘，訪問 baiqiantao.github.io 便可發現本身的博客能夠訪問了！到此爲止，最基本的也是最全面的hexo + github搭建博客網站過程完結。

源碼結構

文件/文件夾	說明
`_config.yml`	配置文件，無論是博客的基礎配置，仍是模板，都是修改這個文件
`package.json`	應用程序的信息
public	生成的靜態文件，這個目錄最終會發布到服務器(上傳到GitHub倉庫)
scaffolds	模板文件夾。當您新建文章時，Hexo 會根據 scaffold 來創建文件。Hexo的模板是指在新建的 Markdown 文件中默認填充的內容，通常用於配置`title、date、tags`等信息。
source	資源文件夾。咱們平常操做的文件夾，`_drafts`爲草稿文件，`_posts`爲發佈的文章。除`_posts`文件夾以外，開頭命名爲`_`的文件、文件夾和隱藏的文件將會被忽略。Markdown 和 HTML 文件會被解析並放到`public`文件夾，而其餘文件會被拷貝過去。
themes	主題文件夾。Hexo 會根據主題來生成靜態頁面。

注意，若是出現亂碼狀況，極可能是你的markdown文件或_config.yml配置文件不是以utf-8編碼格式保存的。

建立文章

官方新編寫BLOG，建議的是使用命令

hexo new [layout] <title>

其實，你能夠直接在source/_drafts新建草稿文章，在source/_posts新建發佈文章。而後在文章頂部加上相關的描述，如:

---
title: new 命令中輸入的 title
date: 2019-03-14 17:38:41
---

這個效果和用命令新建文件是同樣同樣的。

注意，從其餘地方拷文件到source/_posts時，須要保證文件頭有必要的描述(通常title是必須的)，不然此文件可能會被忽略
注意，若是發佈後出現亂碼狀況，極可能是你的文章或_config.yml配置文件不是以utf-8編碼格式保存的

佈局 layout

Hexo 有三種默認佈局：post、page 和 draft，它們分別對應不一樣的路徑，而您自定義的其餘佈局和post相同，都將儲存到 source/_posts 文件夾。

佈局	路徑
`post`	`source/_posts`，默認title便是文件名
`page`	`source`，默認title是文件夾名，文件名爲`index.md`
`draft`	`source/_drafts`，默認title便是文件名

若是你不想你的文章被處理，你能夠將 Front-Matter 中的layout: 設爲 false。

好比使用命令hexo new false 測試layout建立一篇文章，執行後會在source\_posts中生成測試layout.md文件，文件內容爲：

---
layout: 'false'
title: 測試layout
date: 2019-03-15 13:37:40
tags:
---

# 這裏是添加的文章內容  
此內容*不會*被渲染，**固然**，原始的`markdown`仍是被渲染成了`html`。其中`false`能夠*不加*引號。

而後執行hexo g -d，完成後發現訪問此文章，發現此文章沒有任何被設置任何主題等效果(固然，原始的markdown仍是被渲染成了html)

文件名稱 title

Hexo 默認以標題作爲文件名稱(默認值:title.md)，但您可編輯 new_post_name 參數來改變默認的文件名稱。

變量	描述
`:title`	標題。小寫，空格將會被替換爲短槓，默認值爲`:title.md`
`:year`	創建的年份，好比， `2015`
`:month`	創建的月份（有前導零），好比， `04`
`:i_month`	創建的月份（無前導零），好比， `4`
`:day`	創建的日期（有前導零），好比， `07`
`:i_day`	創建的日期（無前導零），好比， `7`

草稿 drafts

剛剛提到了 Hexo 的一種特殊佈局：draft，這種佈局在創建時會被保存到 source/_drafts 文件夾。您可經過 hexo publish [layout] <filename> 命令將草稿中的指定文件(不帶後綴名) 移動到 source/_posts 文件夾，該命令的使用方式與 new 十分相似，您也可在命令中指定 layout 來指定佈局。

草稿默認不會顯示在頁面中，您可在執行時加上--draft參數，或是把render_drafts參數設爲true來預覽草稿。

Front-matter

Front-matter 是文件最上方以 --- 分隔的區域，用於指定個別文件的變量，舉例來講：

title: Hello World
date: 2013/7/13 20:46:25
---

如下是預先定義的參數，您可在模板中使用這些參數值並加以利用。

參數	描述	默認值
`layout`	佈局
`title`	標題
`date`	創建日期	文件創建日期
`updated`	更新日期	文件更新日期
`comments`	開啓文章的評論功能	true
`tags`	標籤（不適用於分頁）
`categories`	分類（不適用於分頁）
`permalink`	覆蓋文章網址

例如，若是你在模板中正文部分添加以下內容：

佈局爲 {{ layout }}，標題爲 {{ title }}，創建日期爲 {{ date }}，更新日期爲 {{ updated }}
開啓評論功能 {{ comments }}，標籤爲 {{ tags }}，分類爲 {{ categories }}，覆蓋文章網址 {{ permalink }}

那麼，在發佈後實際的效果爲(PS：經過此模板建立的文章的內容並無改變，只是發佈後內容才改變)：

資源文件夾 asset

資源（Asset）表明 source 文件夾中除了文章之外的全部文件，例如圖片、CSS、JS 文件等。比方說，若是你的Hexo項目中只有少許圖片，那最簡單的方法就是將它們放在 source/images 文件夾中。而後經過相似於 ![](/images/image.jpg) 的方法訪問它們。

如下幾種方式貌似均可以【images/image.jpg】【/images/image.jpg】【../images/image.jpg】

文章資源文件夾
對於那些想要更有規律地提供圖片和其餘資源，以及想要將他們的資源分佈在各個文章上的人來講，Hexo也提供了更組織化的方式來管理資源。這個稍微有些複雜可是管理資源很是方便的功能能夠經過將 config.yml文件中的 post_asset_folder 選項設爲 true 來打開。

當資源文件管理功能打開後，Hexo將會在你每一次經過 hexo new [layout] <title> 命令建立新文章時，自動在此文章同一目錄中建立一個同名的文件夾。將全部與你的文章有關的資源放在這個關聯文件夾中以後，你能夠經過相對路徑來引用它們，這樣你就獲得了一個更簡單並且方便得多的工做流。

相對路徑引用的標籤插件

{% asset_path slug %}        //打印相對路徑
{% asset_img slug [title] %}        //顯示圖片
{% asset_link slug [title] %}        //生成圖片連接

好比說：當你打開文章資源文件夾功能後，你把一個 example.jpg 圖片放在了你的資源文件夾中，若是經過使用相對路徑的常規 markdown 語法 ![](/example.jpg) ，它將不會出如今首頁上。（可是它會在文章中按你期待的方式工做）

正確的引用圖片方式是使用下列的標籤插件而不是 markdown ：

{% asset_img example.jpg 鼠標在圖片上懸浮時顯示的內容 %}

經過這種方式，圖片將會同時出如今文章和主頁以及歸檔頁中。

模版 scaffolds

在新建文章時，Hexo 會根據scaffolds文件夾內相對應的文件來創建文件，例如：

hexo new abc "My Gallery"

在執行這行指令時，Hexo 會嘗試在 scaffolds 文件夾中尋找 abc.md，並根據其內容創建文章。

你能夠在模板中的Front-matter中直接使用如下三個值(其餘 Front-matter 不支持)：

---
title: {{ title }}
date: {{ date }}
layout: {{ layout }}
---

這樣以後，你經過此模板建立的文章中的這三個變量就有值了。

分類和標籤

只有文章支持分類和標籤，您能夠在 Front-matter 中設置。在其餘系統中，分類和標籤聽起來很接近，可是在 Hexo 中二者有着明顯的差異：分類具備順序性和層次性，也就是說 Foo, Bar 不等於 Bar, Foo；而標籤沒有順序和層次。

categories:
- Android
tags:
- 小經驗
- 面試心得

category_map 和 tag_map
在_config.yml中，咱們能夠經過category_map給一個 category 設置別名，而後在組合 url 的時候，用這個 slug 來替代 category 名稱。tag_map的功能相似。

例如：

category_map: # 分類別名
  baiqiantao: bqt    #在組合 url 時，用 bqt 代替 baiqiantao

命令

hexo init [folder]    //新建網站。若是沒有設置 folder，Hexo 默認在目前的文件夾創建網站
hexo new [layout] <title>    //新建一篇文章。若是沒有設置 layout，默認使用 default_layout 參數代替。若是標題包含空格，請使用引號括起來
hexo generate  //能夠簡寫爲 hexo g，生成靜態文件
hexo publish [layout] <filename>    //發表草稿
hexo server    //能夠簡寫爲 hexo s，啓動服務器
hexo deploy //能夠簡寫爲 hexo d，部署網站
hexo render <file1> [file2] ...    //渲染文件。`-o`設置輸出路徑
hexo migrate <type>    //從其餘博客系統遷移內容
hexo clean    //清除緩存文件(db.json)和已生成的靜態文件(public)
hexo list <type>    //列出網站資料
hexo version    //顯示 Hexo 版本
hexo --safe    //安全模式。在安全模式下，不會載入插件和腳本。當您在安裝新插件遭遇問題時，能夠嘗試以安全模式從新執行
hexo --debug    //調試模式。在終端中顯示調試信息並記錄到`debug.log`
hexo --silent    //簡潔模式。隱藏終端信息
hexo --config custom.yml    //自定義配置文件的路徑
hexo --draft    //顯示`source/_drafts`文件夾中的草稿文章
hexo --cwd /path/to/cwd    //自定義當前工做目錄的路徑

服務器 server

hexo-server
Hexo 3.0 把服務器獨立成了個別模塊，您必須先安裝 hexo-server 才能使用。

npm install hexo-server --save

安裝完成後，輸入如下命令以啓動服務器，您的網站會在 http://localhost:4000 下啓動。在服務器啓動期間，Hexo 會監視文件變更並自動更新，您無須重啓服務器。

hexo server    //可簡寫爲【hexo s】

若是您想要更改端口，或是在執行時遇到了 EADDRINUSE 錯誤，能夠在執行時使用 -p 選項指定其餘端口，以下：

hexo s -p 5000

靜態模式
在靜態模式下，服務器只處理 public 文件夾內的文件，而不會處理文件變更，在執行時，您應該先自行執行 hexo generate，此模式一般用於生產環境下。

hexo s -s

自定義 IP
服務器默認運行在 0.0.0.0，您能夠覆蓋默認的 IP 設置，以下：

hexo s -i 192.168.1.1

指定這個參數後，您就只能經過該IP才能訪問站點。
例如，對於一臺使用無線網絡的筆記本電腦，除了指向本機的127.0.0.1外，一般還有一個192.168.*.*的局域網IP，若是像上面那樣使用-i參數，就不能用127.0.0.1來訪問站點了。
對於有公網IP的主機，若是您指定一個局域網IP做爲-i參數的值，那麼就沒法經過公網來訪問站點。

生成文件 generate

使用 Hexo 生成靜態文件快速並且簡單。

hexo generate    //可簡寫爲【hexo g】

Hexo 可以監視文件變更並當即從新生成靜態文件，在生成時會比對文件的 SHA1 checksum，只有變更的文件纔會寫入。

hexo g --watch    //可簡寫爲【hexo g -w】

您可執行下列的其中一個命令，讓 Hexo 在生成完畢後自動部署網站，兩個命令的做用是相同的。

hexo g -d
hexo d -g

部署 deploy

Hexo 提供了快速方便的一鍵部署功能，讓您只需一條命令就能將網站部署到服務器上。

hexo deploy    //可簡寫爲【hexo d】

在開始以前，您必須先在 _config.yml 中修改參數，一個正確的部署配置中至少要有 type 參數，例如：

deploy:
  type: git

您可同時使用多個 deployer，Hexo 會依照順序執行每一個 deployer。

deploy:
- type: git
  repo:
- type: heroku
  repo:

YAML依靠縮進來肯定元素間的從屬關係。所以，請確保每一個deployer的縮進長度相同，而且使用空格縮進。

永久連接 permalinks

您能夠在 _config.yml 配置中調整網站的永久連接 或者在每篇文章的 Front-matter 中指定。

除了下列變量外，您還 可以使用 Front-matter 中的全部屬性。

變量	描述
`:year`	文章的發表年份（4 位數）
`:month`	文章的發表月份（2 位數）
`:i_month`	文章的發表月份（去掉開頭的零）
`:day`	文章的發表日期 (2 位數)
`:i_day`	文章的發表日期（去掉開頭的零）
`:title`	文件名稱
`:post_title`	文章標題
`:id`	文章 ID
`:category`	分類。若是文章沒有分類，則是 `default_category` 配置信息。

您可在 permalink_defaults 參數下調整永久連接中各變量的默認值：

permalink_defaults:
  lang: en

示例

假設 source/_posts 文件夾中有個 hello-world.md，包含如下內容：

title: Hello World
date: 2013-07-14 17:01:34
bqtdir: 包青天
categories:
- foo
- bar

參數	結果	備註
`:year/:month/:day/:title/`	2018/07/14/hello-world	有多個層級
`:year-:month-:day-:title.html`	2018-07-14-hello-world.html	只有一個層級
`:category/:title`	foo/bar/hello-world	不是以【/】結尾的
`:bqtdir/`	包青天/	徹底自定義的變量

多語種支持

若要創建一個多語種的網站，您可修改 new_post_name 和 permalink 參數，以下：

new_post_name: :lang/:title.md
permalink: :lang/:title/

當您創建新文章時，文章會被儲存到：

hexo new "Hello World" --lang tw
# => source/_posts/tw/Hello-World.md

而網址會是：http://localhost:4000/tw/hello-world/

主題 themes

主題列表

建立 Hexo 主題很是容易，您只要在 themes 文件夾內，新增一個任意名稱的文件夾，並修改 _config.yml 內的 theme 設定，便可切換主題。一個主題可能會有如下的結構：

├── _config.yml        主題的配置文件，不一樣的主題可配置的選項也各不相同。
├── languages        語言文件夾，請先在項目的`_config.yml`中調整 language 的值
├── layout            佈局文件夾，用於存放主題的模板文件，決定了網站內容的呈現方式
├── scripts            腳本文件夾，在啓動時，Hexo 會載入此文件夾內的 JavaScript 文件
└── source            資源文件夾，除了模板之外的 Asset，例如 css、js 文件等，都應該放在這個文件夾中

國際化 i18n

internationalization，i18n
若要讓您的網站以不一樣語言呈現，您可以使用國際化功能。請先在_config.yml中調整 language 設定，這表明的是預設語言，您也可設定多個語言來調整預設語言的順位。

language: 
- zh-tw
- en

您可在front-matter中指定該頁面的語言，也可在_config.yml中修改i18n_dir設定，讓 Hexo 自動偵測。
i18n_dir 的預設值是 :lang，這樣 Hexo 會捕獲網址中的第一段以檢測語言。

使用主題

這裏以使用主題 Concise 爲例進行介紹

一、將主題下載到themes目錄，如：

git clone https://github.com/HmyBmny/hexo-theme-concise.git themes/concise

二、修改_config.yml中的theme：

theme: concise  # 默認爲landscape

三、必要的設置
不一樣的模板，會有不少不一樣的設置，這裏就須要針對模板的使用說明進行修改了。建議經過github找到模板，看下readme。好比Concise主題的部分設置：

menu:
  About: http://www.cnblogs.com/baiqiantao
  Archives: /archives

基本上，這樣就能在本機進行預覽使用了。

修改了模板之後不生效，建議先 hexo clean，而後再 hexo g，只執行 hexo g 可能模板後者靜態文件不會被替換。

插件 plugins

通常不建議使用雜七雜八的插件！

Hexo 有強大的插件系統，使您能輕鬆擴展功能而不用修改核心模塊的源碼。

在 Hexo 中有兩種形式的插件：

腳本 Scripts：若是您的代碼很簡單，建議您編寫腳本，您只須要把 JavaScript 文件放到 scripts 文件夾，在啓動時就會自動載入。
插件 Packages：若是您的代碼較複雜，或是您想要發佈到 NPM 上，建議您編寫插件。

安裝插件：npm install 插件名稱 --save
卸載插件：npm uninstall 插件名稱 -save

連接持久化插件

permalink-pathed-title

實現方案：使用文件的相對路徑生成連接(推薦)

abbrlink，相關介紹

實現方案：對標題+時間進行md5而後再轉base64，而後給每篇文章的front-matter中自動增長abbrlink屬性
相似：【abbrlink: 4a17b156】

Hexo-UUID，相關介紹

實現方案：hook hexo new命令(意味着必須在命令行中建立文章)，而後給每篇文章的front-matter中自動增長uuid屬性
相似：【uuid: 2f2dd790-1e71-11e6-95e1-ffc09ba0b003】

Tips：

百度蜘蛛抓取網頁的規則: 對於蜘蛛說網頁權重越高、信用度越高抓取越頻繁，例如網站的首頁和內頁。蜘蛛先抓取網站的首頁，由於首頁權重更高，而且大部分的連接都是指向首頁。而後經過首頁抓取網站的內頁，並非全部內頁蜘蛛都會去抓取。

搜索引擎認爲對於通常的中小型站點，3層足夠承受全部的內容了，因此蜘蛛常常抓取的內容是前三層，而超過三層的內容蜘蛛認爲那些內容並不重要，因此不常常爬取。出於這個緣由因此permalink後面跟着的最好不要超過2個斜槓。

自動生成分類插件

auto-category
auto-category 介紹
 相似插件：directory-category

一種自動生成 categories 的插件，根據 Markdown 文件在文件目錄自動分類，即自動生成 Markdown 的front-matter中的categories變量。

例如，對於博客 source/_post/web/framework/hexo.md，該插件會自動生成如下categories：

categories:
  - web
  - framework

安裝：npm install hexo-auto-category --save
修改配置文件，添加以下內容：

# Generate categories from directory-tree
auto_category:
 enable: true
 depth:  # the depth of directory-tree you want to generate, should > 0

配置文件 config

# Site 網站
title: 白乾濤的技術博客  # 網站標題
subtitle: 白乾濤的Android開發之旅  # 網站副標題
description: Android Java 前端 程序員 技術 博客 GitHub baiqiantao  # 主要用於SEO
keywords: Android Java 前端 程序員 技術 博客 GitHub baiqiantao # 主要用於SEO
author: 白乾濤  # 用於主題中顯示文章的做者
language: zh-Hans # 網站使用的語言，中文通常爲【zh-CN】或【zh-Hans】，可用值決於你themes\concise\languages下有哪些文件
timezone:  # 網站時區，默認使用您電腦的時區

# URL 網址
url: http://yoursite.com  # 網址
root: /  # 若是您的網站存放在子目錄中，例如 http://bqt.com/blog，則請將您的 url 設爲 http://bqt.com/blog 並把 root 設爲 /blog/
permalink: :bqtdir/  # 文章的永久連接，格式【:year/:month/:day/:title/】注意，要以/或.html結尾
permalink_defaults:  # 永久連接中各部分的默認值

# Directory 目錄
source_dir: source  # 資源文件夾，這個文件夾用來存放內容。
public_dir: public  # 公共文件夾，這個文件夾用於存放生成的站點文件。
tag_dir: tags  # 標籤文件夾
archive_dir: archives  # 歸檔文件夾
category_dir: categories  # 分類文件夾
code_dir: downloads/code  # Include code 文件夾
i18n_dir: :lang  # 國際化文件夾，捕獲網址中的第一段以檢測語言
skip_render:  # 跳過指定文件的渲染，您可以使用 glob 表達式來匹配路徑。

# Writing 文章
new_post_name: :title.md # 新文章的文件名稱，默認值【:title.md】
default_layout: post  # 預設佈局，【post】
auto_spacing: false  # 在中文和英文之間加入空格，false
titlecase: false # 把標題轉換爲 title case，false
external_link: true # 在新標籤中打開連接，true
filename_case: 0  # 把文件名稱轉換爲 (1) 小寫或 (2) 大寫，0
render_drafts: false  # 顯示草稿，false
post_asset_folder: false  # 啓動 Asset 文件夾，【false】
relative_link: false  # 把連接改成與根目錄的相對位址，false
future: true  # 顯示將來的文章，true
highlight:  # 代碼塊高亮設置
  enable: true
  line_number: true
  auto_detect: false
  tab_replace:

# Home page setting 首頁設置
index_generator:
  path: '' # 博客索引頁面(index)的根路徑，默認=''
  per_page: 10 # 每頁顯示的帖子，0 =禁用分頁
  order_by: -date # 排序方式，默認狀況下按日期降序排序

# Category & Tag 分類 & 標籤
default_category: blog # 當沒有分類時的默認分類，uncategorized
category_map: # 分類別名，要在配置文件中獲取category的值請使用【:category】，不要使用【:categories】
  baiqiantao: bqt
tag_map: # 標籤別名

# Date / Time format 日期 / 時間格式，Hexo使用Moment.js來解析和顯示日期
date_format: YYYY-MM-DD
time_format: HH:mm:ss

# Pagination 分頁
per_page: 10 # 每頁顯示的文章量，0 = 關閉分頁功能，10
pagination_dir: page # 分頁目錄，page

# Deployment 部署
deploy:
  type: git
  repo: git@github.com:baiqiantao/baiqiantao.github.io.git
  branch: master

# Extensions 擴展
theme: next  # 當前主題名稱，值爲false時禁用主題，默認爲【landscape】

2019-3-14