Highlights

Upgrade notes

While we do everything we can to maximize backwards compatibility and ensure smooth Pelican upgrades, it's possible that you may encounter un-anticipated wrinkles. Following are a few notes that may help:

• The FILES_TO_COPY setting has been deprecated, so replace it with the STATIC_PATHS and EXTRA_PATH_METADATA settings. Refer to the corresponding entries in the Settings section of the docs for more information.
• Due to minor changes to the plugin API, some plugins may not function properly if they are not updated accordingly. Most (if not all) of the plugins in the official Pelican Plugins Repository have already been updated, but externally-hosted plugins may not be. If you are heavily dependent on such a plugin, consider holding off on upgrading to Pelican 3.3 until you are certain that your desired plugins will function correctly.
• PDF generation has been moved out of core and into a separate plugin. If you previously relied on this feature, please be sure to retrieve, install, and configure the new plugin from the Pelican Plugins Repository.
• There is a new warning for <img> tags without alt="" attributes, which are important for accessibility reasons. Please consider adding these attributes to your <img> tags in order to improve accessibility (and eliminate the warnings).
• The syntax for linking to source content has been changed in order to ensure compatibility with Markdown and reST extensions. For example, the new syntax for Markdown: [a link relative to content root]({filename}/article1.md) The previous |filename|/article1.md syntax will continue to be supported for backwards compatibility.

We will keep the above list updated with any additional items as we find them, so please let us know if we missed anything.