Engrave
Engrave is a lightweight static-site generator built with Python and Jinja2. It is designed for small documentation sites, landing pages, and simple content-driven sites that benefit from templating without adding a backend.
Installation
pip install engrave
CLI overview
Top-level usage:
engrave <command>
Core commands:
engrave buildbuilds the site onceengrave watchbuilds once, then rebuilds when files changeengrave serverbuilds once, then starts a local preview server with watch events
Use engrave --help or engrave <command> --help for full command details.
Build once:
engrave build site build --copy 'assets/.*'
Watch and rebuild:
engrave watch site build --copy 'assets/.*'
Run the preview server:
engrave server site build --copy 'assets/.*'
HTML files are rendered automatically. Non-HTML assets such as CSS, JS, images,
and fonts are only copied when their source-relative paths match one or more
--copy regex patterns.
Testing
python -m unittest
Development
Build package artifacts:
uv build
Build docs:
uv sync --group dev
uv run mkdocs build
Preview docs locally:
uv run mkdocs serve
Changelog
See CHANGELOG.md for release notes.
License
MIT. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for engrave 3.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| engrave-3.2.6.tar.gz | 117.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| engrave-3.2.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 136.7 kB
Release files / engrave-3.2.6.tar.gz
| Download URL | engrave-3.2.6.tar.gz |
|---|---|
| Size | 117.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ee05fa427c57ec41f79654adf23d2d392ea3176a51c24db17cd3c18a91eabf9d
|
|
BLAKE2b-256 checksum How to use checksums |
d5ba61b3054b05fc6045a18feffb2ff525bd0f21ada9e5a8f47ed18e78c08a4a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / engrave-3.2.6-py3-none-any.whl
| Download URL | engrave-3.2.6-py3-none-any.whl |
|---|---|
| Size | 19.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c166ab5a9fff9efd3d1cbf777f98331ca21946c622665f2d6a50a7878885bc52
|
|
BLAKE2b-256 checksum How to use checksums |
aa64b4652b1dcd863d8ed4512698adf9e8423bc5699bbaebce5ff008e62ec27f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
