gsl-statique-litterateur/help/article-comment-ecrire.md

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 <br /> 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
)