提要

如果站点config.toml文件设置为generate_feed = true，那么 Zola 将为该站点生成一个提要文件，根据feed_filename 中的设置命名config.toml，默认为atom.xml. 给定 feed 文件名 atom.xml，生成的文件将位于base_url/atom.xml，基于 目录atom.xml中的文件templates或内置的 Atom 模板。

feed_filename可以设置为任何值，但提供了内置模板atom.xml（以首选的 Atom 1.0 格式）和rss.xml（以 RSS 2.0 格式）。如果您选择不同的文件名（例如feed.xml），您将需要自己提供一个模板。

只有带有日期的页面才可用。

提要模板有五个变量：

  • config: 站点配置
  • feed_url：该特定提要的完整网址
  • last_updated:任何帖子的最新updated或字段date
  • pages：查看页面变量 以了解其中包含的内容的详细说明
  • lang：适用于提要中所有页面的语言代码，如果站点是多语言的，或者config.default_language不是

分类术语的提要使用 分类模板中的类型获得另外两个变量：

  • taxonomy: 类型TaxonomyConfig
  • term: 类型TaxonomyTerm，但没有term.pages（pages改为使用）

generate_feed您还可以通过在相应部分的前言中将变量设置为 true 来为每个部分启用单独的提要 。部分提要将使用文件中指示的相同模板config.toml。Section feeds，除了五个 feed template 变量， section从section template获取变量。

启用提要自动发现允许提要阅读器和浏览器通知用户有关您网站上可用的 RSS 或 Atom 提要。因此用户订阅更容易。例如，这是使用Firefox Livemarks插件的样子。

RSS 提要自动发现示例。

您可以启用帖子自动发现功能，修改您的博客base.html模板，在标签之间添加以下代码<head>。

{% block rss %}
  <link rel="alternate" type="application/rss+xml" title="RSS" href="{{ get_url(path="rss.xml", trailing_slash=false) }}">
{% endblock %}

您也可以使用type="application/atom+xml"和 来使用 Atom 提要path="atom.xml"。

您网站上的所有页面都将引用您的帖子提要。

为了同时启用标签提要，您可以在模板block rss中使用以下代码重载tags/single.html。

{% block rss %}
  {% set rss_path = "tags/" ~ term.name ~ "/rss.xml" %}
  <link rel="alternate" type="application/rss+xml" title="RSS" href="{{/* get_url(path=rss_path, trailing_slash=false) */}}">
{% endblock rss %}

每个标签页都将引用它的专用提要。