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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file wt-3.2.0.tar.gz.
File metadata
- Download URL: wt-3.2.0.tar.gz
- Upload date:
- Size: 177.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c219bff9c039ee018fa832a710ddd0ebc75b84a4f97eb3ab927af3621da75b7
|
|
| MD5 |
896f36f0a660f7da448084732f2d87b0
|
|
| BLAKE2b-256 |
6d2e135f550b8b139a3b9c965c829fa7ad9096cdc51b0af596828b20a2518e1f
|
File details
Details for the file wt-3.2.0-py3-none-any.whl.
File metadata
- Download URL: wt-3.2.0-py3-none-any.whl
- Upload date:
- Size: 35.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d8f30c46751c15cd5e43b5403f4a1ef4e7305cff21b03ff8f3a5692019ca8ad4
|
|
| MD5 |
128220a16d3f5cfdf51a7cf73b8431bf
|
|
| BLAKE2b-256 |
5f5419b6fa86affb5dc65d2c3855e0015bad7cc0d4e1e0bde212d24a1a2d5433
|
