A simple static site generator with live reload
Project description
turbines
A static site generator built with Jinja2.
Inspired by Cactus, a project that is no longer maintained.
What is turbines?
Turbines is a static site generator that allows you to create websites using Jinja-based HTML templates and markdown files. Turbines makes it easy to deploy your site to services like Cloudflare Pages or AWS S3. It supports live reloading during development.
Usage
To install turbines, run:
pip install turbines
or
uv add turbines
To create a new site, run:
turbines create mysite
cd mysite
To build the site, run:
turbines build
To serve the site with live reloading, run:
turbines serve
Templates
Templates are written in Jinja2. You can use any Jinja2 syntax in your templates.
Variables
The site variable is available in all templates and contains information about the site current site, such as the url and the title.
The pages variable is also available and contains a map of tags and the pages that have those tags.
For example, pages.tags.articles would give you a list of all pages that have the articles tag.
The context variable contains the context set in config.yaml.
Functions
The url function is available in all templates and can be used to generate URLs for pages. For example, {% url "test.md" %} would give you the URL for the page generated from test.md.
The static function is also available and can be used to generate URLs for static files. For example, {% static "style.css" %} would give you the URL for the style.css file in the static directory.
Examples
None yet. Coming soon!
Compatibility
Turbines is built with Python 3.12.
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 turbines-0.1.7.tar.gz.
File metadata
- Download URL: turbines-0.1.7.tar.gz
- Upload date:
- Size: 9.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aece69c450d3c5262fdaabc9963a59d4eb43d84fd2593e4f1e676fb8c9f5b42e
|
|
| MD5 |
48444f556bd6bb772ad2b08b65d13bb2
|
|
| BLAKE2b-256 |
a9527e952e5b6cbe4d362171d2db02e3c50c2fa954e44e8384240b90cda06d35
|
File details
Details for the file turbines-0.1.7-py3-none-any.whl.
File metadata
- Download URL: turbines-0.1.7-py3-none-any.whl
- Upload date:
- Size: 14.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b481deb7b80fb1dd3cd94bfbad75f2d729aebaec436993fde3db9258a822443
|
|
| MD5 |
96c80fd357d06a3c4291b0958b51fd20
|
|
| BLAKE2b-256 |
9dc04292000891756ef234185966776bbaf88d63a54dc1e3a8e1a0b7a8479e4f
|
