Install Nikola Static Site Generator on Raspbian
   ================================================

 Last edited: $Date: 2020/12/04 16:47:00 $


             Nikola Static Site Generator
             ----------------------------

 Nikola  is  an  Open  Source  Static Site Generator.
 Nikola offers a lot of  features,  can  be  used  to
 maintain  a  blog,  or a website for personal use or
 for an organisation.

 Nikola is written in Python and available under  the
 Open Source MIT Licence.

 Nikola  takes input in many formats. Out of the box,
 it  supports  reStructuredText,  Markdown,   IPython
 (Jupyter) Notebooks and HTML, and Nikola has plugins
 for many other formats.

 Nikola comes with everything you  need  to  build  a
 modern   website:   blogs   (with   comments,  tags,
 categories, archives, RSS/Atom feeds),  multilingual
 support, easy image galleries, and code listings.

 For    more    information,    see    the     Nikola
 website:  https://getnikola.com.

                     Raspberry Pi
                     ------------

 The Raspberry Pi is a well known, small,  low  cost,
 fanless, energy-efficient computer powered by a SoC.
 Several Open Source Operating  Systems  support  the
 Raspberry  Pi,  each  will  give  you  an  open  and
 powerful system.

 There are multiple variants Raspberry Pi  boards  to
 choose from.

 For   more   information,   see  the  Rapsberry  Pi
 website: https://www.raspberrypi.org

                       Raspbian
                       --------

 Raspbian is a free operating system based on Debian,
 optimized for the Raspberry Pi hardware.

 Raspbian, being based on Debian, uses the same, well
 known package manager as Debian, which makes  it  an
 ideal  introduction  in  using Open Source operating
 system on a Single Board Computer.

 For   more   information,    see    the     Raspbian
 website: http://raspbian.org

            Installing Nikola on Raspbian
            -----------------------------

 I was asked to help to install Nikola on a Raspberry
 Pi.

 For this, I used Raspbian, and downloaded  the  file
 with   the  name
 `2020-08-20-raspios-buster-armhf- lite.zip'.

 Installing Nikola through the usual steps runs  into
 some    problems   with   the   Python   application
 "pyrsistent".

 The system generates a error:

   error: invalid command 'bdist_wheel'

 I presume this has something to  do  with  different
 Python versions.

 The   following   commands   done   on   a  pristine
 2020-08-20-raspios-buster-armhf-lite    installation
 will install Nikola succesfully:

   apt-get update
   apt-get install python3 python-libxslt1 python3-pip \
   python3-venv python-pil python3-zmq python3-wheel \
   libopenjp2-7-dev

   pip3 install -U pip setuptools wheel pyrsistent

   cd
   python3 -m venv nikola
   cd nikola
   source bin/activate
   bin/python -m pip install -U "Nikola[extras]"

   cd
   nikola init --demo mijn-site

 This will result in Nikola running on Python 3.7.

 Have fun !