:cn : Guide de mise en forme pour Discourse : Ajoutez des formats pour rendre les posts plus colorés et variés

Certaines petites modifications apportées à un article peuvent considérablement améliorer sa lisibilité et son interactivité ! Cet article se concentre sur les « petites modifications » du formatage des articles.

Il est encore plus efficace d’ouvrir l’éditeur d’articles et d’apprendre en suivant. L’éditeur d’articles dispose d’une page de prévisualisation intégrée :

Buvez de l’eau, étirez-vous. Êtes-vous prêt à ouvrir votre éditeur d’articles ? Bien, commençons !



Titres

Ajoutez un # devant une ligne pour convertir le contenu de la ligne en titre. Le nombre de # correspond au niveau du titre.

Entrée :

# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3
#### Titre de niveau 4

Résultat :

:bulb: Lorsque le contenu d’un article est volumineux et structuré, l’ajout de titres permet aux lecteurs de mieux comprendre la structure organisationnelle du contenu, rendant l’article plus clair.

:bulb: Les titres dans l’article auront automatiquement des liens qui y mènent (déplacez la souris sur le titre pour voir le symbole :link: représentant le lien correspondant), ce qui permet de sauter rapidement à un titre spécifique via un lien.

:bulb: Notez qu’il doit y avoir un espace entre le # et le contenu du titre.

:bulb: Certains pourraient utiliser le gras comme titre. La plupart du temps, ce n’est pas recommandé, car le gras n’a pas la sémantique, la hiérarchie, ni les liens automatiques du format de titre, et il ne peut pas préparer le terrain pour le format de table des matières qui sera présenté ci-dessous.

:bulb: Il est recommandé d’utiliser un titre de niveau 2 comme titre principal lors de la publication d’un article, plutôt qu’un titre de niveau 1, car le titre de niveau 1 est déjà utilisé par le titre principal du sujet.



Table des matières

Vous avez peut-être remarqué que cet article a une table des matières. Si vous utilisez un téléphone portable, la table des matières se trouve dans le coin inférieur droit et s’ouvre en cliquant sur le bouton de table des matières. Si vous utilisez un ordinateur, la table des matières apparaît sur le côté droit de l’écran.

Lorsque votre sujet d’article contient des titres, vous pouvez ajouter une telle table des matières à votre article.

Comment l’ajouter : Assurez-vous que l’article contient des titres (ces titres servent à construire la table des matières). Dans l’éditeur, placez le curseur sur une ligne vide. Cliquez ensuite sur le bouton illustré ci-dessous.

Après avoir cliqué sur ce bouton, une série de symboles anglais apparaîtra dans l’éditeur :

 <div data-theme-toc="true"> </div>

Ces symboles sont utilisés pour générer automatiquement la table des matières et ne seront pas affichés dans votre article publié, vous ne devez donc pas les supprimer. Laissez-les et continuez à écrire le contenu de l’article. Vous verrez la table des matières après avoir publié l’article.

:bulb: La table des matières permet de présenter les titres de manière centralisée, facilitant le saut rapide vers le contenu du titre correspondant. Si votre sujet d’article contient des titres, l’ajout d’une table des matières est une bonne option !



Gras, Italique, Mise en surbrillance

Entrée :

Ce qui est entouré d'une paire de doubles astérisques est **en gras**
Ce qui est entouré d'une paire d'astérisques simples est *en italique*
Ajoutez deux symboles spéciaux autour du texte à <mark>mettre en surbrillance</mark>.

Résultat :
Ce qui est entouré d’une paire de doubles astérisques est en gras
Ce qui est entouré d’une paire d’astérisques simples est en italique
Ajoutez deux symboles spéciaux autour du texte à mettre en surbrillance.

:bulb: Le gras est très visible et convient pour souligner des informations importantes.

:bulb: L’italique peut également être utilisé pour souligner, et est parfois utilisé pour indiquer des mots étrangers, des noms spéciaux ou des noms propres, afin de les distinguer du texte ordinaire environnant.

:bulb: La mise en surbrillance est également très visible. Quand l’utiliser dépend de vos besoins.



Citation

Ajoutez un symbole > devant un paragraphe pour lui donner un format de citation.
Entrée :

> L'eau verte flotte sous le jade blanc, les pattes rouges remuent dans les vagues claires.

Résultat :

L’eau verte flotte sous le jade blanc, les pattes rouges remuent dans les vagues claires.

Un bloc de citation peut contenir plusieurs paragraphes. Une ligne vide entre les paragraphes doit être précédée d’un symbole >.
Entrée :

> Premier paragraphe de contenu.
>
> Deuxième paragraphe de contenu.

Résultat :

Premier paragraphe de contenu.

Deuxième paragraphe de contenu.

:bulb: Le format de citation est souvent utilisé pour citer des textes, des créations ou d’autres contenus provenant d’autres sources.

:bulb: L’effet visuel des blocs de citation permet de présenter le contenu cité de manière plus saillante, permettant aux lecteurs de distinguer facilement quelles parties du texte sont citées et quelles parties sont écrites par l’auteur, le tout en un coup d’œil.



Citation de contenu de forum

Lorsque vous souhaitez citer un passage d’un article de forum, vous pouvez utiliser la méthode de citation suivante.
Résultat :

Comment l’utiliser :
Sélectionnez le texte que vous souhaitez citer. Un bouton « Citer » apparaîtra. Cliquez dessus, et l’éditeur s’ouvrira automatiquement, générant automatiquement le format de citation de ce texte.

:bulb: Lorsque vous citez/répondez à un passage d’un article, cette citation permet aux autres lecteurs du forum de savoir clairement à quelle phrase de quel auteur vous citez/répondez, et leur permet de consulter le contexte du contenu cité. Cela rend la discussion claire.



Ligne de séparation

Tapez trois tirets - sur une ligne vide pour générer une ligne de séparation.
Entrée :

---

Résultat : Il y a une ligne de séparation au-dessus de chaque titre de cet article !

:bulb: La ligne au-dessus de la ligne de séparation doit être une ligne vide, sinon certains effets étranges peuvent apparaître (essayez par vous-même).



Lignes vides multiples

Parfois, vous souhaitez laisser plusieurs lignes vides entre deux paragraphes ? Ici, c’est un peu contre-intuitif : si votre entrée contient plusieurs lignes vides, l’affichage ne montrera qu’une seule ligne vide au maximum. Dans ce cas, si vous souhaitez ajouter de manière forcée plusieurs lignes vides, vous devez entrer le caractère spécial <br> dans la ligne vide, comme dans l’exemple suivant.
Entrée :

Le contenu ci-dessus, séparé par deux lignes vides du contenu ci-dessous
<br>
<br>
Le contenu ci-dessous, séparé par deux lignes vides du contenu ci-dessus

Résultat :
Le contenu ci-dessus, séparé par deux lignes vides du contenu ci-dessous




Le contenu ci-dessous, séparé par deux lignes vides du contenu ci-dessus



Notes de bas de page

Il existe deux formes de notes de bas de page :
Notes de bas de page en ligne
Entrée :

Une phrase à commenter ^[Contenu de la note]
Une autre phrase à commenter ^[Une autre note]

Résultat :

Une phrase à commenter [1]
Une autre phrase à commenter [2]

Notes de bas de page hors ligne
Entrée :

Une phrase à commenter [^1]
Une autre phrase à commenter [^2]

[^1]: Contenu de la note
[^2]: Une autre note

Résultat :



Masquer les détails

Exemple :
Masquer les détails

Utilisation :

:bulb: Lorsque votre article contient un long passage de contenu relativement secondaire, vous pouvez utiliser cette fonction pour masquer ce contenu.



Boutons pour ajouter rapidement des formats

Certains formats peuvent être ajoutés via les boutons de l’éditeur.



Plus de formats

Ce qui précède est une introduction à quelques formats plus importants. Avez-vous appris ? Explorez les autres formats par vous-même.
Si vous avez des questions, laissez un message dans la section des commentaires du forum. Je vous souhaite à tous un bon posting !

Références :


  1. Contenu de la note ↩︎

  2. Une autre note ↩︎

6 « J'aime »

Très bien, très bien :star_struck: J’attends plus de tutoriels avec impatience

2 « J'aime »

@Dotila_Li
Puis-je vous demander comment configurer le catalogue de chapitres Markdown de la barre de défilement de droite pour qu’il s’affiche ? Existe-t-il un plugin ?


1 « J'aime »

Ceci est le DiscoTOC - automatic table of contents Theme component

1 « J'aime »

Merci !
C’est super !