Qu'est-ce que Nikola?

Nikola est un générateur de site statique créé par Python.

Site officiel: https://getnikola.com

Jekyll, HUGO, Hexo, etc. semblent être les principaux générateurs de sites statiques. Pelican est célèbre pour Python.

C'est l'une des raisons pour lesquelles j'ai choisi Nikola cette fois.

Fabriqué par Python
Le développement est assez actif
Prend en charge divers formats d'entrée
Cli facile à utiliser

Format d'entrée Nikola

Le reStructuredText par défaut est familier aux utilisateurs de Sphinx et vous permet de publier un Notebook (ipynb) créé avec Jupyter comme un blog. Il semble avoir une grande affinité pour Pythonista et les data scientists.

Formats pris en charge par défaut

reStructuredText (default and pre-configured)
Markdown
Jupyter/IPython Notebook
HTML
PHP

Formats pouvant être pris en charge par Plugin

AsciiDoc
BBCode
CommonMark
IRC logs
Markmin
MediaWiki (smc.mw)
Misaka
ODT
Emacs Org-Mode
reST with HTML 5 output
Textile
txt2tags
CreoleWiki
WordPress posts

Installation

Il existe Diverses méthodes d'installation, mais il semble préférable d'installer avec pip.

pip install Nikola

Je ne l'expliquerai pas dans cet article, mais il est recommandé de l'installer dans un environnement virtuel tel que venv ou virtualenv.

Créer un site

Les commandes d'initialisation sont fournies. Répondez à quelques questions et votre site sera créé. Le site_name ci-dessous est n'importe quel nom de répertoire. Un répertoire sera créé avec le nom spécifié.

nikola init site_name

Creating Nikola Site
====================

This is Nikola v7.8.8.  We will now ask you a few easy questions about your new site.
If you do not want to answer and want to go with the defaults instead, simply restart with the `-q` parameter.
--- Questions about the site ---
Site title [My Nikola Site]:

Entrez le titre du site.

Site author [Nikola Tesla]:

Entrez votre nom.

Site author's e-mail [[email protected]]:

Entrez votre adresse email.

Site description [This is a demo site for Nikola.]:

Saisissez une description pour votre site.

Site URL [https://example.com/]:

Saisissez l'URL du site.

Enable pretty URLs (/page/ instead of /page.html) that don't need web server configuration? [Y/n]

Entrez «Y» pour activer les jolies URL.

--- Questions about languages and locales ---
We will now ask you to provide the list of languages you want to use.
Please list all the desired languages, comma-separated, using ISO 639-1 codes.  The first language will be used as the default.
Type '?' (a question mark, sans quotes) to list available languages.
Language(s) to use [en]:

Entrez la langue que vous souhaitez utiliser. Pour le Japon, saisissez «ja».

Please choose the correct time zone for your blog. Nikola uses the tz database.
You can find your time zone here:
https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Time zone [UTC]:

Entrez le fuseau horaire. Pour l'heure japonaise, saisissez «Asie / Tokyo».

--- Questions about comments ---
You can configure comments now.  Type '?' (a question mark, sans quotes) to list available comment systems.  If you do not want any comments, just leave the field blank.
Comment system:

Entrez si vous utilisez le système de commentaires. Laisser vide s'il n'est pas utilisé. Depuis le 17 juin 2017, les éléments suivants peuvent être utilisés.

disqus
facebook
googleplus
intensedebate
isso
livefyre
muut

Publier un article

La commande suivante générera un fichier texte pour le modèle.

nikola new_post

Creating New Post
-----------------

Title:

La saisie du titre de l'article générera un fichier post / titlename.rst. Modifiez ce fichier avec un éditeur. La valeur par défaut est le format reStructuredText.

.. title: {{Saisissez le titre de l'article.}}
.. slug: {{Chemin de l'article(nom de fichier)Entrer le.}}
.. date: {{Entrez la date et l'heure de publication. UTC à la fin pour l'heure japonaise+09:00 est joint.}}
.. tags: {{Entrez le tag. Vous pouvez spécifier plusieurs balises séparées par des virgules.}}
.. category: {{Entrez la catégorie.}}
.. link: {{Saisissez le lien s'il existe une source de référence.}}
.. description: {{Entrez la balise meta description.}}
.. type: text

{{Entrez le contenu de l'article ici.}}

Pour créer un article au format Markdown, utilisez l'option -f et spécifiez comme suit.

nikola new_post -f markdown

Creating New Post
-----------------

Title:

La saisie du titre de l'article générera un fichier post / titlename.md. Modifiez ce fichier avec un éditeur.

<!--
.. title: {{Saisissez le titre de l'article.}}
.. slug: {{Chemin de l'article(nom de fichier)Entrer le.}}
.. date: {{Entrez la date et l'heure de publication. UTC à la fin pour l'heure japonaise+09:00 est joint.}}
.. tags: {{Entrez le tag. Vous pouvez spécifier plusieurs balises séparées par des virgules.}}
.. category: {{Entrez la catégorie.}}
.. link: {{Saisissez le lien s'il existe une source de référence.}}
.. description: {{Entrez la balise meta description.}}
.. type: text
-->

{{Entrez le contenu de l'article ici.}}

Construction du site

Créez l'article publié ci-dessus avec la commande ci-dessous.

nikola build

Confirmation du site

La commande suivante démarrera le serveur http. Le navigateur est lancé en ajoutant l'option -b.

nikola serve -b

Le site est affiché comme ceci.

La prochaine fois vous montrera comment publier un fichier Jupyter Notebook (ipynb) en tant que billet de blog.

Blog sur Nikola