# Créer un fichier depuis la ligne de commande ------------------------------------------------------------------------ Vous pouvez créer un fichier daté du jour avec les METAS obligatoires intégrés (à renseigner après). Vous devez spécifier si votre article sera une page ou un post (Voir section plus bas) et lui donner un nom. Rendez vous dans le dossier de vos articles, enregistrés lors de l'ajout de votre domaine (ou celui que vous avez configuré). Évitez les espaces dans le nom du fichier ou utilisez des guillemets. ``` # Crréer une page nommée index gsl create page index # Créer un article nommé mes-vacances gsl create post mes-vacances ``` Vous pouvez l'éditer dans le terminal ou avec votre éditeur de texte. ``` gsl edit mes-vacances.gsl ``` # 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 HTML selon le slug: /POST-TITLE.html type: page # Article (monarticle) # Création HTML 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 Définir en 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 (ul) - utilisez ```+``` pour définir une liste ordonnée (ol) ``` ( Voici une liste simple = 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 ) ```