Skip to content
/ blag Public

blag is a blog-aware, static site generator -- it uses Markdown and is written in Python.

License

Notifications You must be signed in to change notification settings

venthur/blag

Folders and files

NameName
Last commit message
Last commit date
Jan 3, 2025
Nov 18, 2024
Oct 13, 2024
Aug 26, 2024
Apr 24, 2024
Jun 16, 2023
Jun 16, 2023
Jan 3, 2025
Jul 14, 2018
Jul 13, 2023
Jul 6, 2024
Apr 24, 2024
Aug 26, 2024
Oct 10, 2024
Mar 10, 2025
Mar 10, 2025

Repository files navigation

blag

blag is a blog-aware, static site generator, written in Python.

blag is named after the blag of the webcomic xkcd.

Features

  • Write content in Markdown
  • Good looking default theme: Blag Screenshot
  • Theming support using Jinja2 templates
  • Generation of Atom feeds for blog content
  • Fenced code blocks and syntax highlighting using Pygments
  • 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