gpaumier / gp2

Another experiment in defying the Second Law of Thermodynamics

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 [e-mail]: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)