mirror of
https://github.com/venthur/blag.git
synced 2026-04-14 23:39:31 +02:00
blag is a blog-aware, static site generator -- it uses Markdown and is written in Python.
https://blag.readthedocs.io
- Python 74.1%
- CSS 17.4%
- HTML 6.3%
- Makefile 2.2%
|
|
||
|---|---|---|
| .github | ||
| blag | ||
| debian | ||
| docs | ||
| tests | ||
| .gitignore | ||
| .readthedocs.yaml | ||
| CHANGELOG.md | ||
| LICENSE | ||
| Makefile | ||
| MANIFEST.in | ||
| mkdocs.yml | ||
| pyproject.toml | ||
| README.md | ||
blag
blag is a blog-aware, static site generator, written in Python.
- an example "deployment" can be found here
- online documentation is available on https://readthedocs.org.
blag is named after the blag of the webcomic xkcd.
Features
- Write content in Markdown
- Good looking default theme:
- Theming support using Jinja2 templates
- Generation of Atom feeds for blog content
- Fenced code blocks and syntax highlighting using Pygments
- Markdown footnotes
- Integrated devserver
- Available on PyPI
blag runs on Linux, Mac and Windows and requires Python >= 3.10
Install
blag is available on PyPI, you can install it via:
$ pip install blag
On Debian or Ubuntu, you can also just install the Debian package:
$ sudo aptitude install blag
Quickstart
$ pip install blag # 1. install blag
$ blag quickstart # 2. create a new site
$ vim content/hello-world.md # 3. create some content
$ blag build # 4. build the website