Github上寫Blog
預備知識:
必須:Git,GitHub,Jekyll,Markdown,YAML
可選:HTML,JavaScript,CSS,XML
工具:
可選:VSCode+Markdown Preview Github Styling,GitHub Desktop
操作:
- 注冊一個GitHub的賬號,可以使用GitHub Desktop或者GitHub網站;
- 創建一個空的項目
- 在項目里面創建index.md,或者index.html,提交后,博客首頁就建好了。
- 注:index.html的優先級比index.md的高,系統會默認使用index.html顯示。(系統需要編譯,編譯的進度請參考注1)
-
- 進入項目的Settings,找到Github Pages,修改Source的選項,默認是None(也就是不開啟主頁顯示模式),改為master branch,點save。頁面重新刷新,再找到Source就會出現系統提示的顯示地址。(編譯沒有通過的項目是無法正常顯示的)
- 如果還想換個漂亮的皮膚,就點theme就可以了。
-
- 如果不甘心使用這樣簡單的主頁,你就需要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)
-
-
- 如果還想更漂亮的的頁面,更完整功能可以fork這個項目mmistakes/minimal-mistakes
- 具體修改可以fork我的項目zhuyuanxiang.github.io,改了中文的地方就是我修改的,并且將需要的一些文件從docs目錄下移到了根目錄下。
-
注1:了解編譯的進度,可以點Code的commits,進去后會看到自己本次提交的記錄,如果后面有個綠色的√就是編譯成功了,如果是個紅色的×就是編譯失敗了,失敗了主頁就無法顯示你想要展示的內容。
注2:如果不喜歡遠程編譯結果出來后才知道有沒有問題,可以自己在本機安裝Jekyll,具體方法可以參考其他文章。
posted on 2019-01-06 12:47 zYx.Tom 閱讀(197) 評論(0) 編輯 收藏 所屬分類: 3.開源項目