Github上寫Blog
阿新 • • 發佈:2019-01-06
預備知識:
可選:HTML,JavaScript,CSS,XML
工具:
可選:VSCode+Markdown Preview Github Styling,GitHub Desktop
操作:
- 註冊一個GitHub的賬號,可以使用GitHub Desktop或者GitHub網站;
- 建立一個空的專案
- 在專案裡面建立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檔案編寫有問題,系統編譯沒有通過就會報錯,提醒你去修改。
- 如果不甘心使用這樣簡單的主頁,你就需要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,具體方法可以參考其他文章。
- 如果還想更漂亮的的頁面,更完整功能可以fork這個專案 mmistakes/minimal-mistakes
- 以後補充。