文档介绍:下面,我举一个实例,演示如何在github上搭建blog,你可以跟着一步步做。为了便于理解,这个blog只有最基本的功能。
在搭建之前,你必须已经安装了git,并且有github账户。
第一步,创建项目。
在你的电脑上,建立一个目录,作为项目的主目录。我们假定,它的名称为jekyll_demo。
$ mkdir jekyll_demo
对该目录进行git初始化。
$ cd jekyll_demo
$ git init
然后,创建一个没有父节点的分支gh-pages。因为github规定,只有该分支中的页面,才会生成网页文件。
$ git checkout --orphan gh-pages
以下所有动作,都在该分支下完成。
第二步,创建设置文件。
在项目根目录下,。它是jekyll的设置文件,我们在里面填入如下内容,其他设置都可以用默认选项,具体解释参见官方网页。
baseurl: /jekyll_demo
目录结构变成:
/jekyll_demo
|--
第三步,创建模板文件。
在项目根目录下,创建一个_layouts目录,用于存放模板文件。
$ mkdir _layouts
进入该目录,,作为Blog的默认模板。并在该文件中填入以下内容。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>{{ }}</title>
</head>
<body>
{{ content }}
</body>
</html>
Jekyll使用Liquid模板语言,{{ }}表示文章标题,{{ content }}表示文章内容,更多模板变量请参考官方文档。
目录结构变成:
/jekyll_demo
|--
|-- _layouts
| |--
第四步,创建文章。
回到项目根目录,创建一个_posts目录,用于存放blog文章。
$ mkdir _posts
进入该目录,创建第一篇文章。文章就是普通的文本文件,文件名假定为2012-08-25-hello-。(注意,文件名必须为"年-月-日-"的格式。如果网页代码采用html格式,后缀名为html;如果采用markdown格式,后缀名为md。)
在该文件中,填入以下内容:
---
layout: default
title: 你好,世界
---
<h2>{{ }}</h2>
<p>我的第一篇文章</p>
<p>{{ | date_to_string }}</p>
每篇文章的头部,必须有一个yaml文件头,用来设置一些元数据。它用三根短划线"---",标记开始和结束,里面每一行设置一种元数据。"layout:default",