Debian-facile

Bienvenue sur Debian-Facile, site d'aide pour les nouveaux utilisateurs de Debian.

Vous n'êtes pas identifié(e).


L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT → ODT PDF Export

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

  • Objet : Utilisation des balises BBCode et de la coloration syntaxique sur le forum
  • Niveau requis :
  • Commentaires : Aide pour la mise en forme des commentaires sur le forum et explication de la syntaxe.
  • Suivi :
    • Création par nIQnutn 27/08/2015
    • Testé par <…> le <…>
  • Commentaires sur le forum : Lien vers le forum concernant ce tuto 1)

Introduction

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

  • utiliser au possible un français correct (orthographe, grammaire, ponctuation)
  • éviter les abréviations
  • soyez joyeux et polis, ça l'fera bien.

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:

  • La mise en forme du texte ( gras / italique / souligné / barré )
  • L'ajout de lien ( vers une page web / pour afficher une image )
  • Les citations
  • Les émoticônes
  • Les commandes utilisées dans le terminal
  • Le code.


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 :

  • Commande utilisateur simple,
  • Commande root.

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.

  • balise ouvrante
  • arguments
  • texte libre
  • balise fermante

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]

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 !
atelier/bbcode.txt · Dernière modification: 03/11/2016 13:15 par bendia

Pied de page des forums

Propulsé par FluxBB