kdlj2-web 0.1.2

A small static site generator powered by KDL and Jinja2.

kdlj2-web

• Quick Guide
• Copyright

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/.

• Run kdlj2-web to 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

• If you want your static and template directories in a different location, you can use the -s argument, like so: python kdlj2-web -s my_webroot/ ...

Other Tools

A few auxiliary tools ship with this package.

$ echo 'p "hello"; p { - "world,"; b "o mighty"; }; br; - "that I so much"; i "crave!"' | kdl-to-html
<p>hello</p><p>world,<b>o mighty</b></p><br></br>that I so much<i>crave!</i>

$ echo '' | html-to-kdl

Copyright

(c)2026 Gustavo Ramos Rehermann (wallabra) [e-mail].

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.