Perl programmer for hire: download my resume (PDF).
John Bokma's Hacking & Hiking

Installation of the Python version of tumblelog

The Python version of tumblelog requires Python 3.7 or more recent. This installation guide was tested on Ubuntu 19.04 Disco Dingo but should also work on a more recent version of Ubuntu.

Downloading tumblelog

The easiest way to download tumblelog is to use git. This makes it also possible to check for updates to the program, its styles or the example template. Click on Activities in the left corner and search for terminal to open the terminal and enter the following:

sudo apt install -y git

Next clone the github repository for tumblelog. This will create a directory tumblelog. If you run this command make sure you want this directory created in your current working directory. If not, change to an appropriate directory first.

git clone https://github.com/john-bokma/tumblelog.git

After this you can check for an update using:

git pull

Installing the required packages

The tumblelog program requires the commonmark Python library to be installed. While Ubuntu 19.04 Disco Dingo comes with a package named python3-commonmark-bkrs it's a very outdated version of the library.

So I used pip3 to install the required CommonMark library as follows:

sudo apt install -y python3-pip
pip3 install commonmark

After this, tumblelog.py should be able to run without any errors. Verify this by running the program with the --help option:

python3 tumblelog.py --help

Please take some time to read the help shown.

In order to create the CSS stylesheets the sass program has to be installed as follows:

sudo apt install -y sass

I use Sass, a CSS extension language, to make it easy to create new styles and maintain the current ones. I highly recommend to use Sass or a similar program in your own projects if you work with CSS.

Continue reading in Testing tumblelog.

Related