Table des matières

Utilisation des balises BBCode et de la coloration syntaxique sur le forum

Introduction

Pour poser une question ou y répondre sur le forum, il est important de suivre ces règles basiques :

Le forum propose également des outils (voir les boutons de l'image ci-dessous) pour la mise en forme des message.

Lors de la rédaction d'un message il est souvent utile de le mettre en forme pour en faciliter la lecture par les visiteurs.

On distinguera:


Utilisation

Pour mettre en forme le message, on peut utiliser les boutons. Il suffit de sélectionner le texte et de lui ajouter la balise adéquat en cliquant dessus.

On peut également utiliser directement les balises dans le texte. Il suffit de respecter cette syntaxe: 

[balise]mon texte[/balise]

Mise en forme

  1. Pour commencer, on rédige simplement son message brut de coffrage, c'est à dire sans fioriture.
  2. Et ensuite on ajoute la mise en forme.

Rien de compliqué, il suffit de surligner les mots en les sélectionnant avec la souris et de leurs appliquer la mise en forme choisis par les boutons en haut du post.
Idem pour les liens et les images.

Pour résumer l'utilisation des boutons:

Bouton Description Résultat Balise
B pour mettre en gras (en anglais bold) Gras [b]Gras[/b]
I pour mettre en italique Italique [i]Italique[/i]
U pour souligner (en anglais underline) Souligné [u]Souligné[/u]
S pour barrer (en anglais strike) Barré [s]Barré[/s]

Un petit exemple sur l'utilisation des boutons :

En manipulant les boutons de mise en forme ainsi :

Le message apparaîtra tout beau après validation comme ça :

Avant de publier le message (mis en forme ou non), prenez le temps de le prévisualiser en cliquant sur le bouton… Prévisualisation. ;-)

Citations

On peut également reprendre le message précédent ou ajouter des citations.

Bouton Description Balise
Citation pour ajouter une citation [quote]Citation[/quote]
Citation pour ajouter une citation avec son auteur [quote=nIQnutn]Citation[/quote]

On peut utiliser le bouton Citer pour reprendre le message précédent.

Le résultat:

Ne citer que la partie importante du message et supprimer le reste.

Sinon, on utilise le bouton Citation et on recopie le contenu à la main.

Le résultat:

Commande utilisateur et root

Il nous reste à voir la mise en forme des Codes.

Concernant les commandes écrites dans un terminal, il y a deux boutons :

Quand on utilise les balises Commande on aura automatiquement une seconde balise Code pour le retour du terminal (c'est ce qui s'affiche après l'exécution du terminal). On fera bien la différence entre la commande qui sera exécutée et ce qui nous sera retourné par le système (qui sera inséré dans la balise Code).

Bouton Description Balise
Commande utilisateur pour ajouter une commande utilisateur [code=user]man debian-facile[/code]
Commande root pour ajouter une commande root [code=root]apt install debian-facile[/code]

Le résultat :

On prendra soin de supprimer les blocs de retour de commande automatiques (codes et contenu) lorsque la commande n'en renvoie pas.
Blocs d'ailleurs judicieusement indiqués par le texte qu'ils contiennent : « bloc à supprimer si la commande n’affiche rien. »

Sacré captnfab Comment qu'y pense pour nous tout d'mêm' ! :-D

Code

Le code doit être intégré dans les balises codes.

Si le langage du code utilisé est présent dans la liste déroulante du bouton Code (par exemple apt_sources pour baliser la liste des sources) sélectionnez cette balise spécifique dans la liste déroulante des balises qui apparaît pour aider à rendre le contenu du code plus compréhensibles.

Bouton Description Résultat Balise
Code pour ajouter du code en utilisant la coloration syntaxique [code=html5]<p>Debian Facile</p>[/code]
Autre code pour ajouter du code [code]debian-facile[/code]

Si vous hésitez, êtes naufragés ou si ce langage n'y est pas, utilisez alors la balise simple du bouton Autre code. 8-)

Résultat :

N'insérez que le code qui est vraiment utile pour ne pas encombrer la discussion.

Aller plus loin

Syntaxe et balise

Il est nécessaire de respecter une syntaxe précise pour utiliser les balises.

Il faut également faire attention quand on utilise plusieurs balises et qu'elles s'imbriquent entre elles.

On ferme toujours la balise la plus “proche” 

 [i][url=http://wiki.debian-facile.org/atelier:resolu]Voir le tuto : C'est résolu ! Bravo mais il faut l'indiquer dans l'titre.[/url][/i]

et pas [i][url=wiki.debian-facile.org/atelier:resolu]Voir le tuto : C'est résolu ! Bravo mais il faut l'indiquer dans l'titre.[/i]<[/url]

Annonce de correction des codes dans le forum

[b]Edit[/b] : Pour que la lecture du code sur le forum soit lisible par tous, il faut bien dissocier chaque commande hors de son retour. Modif fête. :)
[i][url=https://debian-facile.org/atelier:bbcode]Oh, quel beau BB …code où comment mettre en forme vos messages dans le fofo[/url][/i]

La Prime

Ne reculant devant aucun sacrifice, Debian-Facile offrira un point-chocolat à qui insèrera le lien suivant dans un message pour aider son prochain à bien utiliser le BBCode :-D

[i][url=https://debian-facile.org/atelier:bbcode]Oh, quel beau BB …code où comment mettre en forme vos messages dans le fofo[/url][/i]

Ressources

1)
N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !