寫做環境搭建(git+github+markdown+jekyll)

轉載自：

https://site.douban.com/196781/widget/notes/12161495/note/264946576/

2013-03-04 19:33:10

 

---

layout: post
categories: [Tools]
tags: [jekyll, github, git, markdown]

---

## 緣起

讀了陽志平大神的一篇博文[理想的寫做環境：git+github+markdown+jekyll]( http://www.yangzhiping.com/tech/writing-space.html),不禁感嘆，這就是我想要的，因而就開始着手作這件事。在小站裏也推薦了一下，而後發現，好多朋友早就已經搞起了，有的已經玩膩了，我果真又落伍了=。 =。這將是我第一篇用Markdown寫的博文，看成練手~，真的很簡單。

## 參考

這方面的好文章網上至關多，我挑幾個本身用上的列出來： 

- git/github相關:
        + [陽志平：Git與Github入門資料]( http://www.yangzhiping.com/tech/git.html) 
        + [陽志平：如何高效利用GitHub]( http://www.yangzhiping.com/tech/github.html) 
- markdown相關：
        + [Markdown 語法說明 (簡體中文版)]( http://wowubuntu.com/markdown/)
        + [圖靈社區 : 怎樣使用Markdown]( http://www.ituring.com.cn/article/23)
        + [陽志平：Markdown寫做淺談]( http://www.yangzhiping.com/tech/r-markdown-knitr.html)
- jekyall相關：
        + [搭建一個免費的，無限流量的Blog----github Pages和Jekyll入門]( http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html)
- 綜述：
        + [Github Pages極簡教程 - 雁起平沙的網絡日誌]( http://yanping.me/cn/blog/2012/03/18/github-pages-step-by-step/)
        + [Play with Jekyll]( http://blog.skydark.info/programming/2012/03/23/play-with-jekyll/)

說實話，這幾篇看完了尤爲是綜述，就不用往下看了，如下做爲我我的記錄，只給出簡單的過程以及排錯經驗，再無概念上的陳述，以備後用。

## 過程記錄

### 如下過程在ubuntu 12.04下進行
1. apt-get安裝rubygems以後，*gem install jekyll*安裝jekyll，並用一樣的gem命令安裝directory_watcher、liquid、open四、maruku、classifier，rdiscount這幾個包。Jekyll默認用maruku來解析markdown語言，你也能夠用別的程序來解析，好比上面的rdiscount。

2. github上創建名爲*username*.github.com的項目，其中*username*是你本身的github用戶名。

3. *git clone*該項目至本地同名文件夾*username*.github.com。

4. 偷懶下載別人改好的jekyll模板框架，比較有名的是Octopress和Jekyll Bootstrap，另外[ https://github.com/mojombo/jekyll/wiki/sites]( https://github.com/mojombo/jekyll/wiki/sites)裏面有不少可供參考的模板，我使用的是[kejinlu.github.com]( https://github.com/kejinlu/kejinlu.github.com)。因爲這些模板通常都是github上的，因此你能夠直接*git clone*到本地，而後將其內容copy到你的*username*.github.com本地文件夾中。

5. 接下來就是改動其內容，美其名曰hack，實際上我對前端代碼徹底看不懂，因此只作了最低級的修改，好比我的信息和文章神馬的，注意必定要將他人的.git文件刪掉。改完後，push到github上，就算大功告成了，過個10分鐘左右訪問 http://*username*.github.com，就能夠看到你的blog雛形了。注意若是接到github發來的郵件告訴你發生錯誤，就說明沒有正確配置，沒法顯示你的blog，我遇到過兩個錯誤：

        >For information on troubleshooting Jekyll see  https://help.github.com/articles/using-jekyll-with-pages#troubleshooting 

        這個錯誤通常是本地安裝的jekyll或者ruby，rubygems等軟件包版本不符合github的版本要求。你可使用*gem list*命令查看本地的軟件包版本號。如下是github上軟件包的版本號要求。 
                gem 'jekyll', '=0.12.0' 
                gem 'liquid', '=2.4.1' 
                gem 'redcarpet', '=2.1.1' 
                gem 'maruku', '=0.6.0' 
                gem 'rdiscount', '=1.6.8' 
                gem 'RedCloth', '=4.2.9'
        
        
        >CNAME already taken: ...... 
 
        這個錯誤須要把本地文件夾下的CNAME文件刪掉，這個應該是別人定義本身自定義域名用的，若是你沒有自定義域名，那就不須要。

6. 若是你的blog能夠正確訪問了，你就能夠在_posts文件夾下添加.md文件做爲你的博文，注意命名格式必定要是yy-mm-dd-*title*.md,title是你文章的標題。寫完以後push到github上就能夠在你的blog上顯示了，其中每篇文章的開頭都要指定必定的格式，如本文：

                ---
                layout: post
                categories: [Tools]
                tags: [jekyll, github, git, markdown]
                ---

        *layout: post*指的是博文格式安裝_layouts文件夾下的post.html指定的格式來顯示。 
        *categories: [Tools]*指定博文分類。 
        *tags: [jekyll, github, git, markdown]*指定博文標籤。

7. 如上所述，每次對博文作出改動都須要push到github上才能看到效果，那麼如何不須要聯網直接在本地調試呢，顯然是能夠的，由於你本地已經安裝了jekyll（在第一步驟中），具體作法就是在本地*username*.github.com文件夾下運行命令，*jekyll serve*，在jekyll 0.12.0之前的命令好像是*jekyll --server*，這樣就啓動了jekyll本地端口的監聽，當你訪問*localhost:4000*時，就會看到你blog顯示出來了。

## **注意事項**

1. 整個過程當中最讓我困擾的的是rubygems軟件包版本的問題，用apt-get怎麼也搞不定，多是源的問題，最終我是從[rubygems.org]( http://rubygems.org/)中搜索全部我想要的版本的包的，而後用*gem instll*安裝包就能夠了。

2. 在家裏我用的ubuntu搭建的環境，在公司的時候我用windows想往github上push文章，可是發現都是亂碼，這是由於我用的mysgit對中文支持很差，因而我按照[windows下git bash顯示中文]( http://blog.csdn.net/self001/article/details/7337182)的方法作了修改，並按照[git編輯器改用本機gvim]( http://www.cuiguojie.com/msysgit_editor_gvim.html)的方法在mysgit下使用gvim或notepad++打開個人博文，保存爲utf-8格式，這樣再push就好用了。