A simple content site framework that harnesses the power of Django without the hassle.
Project description
coltrane
A simple content site framework that harnesses the power of Django without the hassle 🎵
📖 Complete documentation: https://coltrane.readthedocs.io
📦 Package located at https://pypi.org/project/coltrane-web/
⭐ Features
- Can either generate a static HTML, be used as a standalone Django site, or integrated into an existing Django site
- Write content in markdown and render it in HTML
- Use data from JSON files in templates and content
- Live re-rendering of markdown and data when files are saved with the magic of https://github.com/adamchainz/django-browser-reload
- All the power of Django templates, template tags, and filters inside markdown files
- Can include other Django apps for additional functionality
- Opinionated Django project setup where everything works "out of the box"
⚡ Quick start for a new static site
mkdir new-site && cd new-site
to create a new folderpoetry init --no-interaction --dependency 'coltrane-web:<1' && poetry install
to create a new virtual environment and install thecoltrane
packagepoetry run coltrane create
to create the folder structure for a new site- Update
content/index.md
poetry run coltrane play
for a local development server- Go to http://localhost:8000 to see the updated markdown rendered into HTML
poetry run coltrane record
to output the rendered HTML files
Optional
- Enable
watchman
for less resource-intensive autoreload on MacOS:brew install watchman
How to add new content
Add markdown files or sub-directories with markdown files to the content
directory and they will automatically have routes created that can be requested.
Example markdown files
content/index.md
content/about.md
content/articles/this-is-the-first-article.md
poetry run coltrane play
will enable these URLs
http://localhost:8000/
which serves HTML generated from the/content/index.md
filehttp://localhost:8000/about/
which serves HTML generated from the/content/about.md
filehttp://localhost:8000/articles/this-is-the-first-article/
which serves HTML generated from the/content/articles/this-is-the-first-article.md
filehttp://localhost:8000/not-there/
will 404
poetry run coltrane record
will create these HTML files
output/index.html
output/about/index.html
output/articles/this-is-the-first-article/index.html
Read all of the documentation at https://coltrane.readthedocs.io.
Project details
Release history Release notifications | RSS feed
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
Hashes for coltrane_web-0.13.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c3b1416adc1081765038266c970f4860ef293a482b2834b66d327953a8d13a6f |
|
MD5 | 968edd167e2cb9e4f53b8c99132a357f |
|
BLAKE2b-256 | 299de18458fd3e35581693c5067891a74af6c2345b66ea85536f94b8cf5d07fb |