写做环境搭建(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就好用了。