Continuer avec ces séries d'articles sur comment je suis passé de WordPress à Jekyll, Le moment est venu d'abandonner la théorie et de passer à la pratique.
Je décris les étapes de configuration dans le sens où je les ai faites. Le premier fichier à modifier est config.yml. On y retrouve la configuration par défaut du site. Chaque publication ou page particulière peut se voir attribuer une configuration différente. Mais, au cas où nous ne le ferions pas, celui établi dans ce dossier sera attribué.
Rappelez-vous que dans l'article précédent nous avions téléchargé un thème et nous nous basons dessus pour la création de notre site.
L'extension .yml indique que le document est écrit en YAML. Ce langage permet d'établir des hiérarchies entre les données d'une manière compréhensible à la fois pour les ordinateurs et les humains. Jekyll l'utilise pour donner de la cohérence aux différentes composantes d'un projet.
Comment configurer le site en utilisant YAML
Un projet Jekyll basique comporte un fichier config.yml qui nous permet de définir certains paramètres.
Ces paramètres sont représentés au format
Catégorie : « contenu » Il convient de mentionner qu'il est précédé du signe # il est ignoré, donc si nous voulons que Jekyll utilise ce paramètre, nous devons le supprimer.
Dans notre fichier config.yml, nous verrons quelque chose comme ceci:
title:
Le titre du site
email:
L'email du site
description:
Une description de l'objet du site pour les moteurs de recherche à afficher
baseurl
: Si le blog fait partie d'un autre site et qu'un dossier spécifique lui est affecté, il est indiqué ici
url:
Le domaine principal du site.
Il existe également deux autres catégories.
twitter_username
github_username:
Ces deux paramètres affichent des liens vers les comptes d'utilisateurs Twitter et Github.
Ci-dessous, vous indiquerez à Jekyll quel thème utiliser et quels modules complémentaires.
Config.yml dans Erreurs minimales
NNous allons utiliser un thème avec beaucoup plus d'options et, par conséquent, nécessite un config.yml plus complet. Le plus pratique est de copier l'archive du projet de thème et collez-le dans le nôtre au lieu de son contenu. Une fois cela fait, nous éditons les paramètres suivants
N'oubliez pas que notre exemple de projet était un blog de jardinage.
La première chose que nous devons faire est d'établir le thème. Dans cette ligne
# theme : "minimal-mistakes-jekyll
»Nous supprimons le symbole du chiffre" # "
Ce thème propose plusieurs variantes. J'aime l'appel Aqua. Nous commentons "default" en mettant le symbole #d devant le nom et décommentons "aqua
Locale indique la langue du site Web au format language_VARIANT. Par exemple, puisque je suis en Argentine, c'est
locale : "es-AR
»
Vous pouvez trouver la liste des langues dans cette page
Nous indiquons le titre du site
title : "Blog de jardinería"
On choisit un séparateur entre le titre du site et celui du post afin qu'il s'affiche correctement dans les moteurs de recherche.
title_separator : "-"
Nous pouvons ajouter un sous-titre
subtitle: “Llevamos la naturaleza a tu computadora”
Nous indiquons le nom du responsable du site
name : "Rosendo Margarito Flores"
Nous complétons la description du site à afficher dans les moteurs de recherche et sur la page d'accueil
description : "Un blog para difundir el auto cultivo de vegetales y flores entre aquellos que no tienen la menor idea de cómo se hace."
Les deux paramètres suivants sont deux vieilles connaissances, mais dans l'ordre inverse.
EDans le premier cas on indique le domaine du site
URL : « https : //desdeeljardin.flor »
Supposons que notre blog fasse partie d'un magasin de semences. Nous pouvons vouloir lui attribuer sa propre adresse de type à partir de la fleur de jardin / du blog.
Ensuite, nous faisons
baseurl : "/blog"
Pour une raison quelconque, les publications avec des images ont plus de visites que celles sans. Si vous ne leur en avez pas affecté, vous pouvez faire un affichage par défaut en activant ce paramètre.
teaser : "/assets/images/500x300.png"
Pour éviter toute confusion, je vais conserver la structure de fichier d'origine du thème. Par conséquent, dans notre dossier de projet, nous devons créer un dossier appelé assets, à l'intérieur de celui-ci appelé images, et à l'intérieur un 500 × 300 pixel appelé 500 × 300.png
Nous pouvons également choisir le logo du site. Nous répétons la procédure de création et de sauvegarde dans les mêmes dossiers et en complétant le paramètre :
logo : "/assets/images/88x88.png"
Nous pouvons choisir un titre différent de celui du site à afficher en haut navigateur
masthead_title: “¡Feliz primavera!”
Dans le prochain article, nous continuerons à examiner les options de configuration. Mais, j'en profite pour préciser que je n'ai aucune idée du jardinage. Par conséquent, je ne suis pas responsable de ce que dit l'exemple de blog.