wt 3.1.0

Static site generator

wt - static site generator

What

Yet another static site generator with following features:

• markdown for content
• toml for configuration
• toml for content front-matter
• atom for feed
• content pages pagination

Under the hood this project uses following python libraries:

• attrs for models
• markdown-it for markdown-to-html conversion
• jinja for templating
• starlette for development web-server

Why

It was curiosity - "how would I do it?" and good intentions - "let's create something easy to work with".

Documentation

wt documentation is not available online yet but you can check docs/pages/ folder for it.

How

Requirements

Hard dependency is Python>=3.12.

Installation

Install from PyPI with pip:

$ pip install wt

Or pipx:

$ pipx install wt

Or uv:

$ uv tool install wt

Bootstrapping

To initialize new project with some example content use wt init command:

$ wt init .

Configuration

Your site must have configuration file written in toml. By default wt will look for the file named wt.toml in current dir.

To dump default configuration example to console use wt config command:

$ wt config

Usage

To start development server use wt develop command:

$ wt develop

Bt default the server will be listening at 127.0.0.1:9000.

To use multiple configuration files and custom port:

$ wt develop -c wt.toml -c wt-extra.toml --port 3000

When content is ready you will need to build it using wt build command:

$ wt build

By default generated site will be placed to output/ folder (can be changed in configuration file).

To see command-line help use wt help command:

$ wt help

Roadmap

• documentation
• support for pagination
• support for multiple configuration files
• support for tags

License

MIT