了解完全局的配置之后,我们还需要了解 Jekyll 的变量。通过这些变量,可以输出文章的标题、内容、链接等等。
全局变量
变量 |
描述 |
site |
通过 _config.xml 来设置整个站点的信息和全局配置。 |
page |
设置页面信息和自定义的变量。 |
content |
展示文章或者页面的内容。 |
paginator |
当配置文件中设置了 paginator 的时候,这里可以读取分页的信息。 |
站点变量
变量 |
描述 |
site.time |
当你运行jekyll 时候的时间。 |
site.pages |
当前的页面列表。 |
site.posts |
倒序列出所有的文章。 |
site.related_posts |
相关的文章。 默认配置下最多 10 篇相关文章。 |
site.categories.CATEGORY |
某一个分类的文章列表。 |
site.tags.TAG |
某一个标签的文章列表。 |
site.[CONFIGURATION_DATA] |
配置文件中的信息。 |
页面变量
变量 |
描述 |
page.content |
页面渲染出来的内容。 |
page.title |
页面标题。 |
page.excerpt |
文章摘要。 |
page.url |
页面链接地址。 |
page.date |
页面或者文章的时间。 |
page.id |
页面或者文章的唯一标识。 |
page.categories |
页面或者文章的分类。 |
page.tags |
页面或者文章的标签。 |
page.path |
页面的路径。 |
page.CUSTOM |
页面的自定义内容。 |
分页
变量 |
描述 |
paginator.per_page |
每个分页的文章数量 |
paginator.posts |
分页里的文章对象 |
paginator.total_posts |
文章的总数 |
paginator.total_pages |
分页的页数 |
paginator.page |
当前第几页 |
paginator.previous_page |
前一页的页码 |
paginator.previous_page_path |
前一页的地址 |
paginator.next_page |
下一页的页码 |
paginator.next_page_path |
下一页的地址 |
有了这些变量,自定义一个 Jekyll 博客主题,应该不是一件难事。
- 作者「掌心」于 更新本文
- 文章声明:自由转载-非商用-非衍生-保持署名 | BY-NC-SA