MkDocs RSS plugin#

A plugin for MkDocs, the static site generator, which creates RSS 2.0 feeds using the creation and modification dates from git log and page metadata (YAML frontmatter).

Usage#

Typical mkdocs.yml:

plugins:
  - rss:
      abstract_chars_count: 160
      date_from_meta:
        as_creation: "date"
        as_update: false
        datetime_format: "%Y-%m-%d %H:%M"
      feed_ttl: 1440
      image: https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Feed-icon.svg/128px-Feed-icon.svg.png
      length: 20
      pretty_print: false
      match_path: ".*"

For further information, see the user documentation.

Development#

For further information, see the technical documentation.

Quickstart#

Installation:

pip install mkdocs-rss-plugin

Then in your mkdocs.yml:

plugins:
  - rss

Example#

As examples, here come the feeds generated for this documentation:

• feed_rss_created.xml for latest created pages: W3C validator
• feed_rss_updated.xml for latest updated pages: W3C validator

Or it could be displayed as a Feedly follow button:

Credits#

Plugin logic is inspired from Tim Vink git-based plugins and main parts of Git stuff are nearly copied/pasted.

Using magic from:

• GitPython
• Jinja2

Documentation theme United from mkdocs-bootswatch as a tribute to the classic RSS color scheme: orange and white.