Thelie/python-feedgen
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update Documentation

Browse source 
This patch updates the wording on the main documentation page.
This commit is contained in:
Lars Kiesow 2018-12-14 23:55:36 +01:00
parent c60fae476d
commit 2beefb5126
No known key found for this signature in database
GPG key ID: 5DAFE8D9C823CE73
1 changed files with 10 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
readme.rst
View file

@ -11,8 +11,9 @@ Feedgenerator
:alt: Test Coverage Status :alt: Test Coverage Status
This module can be used to generate web feeds in both ATOM and RSS format. It This module can be used to generate web feeds in both ATOM and RSS format. It
has support for extensions. Included is for example an extension to produce Podcasts. has support for extensions. Included is for example an extension to produce
Podcasts.
It is licensed under the terms of both, the FreeBSD license and the LGPLv3+. It is licensed under the terms of both, the FreeBSD license and the LGPLv3+.
Choose the one which is more convenient for you. For more details have a look Choose the one which is more convenient for you. For more details have a look
@ -159,20 +160,17 @@ To produce a podcast simply load the `podcast` extension::
>>> fg.rss_str(pretty=True) >>> fg.rss_str(pretty=True)
>>> fg.rss_file('podcast.xml') >>> fg.rss_file('podcast.xml')
Of cause the extension has to be loaded for the FeedEntry objects as well but If the FeedGenerator class is used to load an extension, it is automatically
this is done automatically by the FeedGenerator for every feed entry if the loaded for every feed entry as well. You can, however, load an extension for a
extension is loaded for the whole feed. You can, however, load an extension for specific FeedEntry only by calling `load_extension(...)` on that entry.
a specific FeedEntry by calling `load_extension(...)` on that entry. But this
is a rather uncommon use.
You can still produce a normal ATOM or RSS feed, even if you have loaded some Even if extensions are loaded, they can be temporarily disabled during the feed
plugins by temporary disabling them during the feed generation. This can be generation by calling the generating method with the keyword argument
done by calling the generating method with the keyword argument `extensions` `extensions` set to `False`.
set to `False`.
**Custom Extensions** **Custom Extensions**
If you want to load custom extension which are not part of the feedgen Python If you want to load custom extensions which are not part of the feedgen
package, you can use the method `register_extension` instead. You can directly package, you can use the method `register_extension` instead. You can directly
pass the classes for the feed and the entry extension to this method meaning pass the classes for the feed and the entry extension to this method meaning
that you can define them everywhere. that you can define them everywhere.