Skip to main content

Static site generator for GitHub Pages

Project description


Genja is a simple static site generator for GitHub Pages. It is a command line tool built in Python that generates HTML files and a JSON feed from Markdown content.


Download and install Python from or from Anaconda. Next, install genja from PyPI using the following command:

pip install genja

Check the installed version from the command line:

genja --version


Before running genja, create a project structure as shown below. The content directory contains Markdown files that are used to generate HTML files. The templates directory contains Jinja templates that are used to render the HTML pages. The docs directory contains the built website which can be hosted with GitHub Pages. Lastly, the config.json defines the URLs and directories for the project.

|- content/
|- templates/
|- docs/
|- config.json

The items in the config.json are shown below. The base_url is the URL for the homepage of the website. Markdown files that are parsed by genja are located in the input_dir directory. The HTML files generated from genja are located in the output_dir directory. Static content such as images and CSS files should go in the output directory.

    "base_url": "",
    "input_dir": "content",
    "output_dir": "docs"

Use the serve command to build the website and start a local server. This will automatically open the default web browser to view the website. The website will automatically reload when changes are saved to the Markdown files.

genja serve

Use the build command to build the website without running a local server.

genja build


To run the example, go to the example directory in this repository. The mdcontent folder is the input directory containing the Mardkown files. The website folder is the output directory containing the built HTML files. Use the commands shown below to build the website and run a local server to view the website in the default web browser. The website will automatically reload in the web browser when changes are saved to the Markdown files.

cd example
genja serve

Use the commands shown below to build the example website without starting a local server.

cd example
genja build


Clone this repository and use the conda environment file to create a Python environment for developing genja. This environment uses ruff for linting and formatting along with pytest for running tests. Genja is installed in editable mode within the environment.

# Clone this project
git clone

# Create the conda environment
cd genja
conda env create --file environment.yml

# Activate the conda environment
conda activate genja


Support this project by using the :heart: Sponsor button at the top of this page. Thank you :smile:.


This project is licensed under the terms of the MIT license. See here for the license text.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

genja-24.3.tar.gz (93.2 kB view hashes)

Uploaded Source

Built Distribution

genja-24.3-py2.py3-none-any.whl (6.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page