Hexo 基本設定

基本上經過上一篇的操作,在 hexo s 後應該已經可以在 http://localhost:4000 看到預設的 Hello World 畫面了,但要讓 Blog 正式啟動前,我們還要先做一些個人化設定。

本文撰寫時的版本如下(可用 hexo version 確認),不同版本的預設配置檔可能會有差異:
hexo: 6.0.0
hexo-cli: 4.3.0

  • 基本配置文件位置在 root\_config.yml冒號後面都必需保留半型空格一格
  • 僅列出通常會修改或我已經修改的部分,其他請參考官方網站說明。

網站設定

1
2
3
4
5
6
7
8
# Site
title: Hexo # 網站標題
subtitle: # 網站副標題
description: # 網站描述
keywords: # 網站關鍵字(支援多個關鍵詞,用半型逗號隔開)
author: John Doe # 作者
language: en # 網站語言 (台灣:zh-tw)
timezone: # 時區(可留空以使用您電腦的時區)

網址設定

1
2
3
4
5
# URL
## Set your site url here.
url: http://UserName.github.io/ # UserName更改為自己的帳戶名
permalink: :year/:month/:day/:title/ # 文章網址的格式(預設使用 年月日/文章名稱)/
permalink_defaults: # permalink 中各區段的預設值
  • permalink 會依照設定值,在每次 generate 時重新產生網址,設定參數可參考官方文件。我在命名檔名時,習慣使用日期 + 英文檔名(日期方便排序,不含空格的英文檔名較不會產生亂碼網址),所以 permalink: 僅用 :title 參數 (最後的 / 要記得保留)。
  • 2021/12/27 更新: 使用 Hexo-abbrlink 產生永久連結

目錄設定

原則上都保留不變,除非有自訂路徑的需求。

1
2
3
4
5
6
# Directory
source_dir: source # 原始檔案資料夾,存放編輯的所有內容
public_dir: public # 存放靜態檔案的資料夾(hexo g 後產生)
tag_dir: tags # 標籤資料夾
archive_dir: archives # 彙整資料夾(deploy後產生)
category_dir: categories # 分類資料夾
  • tagscategories 資料夾預設是不存在的,有需要要另外新增資料夾。

擴充套件設定

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/ # 提供各種套件,可以依自己需求安裝
## Themes: https://hexo.io/themes/ # 提供各種主題,可以依自己需求安裝
theme: landscape # 填寫主題名稱
  • 本部落格選用 Next 主題(要把 landscape 改為 Next),後續會另開一篇變更主題說明文。

部署設定

1
2
3
4
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: ''
  • Hexo 可同時部署到不同地方,相關設定參考官方部署說明
  • 部署到 Github 方式已在用前篇 Hexo + Github Pages 建立部落格 中說明,這邊不另外贅述。

文章內容如有錯誤,歡迎留言討論!


本 Blog 上的所有文章除特别聲明外,均採用 CC BY-SA 4.0 協議 ,轉載請註明出處!