这些天学着使用Github去搭建个人博客, 纯属娱乐, 下面把步骤和一些注意的地方写下来, 免得忘了.

开发准备

1. 注册Github账号, 例如: TonnyYi

2. 安装git

3. 新建一个仓库, 例如: blog

使用Github Pages搭建

1. 进入你的仓库的admin页面, 例如: https://github.com/tonnyyi/blog/admin

2. 向下滚动找到Github pages选项卡, 点击"Automatic Page Generator"

3. 在新页面底部点击"Continue to Layouts"

4. 在打开的页面选择一个主题, 然后点击"PUBLIS"

现在你的博客已经可以访问了, 路径为: http://tonnyyi.github.com/blog

编辑博客

1. 将仓库clone到本地, 命令行下输入: git clone https://github.com/tonnyyi/blog

2. 编辑博客内容, , 命令行下进入仓库目录: cd blog

3. 将文件更改保存到暂存区: git add .

4. 提交文件修改: git commit -m "提交信息"

5. 将修改push到Github上的仓库: git push

( 这一步git会要求你输入用户名密码, 注意是这个仓库的管理员账户和密码, 如果你不想每次push都输入用户名密码或者想使用别的账号push修改记录, 可以生成一个ssh key然后保存到Github. 具体操作可以参考这里 )

使用jekyll搭建

使用jekyll之前先了解下markdown语法, Liquid标签

1. 安装jekyll(最好的方式是:先安装Ruby, 通过Ruby的第三方程序包:gem安装jekyll)

2. 初始化最简单的博客文件结构(jekyll要求的): 

|-- _config.yml

|-- _includes

|-- _layouts

|       |-- default.html

|       |-- post.html

|-- _posts

|       |-- 20011-10-25-open-source-is-good.markdown

|       |-- 20011-04-26-hello-world.markdown

|-- _site

|-- index.html

_config.yml : 保存了站点的配置信息, 详细配置在这里, 中文翻译看这里.

_includes : 该目录存放可以与_layouts和_posts混合,匹配并重用的文件. Liquid标签{% include file.ext %}可以用于嵌入文件_includes/file.ext.

_layout : 该目录存放用来插入帖子的网页布局模板, 注意是模板, 具体数据在_posts中.

_posts : 发表的博文的内容, 其下文件的命名格式为: YEAR-MONTH-DAY-title.md(使用markdown语法写的文件), 另外还支持textile和html文件.

_site : 这里是Jekyll用以存放最终生成站点的根路径位置, 编译好的html文件都放在这里, 最好把这个目录加到 .gitignore 列表中.

index.html : 博客的首页

3. 本地查看效果: jekyll --server  (更多命令参考这里), 然后访问: http://localhost:4000

4. 保存修改, 提交修改, push到Github

从上面可以看到, 有很多文件需要自己手动去写, 有没有简单点的方式? 当然!

使用Jekyll-Bootstrap搭建(推荐)

这里是其主页, 上面介绍了如何使用Jekyll-Bootstrap, 很简单.

1. 在Github上新建一个仓库, 注意仓库名称的格式: USERNAME.github.com, 例如: tonnyyi.github.com

2. clone到本地: git clone https://github.com/plusjade/jekyll-bootstrap.git tonnyyi.github.com

3. 进入目录: cd tonnyyi.github.com

4. 修改远程仓库地址到自己的仓库, 从而可以push到自己的仓库: git remote set-url origin git@github.com:tonnyyi/tonnyyi.github.com.git

5. 推送到Github上自己的仓库: git push origin master  (注意这里是master分支, 不是之前Github Pages的gh-pages分支)

6. 访问http://tonnyyi.github.com, 你的博客已经搭好了.

[Tips]

1. Jekyll默认的markdown解析器是 Maruku, 但据说对中文支持不太好, 所以建议安装 RDiscount: gem install rdiscount  (Ruby安装好以后), 然后在_config.yml文件中 "auto: true" 后添加一行 "markdown: rdiscount"

2. 如果你希望在页面使用源码高亮, 你可以安装Pygments : easy_install Pygments

[参考博客]

搭建一个免费的，无限流量的Blog----github Pages和Jekyll入门

Mort | 像黑客一样写博客——Jekyll入门

利用Jekyll搭建个人博客

Jekyll Quick Start

Jekyll Introduction

Jekyll主页

Jekyll在Github的主页

Jekyll-Bootstrap主页