Package: pelican-series
Series: A Plugin for PelicanSeries 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.InstallationThis plugin can be installed via:python -m pip install pelican-seriesUsageIn order to mark reStructuredText-formatted posts as part of a series, use the:series:metadata::series:  NAME_OF_THIS_SERIESOr, for Markdown-formatted content:Series: NAME_OF_THIS_SERIESThe plugin collects all articles belonging to the same series and provides series-related variables that you can use in your template.IndexingBy 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) orseries_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:article.series.nameis the name of the series as specified in the article metadataarticle.series.indexis the index of the current article inside the seriesarticle.series.allis an ordered list of all articles in the series (including the current one)article.series.all_previousis an ordered list of the articles published before the current onearticle.series.all_nextis an ordered list of the articles published after the current onearticle.series.previousis the previous article in the series (a shortcut toarticle.series.all_previous[-1]) orNonefor the first articlearticle.series.nextis the next article in the series (a shortcut toarticle.series.all_next[0]) orNonefor the last oneFor example:{%ifarticle.series%}<p>This post is part{{article.series.index}}of the "{{article.series.name}}" series:</p><olclass="parts">{%forpart_articleinarticle.series.all%}<li{%ifpart_article==article%}class="active"{%endif%}><ahref='{{SITEURL}}/{{part_article.url}}'>{{part_article.title}}</a></li>{%endfor%}</ol>{%endif%}Global ContextThe plugin also adds the keyseriesto 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{%forseries_name,series_articlesinseries.items()%}{%setarticle=series_articles[0]%}<articleclass="card"><ahref="{{article.url}}"class="image"><imgsrc="/images/{{article.image}}.jpg"alt="{{article.image}}"/></a><divclass="card-body"><ahref="{{article.url}}"><h3class="card-title">{{series_name}}</h3></a><ulclass="actions"><li><ahref="{{article.url}}"class="button">Start</a></li></ul></div></article>{%endfor%}ContributingContributions 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 onexisting issues.To start contributing to this plugin, review theContributing to Pelicandocumentation, beginning with theContributing Codesection.LicenseThis project is licensed under the AGPL 3.0 license.