Comment créer un site Web avec Jekyll - FR

Êtes-vous un propriétaire de site Web à la recherche d'un moyen simple de créer des sites rapides? Bien que la plupart des systèmes de gestion de contenu populaires tels que WordPress soient couramment utilisés pour de telles tâches, ils ne sont pas rapides. Ils s'appuient sur des bases de données, des scripts lourds et des plugins pour enfin livrer sur la page. Mais s'il y a une meilleure façon? Jekyll est tellement mieux que d'autres choix similaires! C'est un générateur de site statique - tout ce que vous avez à faire est de prendre vos messages, formatez-le en conséquence et exécutez-le dans le moteur. Cela se traduira par la création de fichiers compatibles HTML qui peut être facilement téléchargé sur n'importe quel hôte.

Jekyll 4.1.0 Mises à jour

Jekyll a été mis à jour fin mai 2020 avec une nouvelle mise à jour portant le numéro v4.1.0 dans laquelle le composant serveur prend désormais en charge les certificats ECC entre autres. Il s'agit d'une fonctionnalité importante lorsqu'un type de clé autre que RSA est utilisé. Une autre chose importante qui est l'optimisation du moteur Markdown — la mise en forme qui est utilisée dans les brouillons et pilote la sortie des pages. Avec Jekyll 4.1.0 les blogueurs peuvent choisir désactiver la mise en cache du disque ce qui peut être bénéfique dans certains cas, surtout lorsque des tests de projets plus complexes sont effectués.

Les autres améliorations importantes du point de vue du propriétaire du site sont les suivantes:

• Configuration de la langue par défaut pour inclure la coloration syntaxique. Auparavant, cela devait être fait manuellement.
• Les administrateurs peuvent désormais désactiver l'importation de la configuration du thème
• Le module PageDrop peut être utilisé avec les modèles Liquid.

Comme toujours, la nouvelle version de Jekyll inclut des corrections de bugs importantes signalées par les utilisateurs.

Pourquoi Jekyll pour les sites statiques

Les générateurs de sites statiques sont l'un des outils les plus populaires utilisés pour générer sites de haute qualité et faciles à utiliser et à gérer qui ne dépendent pas d'un système de gestion de contenu dynamique tel que WordPress. Les sites statiques sont petits et produits en tant que sortie de projet après que les propriétaires du site ont exécuté le contenu via l'application Jekyll. De par sa conception, Jekyll est un Application exécutable Ruby qui est très facile à utiliser et multi-plateforme. Une fonctionnalité très pratique est que Jekyll comprend un serveur Web local intégré qui permet aux propriétaires du site de prévisualiser en direct les modifications apportées avant la publication du site en ligne. Il y a quelques avantages distincts de s'appuyer sur un site statique par opposition aux dynamiques ayant Jekyll en tête en tant que générateur de site:

• Performance - Les sites créés par Jekyll sont beaucoup plus rapides que ceux de ses homologues. Ils sont produits dans un code HTML propre, facilement lisible par les navigateurs Web et sont beaucoup plus rapides à charger. Il n'y a pas d'éléments dépendants de la base de données et de requêtes complexes qui sont courants dans d'autres types de sites.
• Processus de création - Par rapport aux systèmes de gestion de contenu dynamique, les produits générés par Jekyll sont construits de manière différente. Les développeurs doivent formater le contenu selon le moteur de modèle utilisé par Jekyll et correspondant au fichier de configuration principal. Jekyll transformera les projets de fichiers en sites HTML qui devront ensuite être téléchargés sur les serveurs Web.
• Configuration requise pour le serveur - Les sites Jekyll ont besoin d'un support de scripts spécial ou de bases de données qui facilitent la recherche d'un hébergement bon marché.

Configuration de Jekyll: Les bases

Jekyll 4.0.0 est essentiellement ce qu'on appelle une gemme Ruby - c'est un type spécial de code qui est installé dans l'environnement Ruby. Ruby est un langage de programmation moderne généralement utilisé pour créer des sites Web et des applications. Un Gem est une sorte de programme qui peut être téléchargé à partir du référentiel Ruby et fonctionnera d'une manière donnée. Les fonctionnalités possibles incluent des outils d'emballage, Actions répétées, cadres et etc. En conséquence, Jekyll prendra les fichiers de contenu, les traiter et produire des fichiers HTML prêts à être téléchargés sur les serveurs Web.

Pour être opérationnel avec Jekyll, les propriétaires de sites potentiels doivent avoir installé le logiciel suivant: L'environnement Ruby principal (y compris tous les en-têtes de développement), Prise en charge des packages Ruby Gems et les outils gcc et make. Une description détaillée de l'installation et de la préparation de l'environnement est disponible sur le site Page d'installation de Jekyll.

Le processus de création d'un site Jekyll

Afin d'avoir un site prêt qui est construit par un Jekyll 4.0.0 application installée sur le système local utilisé par les propriétaires du site. Tout d'abord, ils devront configurer le Jekyll en définissant les environnements globaux pour le projet. Lorsque Jekyll est installé et fonctionne sur un système donné, les propriétaires du site devront créer un répertoire qui hébergera tous les fichiers de projet du site - il sera désigné comme “racine du site” . En elle un Jekyll index.htm un fichier doit être créé pour héberger le contenu de la page d'accueil de base et les fichiers importants. Un modèle vide comprendra le code suivant:

doctype html>
<html>
<tête>
<meta charset = & quot; utf-8 & quot;>
<Titre>Accueil</Titre>
</tête>
<corps>
<h1>Bonjour le monde!</h1>
</corps>
</html></p>

Ceci est le général “Bonjour le monde!” site d'accueil à partir duquel les développeurs web peuvent commencer à créer leurs créations. Dans le répertoire racine, les développeurs peuvent exécuter deux commandes:

• jekyll build - Cela va construire le site et afficher le code final dans un sous-répertoire séparé appelé “_site”.
• jekyll serve - Cela surveillera les modifications du site et reconstruira le site automatiquement en tant que connecté lorsque l'application jekyll est en cours d'exécution. Cela activera également le serveur de site Web intégré qui permettra aux développeurs de prévisualiser en direct leur projet. Par défaut, il est accessible à partir de l'URL suivante: http://localhost:4000

Tout ce que les utilisateurs doivent faire est de décider d'une mise en page appropriée du site et de générer le contenu. Cela peut se faire de deux manières principales:

• Fichiers HTML - Ce sont des fichiers HTML standard qui sont créés par les propriétaires du site. Ils se confronteront aux paramètres définis par Jekyll.
• Fichiers de modèles de démarques - Les propriétaires du site peuvent également appliquer des fichiers écrits en Markdown qui seront sortis selon un modèle donné. Cela signifie que les utilisateurs peuvent formater le texte et le code selon un format Markdown facile à suivre. Il sera traité selon les règles définies et finira par renvoyer un fichier HTML conforme aux standards.

Markdown est un langage de balisage facile à utiliser qui est populaire parmi les développeurs et les utilisateurs avancés de développeurs Web. C'est très pratique car plusieurs programmes de traitement de texte et éditeurs spéciaux peuvent les sortir à partir de formats standard. Jekyll prendra les fichiers Markdown (avec l'extension .md appropriée) et en utilisant les fichiers de modèle définis, générez un fichier HTML optimisé.

Le moteur Jekyll différenciera les pages HTML normales et les fichiers dits spéciaux. Cela se fait en tapant le nécessaire Avant-propos de YAML- cela doit être placé au début de chaque page. YAML est un langage de balisage pratique et convivial qui est lu par Jekyll. Un exemple typique d'un tel fichier est le suivant:

—
disposition: Publier
Titre: Blogging 101 Page
—

Dans cet exemple, l’avant-propos spécifiera l’utilisation disposition type (dans cet exemple, ce sera un article de blog standard) et le Titre de la page. Il y a deux autres variables globales qui peuvent être placées en première ligne - permalien (qui permettra à l'utilisateur de configurer son propre permalien pour le poste donné et publié (des valeurs vraies ou fausses peuvent être placées) ce qui peut empêcher la publication en ligne d'une certaine publication. Ceci est particulièrement utile lorsque des ébauches sont planifiées.

Utilisation du moteur de modèle Jekyll et des fichiers de configuration les utilisateurs peuvent créer leurs propres variables ainsi que. Lorsque le type de message est concerné, plusieurs options peuvent être utilisées:

• Date - Cela remplacera la date de la publication comme indiqué dans la sortie du site.
• catégorie / catégories - Cela permettra une meilleure organisation des messages lorsqu'ils sont vus par les visiteurs. En spécifiant cette valeur, les articles seront organisés dans les catégories respectives. Les «catégories» plurielles peuvent être spécifiées dans une liste YAML ou séparées par des espaces comme dans la plupart des systèmes de gestion de contenu dynamique.
• Mots clés - Il s'agit d'une option populaire pour permettre aux messages d'être marqués par les utilisateurs. Ceci est une commodité supplémentaire distincte des catégories susmentionnées.

Structure du site et moteur de mise en page de Jekyll

Dès que le moteur Jekyll est démarré pour la première fois pour un site donné (projet) essentiellement tout ce que les propriétaires de sites doivent faire est d'invoquer le jekyll new $ sitename (où $nom du site est le répertoire du projet). Toutes les versions modernes de Jekyll créeront une disposition de répertoire structurée. Par défaut, le fichier de configuration principal utilisera un modèle par défaut appelé minima qui peut être modifié ou modifié en fonction des préférences des utilisateurs. Le répertoire contiendra les fichiers et dossiers suivants:

• dossier _posts - Cela contiendra les messages individuels. Dans le cas typique, ils auront le format suivant —XXXX-XX-XX- $ postname.markdown (ou .md). Les trois premières chaînes seront l'année-mois-jour, suivies de tirets avec le nom du message dans la structure de permalien. Un exemple de nom de publication sera 2020-01-03-hello.markdown qui produira une publication intitulée «Bonjour» et publiée en janvier 3 2020.
• _config.yml - Ceci est le fichier de configuration principal utilisé par Jekyll.
• 404.html - Il contiendra la page d'erreur Page Not Found standard qui est également connue sous le nom de 404 Erreur.
• about.markdown - Ceci est la page "À propos" qui se trouve normalement dans la plupart des blogs.
• Gemfile - Ceci est un fichier qui est automatiquement créé par l'environnement Gemfile.
• index.markdown - Il s'agit de la page d'accueil standard qui, par défaut, commencera à indexer tous les articles de type blog en fonction de la date dans un ordre décroissant.

Pour plus d'informations sur les options de mise en page, structure du répertoire et plus d'informations, vous pouvez consulter les pages pertinentes dans le Documentation de Jekyll.

Libérez toute la puissance de Jekyll

Les propriétaires de sites Jekyll peuvent utiliser de nombreuses fonctionnalités leur permettant de personnaliser véritablement leurs sites, même dans les moindres détails. Comme nous l'avons mentionné précédemment, toutes les installations de site par défaut utilisent un thème par défaut appelé minima. Il y a de nombreux référentiels de thèmes Jekyll tiers qui profitent des nombreuses options de personnalisation. Ce qui est unique dans le système de modèles Jekyll, c'est qu'il est basé sur Gemmes - bibliothèques pouvant inclure de riches fonctionnalités. Les installations Jekyll utilisent un utilitaire appelé Bundler qui garde une trace des différentes dépendances. Une fonction alternative consiste à utiliser des modèles réguliers - ils utiliseront les fichiers traditionnels qui sont présentés dans le répertoire du site Jekyll.

Le système de plugins est l'un des plus avancés que l'on trouve dans des générateurs de sites statiques similaires et même dans certains des célèbres systèmes de gestion de contenu dynamique. Les plugins peuvent fournir des fonctionnalités améliorées qui ne se trouvent pas dans l'installation de base de Jekyll. En utilisant des crochets personnalisés et le noyau flexible, de nombreuses autres options peuvent être ajoutées. Il existe plusieurs catégories principales de plugins qui peuvent être classés:

• Générateurs - Il s'agit d'une fonction qui sera utilisée pour permettre à Jekyll de créer des contenus supplémentaires. Des règles personnalisées peuvent être utilisées pour diriger le moteur dans la mise en œuvre de la nouvelle fonctionnalité.
• Convertisseurs - Ces plugins permettent aux utilisateurs d'utiliser d'autres langages de balisage et options de thème afin d'implémenter la mise en page.
• Commandes - Cela étendra les fonctionnalités du moteur principal en implémentant de nouvelles commandes.
• Mots clés- Cela créera des étiquettes personnalisées basées sur les liquides.
• Filtres - Plugins qui étendent la fonctionnalité des filtres.
• Crochets - Ils permettent des extensions pendant le processus de construction.

Options de déploiement du site Jekyll

Il existe plusieurs options compatibles qui peuvent être utilisées pour télécharger les sites sur les serveurs. Il est recommandé de créer un gemfile pour chaque site. Cela permettra aux plugins et extensions d'être emballés dans leur ensemble. Plusieurs valeurs d'environnement peuvent également être définies pendant le processus de construction - à la fin de la phase de production, il existe des paramètres définis qui peuvent être utilisés pour créer la sortie du site. Les sites peuvent être téléchargés de deux manières principales:

• Téléchargement simple - La sortie du dossier du site peut être téléchargée à l'aide du panneau d'administration ou d'un utilitaire de téléchargement de fichiers en utilisant des options de glisser-déposer et / ou des commandes spéciales.
• Publication de contrôle de version - Les propriétaires de sites peuvent également utiliser des systèmes de contrôle de version tels que git ou svn afin de maintenir les révisions du site. Il s'agit d'une fonction avancée qui est utilisée pour stocker les modifications et communiquer avec les serveurs de manière à faciliter la documentation des modifications.