我想把部落格轉移到Jekyll
為什麼用Logdown撰寫文章不好呢？
原因有二：

  1. Logdown對Mathjax的支援不甚理想
    不管在手機上還是電腦上
    數學式子都會出現奇怪的邊邊
    尤其在某些佈景主題下更是完全無法閱讀

  2. 我希望讀者能夠更積極地參與撰寫教學的過程
    Logdown顧名思義就是個部落格
    這種類似Wiki的想法不是也不應該是它的設計理念

此外我還對要轉移至的平台有著以下訴求

  1. 能用GitHub Flavored Markdown(GFM)撰寫文章
    我覺得這是撰寫文章的一個很好的標記語言
    無論對於人類抑或是機器
    GFM都是高度可讀的

  2. 和Git有著緊密連結
    我希望讀者能隨時提交Pull Request(PR)
    這使得文章的撰寫不再是單人的獨立活動
    而能成為所有人都能參與的共同活動

  3. 能提供Disqus的留言功能
    這麼一來
    即使是不會用/不想提交PR的讀者
    也能用留言進行簡單的互動
    例如問問題之類的

在以上的大前提下
我找到了Jekyll

簡介

在Jekyll的官方網站上
對於它的介紹是這麼寫的

簡單
安裝時不再需要資料庫、評論審查、或者麻煩的更新
你只需要你的(文章)內容
靜態
可含有Markdown(或Textile), Liquid, HTML和CSS
能直接佈署靜態網頁
適用部落格的
永久連結、類別、頁面、貼文和自訂介面在這之中都是一級成員

哇！聽起來很棒！
而且GitHub Pages是直接基於Jekyll上
它當然是免費的
而且還和GitHub有著緊密的連結
來看看怎麼用Github Pages建立一個網站

建立網站

  1. 首先
    建立一個GitHub的repo
    repo的名稱必須是username.github.io
    其中username是你GitHub上的使用者名稱(或機構名稱)
    啊對了
    我的使用者名稱是AndyShiue
    以下都將以AndyShiue做為例子

  2. 如果沒有安裝Git的話
    請安裝它
    在這裡你可以下載到Git
    下載後安裝應該是很簡單的事情
    之後請用cd移到你想要儲存檔案的資料夾
    以我來說的話
    是C:\AndyShiue
    所以請打開命令提示字元
    送出cd C:\AndyShiue\
    然後把你的repo複製下來
    git clone https://github.com/AndyShiue/AndyShiue.github.io

  3. 然後進入你repo的資料夾中
    cd AndyShiue.github.io
    加入一個檔案index.html：
    echo "Hello World" > index.html

  4. 接著把你本機的檔案推送到Github上
    git add --all
    git commit -m "Initial commit"
    git push -u origin master
    輸入帳號密碼 完成！

  5. 完成了
    到http://Andyshiue.github.io
    你應該就能看到你的網頁
    如果進到你的網站是404的話
    那可能是因為你的GitHub帳號的email沒有驗證過

安裝

接下來介紹如何使用Jekyll
首先在電腦上安裝Jekyll
這樣你就能在推送網站到GitHub前先看看有沒有出什麼錯誤

  1. 因為Jekyll是用Ruby寫的
    所以我們必須先安裝Ruby
    如果你是Windows使用者
    可以下載並安裝RubyInstaller
    如果你在之前沒有安裝過Ruby
    請重新啟動你的命令提示字元

  2. 安裝Bundler
    輸入gem install bundler

  3. 輸入gem install jekyll
    恭喜你成功在你的電腦上安裝Jekyll了！

接著要安裝Github Pages Gem

  1. 先移到你本來本機裡存放Github Pages的資料夾
    以我來說的話是C:\AndyShiue\AndyShiue.github.io

  2. 在那個資料夾裡建立一個檔案Gemfile
    打開它並加入以下文字之後儲存檔案 
    source 'https://rubygems.org'
gem 'github-pages'
  3. 在命令提示字元中運行bundle exec jekyll build --safe
    要是命令提示字元中有任何指示
    跟著它的指示做
    以我來說的話
    它會叫我運行bundle install
    然後又叫我跟著這裡的指示做
    我必須到這裡安裝DevKit
    我把DevKit解壓縮在C:\DevKit
    然後cd C:\DevKit
    執行ruby dk.rb init
    開始安裝ruby dk.rb install
    安裝好了
    回到原本的資料夾cd C:\AndyShiue\AndyShiue.github.io
    再度執行bundle install
    等了好久……終於成功了！
    bundle exec jekyll build --safe 成功
    安裝好Github Pages Gem了
    現在你可以輸入jekyll serve預覽你的網頁
    天啊……又跳錯誤訊息了XDDDDDD
    它叫我安裝kramdown
    這邊叫我運行gem install kramdown
    再來一次 jekyll serve
    還是失敗……
    Google了一下
    輸入bundle exec Jekyll serve
    成功！
    在瀏覽器的網址列裡面輸入http://127.0.0.1:4000/就能看到你的網頁了