# 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.


Source: https://findsoftware.frbit.cloud/tumblelog-py/
Last reviewed: 2026-10-23
Listed since: 2026-10-23

## Record

### Links

- home: https://johnbokma.com/articles/tumblelog/
- repository: https://github.com/john-bokma/tumblelog
- docs: https://johnbokma.com/articles/tumblelog/

### Identity

- status: active
- maintainer: John Bokma
- maintainerType: individual
- parent: unknown
- firstRelease: unknown
- hqCountry: unknown

### Kind

- category: ssg
- hosting: static
- language: python
- runtime: python
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: flat-file
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: static, local
- renderingModes: static
- installMethod: git clone, then pip3 install -r requirements.txt

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: unknown
- latestReleaseDate: unknown

### Adoption

- githubStargazers: 127
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 2
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://johnbokma.com/articles/tumblelog/ (read 2026-10-23)
- urls: https://api.github.com/repos/john-bokma/tumblelog (read 2026-10-23)
- urls: https://johnbokma.com/articles/tumblelog/ (read 2026-10-23)
- maintainer: https://raw.githubusercontent.com/john-bokma/tumblelog/master/LICENSE (read 2026-10-23)
- language: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- category: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- runtime: https://johnbokma.com/articles/tumblelog/installation-of-the-python-version-of-tumblelog.html (read 2026-10-23)
- installMethod: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- installMethod: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- renderingModes: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- runsAs: https://johnbokma.com/articles/tumblelog/ (read 2026-10-23)
- runsAs: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- contentStore: https://raw.githubusercontent.com/john-bokma/tumblelog/master/README.md (read 2026-10-23)
- license: https://api.github.com/repos/john-bokma/tumblelog (read 2026-10-23)
- licenseModel: https://johnbokma.com/articles/tumblelog/ (read 2026-10-23)
- githubStargazers: https://api.github.com/repos/john-bokma/tumblelog (read 2026-10-23)
- contributors: https://api.github.com/repos/john-bokma/tumblelog/contributors?per_page=1 (read 2026-10-23)

## Notes

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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0