# Comment écrire un article ------------------------------------------------------------------------ Votre article doit contenir 2 sections. Les Metas avant #1 et l'article à partir de ce repère (servant de titre h1). - METAS : configurer votre article (titre, date, liens...) - ARTICLE : Contenue rédactionnel avec quelques marqueurs (gras...) ## METAS obligatoires (avant #1) ``` title: POST TITLE slug: POST-TITLE (si espaces, GSL les convertira en -) info: DESCRIPTION (À propos de cet article) author: NAME (doit être enregistré via ($ gsl author add) date: YYYY-MM-DD tags: TAG1,Mon TAG2,TAG3 (séparé par une virgule) ``` ### Page ou Article ? Vous pouvez spécifier pour chaque article si c'est une page ou un article Si non renseigné, GSL ajoutera le type: post (article) par défaut à la première ligne de votre article ``` # Page (index, 404, about...) # Création selon le slug: /POST-TITLE.html type: page # Article (monarticle) # Création selon le slug: /POST-TITLE/index.html type: post ``` ## METAS optionnelles (avant #1) Définir les marqueurs (abbr:, link:...) et utiliser " : " comme séparateur ``` abbr: COURT : LONG file: NOM : NOM-DU-FICHIER : Text alternatif link: NOM : URL : Text alternatif code: NUMERO : NOM-DU-FICHIER : Text alternatif image: NUMERO : NOM-DU-FICHIER : TEXT-ALTERNATIF ``` ## Contenu de l'article: Les marqueurs *et leur contenu* (ex: ```= list 1...```, ```*__monfichier...```) **doivent commencer et finir sur la même ligne**. ### Abréviations Dans les Metas: ``` abbr: CSS : Cascading Style Sheets ``` Dans l'article: ``` Les propriétés CSS ne sont pas définies ``` ### Paragraphes Au début d'une nouvelle ligne, ouvrez avec ( et fermez avec ). Vous pouvez utiliser 4 classes de paragraphes différentes : ( 1 ( 2 ( 3 Dans l'article... ``` ( 2 Paragraphe avec une classe 2 (css) ) ( Paragraphe sans numéro de classe ) ``` ### Liens Définir en METAS ``` link: Mon lien : URL : Alt text link: https://a-lec.org/ : URL : Alt text ``` Dans l'article.. - Écrivez ```_``` devant le nom du lien - Ajoutez ```+``` pour ouvrir le lien dans un nouvel onglet ``` Visitez _Mon lien+ et charger ici la page _https://a-lec.org/ ``` ### Fichiers Définir en METAS ``` file: Mon fichier : FILENAME : ALT-TEXT ``` Dans l'article... ``` __Mon fichier ``` ### Images Définir en METAS ``` image: 1 : FILENAME : ALT-TEXT image: 2 : FILENAME : ALT-TEXT ``` Dans l'article... Définir le marqueur ```_image``` sur une seule ligne et spécifiez les valeurs séparées par ":" - Numero d'image - Alignement: l,r, ou c (g,d également) pour gauche, droite, centre) - Longueur width: juste le nombre - Largeur height: juste le nombre - Champ non vide: Lien de l'image dans un nouvel onglet Exemple d'images affichées l'une à côté de l'autre ``` ( _image:1 _image:2:c:640:480 _image:3:c:320:240:+ ) ``` Exemple d'images affichées l'une en dessous de l'autre, dont la première peut s'ouvrir dans un nouvel onglet ``` ( _image:1:c:640:480:+ ) ( _image:2:c:1920:1080 ) ``` ### Block-Code depuis un fichier Définir en METAS ``` code: 1 : FILENAME : Alt Text ``` Dans l'article... ``` _code:1 ``` ### Écrire en très gras Dans l'article... ``` **c'est du surgras** c'est in**défini**ssable il ad**juge** : pas de pub ! ``` ### Gras Dans l'article... ``` *c'est en gras* ``` ### Italique Dans l'article... ``` C'est /en italique/ ``` ### Code en ligne Info: ¤ = alt-gr + $ sur un clavier FR azerty) Dans l'article... ``` ¤gsl help -w¤ ``` ### Citation simple (au début de la ligne, mettez 3x -) Dans l'article... ``` --- ( Une citation simple dans un paragraphe ) --- ``` ### Citation avancée Dans l'article... ``` --- _cite : Richard Matthew Stallman _link : https://stallman.org/ _lang : en ( In the free/libre software movement, we develop software that respects users' freedom, so we and you can escape from software that doesn't. I could have made money this way, and perhaps amused myself writing code. But I knew that at the end of my career, I would look back on years of building walls to divide people, and feel I had spent my life making the world a worse place ) --- ``` ### Citation avancée : optionnel Ajoutez ces marqueurs, si connus dans la citation, par ex sous ```_cite``` ``` _year: 2021 _book: Esperanza 64 ``` ### Créer des listes L'arborescence est "infinie". - Chaque contenu de la liste *doit être sur la même ligne* Dans l'article... - utilisez ```=``` pour définir l'arborescence d'une liste simple - utilisez ```ø``` pour définir une liste ordonnée (alt+gr + o (FR azerty)) ``` ( Voici une liste = Fruits : *mangez-en* == Kiwis == Fraises === pas mûres == Bananes === Plantins = Légumes == Haricots === Rouges === Verts Fin de la liste ) ``` ### Ajouter des lignes vides Vous pouvez ajouter des ```
``` dans votre rédaction, mais pour une lecture plus propre de votre article, vous pouvez utiliser le caractère ```|``` *au tout début d'une nouvelle ligne* Dans l'article... ``` #1 Mon titre ( Ceci est un long paragraphe (Un peu d'imagination...) | Retour "forcé" à la ligne ) ```