This Pelican plugin extracts an image from the summary or content of an article or page if not already specified in content metadata.
This plugin can be installed via:
python -m pip install pelican-featured-image
As long as you have not explicitly added a PLUGINS setting to your Pelican settings file, then the newly-installed plugin should be automatically detected and enabled. Otherwise, you must add featured_image to your existing PLUGINS list. For more information, please see the How to Use Plugins documentation.
To override the default behavior of selecting the first image in the article's summary or content, set the image property the article's metadata to the URL of the image to display, e.g:
Title: My super title
Date: 2010-12-03 10:20
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Author: Alexis Metaireau
Summary: Short version for index and feeds
Image: /images/my-super-image.png
Article content...To include a representative image in a page add the following to the template:
{% if page.featured_image %}
<img src="{{ page.featured_image }}">
{% endif %}To include a representative image in an article add the following to the template:
{% if article.featured_image %}
<img src="{{ article.featured_image }}">
{% endif %}Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on existing issues.
To start contributing to this plugin, review the Contributing to Pelican documentation, beginning with the Contributing Code section.
This project is licensed under the AGPL-3.0 license.
