Le forum permet de rédiger avec Markdown, des balises BBCode & des balises HTML.
Pour la plupart des messages, le Markdown reste la solution la plus simple.
Markdown
Gras, italique et barré
**texte en gras**
*texte en italique*
***gras et italique***
~~texte barré~~
Ce qui donne :
texte en gras
texte en italique
gras et italique
texte barré
Titres
# Grand titre
## Titre
### Sous-titre
#### Petit sous-titre
Les titres permettent de structurer les publications longues et d’éviter les gros pavés difficiles à lire.
Citations
> Ceci est une citation.
Ce qui donne :
Ceci est une citation.
Listes
Liste simple :
- Premier élément
- Deuxième élément
- Troisième élément
Liste numérotée :
1. Premier élément
2. Deuxième élément
3. Troisième élément
Liens
[Nom du lien](https://example.com)
Images
En pratique, le plus simple reste d’envoyer directement l’image depuis l’éditeur : Discourse génère automatiquement le code nécessaire.
Code
Pour afficher quelques mots ou une commande comme du code :
`du code`
Pour afficher un bloc entier, on l’entoure de trois accents graves :
```text
contenu du bloc
```
Ligne de séparation
---
Ce qui donne :
BBCode
Discourse comprend également plusieurs balises issues des forums classiques.
Gras, italique, souligné et barré
[b]gras[/b]
[i]italique[/i]
[u]souligné[/u]
[s]barré[/s]
Citation
[quote]
Texte cité
[/quote]
Spoiler
[spoiler]
Ce texte est masqué.
[/spoiler]
Ce qui donne :
Dark Vador est le père de Luke.
Bloc repliable
Pratique pour ajouter un complément sans alourdir immédiatement le message :
[details="Afficher la suite"]
Contenu masqué par défaut.
[/details]
Ce qui donne :
Afficher la suite
Contenu masqué par défaut.
Lien
[url=https://example.com]Nom du lien[/url]
Image
[img]https://example.com/image.jpg[/img]
HTML
Discourse accepte également une partie du HTML.
Gras
<b>Texte en gras</b>
On peut aussi utiliser la balise plus sémantique :
<strong>Texte important</strong>
Italique
<em>Texte en italique</em>
Retour à la ligne
Première ligne<br>
Deuxième ligne
<br> force un retour à la ligne sans créer un nouveau paragraphe.
Lien
<a href="https://example.com">Nom du lien</a>
Le HTML est volontairement filtré par Discourse : toutes les balises et tous les attributs HTML ne sont donc pas acceptés.
Pour la rédaction courante, le Markdown reste généralement plus simple.
Balises ajoutées au forum
Quelques balises supplémentaires ont été ajoutées pour améliorer la présentation des publications.
Centrer
[center]
Texte centré
[/center]
Utile pour une courte introduction, un titre, une citation ou une image que l’on souhaite isoler visuellement.
Aligner à gauche
[left]
Texte aligné à gauche
[/left]
Justifier
[justify]
Ce paragraphe sera justifié sur toute sa largeur.
[/justify]
Couleurs du forum
Une balise spéciale permet d’utiliser directement les couleurs prévues par le thème.
Les couleurs disponibles sont les suivantes.
Primaire
[color=primaire]Texte[/color]
[color=primaire]Texte en couleur primaire[/color]
Accent
[color=accent]Texte[/color]
[color=accent]Texte en couleur d’accent[/color]
Alternative
[color=alternative]Texte[/color]
[color=alternative]Texte en couleur alternative[/color]
Danger
[color=danger]Texte[/color]
[color=danger]Texte en couleur danger[/color]
Succès
[color=succes]Texte[/color]
[color=succes]Texte en couleur succès[/color]
J’aime
[color=jaime]Texte[/color]
[color=jaime]Texte en couleur J’aime[/color]
Ces couleurs ont des fonctions et s’adaptent au thème clair ou sombre du forum.
La balise article
Pour les articles, journaux, récits, essais et publications longues, une balise spéciale a été ajoutée :
[article]
Votre texte...
[/article]
Elle donne au contenu une présentation plus aérée, plus confortable à lire et davantage mise en valeur par rapport aux réponses ordinaires.
Le Markdown et les autres balises continuent de fonctionner à l’intérieur.
Ce qui donne :
[article]
Aliquam erat volutpat
Fusce commodo purus eu est vestibulum posuere. Praesent enim urna, congue eget consectetur porttitor, commodo at diam. Vestibulum vel nibh metus. In hac habitasse platea dictumst. Aliquam rutrum lectus nec lacinia dapibus. Proin cursus, metus eget lobortis molestie, mauris dui finibus diam, at mattis magna nisi ut est. Nam purus mi, vestibulum vitae tempor ut, laoreet at ante. In non gravida libero.[/article]