2.7 KiB
+++ title = "Feeds" weight = 50 aliases = ["/documentation/templates/rss/"] +++
If the site config.toml
file sets generate_feed = true
, then Zola will
generate a feed file for the site, named according to the feed_filename
setting in config.toml
, which defaults to atom.xml
. Given the feed filename
atom.xml
, the generated file will live at base_url/atom.xml
, based upon the
atom.xml
file in the templates
directory, or the built-in Atom template.
feed_filename
can be set to any value, but built-in templates are provided
for atom.xml
(in the preferred Atom 1.0 format), and rss.xml
(in the RSS
2.0 format). If you choose a different filename (e.g. feed.xml
), you will
need to provide a template yourself.
Only pages with a date will be available.
The feed template gets five variables:
config
: the site configfeed_url
: the full url to that specific feedlast_updated
: the most recentupdated
ordate
field of any postpages
: see page variables for a detailed description of what this containslang
: the language code that applies to all of the pages in the feed, if the site is multilingual, orconfig.default_language
if it is not
Feeds for taxonomy terms get two more variables, using types from the taxonomies templates:
taxonomy
: of typeTaxonomyConfig
term
: of typeTaxonomyTerm
, but withoutterm.pages
(usepages
instead)
Enable feed autodiscovery allows feed readers and browsers to notify user about a RSS or Atom feed available on your web site. So it is easier for user to subscribe. As an example this is how it looks like using Firefox Livemarks addon.
You can enable posts autodiscovery modifying your blog base.html
template adding the following code in between the <head>
tags.
{% block rss %}
<link rel="alternate" type="application/rss+xml" title="RSS" href="{{ get_url(path="rss.xml", trailing_slash=false) }}">
{% endblock %}
You can as well use an Atom feed using type="application/atom+xml"
and path="atom.xml"
.
All pages on your site will refer to your post feed.
In order to enable the tag feeds as well, you can overload the block rss
using the following code in your tags/single.html
template.
{% 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 %}
Each tag page will refer to it's dedicated feed.