如何使用 Hexo 寫文章

在介紹完安裝與設定之後,我們可以開始使用 Hexo 來寫作,介紹一些寫作時會用到指令。

建立新文章

開啟 [命令提示字元] 視窗,並切換到 blog 資料夾。

hexo new [layout] <title>

Hexo 內建兩種 layout

  • post: 預設值,沒有指定的話將會是這個 layout,適合用來發表文章,文章儲存在 source/_posts。

新增一篇文章

hexo new "first-post"

將生成 source/_posts/first-post.md

  • page: 適合用來產生類似關於我這種頁面,文章儲存在 source。

新增一個頁面

hexo new page "about"

將生成 source/about/index.md

寫作文章

開啟 .md 檔後可以發現系統自動帶入一些設定,如果覺得系統產生的不符合自己的需求,可以修改 scaffolds 資料夾內相對應的範本。

title: first-post
date: 2014-08-05 08:01:00
tags:
---

介紹幾個常用設定

  • title: 標題。
  • date: 發佈日期。
  • tags: 標籤,layout 如果是 page 則無效。
  • categories: 分類,layout 如果是 page 則無效。

多個標籤或分類可以這樣設定 tags: [tag1, tag2]

設定好之後可以開始寫文章,使用 Markdown 格式來寫作,張貼程式碼很方便。

設定文章摘要

在文章列表頁預設會顯示全部的文章內容,但有時候文章很長,如果全部顯示會很佔空間,可以在文章中插入 <!-- more -->,列表頁只會顯示 <!-- more --> 之前的內容,當查看後才會顯示完整的文章。

預覽

啟動預覽伺服器

hexo server

使用瀏覽器開啟 http://localhost:4000/ 就可以看到網站,在撰寫文章的期間,只要執行hexo server後不退出,儲存文章後可以即時看到結果,非常方便。