alloypress 0.1.1

HTML/CSS-only Python SSG with support for LaTeX, syntax highlighting and sidenotes.

alloypress

A Python static site generator which I use for my personal website.

Getting Started

Install via pip install alloypress.

Run the following Python code in the root directory of your site:

from alloypress import generate
generate()

An example of this can be seen in ./tests. It will take every .md file in ./raw and generate the HTML in ./.

Features

The high-level approach of alloypress is serve static HTML and CSS files, rendering nothing client-side.

It supports:

• Jon Gruber's original Markdown syntax via markdown
• LaTeX via latex2mathml inside $ and $$ delimiters
• Syntax highlighting for Python via pygments
• Sidenotes which are displayed inline on narrow devices
• Sortable and tag-filtered index page for each top-level folder

To Be Implemented

• Clearing old files before generating new ones
• Support for other languages via pygments
• Sidebar-based navigation
• Embedding-based search across all pages
• Post summaries on the index page via yaml frontmatter
• More coming soon...