An installable version of the original Pelican Series plugin
Project description
Pelican Series: A Plugin for Pelican
This plugin extends the original series plugin by FELD Boris lothiraldan@gmail.com Copyright (c) Leonardo Giordani giordani.leonardo@gmail.com This plugin is also in the Pelican Plugins repository
The series plugin allows you to join different posts into a series.
In order to mark posts as part of a series, use the :series:
metadata:
:series: NAME_OF_THIS_SERIES
or, in Markdown syntax
Series: NAME_OF_THIS_SERIES
The plugin collects all articles belonging to the same series and provides series-related variables that you can use in your template.
Indexing
By default articles in a series are ordered by date and then automatically numbered.
If you want to force a given order just specify the :series_index:
metadata or in Markdown series_index:
,
starting from 1. All articles with this enforced index are put at the beginning of
the series and ordered according to the index itself. All the remaining articles
come after them, ordered by date.
The plugin provides the following variables to your templates
* `article.series.name` is the name of the series as specified in the article metadata
* `article.series.index` is the index of the current article inside the series
* `article.series.all` is an ordered list of all articles in the series (including the current one)
* `article.series.all_previous` is an ordered list of the articles published before the current one
* `article.series.all_next` is an ordered list of the articles published after the current one
* `article.series.previous` is the previous article in the series (a shortcut to `article.series.all_previous[-1]`)
* `article.series.next` is the next article in the series (a shortcut to `article.series.all_next[0]`)
* `article.series.first` is the first article in the series
* `article.series.last` is the last article in the series
For example:
{% if article.series %}
<p>This post is part {{ article.series.index }} of the "{{ article.series.name }}" series:</p>
<ol class="parts">
{% for part_article in article.series.all %}
<li {% if part_article == article %}class="active"{% endif %}>
<a href='{{ SITEURL }}/{{ part_article.url }}'>{{ part_article.title }}</a>
</li>
{% endfor %}
</ol>
{% endif %}
Joins articles in a series and provides variables to manage the series in the template.
Installation
This plugin can be installed via:
pip install pelican-series-plugin
Next add it to the PLUGINS
section in pelicanconf.py
PLUGINS = [
'...',
'pelican.plugins.series',
'...'
]
Contributing
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.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pelican-series-plugin-1.1.1.tar.gz
.
File metadata
- Download URL: pelican-series-plugin-1.1.1.tar.gz
- Upload date:
- Size: 4.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.4 CPython/3.8.1 Darwin/19.6.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b5016021f934e39e8051c413bc2833e94e293d797d35bcb8588cd2a6fc642c28 |
|
MD5 | cf8cf66bc3eee2fe1d7c207a1418b1a6 |
|
BLAKE2b-256 | cfe87980a082b4746f8da68f8aff338dba8638843ff3df6453ab69d4befc35f7 |
File details
Details for the file pelican_series_plugin-1.1.1-py3-none-any.whl
.
File metadata
- Download URL: pelican_series_plugin-1.1.1-py3-none-any.whl
- Upload date:
- Size: 4.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.4 CPython/3.8.1 Darwin/19.6.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 37e212a9c3c890c3930a769d45b2293cd845018f841a492b52055b7a139b4c89 |
|
MD5 | 880322e6e1b5c93c5bf956428d6a9337 |
|
BLAKE2b-256 | 53aa2672ff25b0bd26118c49f2c25729df5925ef89b6a54e550ff529a79cde8a |