Blog sur Nikola

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.

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

Formats pouvant être pris en charge par Plugin

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.

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.

image.png

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

Recommended Posts

Blog sur Nikola
Utilisez Github-Flavored-Markdown sur le blog Pelican
Blog Django sur heroku: implémentation de la connexion