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.
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:
Installing the required packages
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
tumblelog.py should be able to run without any errors. Verify this by running the program with the
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.
- tumblelog: a static microblog and microsite generator - Introduction