1. _config.yml
注意：這里面的東西不一定都要設(shè)置的，如果全部設(shè)置也是完全可以的，甚至你沒(méi)必要在這個(gè)_config.yml設(shè)置猩系，你可以自定義多個(gè)
SITE
title 網(wǎng)站標(biāo)題
subtitle 網(wǎng)站副標(biāo)題
description 網(wǎng)站描述,告訴搜索引擎站點(diǎn)的簡(jiǎn)單描述
keywords 關(guān)鍵字,便于搜索引擎的搜索
author 作者名字，用于顯示文章的作者
language 網(wǎng)站使用的語(yǔ)言,默認(rèn)是英語(yǔ)中燥，可設(shè)置的語(yǔ)言見(jiàn)語(yǔ)言列表
timezone 網(wǎng)站時(shí)區(qū)寇甸，Hexo 默認(rèn)使用電腦的時(shí)區(qū)，可設(shè)置的時(shí)區(qū)見(jiàn)時(shí)區(qū)列表
URL
url 網(wǎng)址
root 網(wǎng)站根目錄
permalink 文章的永久鏈接格式
permalink_defaults 設(shè)置永久鏈接中各部分的默認(rèn)值
DIRECTORY
source_dir 資源文件夾疗涉，這個(gè)文件夾用來(lái)存放內(nèi)容拿霉，默認(rèn)是source
public_dir 公共文件夾，這個(gè)文件夾用于存放生成的站點(diǎn)文件咱扣，默認(rèn)是public
tag_dir 標(biāo)簽文件夾绽淘，默認(rèn)是tags
archive_dir 歸檔文件夾，默認(rèn)是archives
category_dir 分類文件夾闹伪，默認(rèn)是categories
code_dir Include code 文件夾沪铭，默認(rèn)是downloads/code
i18n_dir 國(guó)際化（i18n）文件夾，默認(rèn)是lang
skip_render 跳過(guò)指定文件的渲染偏瓤。比如source/mypage/hello.md 將會(huì)輸出為index.html杀怠，而source/mypage/code.js不會(huì)渲染它，更多請(qǐng)移步我的其他文章
WRITING
new_post_name 新文章的文件名稱格式 :title.md或者:year-:month-:day-:title.md
default_layout 預(yù)設(shè)布局,默認(rèn)是post
auto_spacing 在中文和英文之間加入空格厅克，默認(rèn)是false
titlecase 把標(biāo)題轉(zhuǎn)換為title case,默認(rèn)是false
external_link 在新標(biāo)簽中打開(kāi)鏈接,默認(rèn)是true
filename_case 把文件名稱轉(zhuǎn)換為小寫(xiě)(1)或大寫(xiě)(2),默認(rèn)是0不轉(zhuǎn)換
render_drafts 顯示草稿赔退，默認(rèn)是false
post_asset_folder 啟動(dòng)資源文件夾，默認(rèn)是 false，表示source文件夾中除了文章以外的所有文件硕旗，例如圖片窗骑、CSS、JS 文件等漆枚。比方說(shuō)慧域，如果你的Hexo項(xiàng)目中只有少量圖片，那最簡(jiǎn)單的方法就是將它們放在source/images 文件夾中浪读。
relative_link 把鏈接改為與根目錄的相對(duì)位址昔榴，默認(rèn)是false，默認(rèn)情況下碘橘，Hexo生成的超鏈接都是絕對(duì)地址互订。例如，如果你的網(wǎng)站域名為example.com,您有一篇文章名為hello痘拆，那么絕對(duì)鏈接可能像這樣：http://example.com/hello.html仰禽，它是絕對(duì)于域名的。相對(duì)鏈接像這樣：/hello.html纺蛆，也就是說(shuō)吐葵，無(wú)論用什么域名訪問(wèn)該站點(diǎn),一般建議用絕對(duì)路徑
future 顯示未來(lái)的文章，默認(rèn)是true
highlight 代碼塊的設(shè)置
? ?enable: true 啟動(dòng)高亮
? ?line_number: true 顯示行號(hào)
? ?auto_detect: false 自動(dòng)檢查
? ?tab_replace: 縮進(jìn)大小
HOME PAGE SETTING
path 博客默認(rèn)頁(yè)面的路徑桥氏，默認(rèn)為空
per_page 主頁(yè)中每頁(yè)顯示的貼子温峭，0表示禁止分頁(yè)
order_by 按時(shí)間倒序排列
CATEGORY & TAG
default_category 默認(rèn)分類，默認(rèn)為沒(méi)有分類uncategorized
category_map 分類別名字支，默認(rèn)為空
tag_map 標(biāo)簽別名凤藏，默認(rèn)為空
DATE / TIME FORMAT
date_format 日期格式 YYYY-MM-DD
time_format 時(shí)間格式 H:mm:ss
按照格式列表設(shè)置格式
PAGINATION
per_page 每頁(yè)顯示的文章量（0表示關(guān)閉分頁(yè)），默認(rèn)是10
pagination_dir 分頁(yè)目錄堕伪，默認(rèn)是page
EXTENSIONS
plugins 插件揖庄，插件列表
theme 當(dāng)前主題名稱,為false時(shí)禁用主題,主題列表
theme_config 自定義主題配置，這和全局的_config.yml文件是分離的欠雌，你可以寫(xiě)themes/my-theme/_config.yml蹄梢，如果全局的_config.yml文件是
theme_config:
??bio: "hello_world"
而在你的themes/my-theme/_config.yml是
bio: "HELLO_WORLD"
logo: "hi.png"
那么結(jié)果是
bio: "hello_world"
logo: "hi.png"
也就是說(shuō)如果在themes/my-theme/_config.yml中修改了全局_config.yml中的定義的參數(shù)，那么是無(wú)效的富俄，但是可以添加全局_config.yml中沒(méi)有的參數(shù)禁炒，如這里的logo
DEPLOYMENT
deploy: 部署格式如下
? ?type: git
? ?repository: https://github.com/xxx/xxx.github.io.git
? ?branch: master
INCLUDE/EXCLUDE FILES OR FOLDERS
設(shè)置鍵值使hexo顯式或忽略某些文件
include
?-Impo 包含Impo這個(gè)文件，include參數(shù)一般不使用蛙酪，需要包含的文件hexo都做好了
exclude
?-.Igno 忽略.Igno這個(gè)文件
USING AN ALTERNATE CONFIG
自定義配置文件齐苛，使用hexo server啟動(dòng)時(shí)是默認(rèn)加載_config.yml里面的配置，如果我們自定義文件custom.yml桂塞，那么啟動(dòng)時(shí)使用hexo server --config custom.yml,甚至是多個(gè)自定義文件custom1.yml,custom2.json,啟動(dòng)時(shí)使用hexo server --config custom1.yml,custom2.json凹蜂，注意默認(rèn)后面文件的優(yōu)先級(jí)高，也就是先加載.json，多個(gè)自定義文件可以寫(xiě)入_multiconfig.yml中玛痊，同樣最后一個(gè)文件優(yōu)先加載
2. package.json
這是一些應(yīng)用程序的信息汰瘫，json格式，建議不要改動(dòng)
3. scaffolds
這是一個(gè)模板文件夾擂煞，當(dāng)你新寫(xiě)了一片文章時(shí)混弥，其顯示格式都會(huì)以scaffolds中post.md的內(nèi)容來(lái)加載。
4. source
這是一個(gè)資源文件夾对省。以_開(kāi)頭的文件都會(huì)被忽略蝗拿，.md和.html文件會(huì)被解析并放到public，其他文件也會(huì)被拷貝過(guò)去 (如果文件可以被渲染的話蒿涎，會(huì)經(jīng)過(guò)解析然后儲(chǔ)存到 public 文件夾哀托，否則會(huì)直接拷貝到 public 文件夾)
5. themes
主題文件夾，這部分請(qǐng)移步到其他文章劳秋。
6. 關(guān)于文件名
Hexo 默認(rèn)以標(biāo)題做為文件名稱仓手，編輯 new_post_name 參數(shù)來(lái)改變默認(rèn)的文件名稱,提供以下參數(shù)
:title 標(biāo)題（小寫(xiě)，空格將會(huì)被替換為短杠） :year 建立的年份玻淑，比如嗽冒， 2015 :month 建立的月份（有前導(dǎo)零），比如补履， 04 :i_month 建立的月份（無(wú)前導(dǎo)零）添坊，比如， 4 :day 建立的日期（有前導(dǎo)零）干像，比如帅腌， 07 :i_day 建立的日期（無(wú)前導(dǎo)零）驰弄，比如麻汰， 7
7. 關(guān)于模板
在新建文章時(shí)，Hexo 會(huì)根據(jù) scaffolds 文件夾內(nèi)相對(duì)應(yīng)的文件來(lái)建立文件戚篙，例如：hexo new photo "My Gallery"五鲫，在執(zhí)行這行指令時(shí)，Hexo 會(huì)嘗試在 scaffolds 文件夾中尋找 photo.md模板岔擂，并根據(jù)其內(nèi)容建立文章位喂，默認(rèn)使用 _config.yml 中的 default_layout 參數(shù)post代替，模板文件中的參數(shù)有
layout 布局 title 標(biāo)題 date 文件建立日期
8. 關(guān)于Front-matter
Front-matter 是文件最上方以 --- 分隔的區(qū)域乱灵，用于指定個(gè)別文件的變量塑崖，舉例來(lái)說(shuō)：
title: Hello World date: 2013/7/13 20:46:25 ---
以下是預(yù)先定義的參數(shù)，在模板中使用這些參數(shù)值并加以利用痛倚。
參數(shù) 描述 默認(rèn)值 layout 布局 title 標(biāo)題 date 建立日期 文件建立日期 updated 更新日期 文件更新日期 comments 開(kāi)啟文章的評(píng)論功能 true tags 標(biāo)簽（不適用于分頁(yè)） categories 分類（不適用于分頁(yè)） permalink 覆蓋文章網(wǎng)址
9. 關(guān)于分類和標(biāo)簽
只有文章支持分類和標(biāo)簽规婆，您可以在 Front-matter 中設(shè)置。在其他系統(tǒng)中，分類和標(biāo)簽聽(tīng)起來(lái)很接近抒蚜，但是在 Hexo 中兩者有著明顯的差別：分類具有順序性和層次性掘鄙，也就是說(shuō) Foo, Bar 不等于 Bar, Foo；而標(biāo)簽沒(méi)有順序和層次
示例
categories: - Diary tags: - PS3 - Games
注意 下面的方法會(huì)使分類Life成為Diary的子分類嗡髓，而不是并列分類
categories: - Diary - Life
10. 關(guān)于.json和.yml配置文件的區(qū)別
兩者都可以來(lái)編寫(xiě)front-matter,只要將---換成;;;即可
例如
"title": "Hello World", "date": "2013/7/13 20:46:25" ;;;
11. 關(guān)于文章內(nèi)部的標(biāo)簽引用
1操漠，引用塊
格式
{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}
示例1
{% blockquote @DevDocs https://twitter.com/devdocs/status/356095192085962752 %} NEW: DevDocs now comes with syntax highlighting. http://devdocs.io {% endblockquote %} 輸出 NEW: DevDocs now comes with syntax highlighting. http://devdocs.io @DevDocst--witter.com/devdocs/status/356095192085962752
示例2
{% blockquote Seth Godin http://sethgodin.typepad.com/seths_blog/2009/07/welcome-to-island-marketing.html Welcome to Island Marketing %} Every interaction is both precious and an opportunity to delight. {% endblockquote %} 輸出 Every interaction is both precious and an opportunity to delight. Seth GodinWelcome to Island Marketing
注意：對(duì)應(yīng)關(guān)系
2，代碼塊
示例1
{% codeblock %} alert('Hello World!'); {% endcodeblock %} 輸出 alert('Hello World!');
3饿这，在文章中插入指定大小的圖片浊伙。
{% img [class names] /path/to/image [width] [height] [title text [alt text]] %}
12. 關(guān)于Asset資源文件夾
資源（Asset）代表 source 文件夾中除了文章以外的所有文件，例如圖片长捧、CSS吧黄、JS 文件等。比方說(shuō)唆姐，如果你的Hexo項(xiàng)目中只有少量圖片拗慨，那最簡(jiǎn)單的方法就是將它們放在 source/images 文件夾中。然后通過(guò)類似于 [圖片上傳失敗...(image-22899b-1541302947970)] 的方法訪問(wèn)它們奉芦。
當(dāng)資源文件管理功能打開(kāi)后(post_asset_folder: true)赵抢，Hexo將會(huì)在你每一次通過(guò) hexo new [layout] <title>命令創(chuàng)建新文章時(shí)自動(dòng)創(chuàng)建一個(gè)文件夾。這個(gè)資源文件夾將會(huì)有與這個(gè) markdown 文件一樣的名字声功。將所有與你的文章有關(guān)的資源放在這個(gè)關(guān)聯(lián)文件夾中之后烦却，你可以通過(guò)相對(duì)路徑來(lái)引用它們，這樣你就得到了一個(gè)更簡(jiǎn)單而且方便得多的工作流先巴。
13. 關(guān)于圖片的顯示
當(dāng)你打開(kāi)文章資源文件夾功能后其爵，你把一個(gè) example.jpg 圖片放在了你的資源文件夾中，如果通過(guò)使用相對(duì)路徑的常規(guī) markdown 語(yǔ)法 [圖片上傳失敗...(image-9a9526-1541302947971)] 伸蚯，它將 不會(huì) 出現(xiàn)在首頁(yè)上摩渺。（但是它會(huì)在文章中按你期待的方式工作）
正確的引用圖片方式是使用下列的標(biāo)簽插件而不是 markdown ：{% asset_img example.jpg This is an example image %}通過(guò)這種方式，圖片將會(huì)同時(shí)出現(xiàn)在文章和主頁(yè)以及歸檔頁(yè)中剂邮。
14. 關(guān)于Permalinks永久鏈接
在 _config.yml 配置中調(diào)整網(wǎng)站的永久鏈接或者在每篇文章的 Front-matter 中指定摇幻。
除了下列變量外，您還可使用 Front-matter 中的所有屬性挥萌。
變量 描述 :year 文章的發(fā)表年份（4 位數(shù)） :month 文章的發(fā)表月份（2 位數(shù)） :i_month 文章的發(fā)表月份（去掉開(kāi)頭的零） :day 文章的發(fā)表日期 (2 位數(shù)) :i_day 文章的發(fā)表日期（去掉開(kāi)頭的零） :title 文件名稱 :post_title 文章標(biāo)題 :id 文章 ID :category 分類绰姻。如果文章沒(méi)有分類，則是 default_category 配置信息引瀑。permalink_defaults 參數(shù)調(diào)整永久鏈接中各變量的默認(rèn)值：
示例
假設(shè) source/_posts 文件夾中有個(gè) hello-world.md狂芋，包含以下內(nèi)容：
title: Hello World date: 2013-07-14 17:01:34 categories: - foo - bar 參數(shù) 結(jié)果 :year/:month/:day/:title/ 2013/07/14/hello-world :year-:month-:day-:title.html 2013-07-14-hello-world.html :category/:title foo/bar/hello-world
15. 關(guān)于多語(yǔ)種
修改 new_post_name 和 permalink 參數(shù)，如下：
new_post_name: :lang/:title.md
permalink: :lang/:title/
建立文章時(shí)憨栽，文章會(huì)被儲(chǔ)存到：
hexo new "Hello World" --lang en
# =source/_posts/en/Hello-World.md
而網(wǎng)址會(huì)是：
http://localhost:4000/en/hello-world/
16. 關(guān)于Themes主題設(shè)置
在 themes 文件夾內(nèi)帜矾，下載主題辆影，并修改 _config.yml 內(nèi)的 theme 設(shè)定，即可切換主題黍特。
