Github上寫B(tài)log
預(yù)備知識(shí):
必須:Git,GitHub,Jekyll,Markdown,YAML
可選:HTML,JavaScript,CSS,XML
工具:
可選:VSCode+Markdown Preview Github Styling,GitHub Desktop
操作:
- 注冊(cè)一個(gè)GitHub的賬號(hào),可以使用GitHub Desktop或者GitHub網(wǎng)站;
- 創(chuàng)建一個(gè)空的項(xiàng)目
- 在項(xiàng)目里面創(chuàng)建index.md,或者index.html,提交后,博客首頁就建好了。
- 注:index.html的優(yōu)先級(jí)比index.md的高,系統(tǒng)會(huì)默認(rèn)使用index.html顯示。(系統(tǒng)需要編譯,編譯的進(jìn)度請(qǐng)參考注1)
-
- 進(jìn)入項(xiàng)目的Settings,找到Github Pages,修改Source的選項(xiàng),默認(rèn)是None(也就是不開啟主頁顯示模式),改為master branch,點(diǎn)save。頁面重新刷新,再找到Source就會(huì)出現(xiàn)系統(tǒng)提示的顯示地址。(編譯沒有通過的項(xiàng)目是無法正常顯示的)
- 如果還想換個(gè)漂亮的皮膚,就點(diǎn)theme就可以了。
-
- 如果不甘心使用這樣簡(jiǎn)單的主頁,你就需要fork一個(gè)別人的項(xiàng)目barryclark/jekyll-now;
- 修改_config.yml文件
- name:博客的名字
- description:顯示在瀏覽器上的標(biāo)題欄的名字
- avatar:博主的照片(可以從Git的Profile里面取照片的地址)
- # Flags below are optional:表示以下的內(nèi)容可以選擇性的修改
- email,github是我有的,其他的就看個(gè)人喜歡,不填內(nèi)容就不會(huì)在網(wǎng)頁上顯示,也不會(huì)出錯(cuò)
- sina,douban等國(guó)內(nèi)的需要修改代碼才能實(shí)現(xiàn)(人懶就先放一下了)
-
- permalink在前面加個(gè)#把它屏蔽掉,因?yàn)槟J(rèn)的方式似乎無法正常顯示。
-
- Settings設(shè)置參考前面的說明。
- 按照“_post”目錄下的“2014-3-3-Hello-World.md”的模式,依據(jù)“YYYY-MM-DD-文件名稱.md”的標(biāo)準(zhǔn)創(chuàng)建一個(gè)新文件,就是你發(fā)表的新文章了。
- 打開主頁,就會(huì)看到文章的主題出現(xiàn)在主頁,點(diǎn)進(jìn)去就可以看到文章的內(nèi)容。(系統(tǒng)需要編譯,編譯的進(jìn)度請(qǐng)參考注1)
-
-
- 如果還想更漂亮的的頁面,更完整功能可以fork這個(gè)項(xiàng)目mmistakes/minimal-mistakes
- 具體修改可以fork我的項(xiàng)目zhuyuanxiang.github.io,改了中文的地方就是我修改的,并且將需要的一些文件從docs目錄下移到了根目錄下。
-
注1:了解編譯的進(jìn)度,可以點(diǎn)Code的commits,進(jìn)去后會(huì)看到自己本次提交的記錄,如果后面有個(gè)綠色的√就是編譯成功了,如果是個(gè)紅色的×就是編譯失敗了,失敗了主頁就無法顯示你想要展示的內(nèi)容。
注2:如果不喜歡遠(yuǎn)程編譯結(jié)果出來后才知道有沒有問題,可以自己在本機(jī)安裝Jekyll,具體方法可以參考其他文章。
posted on 2019-01-06 12:47 zYx.Tom 閱讀(201) 評(píng)論(0) 編輯 收藏 所屬分類: 3.開源項(xiàng)目