前言
偶然間發現Hexo這款很不錯的博客框架,能直接生成靜態文件,可以很方便的進行部署,搭配GitPages簡直不要太棒,省去了服務器的維護。支持Markdown,剛好符合我的習慣,因此決定使用Hexo+GitPages的方式搭建一個個人博客,歡迎訪問Sunshine。此處記錄搭建的過程。
初始化GitPages
GitPages的使用依賴於GitHub賬號,若沒有需要自行創建。
基本使用
- 新建Repository,命名爲
<GitHub賬戶名>.github.io
- Clone倉庫到本地,並創建測試頁面,命名爲
index.html
,Push到遠程GitHub,即可通過<GitHub賬戶名>.github.io
訪問到頁面
自定義域名
- 進入Repository的設置界面,在
Custom domain
填入域名地址 - 配置域名解析,添加
CNAME
類型的記錄,填入<GitHub賬戶名>.github.io
安裝Hexo
Hexo依賴Node.js和Git,詳細步驟可參考官方文檔。
使用npm安裝Hexo
npm install -g hexo-cli
初始化博客目錄
爲自定義文件夾,Hexo會在該文件夾下創建博客文件。
hexo init <folder>
cd <folder>
npm install
啓動博客服務器
在博客目錄下,執行如下命令即可啓動博客服務器,可以看到一篇示例博文。默認端口4000,訪問地址爲:http://localhost:4000
hexo server
新建文章
使用Hexo的命令創建一篇文章,會在source/_posts
路徑下生成對應的Markdown
文件。關於創建文章的詳細說明,參照官方文檔。
hexo new FirstPage
使用文本編輯器,編輯文章的內容,最好使用可視化的Markdown
編輯器。啓動博客服務,可看見新建的文章。
發佈博客到GitPages
方式一:手動提交靜態網頁
使用將Hexo生成的靜態網頁文件手動提交到代碼倉庫的方式來發布博客。
- 執行
hexo generate
命令,會在博客目錄生成public
文件夾,裏面是打包的靜態網頁文件 - 將
public
文件夾下的內容push到GitPages的倉庫 - 訪問GitPages即可看到博客的內容
方式二:使用Hexo的deploy命令發佈
通過配置Hexo的部署選項,部署博客到GitPages。
- 安裝
hexo-deployer-git
npm install hexo-deployer-git --save
- 編輯
_config.yml
配置文件,加入部署的相關配置
deploy:
type: git
repo: https://github.com/<username>/<username>.github.io
branch: [branch] #默認爲master,GitPages的個人主頁只能部署master分支,項目主頁可選
message: [message]
- 生成博客站點文件並部署至遠程倉庫
hexo clean && hexo deploy
- 查看GitPages所在倉庫文件是否更新,進入GitPages頁面即可看到博客內容
總結
本篇文章只粗略的記錄了主要步驟,更多詳細使用說明請參照官方文檔。