繼上一篇文章之后,你的博客應該都已經能夠正常的在本機運行了。但是這遠遠不能滿足我們搭建博客的需求。不過老生常談,大部分的配置都能夠在官方找到,傳送門Hexo配置。不同的主題還有個性化的配置,詳細的配置請參見你使用的主題的文檔。
Hexo的目錄結構
使用
$ hexo init
命令之后,會初始化完成一個完整的博客文件夾,其中包含以下幾個文件或文件夾:
_config.yml Hexo的配置文件,大部分的參數在這里配置
package.json 應用程序的信息,小白不用動這個文件,官方提示可以自由移除
scaffolds 模板文件夾。新建文章時,采用的模板存放于此
source 用戶存放資源的地方,所有用戶生成文件或資源都用這里保存_drafts 草稿文件夾,用戶可以直接生成草稿到這個文件夾
_posts 可發布的文章文件夾,下面的文章會在hexo d
時,發布出去
themes 主題文件夾,Hexo會根據主題設置生成靜態頁面
_config.yml配置
這一節的內容全部copy自官方文檔
網站
參數 | 描述 |
---|---|
title | 網站標題 |
subtitle | 網站副標題 |
description | 網站描述 |
author | 您的名字 |
language | 網站使用的語言 |
timezone | 網站時區。Hexo默認使用您電腦的時區。時區列表。比如說:America/New_York,Japan,和UTC。 |
網址
參數 | 描述 | 默認值 |
---|---|---|
url | 網址 | |
root | 網站根目錄 | |
permalink | 文章的永久鏈接格式 | :year/:month/:day/:title/ |
permalink_default | 永久鏈接中各部分的默認值 |
網站存放在子目錄
如果您的網站存放在子目錄中,例如
http://yoursite.com/blog
,則請將您的url
設為http://yoursite.com/blog
并把root
設為/blog/
。
目錄
參數 | 描述 | 默認值 |
---|---|---|
source_dir | 資源文件夾,這個文件夾用來存放內容。 | source |
public_dir | 公共文件夾,這個文件夾用于存放生成的站點文件 | public |
tag_dir | 標簽文件夾 | tags |
archive_dir | 歸檔文件夾 | archives |
category_dir | 分類文件夾 | categories |
code_dir | Include code文件夾 | downloads/code |
i18n_dir | 國際化(i18n)文件夾 | :lang |
skip_render | 跳過指定文件的渲染,您可使用glob 表達式來匹配路徑。 |
文章
參數 | 描述 | 默認值 |
---|---|---|
new_post_name | 新文章的文件名稱 | :title.md |
default | 預設布局 | post |
auto_spacing | 在中文和英文之間加入空格 | false |
titlecase | 把標題轉換為title case | false |
external_link | 在新標簽中打開鏈接 | true |
filename_case | 把新文件名稱轉換為(1)小寫或(2)大寫 | 0 |
render_drafts | 顯示草稿 | false |
post_asset_folder | 啟動Asset文件夾 | false |
relative_link | 吧鏈接改為與根目錄的相對地址 | false |
future | 顯示未來的文章 | true |
highlight | 代碼塊的設置 |
分類&標簽
參數 | 描述 | 默認值 |
---|---|---|
default_category | 默認分類 | uncategorized |
category_map | 分類別名 | |
tag_map | 標簽別名 |
日期/時間格式
Hexo使用Moment.js來解析和顯示時間。
參數 | 描述 | 默認值 |
---|---|---|
date_format | 日期格式 | YYYY-MM-DD |
time_format | 時間格式 | H:mm:ss |
分頁
參數 | 描述 | 默認值 |
---|---|---|
per_page | 每頁顯示的文章量(0=關閉分頁功能) | 10 |
pagination_dir | 分頁目錄 | page |
擴展
參數 | 描述 |
---|---|
theme | 當前主題名稱。值為false時禁用主題 |
deploy | 部署部分的設置 |
主題設置
我的主題使用的@Litten制作的主題Yilia。
關于主題的設置,可以參考該主題的配置。
關于主題的設置,有些坑在這里說明一下。
相對路徑
Hexo對于路徑的生成策略都是相對路徑,也就是說,只要你不指定為絕對路徑,設置的鏈接都將是root
+url
的形式。
例如:
github: "github.com/arobot"
點擊圖標會鏈接到http://yoursite/github.com/arobot
,顯然這樣是錯誤的。正確的設置方式是絕對路徑:
github: "https://github.com/arobot"
同理,其他項的設置也是如此,注意區分你使用的鏈接是否需要指定絕對路徑。
個人域名
獲取ip
如果你手上恰好有一個為自己購買的域名,那正適合你剛剛搭建好的博客。
我的域名是在aliyun.com上購買的,在我搭建這個博客時候就想,我應該有一個自己的域名,換了很多組合選了一個還算滿意的。當你看到這里的時候,如果也有沖動,那趕緊去看看吧,說不定過兩天就沒有了呢
首先,需要知道你的博客所在的服務器地址
$ ping arobot.github.io
得到我的博客在151.101.100.133
上面,記下這個ip,會在后面用到。
設置域名解析
進入阿里云的云解析,可以為你購買的域名添加解析。

選項 | 描述 |
---|---|
記錄類型 | 選擇A
|
主機記錄 | 配置兩項。一項填寫@ ;另一項填寫www
|
其他的選擇默認就行,配置好的結果如下

完成了域名的解析工作之后,在博客的source
文件下新建文件名為CNAME
的文件,將你的域名不加協議填寫進去。例如wluo.me
。
個性化域名的配置就完成了,將博客部署上去就能夠通過自己的域名鏈接過來。
部署博客
靜態網頁可以部署在多種服務器上,Hexo官方提供了多種部署方式,詳細的部署方式參見官網。
我是部署在Github pages
上。
在_config.yml
文件中配置deploy
deploy:
type: git
repo: https://github.com/arobot/arobot.github.io.git
branch: master
原文見我的博客