39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
|
# DEPRECATED — Do Not Use #
|
||
|
|
|
||
|
|
**As noted in the [Pelican 3.7 release notes](https://blog.getpelican.com/pelican-3.7-released.html), RSS feeds now provide summaries by default, so this plugin is no longer relevant and will eventually be removed from this repository.**
|
||
|
|
|
||
|
|
-----------------------
|
||
|
|
|
||
|
|
This plugin allows article summaries to be used in ATOM and RSS feeds instead of the entire article. It uses the
|
||
|
|
built-in pelican `Summary:` metadata.
|
||
|
|
|
||
|
|
The summary of an article can either be set explicitly with the `Summary:` metadata attribute as described in the
|
||
|
|
[Pelican documentation](http://docs.getpelican.com/) (*Writing content* > *File metadata* section),
|
||
|
|
or automatically generated using the number of words specified in the
|
||
|
|
[SUMMARY_MAX_LENGTH](http://docs.getpelican.com/en/latest/settings.html) setting.
|
||
|
|
|
||
|
|
## Usage ##
|
||
|
|
To use this plugin, ensure the following are set in your `pelicanconf.py` file:
|
||
|
|
|
||
|
|
PLUGIN_PATH = '/path/to/pelican-plugins'
|
||
|
|
PLUGINS = [
|
||
|
|
'feed_summary',
|
||
|
|
]
|
||
|
|
FEED_USE_SUMMARY = True
|
||
|
|
|
||
|
|
The default value of `FEED_USE_SUMMARY` is `False`, so it must be set to `True` to enable the plugin, even if it is loaded.
|
||
|
|
|
||
|
|
This plugin is written for pelican 3.3 and later.
|
||
|
|
|
||
|
|
|
||
|
|
## Implementation Notes ##
|
||
|
|
|
||
|
|
This plugin derives `FeedSummaryWriter` from the `Writer` class, duplicating code of the `Writer._add_item_to_the_feed` method.
|
||
|
|
|
||
|
|
When the `initialized` signal is sent, it alternates the `get_writer` method of the `Pelican` object to use `FeedSummaryWriter` instead of `Writer`.
|
||
|
|
|
||
|
|
A little hackish, but currently this can't be done otherwise via the regular plugin methods.
|
||
|
|
|
||
|
|
* *Initial Code (PR #36): Michelle L. Gill <michelle.lynn.gill@gmail.com>*
|
||
|
|
* *Resumption of PR and Maintainer: Florian Jacob ( projects[PLUS]pelican[ÄT]florianjacob.de )*
|