FindSoftware

tumblelog

Static microblog generator that turns a single Markdown input file into HTML5 pages, a JSON feed and an RSS feed; this record covers its Python version.

tumblelog is a static microblog generator. This record covers the Python version, which reads a single Markdown file with directives that define pages and, optionally, tags, and writes HTML5 pages, a JSON feed and an RSS feed. Parameters are given as command-line arguments, and the output is files that any web space can serve.

The Python version is installed from a clone of the repository with its required libraries, or as a Docker image built from a Dockerfile in the repository. The styles that come with the project are written in Sass and are converted to CSS with a Sass program or the Sass container the repository describes.

Worth knowing

The same repository holds a Perl version, tracked as its own record. The README says the author keeps the output of both versions identical apart from minor differences between the render libraries. The repository has no tagged releases, so the date of the last commit stands in for release currency.

Identity

Status
Active
Maintainer
John Bokma3
Maintained by
Individual

Rendering and deploy

Runs as
Static files, Dev only14
Rendering
Static output4
Install with
git clone, then pip3 install -r requirements.txt4

Adoption

GitHub stars
1272
Contributors
26

Why these figures do not compare

Sources

  1. 2026-10-23: links, Runs as, License model
    johnbokma.com/articles/tumblelog/
  2. 2026-10-23: links, License, GitHub stars
    api.github.com/repos/john-bokma/tumblelog
  3. 2026-10-23: Maintainer
    raw.githubusercontent.com/john-bokma/tumblelog/master/LICENSE
  4. 2026-10-23: Written in, Categories, Install with, Rendering, Runs as, Content storage
    raw.githubusercontent.com/john-bokma/tumblelog/master/README.md
  5. 2026-10-23: Runtime
    johnbokma.com/articles/tumblelog/installation-of-the-python-version-of-tumblelog.html
  6. 2026-10-23: Contributors
    api.github.com/repos/john-bokma/tumblelog/contributors?per_page=1

Last reviewed · Listed since Edit on GitHubThis page as markdownas JSON