Ajouter un article en Asciidoc - SCIAM-FR/sciam-fr.github.io GitHub Wiki
Ajouter dans le sous-répertoire _post le fichier de l’article avec l’extension .adoc
Le nom du fichier doit être de la forme :
YYYY-MM-DD-nom-article.adoc
|
Warning
|
Toujours prévisualiser le rendu dans le blog en local. L’aperçu avec son outil préféré peut être parfois différents pour certaines fonctionnalités. |
Il débute par le titre de premier niveau au format AsciiDoc suivi par des méta-données :
| Méta-données | Rôle |
|---|---|
:author: xxx |
L’identifiant de l’auteur (doit être défini dans le fichier _data/authors.yml) |
:docinfo: shared-footer |
|
:layout: post |
Le format d’affichage de la page |
:page-excerpt: xxx |
Le résumé de l’article |
:page-liquid: |
La page contient des instructions liquibase (notamment pour générer les urls relatives) |
:page-navtitle: xxx |
Le titre court |
:page-tags: xxx ou [xxx,xyy,xyz] |
Les tags associés à l’article |
:page-toc: true|false |
L’affichage ou non du sommaire (true par défaut) |
:page-vignette: |
Le nom du fichier de l’image utilisée comme vignette dans l’article |
:post-vignette: |
Le nom du fichier de l’image utilisée comme vignette dans liste des articles |
:page-vignette-licence: |
L’origine et/ou la licence de la vignette |
:showtitle: |
Inclure le titre de niveau 1 dans le contenu de l’article |
:page-auteurs: |
Les auteurs de l’article |
Suivi par le contenu de l’article
Exemple :
= Article de test
:author: antoinesd
:docinfo: shared-footer
:layout: post
:page-excerpt: Article de test sur le blog
:page-liquid:
:page-navtitle: Article de test
:page-tags: [CDI,SPI,Extension,Java]
:page-toc: false
:post-vignette: 1_wP4DCPy7MxRbZGkCQ1y7tw.jpeg
:page-vignette: 1_wP4DCPy7MxRbZGkCQ1y7tw.jpeg
:page-vignette-licence: Source Pixabay
:showtitle:
Erat voluptua duo ipsum voluptua kasd placerat commodo imperdiet aliquam minim stet ut ipsum. Velit consetetur et et dolores illum nonumy nonumy ipsum ipsum luptatum diam. Ea lorem sed et sadipscing sed soluta sit sea laoreet vero est clita labore est et assum eu duis. Takimata erat consetetur iriure sadipscing elitr voluptua qui zzril dolor at magna sanctus ut labore et vulputate vel diam. Iriure no consectetuer lorem kasd.
image::\{\{'/images/fishbowl.png' | relative_url}}[width="285",float="right"]
== Titre niveau 2
Dolor vero aliquyam eu accusam et amet clita invidunt. Lorem diam amet lorem et ut gubergren no erat lorem nonumy sit erat quod sanctus aliquip ex magna dolor. Laoreet dolore diam diam erat doming velit consectetuer sanctus tempor sanctus. Ipsum amet tempor sadipscing imperdiet ad clita exerci odio sit te. Amet sit amet tempor nonummy.
Le sommaire est généré par défaut pour tous les articles.
Pour le désactiver, il faut utiliser la valeur false à l’atttribut :page-toc:
Les images doivent être le sous-répertoire images.
Dans un article en AsciiDoc :
-
Définir l’attribut
:page-liquid:dans les méta-données -
Laisser Jekyll définir l’url relative en utilisant la syntaxe :
image::\{\{'/images/fishbowl.png' | relative_url}}[texte de remplace, width=540]== La vignette
Les images des vignettes doivent être le sous-répertoire images/vignettes.
Dans un article en AsciiDoc, définir l’attribut :page-vignette: dans les méta-données avec le nom du fichier
Dans un article en AsciiDoc, utiliser l’attribut :page-tags: dans les méta-données
:page-tags: [CDI,SPI,Extension,'Ordinateur quantique',Java]Attention : ils sont sensibles à la casse
Il faut utiliser la macro link suivie de la fonction post_url de Liquid avec le nom du fichier de l’article sans son extension.
dans link:{% post_url 2021-01-14-cinquante-nuances-de-beans-CDI %}[l'article précédent^]