原文来自:Jekyll QuickStart

 本文结构:
  1. 仅需3分钟,在github上搭建自己的博客
  2. 本地运行Jekyll
  3. 创建Post页面
  4. 创建Page页面
  5. 发布
  6. 自定义

1. 仅需3分钟,在github上搭建自己的博客

请务必将以下 USERNAME 替换为您的github用户名。以确保正常运行您托管的博客。

####1. 创建一个新的仓库

登陆https://github.com 并创建一个新的仓库,命名为 USERNAME.github.com

####2. 安装Jekyll-Bootstrap

打开终端,进入您希望安装Jekyll-Bootstrap的目录,然后运行以下命令。

1
2
3
4
$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
$ cd USERNAME.github.com
$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git
$ git push origin master

####3. 结果

一两分钟之后,您就可以通过公开的链接http://USERNAME.github.com访问您的博客了。

您的博客已经托管在github上了吗?

如果您已经在您的电脑上安装了Jekyll gem 。您可以在本机 运行Jekyll-Boostrap,运行以下命令:

1
2
3
$ git clone https://github.com/plusjade/jekyll-bootstrap.git
$ cd jekyll-bootstrap
$ jekyll serve

即可通过 http://localhost:4000 访问。

2. 本地运行Jekyll

如果您想在本地预览您的博客,您需要安装Jekyll ruby gem。注意gem的依赖包也会被安装。除非您想在您发布信息之前预览发布的内容,因为在本地运行、预览博客并不是必须的。

1
$ gem install jekyll

如果期间您遇到了问题,您可以咨询一下原作:Jekyll installation documentation。或者利用github上的提问功能向jekyll-bootstrap提问。

一旦gem安装成功,您就可以在本机浏览Jekyll-Bootstrap了。确定您已经将 USERNAME 修改为您的github用户名。进入USERNAME.github.com 目录,您就可以利用Jekyll serve 浏览您的博客。

1
2
$ cd USERNAME.github.com 
$ jekyll serve

即可通过http://localhost:4000 访问您的博客。

3. 创建Post页面

利用rake task可以很容易创建posts页面

1
$ rake post title="Hello World"

rake task 将自动创建一个带有正确文件名和YAML信息的post页面。确定指定了自己的标题,默认日期是当前日期。

rake task不会覆盖已经存在的posts页面,除非您指定让它这么做。

4. 创建Page页面

利用rake task可以很容易创建pages页面

1
$ rake page name="about.md"

创建一个带路径的page页面

1
$ rake page name="pages/about.md"

利用路径创建page页面

1
2
$ rake page name="pages/about"
# this will create the file: ./pages/about/index.html

rake task 将自动创建一个带有正确文件名和YAML信息的page页面,以及Jekyll-Bootstrap 的配置文件,即 “setup” 。

5. 发布

当您已经增加了post页面或者对您的博客主题以及其他文件有所更改时,只需要提交这些更改至您的git repo,然后推送这些提交至您的Github帐户下即可。

1
2
3
$ git add .
$ git commit -m "Add new content"
$ git push origin master

Github的post-commit hook会自动将这些更新部署到您托管的博客里。对于每一次提交,您都会收到成功或者失败的反馈信息。

6. 自定义

Jekyll-Bootstrap 只是作为一个基础的博客框架,您还可以根据需要进行定制。以下介绍一些Jekyll-Bootstrap的定制技术。

####1.主题

Jekyll-Bootstrap 支持主题的模块化,多个主题可以共存,利用 启用/禁止 命令进行切换,编辑、配置、创建主题在 Theming section部分有详细说明。

####2.博客配置

Jekyll 和 Jekyll-Bootstrap有一个简单、强大的配置系统。您可以
*指定博客永久链接的格式。
*指定一个第三方评论系统,如:disqus, intensedebate, livefyre,或者自定义。
*指定一个站点分析系统,如:google, getclicky,或者自定义。

####3.编程接口

API 页面提供了主要的数据格式和可用代码,查看这些页面,去学习如何使用这些数据和所提供的代码。

####4.极力推荐 Jekyll 简介

如果您希望自定义博客,我极力推荐去阅读 Jekyll 简介。这个简介对您理解Jekyll的运行方式有很大的帮助。它将会为您理解和高效地利用Jekyll 和 Jekyll-Bootstrap 提供正确的内容、基础知识和必要的基础原则。