github/pelican
1
0
Fork 1
mirror of https://github.com/getpelican/pelican.git synced 2025-10-15 20:28:56 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add FAQ re: Atom full-post vs. summary-only feeds

Browse source 
Replaces a FAQ about upgrading from a very old version of Pelican, which
isn't relevant to most folks at this point.
This commit is contained in:
Justin Mayer 2021-01-06 07:36:21 +01:00
commit b17e4a5ffa
1 changed files with 11 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

32
docs/faq.rst
View file

@ -174,28 +174,18 @@ your site.
Feeds are still generated when this warning is displayed, but links within may Feeds are still generated when this warning is displayed, but links within may
be malformed and thus the feed may not validate. be malformed and thus the feed may not validate.
My feeds are broken since I upgraded to Pelican 3.x Can I force Atom feeds to show only summaries instead of article content?
=================================================== =========================================================================
Starting in 3.0, some of the FEED setting names were changed to more explicitly Instead of having to open a separate browser window to read articles, the
refer to the Atom feeds they inherently represent (much like the FEED_RSS overwhelming majority of folks who use feed readers prefer to read content
setting names). Here is an exact list of the renamed settings:: within the feed reader itself. Mainly for that reason, Pelican does not support
restricting Atom feeds to only contain summaries. Unlike Atom feeds, the RSS
FEED -> FEED_ATOM feed specification does not include a separate ``content`` field, so by default
TAG_FEED -> TAG_FEED_ATOM Pelican publishes RSS feeds that only contain summaries (but can optionally be
CATEGORY_FEED -> CATEGORY_FEED_ATOM set to instead publish full content RSS feeds). So the default feed generation
behavior provides users with a choice: subscribe to Atom feeds for full content
Starting in 3.1, the new feed ``FEED_ALL_ATOM`` has been introduced: this feed or to RSS feeds for just the summaries.
will aggregate all posts regardless of their language. This setting generates
``'feeds/all.atom.xml'`` by default and ``FEED_ATOM`` now defaults to ``None``.
The following feed setting has also been renamed::
TRANSLATION_FEED -> TRANSLATION_FEED_ATOM
Older themes that referenced the old setting names may not link properly. In
order to rectify this, please update your theme for compatibility by changing
the relevant values in your template files. For an example of complete feed
headers and usage please check out the ``simple`` theme.
Is Pelican only suitable for blogs? Is Pelican only suitable for blogs?
=================================== ===================================