自带全文检索的jekyll主题-阿里云开发者社区

开发者社区> 开发与运维> 正文
登录阅读全文

自带全文检索的jekyll主题

简介: 包含功能: a). 不依赖第三方服务的全文检索 b). 自定义类别和标签归类文章 c). 瀑布流翻页

0. 项目地址:

https://github.com/bigablecat/example.github.io

1. 包含功能:

a). 不依赖第三方服务的全文检索

b). 自定义类别和标签归类文章

c). 瀑布流翻页

2. 安装方法:

步骤一. fork本项目

fork

步骤二. 将项目名称example.github.io中的example部分修改为你自己的github用户名, 例如: bigablecat.github.io

change name

步骤三. 与步骤二类似,在/config.xml文件中找到url属性,将example.github.io中的example部分修改为你自己的github用户名, 例如: bigablecat.github.io

change url

三个步骤完成后,如果发布成功,可以在当前项目settings的GitHub Pages项中看到设置成功的提示:
success tip

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

ii. http://www.minddust.com

b). 翻页实现方式参考来源:
i. 用Jekyll和jQuery实现异步加载文章列表(作者ypchen)

ii. pagination using waypoints.js

c). 主题中使用到的其他js插件:
i. typeahead功能

d). 搭建jekyll博客相关教程:
i. Github+Jekyll搭建个人博客三步走 | 极简小白教程(作者简疏志)

ii. 我的 Github 个人博客是怎样炼成的(作者天晨Joey)

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享: