Pelican 3.7 has been released, incorporating a year and a half worth of
enhancements and bug fixes.
Upgrading from previous releases
Unlike Atom, the RSS feed specification does not contain a <content> field
and only contains a <summary> field. Pelican previously put the full content
in this field, which could cause odd behavior in feed readers that only expected
a summary. For this reason, RSS feeds in Pelican 3.7 will by default only contain
article summaries. To revert to the previous full-content behavior, either
use Atom (which supports both <summary> and <content> fields) or set:
RSS_FEED_SUMMARY_ONLY = False
If you have defined MD_EXTENSIONS in your settings file, you will see
deprecation warnings since that setting has been replaced by the MARKDOWN
setting in Pelican 3.7. Refer to the corresponding entry in the Settings
documentation to see the new default value and replace any existing
MD_EXTENSIONS settings with your preferred customized variation of the
Themes originally had access to two identical context variables: PAGES and
pages. This redundancy was removed in Pelican 3.7, so any themes that use
PAGES will need to be updated to use pages instead.
JINJA_EXTENSIONS has been replaced by the JINJA_ENVIRONMENT setting.
Any plugins that refer to the former setting will need to be updated. Refer to
the corresponding entry in the Settings documentation for more information.
As always, we do everything we can to maximize backwards compatibility and ensure
smooth Pelican upgrades. If you run into problems, please see the How to Get Help section
of the documentation, and we will update this post with any upgrade tips
contributed by the Pelican community.