1. 程式人生 > >Github上寫Blog

Github上寫Blog

預備知識:

必須:Git,GitHub,JekyllMarkdown

可選:HTML,JavaScript,CSS,XML

工具:

可選:VSCode+Markdown Preview Github Styling,GitHub Desktop

操作:

  1. 註冊一個GitHub的賬號,可以使用GitHub Desktop或者GitHub網站;
  2. 建立一個空的專案
    • 在專案裡面建立index.md,或者index.html,提交後,部落格首頁就建好了。
      • 注1:index.html的優先順序比index.md的高,系統會預設使用index.html顯示。
    • 進入專案的Settings,找到Github Pages,修改Source的選項,預設是None(也就是不開啟主頁顯示模式),改為master branch,點save。頁面重新重新整理,再找到Source就會出現系統提示的顯示地址。
    • 如果還想換個漂亮的面板,就點theme就可以了。
      • 注1:所有的操作完成後,系統會編譯你的主頁,等1分鐘左右,就可以點選那個地址,看自己的成果了。如果報錯,就再多等一會,可惜GitHub也不給個編譯程序的提示。
      • 注2:如果你的index.md檔案編寫有問題,系統編譯沒有通過就會報錯,提醒你去修改。
  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:系統需要編譯,請耐心等待一會再開啟檢視,還要記得看系統編譯有沒有問題。
      • 注2:如果不喜歡遠端編譯結果出來後才知道有沒有問題,可以自己在本機安裝Jekyll,具體方法可以參考其他文章。
  4. 如果還想更漂亮的的頁面,更完整功能可以fork這個專案 mmistakes/minimal-mistakes
    • 以後補充。