1.2.3 Infrastructure and Technical Implementation

1.2.3.1 Removed Features (in Comparison With the Stacks Project)

A few features present in the general infrastructure of the Stacks Project were removed in Clowder, including:

  1. 1.

    The python back-end, in favour of static pages.

  2. 2.

    The comment system, as a result of the static nature of the website.

1.2.3.2 Gerby and the Tags System

Clowder is built using Gerby, similarly to the Stacks Project. However, a number of additional features and quality-of-life additions not implemented in plasTeX or Gerby were required by Clowder, including:

  1. 1.

    Clowder uses tcbtheorem-like environments, which affects the placement of footnotes (which are often used).

  2. 2.

    Clowder implements a dangerous bend symbol to help visually highlight warnings (example).

  3. 3.

    There are a few aesthetic changes in Clowder’s HTML/CSS structure, including font selection as well as a dark mode.

  4. 4.

    tikz-cd diagrams are very frequently used, and they need to be separately compiled and converted to svg files.

  5. 5.

    Code in Clowder can be copied easily using a “Copy” button, with code for bibliography entries also having proper syntax highlighting (example).

  6. 6.

    Clowder is automatically built using GitHub actions.

  7. 7.

    Non-sectioning tags are rendered differently and shown in context (example).

These have been implemented using a fork of Gerby along with a few build scripts.

1.2.3.3 Placeholder Symbols and Future Style

Currently, a number of macros have been defined using placeholder symbols, and look very ugly as a result.

They will eventually be replaced with proper symbols coming from the math fonts of Hundar, a free and open-source typeface project currently being worked on.

You can find more details about Hundar at its GitHub repository or website.


Noticed something off, or have any comments? Feel free to reach out!


You can also use the contact form below: