Github Pages 建立個(gè)人博客總結(jié)

參考Beiyun的文章使用Github Pages建獨(dú)立博客。

配置Github

這里我直接使用了GithubDesktop客戶端,安裝登錄之后關(guān)于SSH Key的部分會(huì)自動(dòng)完成,不過Git的帳號信息還是要設(shè)置一下:

$ git config --global user.name "你的名字"
$ git config --global user.email "your_email@youremail.com"

名字和郵箱替換成自己的,Github會(huì)用這些信息做相關(guān)權(quán)限的處理。

使用Github Pages 新建項(xiàng)目

在這步我折騰了好久,建立項(xiàng)目上傳之后,jayf4n.github.io一直顯示404,最后發(fā)現(xiàn)是弄成了依附于項(xiàng)目的pages。

  1. 登錄Github網(wǎng)站,點(diǎn)擊+New repository ,項(xiàng)目名稱為username.github.io ,這里的username必須是Github賬號的用戶名。

  2. 在Github Desktop 里將剛才的項(xiàng)目克隆到本地。打開 Git shell:

進(jìn)入項(xiàng)目目錄

cd username.github.io                 #進(jìn)入項(xiàng)目目錄

在本地的項(xiàng)目目錄里添加index.html文件

git add index.html                     #將index.html文件添加到暫存區(qū)
git commit -a -m "First pages commit"  #將暫存區(qū)的修改提交到當(dāng)前分支
git push                               #將修改同步到Github

可以打開username.github.io開下是否成功

套用Jekyll模板

這里我folk了Beiyun模板

  1. 下載模板,可以在客戶端里下載也可以在Git shell用git clone https://github.com/beiyuu/Github-Pages-Example命令。

  2. 刪除之前的index.html文件,在Git shell里打開

    git rm index.html
    git commit -m "delete first-pages"

將除了.git文件夾的所有內(nèi)容復(fù)制到自己的user.github.io文件夾內(nèi)。

  1. 修改模板,將里面關(guān)于社交資料的內(nèi)容改為自己的。刪除images和_posts文件夾里的內(nèi)容,原作者用的是本地圖片在Git里上傳,我自己在Markdwon鏈接的是七牛云存儲(chǔ)的圖床。

  2. 加入自己的文章,md文件命名格式為year-month-day-title.md,例如2016-03-06-github-pages.md,放到_posts文件夾里對應(yīng)的分類中。

YAML Front Matter和模板變量

對于使用YAML定義格式的文章,Jekyll會(huì)特別對待,他的格式要求比較嚴(yán)格,必須是這樣的形式:

---
layout: post
title: Blogging Like a Hacker
---

前后的---不能省略,在這之間,你可以定一些你需要的變量,layout就是調(diào)用_layouts下面的某一個(gè)模板,他還有一些其他的變量可以使用:

permalink 你可以對某一篇文章使用通用設(shè)置之外的永久鏈接
published可以單獨(dú)設(shè)置某一篇文章是否需要發(fā)布
category 設(shè)置文章的分類
上面的title就是自定義的內(nèi)容,你也可以設(shè)置其他的內(nèi)容,在文章中可以通過{ { page.title }}這樣的形式調(diào)用。

還有其他需要的變量,可以參考官方的文檔

同步到Github pages

cd username.github.io                   #進(jìn)入目錄
git add .                               #添加修改到暫存區(qū)
git commit -m "add Beiyunn's theme"     #添加修改到當(dāng)前分支
git push                                #將修改同步到Github

完成之后可以在瀏覽器里看下是否成功

主頁


文章


至此利用Github pages和Jekyll模板搭建個(gè)人博客已經(jīng)完成了,接下來就是不斷學(xué)習(xí)與完善了;_)

Git與Markdown教程


原文鏈接JayF4n'Blog

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容