gemerald

Markdown-based static site generator

0.1
PyPI

Maintainers: 1

Gemerald

A markdown-based static site generator for HTTP and Gemini. Inspired by Hugo. Written in Python.

Try it out

This repository provides an example project for you to play around. You can try to build it with just a few commands

pip install gemerald
gemerald example
ls -la example-build

Gemerald markdown

We use specific subset of markdown with some extensions. Here is features currently supported:

Markdown features currently working

Markdown features that wont be supported

Inline links - All links must be placed on separate lines

Extra markdown features

Authors for quotes
Raw .html snippets
Raw .gmi snippets
Metadata headers

SSG features

Output formats

Project Guide

Compatibility

Python 3.12

Basic directory structure

To start building your site you will need 3 directories:

templates
static
content

static directory will hold all your assets for the website. This catalog will be copied to every output format under the path /static. Please put your images there.

content directory contains all your markdown files. These will be translated into output formats. It can contain subfolders. Subfolders will apear in output ass well.

templates is a directory that contains only other subdirectories. All subdirectories must be named just like needed output formats. As an example, if you need to produce HTML output, all your HTML templates will be placed under templates/html.

Config files

Each format's template directory must contain additional file named config.yaml. This file contains all configuration for given format. This is a list of mandatory keys that need to be present:

enabled (boolean) - Prevent output for given format by setting this to false.

Templating

Blog entires

Who uses it?

wilmhit.pw (not yet)
hspoz.pl (If they will be willing to)
Your website

FAQs

What is gemerald?

Is gemerald well maintained?

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install