Installation of the Python version of tumblelog
The Python version of tumblelog has been tested with Python
3.7.3. This installation guide was tested on Ubuntu 20.04.2.0 LTS
Focal Fossa 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 templates. 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
your preferred directory first.
git clone https://github.com/john-bokma/tumblelog.git
cd tumblelog
Installing the required packages
The tumblelog program requires the commonmark and regex Python
libraries to be installed. I used pip3 to install the required
libraries as follows:
sudo apt install -y python3-pip
pip3 install commonmark
pip3 install regex
Installing commonmark gives a warning regarding cmark which can be
ignored.
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
- tumblelog: a static microblog and microsite generator - Introduction