使用git+github+jekyll+markdown写博客果然是爽哈,简单干净,专注于博客内容,并且可控性好。博客搭好了,开始博客之旅吧

##Git Github环境 这个当能了,安装个git,一个分布式的版本管理系统用来管理博客内容。 git hub上注册用户,这就是用来托管代码了

##搭建jekyll 博客环境 这里针对windows平台

  • 安装ruby(rubyinstaller-1.9.3-p392.exe)
  • 安装DevKit(DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe)

解压DevKit, 从start command prompt with ruby命令行i进入DevKit解压缩目录, 然后

$ ruby dk.rb init
$ ruby dk.rb install
$ gem install rdiscount --platform=ruby
$ //安装成功就可以使用一些ruby工具了

$ gem install jekyll 

##下载博客代码 通过Git从Github上克隆一份jekyll bootstrap博客模板

$git clone https://github.com/brionas/brionas.github.com.git

会在本地生成一个brionas.github.com文件夹,这就是clone下来博客的repo

##写博文

$ cd _post
$ rake post title="test"

到_post目录下找到刚才建立的文件gitdatetime-test.md,然后编辑文件。 设置title,description,category,tags等,就是用markdown来写文章了。 当然也可以不用啥命令,自己直接在_post下新建文件写博客,具体参见后文,快速写博客。

##本地预览博客

$ jekyll --server --auto

启动了jekyll的server程序,监听4000 端口。这样就可以打开浏览器进行浏览了,网址是”localhost:4000”

##将博客同步到github 博客写好后要同步到github了

$ cd brionas.github.com
$ git add .
$ git commit -m "Add new content" 
$ git push origin master

##注意的地方

  1. 如果用notpad++来编辑时,要设置文件的格式为 “以UTF-8无BOM格式编码” 否则提交会出现乱码情况
  2. 运行 jekyll –server –auto在本地测试时出现一下错误Liquid error: invalid byte sequence in GBK。解决方法:添加两对用户自定义的环境变量,LC_ALL=en_US.UTF-8 和 LANG=en_US.UTF-8

##快速写博客 前面说的整个过程,如果只是写写博客,可以直接在本地用文本编辑器写博文,当然了要用markdown语法。 这里说下过程

  • 在bolg repo的_post目录下新建一个文本文件,命名如下datetime-title.md(比如本博文为2013-03-01-test.md)
  • 因为这是中文博客,编码设为以UTF-8无BOM格式编码
  • 加入博客固定抬头,title,category,tags等

    ---
    layout: post
    title: "博客搭好了,开始写技术博客吧"
    description: "使用git+github+jekyll+markdown写博客果然是爽哈,简单干净,专注于博客内容,并且可控性好。技术博客搭好了,开始技术写博客吧"
    category: lessons
    tags: [Markdown, jekyll博客]
    ---
    
  • 开始用markdown写博客内容吧,其实markdown语法挺简单,常用到就是以下几点:

    1. 标题: 两个#号代表二级标题(建议以二级标题将博文分块,子块可以三级别表)。如:##二级标题 
    2. 换行: 行末尾加两个以上空格 
    3. 段落: 空一行,会起一个新的段落 
    4. 无序列表:*加空格然后写这个条目的内容,如:* 这是一个条目哦
    5. 有序列表: 数字加英文句点然后写条目内容,如:1. 这是条目一
    6. 插入代码:代码快每行都缩进四个空格或一个tab(建议代码前后都加一个空行)
    7. 插入图片:叹号中括号加入图片文本,小括号加图片路径(本博客图片放在/assert/image下)。比如![wxEventDS](/assets/image/wxeventds.png)
    8. 加入链接:中括号加入链接文字,小括号加入链接地址。比如:可以访问[Brion公司](http://www.briontech.com)

更多markdown语法可以参考这个文档



-EOF-
Simple is beautiful博客,转载请注明出处