===== gp2

Another experiment in defying the Second Law of Thermodynamics.

Background

This project is an attempt to migrate my personal site <https://guillaumepaumier.com> from WordPress to a static site using Nikola <https://getnikola.com>.

Install and build

See also the Getting started <https://getnikola.com/getting-started.html>_ 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 git@github.com: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 <https://gulpjs.com/> 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 <https://gulpjs.com/docs/en/getting-started/quick-start> 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 <https://en.opensuse.org/Docker>__

• Set up the local build container <https://github.com/netlify/build-image#available-images>__

• Make sure the site config in Netlify has the GIT_LFS_ENABLED environment variable set to true (source <https://answers.netlify.com/t/builds-fail-after-new-commit-to-git-lfs/1362/7>__)