gp2

Another experiment in defying the Second Law of Thermodynamics.

Background

This project is an attempt to migrate my personal site from WordPress to a static site using Nikola.

Install and build

See also the Getting started page in the documentation for Nikola.

Install system packages:

# zypper in libjpeg8-devel libxml2-devel libxslt-devel python3-dbm

Install Python packages:

# pip install --upgrade virtualenv

Set up the virtualenv:

$ virtualenv nikola
$ cd nikola
$ source bin/activate

Install Nikola and extras:

$ pip install --upgrade pip setuptools wheel
$ pip install --upgrade "Nikola[extras]"

Clone the site's repository:

$ git clone [email protected]:gpaumier/gp2.git

Once in the site's directory: Install Nikola plugins as needed:

$ nikola plugin -i sphinx_roles

Build the site :

$ nikola build

and launch the built-in webserver:

$ nikola serve

Or launch in watcher+server mode:

$ nikola auto

Developing the theme

I'm currently using Gulp to compile JavaScript and CSS assets. This is only needed to modify the site's JS and CSS; when writing and publishing a new post or page, the theme doesn't change so the previous section is enough. See the Gulp documentation for more details.

Install Gulp globally:

# npm install -g gulp-cli

From the site's directory, install the theme's dependencies:

$ npm install -D

Build assets with a one-off command:

$ gulp

Or start gulp in watcher mode, which will automatically recompile on save:

$ gulp watch

Bits (JS and CSS) will be picked up by Gulp and compiled, then Nikola will update its build folder, if it's simultaneously running in auto mode; otherwise, build manually.

Maintenance stuff:

$ npm outdated

Building for deployment

• Install Docker
• Set up the local build container
• Make sure the site config in Netlify has the GIT_LFS_ENABLED environment variable set to true (source)