Skip to main content

Series is a Pelican plugin that joins multiple posts into a series

Project description

Series: A Plugin for Pelican

Build Status PyPI Version License

Series is a Pelican plugin that joins multiple posts into a series. Globally, it provides a list of all the series, and for each article it provides a list of all articles in the same series and links to the next and previous articles in the series.


This plugin can be installed via:

python -m pip install pelican-series


In order to mark reStructuredText-formatted posts as part of a series, use the :series: metadata:


Or, for Markdown-formatted content:


The plugin collects all articles belonging to the same series and provides series-related variables that you can use in your template.


By default, articles in a series are ordered by date and then automatically numbered.

If you want to force a given order, specify :series_index: (reST) or series_index: (Markdown) in the article metadata, 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:

  • 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]) or None for the first article
  • is the next article in the series (a shortcut to article.series.all_next[0]) or None for the last one

For example:

{% if article.series %}
    <p>This post is part {{ article.series.index }} of the "{{ }}" 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>
        {% endfor %}
{% endif %}

Global Context

The plugin also adds the key series to the global context, which is a dictionary of all series names (as keys) and articles (as values). You can use that to list all the series of articles in your site, for example

{% for series_name, series_articles in series.items() %}
{% set article = series_articles[0] %}
<article class="card">
	<a href="{{ article.url }}" class="image">
		<img src="/images/{{ article.image }}.jpg" alt="{{ article.image }}" />
	<div class="card-body">
    	<a href="{{ article.url }}"><h3 class="card-title">{{ series_name }}</h3></a>
     	<ul class="actions">
     		<li><a href="{{ article.url }}" class="button">Start</a></li>
{% endfor %}


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.

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

pelican-series-2.1.0.tar.gz (7.5 kB view hashes)

Uploaded source

Built Distribution

pelican_series-2.1.0-py3-none-any.whl (10.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page