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

时间: 2024-10-29 19:07:12

写作环境搭建(git+github+markdown+jekyll)的相关文章

Mac搭建Git/GitHub全过程

在GitHub上注册了账号,建立了第一个hello-world repository,然后打算把Git平台配置在自己的机器上.因为是Mac OS,我也是一个初学者,很多功能需要自己摸索,于是各种百度,总算是完成了.在此记录一下我的配置过程,自认为还是比较全面的,虽然实质上是很多篇已有教程的融合及实践,不知道可不可以算原创. 准备工作: 已在GitHub网站上注册了账号 系统是Mac OS X EI Capitan 第一步:安装Git 在这里我使用brew进行安装.brew全称是Homebrew,

centos 环境搭建git 服务器

首先yum安装git yum install git 查看git的版本 sudo git --version 服务器端创建一个git 用户,专门来处理git服务,并为git用户设置密码 查看是否有git的用户 id git 添加git用户 useradd git 为git用户分配密码 passwd git 创建git仓库 sudo mkdir -p /home/git/project.git git初始化仓库 sudo git init --bare /home/git/project.git

Dubbo源码学习--环境搭建及基础准备(ServiceLoader、ExtensionLoader)

环境搭建 1. Github上下载 "Dubbo最新发布版本" ,楼主下载版本为2.5.7. 2. cd到源码解压目录,maven编译,命令为: 3. 生成Intellij idea相关配置文件,命令为: 4. 双击运行生成的 文件 Java SPI SPI是Service Provider Int http://p.baidu.com/itopic/main/qlog?qid=ae116162633263383961612700&type=questionlog http:/

Github pages + jekyll 博客快速搭建

Github Pages + Jekyll 方案的优点: · 免费 · 有版本管理,修改方便 · 支持markdown 缺点: · 它生成的是静态网页,添加动态功能必须使用外部服务,比如评论功能要使用第三方服务(如disqus). · 它不适合大型网站,因为没有用到数据库,每运行一次都必须遍历全部的文本文件,网站越大,生成时间越长. 步骤: 1.注册Github 2.域名 1)去买域名 2)用Github pages提供的免费域名 http://{username}.github.io //用你

Jenkins + Git + Maven + tomcat集成环境搭建

折腾了好几天,终于吧Jenkins + Git + Maven + tomcat集成环境搭建起来了,最终主要实现"自动构建.部署"web应用. 1.安装环境 操作系统:Centos 6.5 JDK:1.7.x Maven:3.1.x Git: 1.7.1,自建GitLab平台 tomcat:7.x 上述宿主机器2台:192.168.1.194,192,168.1.198,其中194位Jenkins Master,198位slave. 2.第三方安装安装和环境配置 JDK.Git.Mav

Linux下Jenkins+git+gradle 持续集成环境搭建

一.项目介绍 和 linux 环境搭建 本教程讲解 Linux下Jenkins+git+gradle 持续集成环境搭建,后续会加入 gerrit代码审核 和 robotium自动化测试 1.基本流程如下: androidstudio--  gerrit  --- git(github)   ----jenkins ---gradle ----  robotium  结果 使用AndroidStudio 开发,提交到gerrit进行代码审核,审核后提交给git(可以自己搭建git服务也可以使用gi

【搭建开发环境】在 Windows XP 中参与开源项目,搭建 git 和 cygwin 开发环境

引言 只有一台 Windows XP 家用机,却想在诸如 [email protected] 之类的开源社区参与开发,本文提供一个入门级的开发环境搭建指引. 涉及工具:Eclipse,EGit,Cygwin. Git git 是一个类似 svn 的版本控制系统.网上有很多基于 git 的在线代码托管平台,如 GitHub.OSC 等.由于伟大的 GFW,这里仅介绍如何使用 Eclipse 的 EGit 插件与 [email protected] 交互. 1. 安装 Eclipse Kepler,

Git入门篇之环境搭建&基本功能的使用

网上关于GitHub的使用教程还是比较丰富,不过部分教程比较陈旧抑或写得不够详细,在我实践的过程中遇到了一些麻烦,记录下来,当是自己的一个总结吧,也供大家参考.欢迎留言交流. 本文主要讲解Windows Msysgit软件平台的使用,windows的GitHub for Windows方式和苹果系统的Github或git方式也在用,这方面网上的教程比较丰富,也就不做过多阐述了,欢迎留言讨论. Windows版本: 在windows中搭建Git环境使用Github有两种方式: 方式一: GitHu

Windows环境下Git环境的搭建

书看了一段时间,是时候开始维护自己的个人资料了.正所谓工欲善其事必先利其器,开发先从环境搭建开始.而环境搭建先从自己的GitHub账号搞起. 首先,任何Git初学者应该先看一下廖雪峰老师的教程,这点非常重要!!! 1.先去官网下载一个Git for Windows的安装包,安装完成. 2.开始菜单打开Git Base,设置一下你的用户名和email $ git config --global user.name "Your Name" $ git config --global use