A small static site generator powered by KDL and Jinja2.
Project description
kdlj2-web
An example of using Jinja2 and KDL as building blocks to build robust, possibly dynamic website markup and interpolation pipelines with a friendly syntax.
This example is very small. It has a simple file browser (only when using the debug HTTP server), and an example invoices table.
Quick Guide
After installing through pipx or uv or anything else,
-
Put your static assets in
static/. -
Write your page templates in the top level of
templates/.- Snippets to be used inside pages should go on
templates/partials/. - Layouts a page should inherit should go on
templates/layouts/.
- Snippets to be used inside pages should go on
-
Run
kdlj2-webto render your pages!- As a debug server:
python kdlj2-web serve --port=1234 - To a static file folder:
python kdlj2-web build --outdir=my-path/ - Add custom options:
python kdlj2-web --opts theme=dark serve
- As a debug server:
-
If you want your static and template directories in a different location, you can use the
-sargument, like so:python kdlj2-web -s my_webroot/ ...
Copyright
(c)2026 Gustavo Ramos Rehermann (wallabra) gr.wallabra@proton.me.
All code and assets in this project are made available under the Cooperative Non-Violent Public License: about, raw, ScanCode LicenseDB.
Please see LICENSE.md.
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 kdlj2_web-0.1.0.tar.gz.
File metadata
- Download URL: kdlj2_web-0.1.0.tar.gz
- Upload date:
- Size: 48.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":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 |
d73d5f7a3bf48799c46ea171a3071d10b256a8a757baa39a95785d6eab5e2ed5
|
|
| MD5 |
bb522f5ba1bd6ac987736677994f6377
|
|
| BLAKE2b-256 |
9bd504509600413287139aaa4c1e092ae7926730fbaf368fdbf0421a8804e6b9
|
File details
Details for the file kdlj2_web-0.1.0-py3-none-any.whl.
File metadata
- Download URL: kdlj2_web-0.1.0-py3-none-any.whl
- Upload date:
- Size: 21.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":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 |
684a5689a3835ce890f3d0c2e148bde78703f5f86b354058410e8117298a9617
|
|
| MD5 |
9633eb3abdb08c486eac89845c0859a3
|
|
| BLAKE2b-256 |
c636416746fd9bc4923884f2034ec56a78cb3b201a7d8cda0679faf32e58b496
|
