雖然在自建博客系列（四）HEXO博客的常識+更換NEXT主題中有略微提及囱嫩，這里我還是想單獨列一個帖子來闡述下。

正文

一撼泛、最核心的寫作相關(guān)命令和格式

博客嘛挠说，最核心的功能還是要有博文，在這內(nèi)容為王的時代愿题，寫文章還是相當(dāng)重要的损俭！

1.已知命令

• 寫文章
  你可以執(zhí)行下列命令來創(chuàng)建一篇新文章。

hexo new [layout] <title> #新建文章潘酗，可以改成中文的杆兵，如“新文章”

• 刪除文章
  先刪除目標(biāo)文章，然后重新運行

hexo clean
hexo g -d

• 寫完文章后仔夺，你可以使用

hexo g #生成靜態(tài)文件
hexo s #在本地預(yù)覽效果
hexo d #同步到github琐脏，然后使用http://huangjunhui.github.io進行訪問

2.現(xiàn)狀

• 你可以在博客目錄（我的路徑是：D:\hexo）下打開“Git Bash Here”輸入以下命令：

  hexo new '測試' #系統(tǒng)會在source_posts創(chuàng)建一個測試.md文件

• 文章的永久鏈接格式title屬性取自該文件名。默認(rèn)（當(dāng)然缸兔，你也可以在 站點配置_config.yml 文件中修改日裙，見后文）生成的永久鏈接格式為:http://yoursite.com/year/:month/:day/:title/。
  

  創(chuàng)建一個名為“測試.md”文件后生成的永久鏈接格式

• 你打開（D:\hexo:\source:_posts）目錄下的這個“測試.md”文件惰蜜，會發(fā)現(xiàn)Hexo默認(rèn)的文件頭只有title屬性昂拂。

• 而執(zhí)行“hexo s”命令，啟動服務(wù)器抛猖，在瀏覽器中打開http://localhost:4000 格侯，即可看到：在打開新建博文頂部，只能看到文件名和建立的日期财著。

如果你想增添標(biāo)簽等內(nèi)容联四，那我們一起學(xué)習(xí)接下來的內(nèi)容吧。

3.添加 分類和標(biāo)簽頁面

• 分類和標(biāo)簽
  您可以在 Front-matter 中分類和標(biāo)簽設(shè)置撑教。

只有文章支持分類和標(biāo)簽

• 分類具有順序性和層次性

在其他系統(tǒng)中朝墩，分類和標(biāo)簽聽起來很接近，但是在 Hexo 中兩者有著明顯的差別伟姐，
也就是說 Foo, Bar 不等于 Bar, Foo鱼辙；
而標(biāo)簽沒有順序和層次廉嚼。

• Hexo不支持指定多個同級分類，比如：
  categories:

對技術(shù)小白來說倒戏，官方網(wǎng)頁上這有個坑怠噪。。杜跷。

• 可能需要安裝的插件

• 如果你需要顯示標(biāo)簽
  新建「標(biāo)簽」頁面傍念，并在菜單中顯示「標(biāo)簽」鏈接「鹈疲「標(biāo)簽」頁面將展示站點的所有標(biāo)簽憋槐，若你的所有文章都未包含標(biāo)簽，此頁面將是空的淑趾。

  在博客目錄（我的路徑是：D:\hexo）下打開“Git Bash Here”輸入
  hexo new page tags
  然后到新建的目錄（D:\hexo\source\tags）下阳仔，打開index.md文件進行修改：

注意：如果有啟用 多說 或者 Disqus 評論，頁面也會帶有評論扣泊。 若需要關(guān)閉的話近范，請?zhí)砑幼侄?comments 并將值設(shè)置為 false，如：

• 如果你需要顯示分類
  新建「分類」頁面延蟹，并在菜單中顯示「分類」鏈接评矩。「分類」頁面將展示站點的所有分類阱飘，若你的所有文章都未包含分類斥杜，此頁面將是空的。

  同樣沥匈，在博客目錄（我的路徑是：D:\hexo）下打開“Git Bash Here”輸入
  hexo new page categories
  然后到新建的目錄（D:\hexo\source\categories）下蔗喂，打開index.md文件進行修改：

注意：如果有啟用 多說 或者 Disqus 評論，頁面也會帶有評論高帖。 若需要關(guān)閉的話弱恒，請?zhí)砑幼侄?comments 并將值設(shè)置為 false，如：

• 一些細(xì)節(jié)

• 單個標(biāo)簽和分類的顯示
  方法很簡單棋恼，直接輸入即可。
  只要注意一點——所有文件：后面都必須有個空格锈玉，不然會報錯爪飘。

• 多個標(biāo)簽和分類的顯示方法 （此處及后面的Front-matter模板定制細(xì)節(jié)，我花了好多時間才整明白拉背。师崎。。希望我的文章能幫你少走一些彎路~~~）
  下面兩種方式均可：

注意上圖椅棺，紅色的兩個方框內(nèi)才 是多個顯示的正確語法

二犁罩、定制個性化模板

這部分內(nèi)容是我踩過坑后齐蔽，花了好多時間才總結(jié)出來的，希望我的分享對你有用

1.再說布局Layout

• 關(guān)于布局（Layout）
  Hexo 有三種默認(rèn)布局：post床估、page 和 draft含滴，它們分別對應(yīng)不同的路徑，而您自定義的其他布局和 post 相同丐巫，都將儲存到 source/_posts 文件夾谈况。

• 布局的選擇
• 默認(rèn)布局
  當(dāng)我們執(zhí)行下列命令來創(chuàng)建一篇新文章時
  hexo new [layout] <title>
  其中的[layout]命令是拿來指定文章布局的，是可選參數(shù)递胧，系統(tǒng)默認(rèn)為 post（比如當(dāng)你運行 hexo new test命令新建了一個 test.md文件時）碑韵，而 layout 的選項就是 scaffolds 目錄下的文件，也就是默認(rèn)的就是 layout的選項即為
  draft.md
page.md
photo.md
post.md
  通過這種方法缎脾，如果想增加一個layout的選項祝闻，即在這個目錄下增加一個文件，那個文件名即為新的選項遗菠，新的文件將會在(D:\hexo) source_post\目錄下联喘。
• 更改默認(rèn)布局
  您可以在命令中指定文章的布局 [layout]，
  或者
  通過修改站點配置文件 _config.yml 中的 default_layout 參數(shù)來指定默認(rèn)布局(在后文的配置中會提到具體修改參數(shù)）舷蒲，這樣所有的文章都會以md形式保存在（D:\hexo目錄下的）source文件夾的_post文件夾中耸袜，只要在_post文件夾中新建md類型的文檔，就能在執(zhí)行hexo g的時候被渲染牲平。

不要處理我的文章
如果你不想你的文章被處理堤框，你可以將 Front-Matter 中的layout: 設(shè)為 false 。

2.修改文章的永久鏈接格式

• 具體參數(shù)
  關(guān)于文章名稱和永久鏈接（Permalinks）的參數(shù)情況以及更復(fù)雜的生成方法可以具體查看官方文檔纵柿。

hexo采用了 moment.js蜈抓，如果你想研究得更深入，那么想看現(xiàn)實格式的具體參數(shù)可以參照 這里

• 修改默認(rèn)的URL
  如果你覺得默認(rèn) URL 顯得比較冗長了昂儒，需要進行修改沟使，那么可以嘗試直接從站點配置文件 _config.yml 中修改成如下
  permalink: :category/:title/
  這點我嘗試沒修改站點配置文件前提想，在文章的Front-matter里面直接修改渊跋，結(jié)果失敗

3.定制模板

• Front-matter是什么
  Front-matter 是文件最上方以 --- 分隔的區(qū)域腊嗡，用于指定個別文件的變量。

• 參數(shù)
  你可以在官方頁面上找到Front-matter 參數(shù)的定義拾酝，并可在模板中使用這些參數(shù)值并加以利用燕少。

• 個性化的模板

我們發(fā)布文章的時候有個想法，就是我們能不能只寫文章蒿囤，格式雖然 markdown 夠簡單客们，但是不免有些字段還是需要我們自己輸入，例如 ## 標(biāo)題、 這種底挫，能否再簡化一點恒傻，直接 new 文章的時候自動創(chuàng)建好，答案是可以的~~

找到模板（D:\hexo\scaffolds\post.md ）建邓，在里面的內(nèi)容在新建的時候盈厘，都會直接創(chuàng)建出來，也就是類似 template 的功能了涝缝，這樣就可以在模板里創(chuàng)建好文章骨架扑庞，架構(gòu)，以后每次創(chuàng)建出來的文章都是通用的結(jié)構(gòu)拒逮，就可以直接開始寫文章罐氨，而不必熟悉記住一些語法關(guān)鍵字神馬的了，目前我是這樣修改的：

海天心的POST模板

這樣滩援，以后寫博文時可以直接往對應(yīng)的地方寫文字就可以了栅隐，機智否？

• 我的理解
  作為技術(shù)小白玩徊，我在這一步折騰了很久租悄，目前是這樣理解幾個參數(shù)的：

Hexo默認(rèn)的文件頭只有title、date恩袱、tags屬性泣棋，生成的html會缺少Meta信息，不利于搜索引擎收錄畔塔。

在文件頭中添加keywords和description屬性潭辈，是為了便于搜索。

• description
  加了這個front-matter參數(shù)后澈吨，會對“閱讀全文”顯示效果有影響（再往本文下面看）把敢。

• keywords
  不知道這個是不是為了有利于搜索引擎收錄，我嘗試了谅辣，但是在博客的顯示效果上好像沒什么區(qū)別修赞，感興趣的可以自己咨詢下這里。

• 其他可能可以適用的參數(shù)或變量
  可以看看《Hexo ： （三）高級進階》

• 如何設(shè)置「閱讀全文」

• 一般情況
  在主題配置文件中找到如下字段桑阶，已修改如下：

auto_excerpt:
enable: true
length: 150 #默認(rèn)截取的長度為 150 字符柏副，可以根據(jù)需要自行設(shè)定

• 幾種選擇
  在首頁顯示一篇文章的部分內(nèi)容，并提供一個鏈接跳轉(zhuǎn)到全文頁面是一個常見的需求蚣录。 NexT 提供三種方式來控制文章在首頁的顯示方式割择。 也就是說，在首頁顯示文章的摘錄并顯示 閱讀全文 按鈕包归，可以通過以下方法：

• 在文章中使用 手動進行截斷，Hexo 提供的方式(推薦)

• 在文章的 front-matter 中添加 description，并提供文章摘錄

• 自動形成摘要公壤，在主題配置文件中添加：
  auto_excerpt:
  enable: true
  length: 150

  默認(rèn)截取的長度為 150 字符换可，可以根據(jù)需要自行設(shè)定

建議使用 （即第一種方式），除了可以精確控制需要顯示的摘錄內(nèi)容以外厦幅， 這種方式也可以讓 Hexo 中的插件更好的識別沾鳄。

• 我的嘗試
  Front-matter增加了description，在首頁將優(yōu)先顯示 description（不受字?jǐn)?shù)限制确憨，但是在MD文件里書寫不能換行）而且不受限制译荞，其次是 excerpt（這個還沒琢磨透）。

三休弃、發(fā)現(xiàn)的一個小問題及解決辦法

系統(tǒng)生成的文章目錄不正確吞歼，比如像這樣：

更改主題配置文件（D:\hexo\themes\next_config.yml）：搜索“doc”后，進行如下修改：

第二個若為true塔猾，表示開啟

參考
官方給出的Front-matter格式和標(biāo)簽插件

既然來了篙骡，留下個喜歡再走吧，鼓勵我繼續(xù)創(chuàng)作……
如果喜歡我的文章丈甸，那就關(guān)注我的簡書賬號吧糯俗，我們一起做朋友~~
歡迎關(guān)注個人微信公眾號：海天心