使用Github Pages搭建我的Blog

使用Github Pages搭建我的Blog

關於使用Github Pages搭建我的Blog的文章網絡上處處都是，下面僅記錄下簡單的流程和搭建過程當中遇到的一些坑

建立項目主頁

這裏直接使用了GithubPages嚮導中提供的方法

這樣整個網站內容都在master分支下

http:// username .github.io/就是你的我的主頁的地址了

jekyll模板的使用

隨後咱們須要建立用於jekyll的網站結構，關於jekyll的更多內容能夠參見這裏

爲了方便因此就先找個jekyll模版用下先

這裏我使用的是這個Cayman Theme,結構樣式都比較簡單，方便以後基於這個搞本身的模版

下載模版放到git目錄下便可

本地環境搭建

Ruby環境搭建

jekyll基於Ruby開發，因此須要一個Ruby環境來提供本地測試

Mac OS 已自帶Ruby環境(新版Ruby自帶gem)

因此Ruby和gem安裝這步就省了

windows下安裝能夠參見這裏

安裝Bundle

因爲國內網絡的問題gem基本上是掛掉的

因此使用gem前仍是替換淘寶鏡像先

gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/

而後執行下面的命令(須要管理員權限):

gem install bundle

頁面初始化

bundle使用前須要建立Gemfile文件來定義gem源和插件依賴

模板中一般都會有這個文件，因此使用模板的話，這步一般能夠省略

不過要確認下模板中的Gemfile的source是不是淘寶鏡像，不是須要替換成 https://ruby.taobao.org/

這裏是個人Gemfile文件的內容，

source 'https://ruby.taobao.org/'
gem 'jekyll'
gem 'jekyll-paginate'
gem 'kramdown'
gem 'pygments.rb'

模版Cayman Theme中使用的markdown解釋器是redcarpet，

貌似自5月1日之後，github就再也不支持這個解釋器了，因此這裏替換了github默認的解釋器kramdown

而後執行

bundle install

來安裝相應的依賴 (jekyll也一併安裝了)

本地測試

編譯並啓動本地服務

bundle exec jekyll serve

默認預覽地址 http://127.0.0.1:4000/

發佈

本地測試經過後 提交分支便可