Skip to content
A static tumblelog generator available as both a Perl and Python version
Perl CSS Python HTML
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
screenshots
styles
.gitignore Updated documentation to explain how to run on macOS Nov 9, 2019
CHANGELOG.md Update to show change in version 4.0.2 Nov 2, 2019
README.md Updated documentation to explain how to run on macOS Nov 9, 2019
tumblelog.html
tumblelog.md Improve the example page to make SCSS testing easier. Oct 6, 2019
tumblelog.pl
tumblelog.py

README.md

tumblelog: a static microblog generator

tumblelog is a static microblog generator. There are two versions available, one written in Perl and one written in Python. Which version you use is up to you; I make an effort to keep the output of both versions identical.

The input is a single "Markdown" file divided into pages by starting a line with a date followed by a title. Each date page can further be split up into multiple articles using a single % on a line by itself.

Parameters to control the blog are given via command line arguments. The program creates the blog HTML5 pages and both a JSON and RSS feed.

Python Version Quick Start

Install sass and pip3 for Linux:

sudo apt install -y git sass python3-pip

For macOS:

brew install sass
brew install pip3

Then:

git clone https://github.com/john-bokma/tumblelog.git
cd tumblelog
python3 -m venv venv
pip3 install commonmark
source venv/bin/activate
mkdir htdocs
sass --sourcemap=none -t compressed styles/steel.scss htdocs/steel.css
python3 tumblelog.py --template-filename tumblelog.html --output-dir htdocs/ \
        --author 'Test' --name 'Test Blog' --description 'This is a test'    \
        --blog-url 'http://example.com/' --css steel.css tumblelog.md

To view the generated site at http://localhost:8000/ enter:

cd htdocs
python3 -m http.server

Documentation

Style Examples

A screenshot of the four styles that come with tumblelog

A screenshot of four of the twelve styles that come with tumblelog.

The screenshots directory has 1:1 examples of themes that come with tumblelog.

Blogs

If you want your tumblelog generated site listed, please let me know.

You can’t perform that action at this time.