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

Provides Custom URLs for FEEDS

Browse source 
Provides an optional FEED URL. Feed variables have been split into two, _SAVE_AS and _URL.

 _SAVE_AS variables are used to define the RSS/ATOM Files.
 _URL variables are the feed slugs (aligns to post/page variables)

 Using rewrite rules (nginx/apache) it is now possible to have _pretty_ feed URLS like /feed or /feed/tag/pelican
This commit is contained in:
Nick 2015-01-05 10:14:59 +00:00
commit 7f8df5bb8e
12 changed files with 223 additions and 131 deletions
Download patch file Download diff file Expand all files Collapse all files

28
docs/faq.rst
View file

@ -154,11 +154,11 @@ To disable feed generation, all feed settings should be set to ``None``.
All but three feed settings already default to ``None``, so if you want to
disable all feed generation, you only need to specify the following settings::
FEED_ALL_ATOM = None
CATEGORY_FEED_ATOM = None
TRANSLATION_FEED_ATOM = None
AUTHOR_FEED_ATOM = None
AUTHOR_FEED_RSS = None
FEED_ALL_ATOM_SAVE_AS = None
CATEGORY_FEED_ATOM_SAVE_AS = None
TRANSLATION_FEED_ATOM_SAVE_AS = None
AUTHOR_FEED_ATOM_SAVE_AS = None
AUTHOR_FEED_RSS_SAVE_AS = None
The word ``None`` should not be surrounded by quotes. Please note that ``None``
and ``''`` are not the same thing.
@ -192,6 +192,24 @@ generates ``'feeds/all.atom.xml'`` by default and ``FEED_ATOM`` now defaults to
TRANSLATION_FEED -> TRANSLATION_FEED_ATOM
Starting in 3.5, the feed variables have been split into two. FEED_ATOM
has now become FEED_ATOM_SAVE_AS allowing FEED_ATOM_URL to be introduced; FEED_ATOM_URL
allows you to assign URL Slugs to feeds such as /feed/atom. (URL rewriting will still
be required on the web server). Here is an exact list of the renamed settings::
FEED_ATOM -> FEED_ATOM_SAVE_AS
FEED_RSS -> FEED_RSS_SAVE_AS
FEED_ALL_ATOM -> FEED_ALL_ATOM_SAVE_AS
FEED_ALL_RSS -> FEED_ALL_RSS_SAVE_AS
CATEGORY_FEED_ATOM -> CATEGORY_FEED_ATOM_SAVE_AS
CATEGORY_FEED_RSS -> CATEGORY_FEED_RSS_SAVE_AS
AUTHOR_FEED_ATOM -> AUTHOR_FEED_ATOM_SAVE_AS
AUTHOR_FEED_RSS -> AUTHOR_FEED_RSS_SAVE_AS
TAG_FEED_ATOM -> TAG_FEED_ATOM_SAVE_AS
TAG_FEED_RSS -> TAG_FEED_RSS_SAVE_AS
To use the new URLs see :doc:`feed settings <settings>`.
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