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