Scripts for the New Website https://www.residuum.org/

For the new website residuum.org I have adopted Faircamp and Nikola as static site generators. Nikola is mostly a blog generator, but as I am not running a blog, some scripts are used to remove unwanted output from the site. Faircamp is a generator for a music catalog, but lacks the ability to include custom HTML for an outside site structure, so there is a script to include a header and a footer to the site.

Inject Header and Footer to Faircamp (fc-inject-frame.sh)

Original idea by Luca Mancini. This is a shell script and uses sed and find.

Additional things that the original did not have:

• Not only header, but also footer can be injected into the site.
• Exclude HTML pages for embedding from adding header and footer.

Nikola Plugins

Additional plugins, because the standard ones did not fit my purpose, written in Python.

Extended Content

Like the contents directive from reStructuredText, but with a different template. This is only Python without any templating, based on original source code.

To use it, add the following to the page:

.. extended_contents

Linklist

A plugin to generate a list of links, that looks like the standard layout from Faircamp, so that both parts of the website look similar. The templates are using Jinja.

Empty lines are used to separate the linked items, and an additional empty line to end the list.

To use the linklist with images, the following code is needed:

.. linklist: image
 <url to first item>
 <url to image>
 <Headline>
 <Description>
 <url to second item>
 <url to image>
 <Headline>
 <Description>

Without images, leave out the image parameter and the image link:

.. linklist:
 <url to first item>
 <Headline>
 <Description>
 <url to second item>
 <Headline>
 <Description>

PS: Yes, I am aware that this README is writting in Markdown, while the Nikola plugins are making use of reStructured Text.