Github上寫Blog

預備知識：

必須：Git，GitHub，Jekyll，Markdown，YAML

可選：HTML，JavaScript，CSS，XML

工具：

可選：VSCode+Markdown Preview Github Styling，GitHub Desktop

操作：

1. 註冊一個GitHub的賬號，可以使用GitHub Desktop或者GitHub網站；
2. 創建一個空的項目
   • 在項目裡面創建index.md，或者index.html，提交後，博客首頁就建好了。
     • 註：index.html的優先順序比index.md的高，系統會預設使用index.html顯示。(系統需要編譯，編譯的進度請參考註1)
   • 進入項目的Settings，找到Github Pages，修改Source的選項，預設是None（也就是不開啟主頁顯示模式），改為master branch，點save。頁面重新刷新，再找到Source就會出現系統提示的顯示地址。（編譯沒有通過的項目是無法正常顯示的）
   • 如果還想換個漂亮的皮膚，就點theme就可以了。
3. 如果不甘心使用這樣簡單的主頁，你就需要fork一個別人的項目barryclark/jekyll-now；
   • 修改_config.yml文件
     • name：博客的名字
     • description：顯示在瀏覽器上的標題欄的名字
     • avatar：博主的照片（可以從Git的Profile裡面取照片的地址）
     • # Flags below are optional：表示以下的內容可以選擇性的修改
       • email，github是我有的，其他的就看個人喜歡，不填內容就不會在網頁上顯示，也不會出錯
       • sina，douban等國內的需要修改代碼才能實現（人懶就先放一下了）
     • permalink : 在前面加個#把它屏蔽掉，因為預設的方式似乎無法正常顯示。
   • Settings設置參考前面的說明。
   • 按照“_post”目錄下的“2014-3-3-Hello-World.md”的模式，依據“YYYY-MM-DD-文件名稱.md”的標準創建一個新文件，就是你發表的新文章了。
     • 打開主頁，就會看到文章的主題出現在主頁，點進去就可以看到文章的內容。(系統需要編譯，編譯的進度請參考註1)
4. 如果還想更漂亮的的頁面，更完整功能可以fork這個項目minimal-mistakes
   • 具體修改可以fork我的項目zhuyuanxiang.github.io，改了中文的地方就是我修改的，並且將需要的一些文件從docs目錄下移到了根目錄下。

註1：瞭解編譯的進度，可以點Code的commits，進去後會看到自己本次提交的記錄，如果後面有個綠色的√就是編譯成功了，如果是個紅色的×就是編譯失敗了，失敗了主頁就無法顯示你想要展示的內容。

註2：如果不喜歡遠程編譯結果出來後才知道有沒有問題，可以自己在本機安裝Jekyll，具體方法可以參考其他文章。