jekyll 分页功能
一、安装分页插件
-
执行
gem install jekyll-paginate安装插件 -
在
Gemfile的group :jekyll_plugins do下添加一行gem "jekyll-paginate", "~> 1.0" -
在
_config.yml的plugins:下添加一行:- jekyll-paginate
二、开启分页功能
- 修改
_config.yml文件
增加分页配置:
paginate: 10
paginate_path: pagination/page:num/
-
将站点
index.md文件重命名为index.html由于Jekyll的分页功能只支持HTML文件,因此需要重命名。否则分页功能不生效,在服务启动时会提示:
Pagination: Pagination is enabled, but I couldn't find an index.html page to use as the pagination template. Skipping pagination. -
新增分页layout
在_layouts下新建pagination.html,内容参见附录
- 修改站点
index.html文件头信息中的layout为pagination
三、说明
1、分页配置
-
paginate
每页最多显示的文章数
-
paginate_path
分页页面所在的位置。例如:此属性值为”pagination/page:num/”时会在
_site/pagination目录下生成page:num的文件夹:page1、page2、…。
2、另一种分页方式
按照官网上的说明,配置完paginate_path: "blog/page:num"后,只需要在blog下新建index.html文件,然后在此文件中遍历分页后的文章并生成分页链接,代码和前面所述的pagination.html一样。
但是此种方式访问首页并不会分页,而是需要访问/blog才会分页。
附:
-
参考资料:分页功能
-
pagination.html