- 在 Github 上建一個名爲 xxx.github.io 的庫;
- 把看中了的 Jekyll 模板 clone 到本地;
- 把這個模板 push 到本身的庫;
下面爲了從頭展現如何用 Git + Github + Jekyll 搭建博客。html
1、在 Github 建立名爲 username.github.io 的庫
按照 Github Pages 上的說明,首先要建立一個新的庫,把它命名爲 username.github.io。博客搭建成功後,這就是該博客的訪問網址。
庫名的第一部分須要與用戶名一致才能生效。因此若是你的用戶名是 MichaelMaoMao,庫的名字就是MichaelMaoMao.github.io。
關於「Initialize this repository with a README」這個選項是在初始化庫的時候建立一個關於該庫的說明,huangziwei建議不要勾選,本身提交一個,我爲了省事勾選了,git
若是你沒有勾選,能夠之後建立github
第一步完成,建立好了庫,可是裏面空空的,沒什麼東西,下面就要用到git工具向倉庫存放主頁和其餘文件啦。
若是對git不熟悉的童鞋,能夠參考 git教程,也能夠在終端中輸入 git help 命令來查看全部的命令。
瀏覽器
若是你以前沒有勾選README,如今能夠打開終端,bash
cd 到桌面,而後複製一下你庫的地址:markdown
而後clone到桌面工具
git clone https://github.com/username/username.github.io.gitpost
進入本地庫fetch
cd username.github.io.gitui
輸入如下命令建立一個README.md
:
echo "# username.github.io" >> README.md
git add README.md
git commit -m "first commit"
git push origin master
2、選擇模板
jekyllthemes.org 上有不少Jekyll模板,尋找本身喜歡的。我用的模板是 Skinny Bones, 這部分huangziwei講的很清楚,我就直接用他的解釋吧(他建立的庫名是hyaojia
):
首先,咱們把 Scribble 這個庫 clone 到本地:
$ git clone https://github.com/hyaojia/scribble.git
把名爲 scribble 的文件夾更名爲 hyaojia.github.io (沒必要要,理由跟以前同樣,只是爲了比較好找),只須要下面這行命令(mv
是移動文件夾的命令,但是也能用來重命名文件。
我明白,一開始這很難理解):
$ mv scribble hyaojia.github.io
而後咱們能夠進入如今叫 hyaojia.github.io
的文件夾裏:
$ cd hyaojia.github.io
3、把博客託管到 Github Pages
通常而言,克隆了別人的模板,第一件事要作的就是修改 _config.yml 裏的我的信息。在 scribble 這個模板中,修改的地方很少,只須要把導航欄相關的鏈接修改爲本身的就能夠了,
好比 Blog 的 url 改爲 http://hyaojia.github.io,郵件和 Github 賬號改爲本身的賬號。
只要修改過文件,咱們就須要重複 git add
和 git commit
這兩步:
$ git add . $ git commit -m 'modified _config.yml'
git add .
裏的一點,指把當前目錄全部修改過的文件都加到 Staged Area 去。
前面咱們說過 git remote -v
。由於咱們直接 clone 了別人的庫,因此 clone 下來的文件夾裏,已經登記了模板做者的遠程庫信息:
$ git remote -v origin https://github.com/muan/scribble.git (fetch) origin https://github.com/muan/scribble.git (push)
咱們要把 origin 的地址改爲咱們以前建立的 username.github.io 庫的地址:
$ git remote set-url origin https://github.com/username/username.github.io.git $ git remote -v origin https://github.com/username/username.github.io.git (fetch) origin https://github.com/username/username.github.io.git (push)
如今已經變成咱們本身的了。
最後輸入
$ git push -u origin master
若是沒有綁定 SSH key,通常會要求輸入用戶名和密碼。輸入後則會出現
Counting objects: 268, done. Delta compression using up to 4 threads. Compressing objects: 100% (187/187), done. Writing objects: 100% (268/268), 224.02 KiB | 0 bytes/s, done. Total 268 (delta 76), reused 268 (delta 76) To https://github.com/hyaojia/hyaojia.github.io.git * [new branch] master -> master
表明成功推送。如今在瀏覽器輸入網址 http://username.github.io,則能夠看到博客的樣子了。
若是沒有修改模板的需求,利用 Git + Github + Jekyll 搭建博客大概就是這樣子。寫文章,只須要在 _post/
文件加中,加入帶有 YAML 頭信息(YAML front matter)
的 markdown 文件,而後 push 到 Github,就會被自動渲染成 HTML。好比,增長一篇名爲 My First Post 的博客,在本地建立一個文件名帶有日期的 markdown 文
件 2015-04-20-my-first-post.md(裏面要寫好頭信息):
---
layout: post
title: My First Post
---
這是個人第一篇博客
最後按上述方法(git add / git commit / git push)推送到 Github,就大功告成了。
4、添加評論
一個博客少不了交流,若是你想讓別人評論,能夠選擇將評論託管給Disqus。
4.1 訪問Disqus註冊賬號,並驗證郵箱;
4.2 登陸後點擊Add Disqus To Site ,
填寫所鏈接博客的名字,選擇一個disqus的url (最好和你的用戶名一致,方便查看):
4.3 而後在你本地github.io文件裏修改_config.yml配置文件,在disqus_shortname:後面添加你的disqus名稱:
4.4 最後修改好以後,add, commit, push到github, 過一會刷新一下就能夠看到下面的評論區了。enjoy, ;)
附上我剛建好的小站, 歡迎留言: http://michaelmaomao.github.io
參考連接: