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

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