0. 项目地址:
https://github.com/bigablecat/example.github.io
1. 包含功能:
a). 不依赖第三方服务的全文检索
b). 自定义类别和标签归类文章
c). 瀑布流翻页
2. 安装方法:
步骤一. fork本项目
步骤二. 将项目名称example.github.io中的example部分修改为你自己的github用户名, 例如: bigablecat.github.io
步骤三. 与步骤二类似，在/config.xml文件中找到url属性，将example.github.io中的example部分修改为你自己的github用户名, 例如: bigablecat.github.io
三个步骤完成后，如果发布成功，可以在当前项目settings的GitHub Pages项中看到设置成功的提示:
3. 发布文章:
a). 在/_posts/目录下新建一个后缀为.md的markdown文件,命名格式为yyyy-mm-dd-filename.md,例如2017-01-01-test.md
b). 文件名filename须使用英文以避免错误
4. 新建category或者tag:
a). 在/_my_categories/目录下新建.md文件,文件名称为新增的category名。如programming.md。
b). 文件内容如下:
---
slug: programming
name: Programming
cn: 编程
color: '#242A3A'
---i. slug，name，cn和color都是该类别的属性，以key:value键值对的形式存在。在页面中获取到某个category的时候，可以通过category.key的方式获取key对应的value。
ii. slug属性可以看做是类别的基本标识，如果一篇文章类别标为programming,这里的programming实际上就是slug的值,因此建议slug值与文件名相同,便于使用。
iii. 其余属性由用户根据需要自定义,本文件中的name,cn和color就是自定义的,可以删除,也可以另外增加其他属性。
b). tag的创建方式和使用与category完全一样。
5. 参考与推荐:
a). 当前主题的jekyll主题样式参考来源:
i. http://lanyon.getpoole.com
b). 翻页实现方式参考来源:
i. 用Jekyll和jQuery实现异步加载文章列表(作者ypchen)
ii. pagination using waypoints.js
c). 主题中使用到的其他js插件:
i. typeahead功能
d). 搭建jekyll博客相关教程:
i. Github+Jekyll搭建个人博客三步走 | 极简小白教程(作者简疏志)