在github上搭建博客(使用Jekyll)

簡單說,只須要三步,就能夠在 Github 搭建起一個博客:

  1. 在 Github 上建一個名爲 xxx.github.io 的庫;
  2. 把看中了的 Jekyll 模板 clone 到本地;
  3. 把這個模板 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  

 

參考連接: 

  1. huangziwei的博客, 很耐心的教程.

  2. isnowfy作一個博客theme.

  3. 搭建Disqus評論區.

  4. git教程.

  5. 如何搭建一個獨立博客

相關文章
相關標籤/搜索