Hexo 編輯文章

基本設定都完成後就可以來寫部落格了! 在正式開始前，如果能對 Hexo 的資料夾架構及 Front-matter 有點基本的認識，會對後續的操作很有幫助。

Hexo 資料夾架構

之前在 hexo init 之後，根目錄資料夾會多了一些預設檔案，接下來會對其中比較重要的做簡單說明。

root
├── .deploy_git             # 內含已部署到 Github Repository 的所有檔案
├── public                  # hexo g 生成靜態網站檔
├── scaffolds               # 樣板資料夾(hexo new 會從這裡抓樣板，也可以自己新建樣板)
|   ├── draft.md            # 草稿樣板
|   ├── page.md             # 頁面樣板
|   └── post.md             # 文章樣板(預設)
├── source                  # 存放原始檔案的地方
|   ├── _data               # 存放自定義設定原始碼的地方
|   ├── _drafts             # 草稿資料夾
|   └── _posts              # 文章資料夾
├── themes                  # 各種主題資料夾
|   └── landscape           # 預設主題
|       └── _config.yml     # 主題樣式設定檔
├── .gitignore              # 設定不想被加入版本控制或是上傳到 GitHub 的資料夾或檔案
└── _config.yml             # Hexo 基本設定

• _drafts 草稿資料夾預設會被 generate 、server 和 deploy 指令略過(_post 以外以”_”開頭的資料夾都是)。如果想在 localhost 先預覽的話，可以在 root\_config.yml 裡把 render_drafts: false(預設) 改為 true。

Front-matter

Front-matter 是檔案最上方以 — 分隔的區域，用於指定個別檔案的變數。可以每篇文章個別設定，也可以預先在樣板中建立套用內容。常用的變數如下:

title        # 標題(預設為檔案名稱)
date         # 建立日期(預設為檔案建立日期)
updated      # 更新日期(預設為檔案更新日期)
comments     # 留言功能(預設 true :開啟)
tags         # 標籤
categories   # 分類

• 當因為重新部署或其他原因，導致在沒有修改文章情況下顯示文章更新，可以手動修改 updated 值，讓他跟建立日期相同即可。
• 多個標籤/多個分類寫法不同，可參考官方說明。

草稿編輯

新增草稿

草稿會建立在 root\source\_drafts 資料夾內。

hexo new draft 文章名稱

草稿轉文章

指令會把檔案從 _drafts 移至 _posts 資料夾內，也可以自己手動移動。

hexo publish draft 文章名稱

文章編輯

新建文章

會建立在 root\source\_posts 資料夾內。

hexo new 文章名稱         # 預設抓取 post 樣板

刪除貼文

直接從 root\source 資料夾刪除本地檔案，清除靜態檔再重新上傳即可。

hexo clean
hexo g
hexo d

頁面編輯

頁面和文章不同，是指每個主題 menu 項目的頁面。如果有開啟 menu 項目卻沒有預設頁面的情況下，會被導向 404 畫面。常用的幾個頁面如下:

about         # 關於我(通常會寫網站介紹或作者介紹)
archives      # 歸檔(依發布日期把所有文章排序)
categories    # 分類(會依每篇文章 Front-matter 裡的分類建立分類目錄-有層級)
tags          # 標籤(會依每篇文章 Front-matter 裡的分類建立標籤目錄-無層級)
link          # 對外連結(通常是推薦部落格或網站的連結)

新建頁面

hexo new page 頁面名稱

• 頁面通常不需要開啟留言功能，所以在新建時要記得將 Front-matter 的 comments 值改為 false。

---
title: categories
date: 2021-12-14 18:33:37
type: "categories"
comments: false
---

---
title: tags
date: 2021-12-14 18:34:46
type: "tags"
comments: false
---

• 新建頁面會新建一個 index 檔案，放在”頁面名稱”資料夾裡。

文章發布

同之前的部署指令。

hexo clean
hexo g
hexo d

文章內容如有錯誤，歡迎留言討論！