From 667e11c4ec3835d959aab1797647bd0a49869674 Mon Sep 17 00:00:00 2001 From: etienne Date: Tue, 21 Oct 2014 23:35:24 +0200 Subject: Init commit --- content/templates/rss.md | 100 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 content/templates/rss.md (limited to 'content/templates/rss.md') diff --git a/content/templates/rss.md b/content/templates/rss.md new file mode 100644 index 0000000..a31b1ad --- /dev/null +++ b/content/templates/rss.md @@ -0,0 +1,100 @@ +--- +aliases: +- /layout/rss/ +date: 2013-07-01 +linktitle: RSS +menu: + main: + parent: layout +next: /templates/sitemap +notoc: one +prev: /templates/partials +title: RSS (feed) Templates +weight: 90 +--- + +Like all other templates, you can use a single RSS template to generate +all of your RSS feeds, or you can create a specific template for each +individual feed. Unlike other templates, *Hugo ships with its own ATOM +2.0 RSS template. In most cases this will be sufficient, and an RSS +template will not need to be provided by the user.* + +RSS pages are of the type "node" and have all the [node +variables](/layout/variables/) available to use in the templates. + + +## Which Template will be rendered? +Hugo uses a set of rules to figure out which template to use when +rendering a specific page. + +Hugo will use the following prioritized list. If a file isn’t present, +then the next one in the list will be used. This enables you to craft +specific layouts when you want to without creating more templates +than necessary. For most sites only the \_default file at the end of +the list will be needed. + +### Main RSS + +* /layouts/rss.xml +* /layouts/\_default/rss.xml +* \__internal/rss.xml + +### Section RSS + +* /layouts/section/`SECTION`.rss.xml +* /layouts/\_default/rss.xml +* /themes/`THEME`/layouts/section/`SECTION`.rss.xml +* /themes/`THEME`/layouts/\_default/rss.xml +* \__internal/rss.xml + +### Taxonomy RSS + +* /layouts/taxonomy/`SINGULAR`.rss.xml +* /layouts/\_default/rss.xml +* /themes/`THEME`/layouts/taxonomy/`SINGULAR`.rss.xml +* /themes/`THEME`/layouts/\_default/rss.xml +* \__internal/rss.xml + + +## Configuring RSS + +If the following are provided in the site’s config file, then they +will be included in the RSS output. Example values are provided. + + languageCode = "en-us" + copyright = "This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License." + + [author] + name = "My Name Here" + + +## The Embedded rss.xml +This is the RSS template that ships with Hugo. It adheres to the +ATOM 2.0 Spec. + + + + {{ .Title }} on {{ .Site.Title }} + Hugo + {{ .Permalink }} + {{ with .Site.LanguageCode }}{{.}}{{end}} + {{ with .Site.Author.name }}{{.}}{{end}} + {{ with .Site.Copyright }}{{.}}{{end}} + {{ .Date.Format "Mon, 02 Jan 2006 15:04:05 MST" }} + {{ range first 15 .Data.Pages }} + + {{ .Title }} + {{ .Permalink }} + {{ .Date.Format "Mon, 02 Jan 2006 15:04:05 MST" }} + {{with .Site.Author.name}}{{.}}{{end}} + {{ .Permalink }} + {{ .Content | html }} + + {{ end }} + + + +*Important: Hugo will automatically add the following header line to this file +on render… please don't include this in the template as it's not valid HTML.* + + -- cgit v1.3