Meral¶

Meral is the hand crafted Sphinx theme used for PRE documentation. It lies deep within the docs repository, under the docs/docs/source/_themes/meral subdirectory.

This subdictory follows the stucture of a basic Python module with the additions of files and patterns to make it a Sphinx theme.

Meral is born from the Alabaster theme, and has been upgraded using the Python Documentation theme in order to add a dark mode along with some admonition tweaks.

It only serves as a local theme for PRE for now and is now released.
In fact it is very much NOT ready to be released since it has been
Frankensteined in many unfathomable ways.

There are still many things to fix, mainly CSS styling dual definition between light and dark mode which are very split and repetitive.

Admonitions¶

Here are the rendering of the admonitions with the Meral theme.

An admonition

Some charm, yes