hexo是當前最火的靜態博客框架,支持Markdown格式文章編輯並自動生成對應的靜態網頁,簡單高效令人愛不釋手。
使用hexo寫博客的流程通常是,
- 通過
hexo new post_name
命令,會自動在source/_post
目錄下生成一個待寫的post_name.md
文件 - 編寫完該md文件後,用
hexo generate
編譯生成對應的HTML文件 - 發佈之前,可以用
hexo s
本地預覽,然後通過hexo deploy
發佈到遠程倉庫的master分支,然後你的個人站點就能看到剛纔新加的文章了
困擾
然而,使用過hexo搭建個人博客的朋友們想必都會遇到博客源碼保存的問題。即遠程倉庫只會保存hexo發佈後的靜態HTML文件,你的博客md源文件、主題配置等還在本地,一旦電腦磁盤壞了或者換了電腦,就無法在之前倉庫的基礎上繼續寫博客。針對此問題,有不少博主會在github上單獨另起一個repository來專門保存博客源文件,每次發佈完新文章,需要手動地將source/post
下的md文件上傳到源文件對應的repository,確實也能解決問題,但總歸是麻煩。後來偶然看到聰明的網友藉助git分支來巧妙地實現用同一個倉庫保存靜態網頁和博客源碼,自己試了下確實很贊,故總結之。
解決辦法
新建git分支
因Github Page要求使用master分支作爲發佈網站的源代碼,我們只能用master分支來保存hexo生成的靜態網頁,對於博客源碼,可以新建一個source分支來存儲。在github上打開Pages對應的倉庫,也就是以"username.github.io"命名的倉庫,然後建立一個source分支,如下圖:
因爲我已經創建過source分支,故下方會顯示目前該倉庫上有master和source兩個分支。其中source分支顯示打鉤,表示當前倉庫的默認分支已經是source而不是master了,下面會講。
更改倉庫的默認分支
github上的倉庫初始都會有個master分支,也就是默認分支。對於一個倉庫project_name
,當我們通過git clone https://github.com/sherlockyb/project_name.git
下載代碼時,實際拉取的是默認分支master對應的代碼。而我們用hexo寫博客時,通常是與md源文件打交道,對於deploy生成的master分支代碼並不需要我們關注,因此可將倉庫的默認分支改爲保存源碼的source分支,這樣通過git clone
拉取的就是source分支代碼了。
在倉庫的主頁面,通過Settings -> Branchs,可以看到Default branch的Tab,顯示的默認分支是master,可以勾選source,然後update即可將默認分支設置爲source,如下圖:
將本地hexo目錄與遠程倉庫關聯
進入到本地hexo工程目錄,也就是我們通常執行hexo new post
等命令的目錄,執行如下操作:
git remote add origin https://github.com/sherlockyb/sherlockyb.github.io.git
推送博客源碼
將本地的md源文件、站點配置文件等推送到source分支。
因爲我們只需要保留博客源碼,其他無關的文件並不希望推送,需要確保配好了.gitignore
文件,通常如下:
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
然後依次執行如下命令:
git add .
git commit -m 'hexo source post'
git push origin source
刪除public等文件(可選)
因爲source分支是從master分支新建的,初始代碼實際就是master的拷貝,因而master中已有的public等deploy生成的文件也會一起帶過來,這些都不算是博客源文件,如果你也覺着source分支還存着這些有些彆扭,就可以先在本地把它刪掉,然後執行:
git add .
git commit -m 'DEL: public things which only for deploy'
git push origin source
執行完之後,你的倉庫大概就是長這個樣子:
後續即便你再發布博客時,deploy生成public文件,在提交博客源碼時,也不會將其帶上去,因爲有.gitignore
將其忽略了。
新環境
假設我們換電腦了,要在新環境繼續在原有倉庫基礎上擼文章,此時通過git clone
將博客源碼拉到本地,然後安裝、初始化hexo就能搞定:
git clone https://github.com/sherlockyb/sherlockyb.github.io.git sherlockyb
cd sherlockyb
npm install hexo
npm install hexo-deployer-git -save
// hexo環境配置好後,繼續像之前一樣
hexo new post_name
...
注意事項
確保hexo deploy
推送的是master分支,hexo目錄下的_config.yml文件通常會配置deploy推送的目標地址,這個一般在最初使用hexo時,就會配置爲master,不用改動:
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/sherlockyb/sherlockyb.github.io.git
branch: master
同步更新到原文