.. title: Getting started with Nikola
.. slug: first-steps-with-nikola
.. date: 2017-12-10 20:39:06 UTC+01:00
.. tags: python, nikola
.. category: blog
.. link: 
.. description: 
.. type: text

My personal pages went through handcrafted HTML, handcrafted PHP, a good-but-too-heavy CMS; I was looking for something lighter to manage these pages. I almost started to use `Django <https://www.djangoproject.com/>`_ (by the way, `Django girls <https://tutorial.djangogirls.org/fr/django_start_project/>`_ are awesome to start with), but I finally opted for `Nikola <https://getnikola.com>`_. It is nonetheless in Python but particularly light-weighted and increadibly easy to start with.

.. TEASER_END

To get started, Nikolas's `getting started <https://getnikola.com/getting-started.html>`_ pages are just what you need. To go further and to solve some minor issues I got with the configuration, tips and tricks from `Louis Tiao <http://louistiao.me/posts/how-i-customized-my-nikola-powered-site/>`_ were particularly useful.

The theme I'm using is a light adaptation of `Zen <https://themes.getnikola.com/v7/zen/>`_ (color, layout and icons twicking). Moreover, I updated Awesome font to get a larger choice of icons (the corresponding lines appear around lines 375-380 in ``main.css`` of Zen theme):

.. code-block:: css

    @font-face {
      font-family: 'FontAwesome';
      src:url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/fonts/fontawesome-webfont.eot?v=4.7.0');
      src:url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/fonts/fontawesome-webfont.eot?#iefix&v=4.7.0') format('embedded-opentype'),
      url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/fonts/fontawesome-webfont.woff2?v=4.7.0') format('woff2'),
      url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/fonts/fontawesome-webfont.woff?v=4.7.0') format('woff'),
      url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/fonts/fontawesome-webfont.ttf?v=4.7.0') format('truetype'),
      url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular') format('svg');
      font-weight: normal;
      font-style: normal;
    }