Jekyll 教程五:常用变量

HomeJekyllJekyll 教程五:常用变量

了解完全局的配置之后,我们还需要了解 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
← Jekyll 教程四:配置文件 Jekyll 教程六:主题→
  • 获取每日の能量源
  • ATP