menu

Jekyll

Jekyll est un générateur de site Web statique qui utilise des fichiers au format Markdown comme base.

  1. Markdown
  3. Éditeurs Markdown
  5. Jekyll

Aperçu

Connaissez-vous Ruby? C'était donc le langage de programmation choisi pour développer Jekyll.

Le programme est gratuit et open source.

Parmi les milliers de sites qui utilisent Jekyll pour convertir des fichiers Markdown en HTML, l'un d'entre eux mérite d'être mentionné, les pages GitHub.

GitHub Pages utilise Jekyll comme outil principal pour convertir les fichiers Markdown en HTML sur son service d'hébergement de site Web gratuit.

Le processeur Markdown utilisé par l'application est kramdown.

Jekyll charge kramdown avec les paramètres par défaut, mais vous pouvez les modifier comme indiqué dans l'exemple ci-dessous.

kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3

Le fichier de configuration s'appelle _config.yml, vous pouvez cliquer ici pour en savoir plus sur les paramètres de Jekyll.

Site officiel: https://jekyllrb.com/

Prise en charge de Markdown dans Jekyll

Le Tableau 1.1 présente les éléments Markdown compatibles avec Jekyll.

Élément Soutien Informations
Titres Ouais
Les paragraphes Ouais
Sauts de ligne Ouais
Gras Ouais
Italique Ouais
Blockquote Ouais
Listes ordonnées Ouais
Listes non ordonnées Ouais
Code Ouais
Lignes horizontales Ouais
Links Ouais
Images Ouais
les tables Ouais
Blocs de code clôturés Ouais Insérez l'option syntax_highlighter: rouge dans la section kramdown du fichier _config.yml pour activer la mise en évidence de la langue dans le bloc.
Notes de bas de page Ouais
Identifiant du titre Ouais
Listes de définitions Ouais
Barré Ouais Pour rayer un mot dans Jekyll, utilisez les tuiles ~~ mot ~~ ou juste une tuile ~ mot ~ autour du contenu. Les deux syntaxes fonctionnent.
Listes de tâches Ouais
Emoji (copier et coller) Ouais
Emoji (codes d'accès) Non Jekyll ne fournit pas de support par défaut, mais vous pouvez ajouter plugin jemoji.
URL automatique Link Ouais
Désactiver URL automatique link Ouais
HTML Ouais

Prise en charge d'éléments de syntaxe supplémentaires

Dans Table 1.2 vous pouvez voir des éléments plus obscurs supportés par Jekyll.

Élément Markdown Sortir
Abréviation *[HTML]: Hyper Text Markup Language
La spécification de HTML est maintenue par le W3C.		 La spécification de HTML est maintenue par le W3C

Voir aussi

Options de configuration de Markdown dans Jekyll

Documentation kramdown