You’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.
To add new posts, simply add a file in the _posts directory that follows the convention YYYY-MM-DD-name-of-post.ext and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.
Jekyll also offers powerful support for code snippets:
def print_hi(name)
puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.
一、jekyll介绍
jekyll是一款Blog生成器，不需要数据库的支持。jekyll用于发行生成静态网页发行。
1.文件结构
_config.yml：用于保存配置。（jekyll会自动加载这些配置）
_includes文件夹：存放可以重复利用的文件，可以被其他的文件包含（方法：{ % include 文件名 % }）
_layouts文件夹：存放模板文件（标签{{ content }}将content插入页面中）。
_posts文件夹：存放实际的博客文章内容（文件名格式：年-月-日-标题.md）。
_site文件夹：存放最终生成的文件（其他的目录都会被拷贝到最终文件的目录下。所以css,images等目录都可以放在根目录下）。
YAML头信息（可选的）：（文章只要包含YAML头，yekyll就会将其转换成html文件）设置一些预定义的变量，或你自己定义的变量。
也可定义自己的变量：比如title，在文中使用的方法：一起来用Jekyll!
2.常用命令（命令行输入）
$ jekyll build ：当前文件夹中的内容将会生成到 ./site 文件夹中。
$ jekyll build –destination <destination> ：当前文件夹中的内容会生成到指定文件夹中。
$ jekyll build –source <source>–destination <destination> ：将指定源文件夹中的内容生成到指定文件夹中。
$ jekyll build –watch ：查看更改，再生成。
$ jekyll serve ：启动服务器，使用本地预览，运行在http://localhost:4000/。（jekyll集成了一个服务器）
$ jekyll serve –watch ：先查看变更在启动服务器。
可以在_config.yml文件中添加配置，jekyll会自动获取其中的配置，例如：
source:_source
destination:_deploy
等同于命令：jekyll build –source _source –destination _deploy
3.jekyll原理
jekyll使用Liquid语言
Liquid语言使用2种标记（Output和Tag）：Output： { {content } }，Tag：{ % content % }
Liquid过滤器：将左边字符串通过过滤器得到想要的结果并输出。
过滤器示例
Liquid的标准过滤器：
date - 格式化日期
capitalize - 将输入语句的首字母大写
downcase - 将输入字符串转为小写
upcase - 将输入字符串转为大写
first - 得到传递数组的第一个元素
last - 得到传递数组的最后一个元素
join - 将数组中的元素连成一串，中间通过某些字符分隔
sort - 对数组元素进行排序
map - 从一个给定属性中映射/收集一个数组
size - 返回一个数组或字符串的大小
escape - 对一串字符串进行编码
escape_once - 返回一个转义的html版本，而不影响现有的转义文本
strip_html - 去除一串字符串中的所有html标签
strip_newlines - 从字符串中去除所有换行符(\n)
newline_to_br - 将所有的换行符(\n)换成 html 的换行标记
replace - 匹配每一处指定字符串并替换，如 { { ‘foofoo’ replace:’foo’,’bar’ } } #= ‘barbar’
replace_first - 匹配第一处指定的字符串并替换，如 { { ‘barbar’ replace_first:’bar’,’foo’ } } #=> ‘foobar’
remove - 删除每一处匹配字符串，如 { { ‘foobarfoobar’ remove:’foo’ } } #= ‘barbar’
remove_first - 删除第一处匹配的字符串，如 { { ‘barbar’ remove_first:’bar’ } } #=> ‘bar’ truncate - 将一串字符串截断为x个字符
truncatewords - 将一串字符串截断为x个单词
prepend - 在一串字符串前面加上指定字符串，如 { { ‘bar’ prepend:’foo’ } } #= ‘foobar’
append - 在一串字符串后面加上指定字符串，如 { { ‘foo’ append:’bar’ } } #= ‘foobar’
minus - 减，如 { { 4 minus:2 } } #=> 2
plus - 加，如 { { ‘1’ plus:’1’ } } #=> ‘11’, { { 1 plus:1 } } #=2 times - 乘，如 20 #=> 20
divided_by - 除，如 { { 10 divided_by:2 } } #=> 5
split - 将一串字符串根据匹配模式分割成数组，如 { { “a~b” split:~ } } #= [‘a’,’b’]
modulo - 余数，如 { { 3 modulo:2 } } #=> 1
tag标签：
assign- 创建一个变量
capture- 块标记，把一些文本捕捉到一个变量中（如：把一系列字符串连接为一个字符串，并将其存储到变量中）
case- 块标记，标准的 case 语句
comment- 块标记，将一块文本作为注释
if- 标准的 if/else 块
unless- if 语句的简版
include- 包含其他的模板
raw- 暂时性的禁用的标签的解析（展示一些可能产生冲突的内容）
cycle- 用于循环轮换值，如颜色或 DOM 类
for- 用于循环 For loop（for 。。。 in 。。。 limit:int使你可以限制接受的循环项个数；offset:int可以可以让你从循环集合的第 n 项开始；reversed让你可以翻转循环）
jekyll新增的过滤器：
date_to_string - 日期转化为短格式
date_to_long_string - 日期转化为长格式
number_of_words - 统计字数（{ { page.content number_of_words } }）
array_to_sentence_string - 数组转换为句子（列举标签时：{ { page.tags array_to_sentence_string } }） markdownify - 将makedown格式字符串转换成HTML
jsonify - data to JSON
jekyll新增标签：
highlight 语言 linenos（行号，可选）- 块标签，代码高亮
post_url - 使用某篇博文的超链接（不需要写文件后缀）
gist - github gist显示代码（gist的介绍和使用 ）（{ % gist 5555251 % }）
4.书写博客
引用图片或其他资源：新建一个文件夹存放，在博文中的引用方式：https://blog.970909.xyz表示站点的根目录
其他的资源引用也是一样的。
5.创建博文目录
一个简单的例子，使用的是Liquid模板语言。
6、分页
在_config.yml里边加一行，并填写每页需要几行：
paginate:5
对需要带有分页页面的配置： paginate_path:”blog/page:num”
blog/index.html将会读取这个设置，把他传给每个分页页面，然后从第2页开始输出到blog/page:num，:num是页码。如果有 12 篇文章并且做如下配置paginate: 5， Jekyll会将前 5 篇文章写入blog/index.html，把接下来的 5 篇文章写入blog/page2/index.html，最后 2 篇写入blog/page3/index.html。
7、草稿
草稿是你还在创作中不想发表的文章。
创建一个名为_drafts的文件夹
8、部署到github
http://jekyll.bootcss.com/docs/github-pages/
克隆仓库到本地：
git clone https://github.com/用户名/用户名.github.com.git
在本地启动服务：
cd 用户名.github.com
jekyll serve -B
提交代码到线上：
git add –all #添加到暂存区
git commit -m “提交jekyll默认页面” #提交到本地仓库
git push origin master #线上的站点是部署在master下面的
##