Guide du BBCode

Introduction

Qu’est-ce que le BBCode ?
Le BBCode est une implémentation spéciale de l’HTML. Vous pouvez insérer du BBCode dans vos messages sur le forum sous réserve que cette fonctionnalité ait été autorisée par un administrateur. De plus, vous pouvez désactiver le BBCode sur chacun de vos messages par l’intermédiaire du formulaire de rédaction. Le BBCode est similaire à l’architecture de l’HTML, les balises sont contenues entre des crochets [ et ] à la place de < et >, et il offre un meilleur contrôle sur la mise en forme. Selon le template que vous utilisez, vous pouvez trouver et insérer très facilement du BBCode dans vos messages par l’intermédiaire d’une interface cliquable située juste au-dessus du formulaire de rédaction. Si ces brèves explications ne vous conviennent pas, vous pouvez consulter le guide suivant qui s’avère très explicite.
Haut

Mise en forme du texte

Comment utiliser le gras, l’italique et le souligné
Le BBCode permet de modifier rapidement la forme du texte grâce aux méthodes suivantes :
  • Encadrez le texte entre [b][/b] pour mettre en gras, exemple :

    [b]Salut[/b]

    devient Salut
  • Utilisez [u][/u] pour souligner, exemple :

    [u]Bonjour[/u]

    devient Bonjour
  • Utilisez [i][/i] pour l’italique, exemple :

    C’est [i]génial ![/i]

    donne C’est génial !
Haut

Changer la couleur et la taille du texte
Pour modifier la couleur ou la taille de votre texte, vous pouvez utiliser les balises suivantes. Gardez à l’esprit que la façon dont votre message s’affichera dépendra du navigateur et du système :
  • Vous pouvez changer la couleur d’un texte en l’encadrant entre les balises [color=][/color]. Vous pouvez indiquer un nom de couleur connu (comme : red, blue, yellow, etc.) ou bien indiquer un code hexadécimal, c.-à-d. #FFFFFF, #000000. Par exemple, pour du texte rouge :

    [color=red]Salut ![/color]

    ou

    [color=#FF0000]Salut ![/color]

    afficheront tous les deux Salut !
  • Vous pouvez changer la taille du texte de façon analogue avec les balises [size=][/size]. Cette balise dépend du thème utilisé mais le format recommandé est une valeur numérique représentant la hauteur du texte en pourcentage, à partir de 20 (tellement petit que vous ne pourrez pas le voir) jusqu’à 200 (très grand). Par exemple :

    [size=30]PETIT[/size]

    sera affiché PETIT

    alors que

    [size=200]ÉNORME ![/size]

    donnera ÉNORME !
Haut

Puis-je combiner des balises ?
Oui, bien évidemment, vous pouvez écrire pour attirer l’attention :

[size=200][color=red][b]REGARDEZ-MOI ![/b][/color][/size]

ce qui donne REGARDEZ-MOI !

Attention toutefois à ne pas en abuser ! Retenez aussi que c’est à vous, l’auteur, de vous assurer que les balises sont correctement fermées. Par exemple, ceci est incorrect :

[b][u]C’est faux ![/b][/u]
Haut

Citation et données de largeur fixe

Citer du texte dans les réponses
Il y a deux manières de citer un texte, avec ou sans référence.
  • Lorsque vous utilisez la fonction de citation pour répondre à un message sur le forum, vous pouvez noter que le texte du message est ajouté à l’intérieur d’un bloc [quote=""][/quote]. Cette méthode vous permet de citer avec une référence à une personne ou toute autre référence ! Par exemple, pour citer un texte de M. Goutte, vous mettrez :

    [quote="M. Goutte"]Le texte de M. Goutte ira ici[/quote]

    M. Goutte a écrit : sera ajouté automatiquement avant le texte. Souvenez-vous que vous devez encadrer entre "" le nom à citer, ce n’est pas optionnel.
  • La deuxième méthode vous permet de faire des citations en aveugle. Pour l’utiliser, encadrez le texte avec les balises [quote][/quote]. Lorsque vous consulterez le message, cela affichera, en fonction du thème utilisé, Citation : avant le texte lui-même.
Haut

Afficher du code ou des données à espacement fixe
Si vous désirez insérer du code ou quoi que ce soit qui nécessite une police à largeur fixe, par exemple : une police de type Courier, encadrez votre texte entre les balises [code][/code] :

[code]echo "Un peu de code" ;[/code]

Le format utilisé entre les balises [code][/code] est enregistré pour une consultation ultérieure. La syntaxe PHP peut être mise en valeur en utilisant [code=php][/code] et c’est recommandé lorsque des extraits de code PHP sont publiés afin d’en améliorer la lisibilité.
Haut

Genèse de listes

Création d’une liste non ordonnée
Le BBCode gère deux types de listes : ordonnées ou non. Elles sont les mêmes que leur équivalent HTML. Une liste non ordonnée affiche chaque élément de la liste séquentiellement l’un après l’autre, chacun indenté par une puce. Utilisez [list][/list] pour créer une liste non ordonnée et définissez chaque élément avec [*]. Par exemple, pour la liste de vos couleurs préférées, utilisez :

[list]
[*]Rouge
[*]Bleu
[*]Jaune
[/list]

Ce qui générera la liste suivante :
  • Rouge
  • Bleu
  • Jaune
Haut

Création d’une liste ordonnée
Le deuxième type de liste, la liste ordonnée, vous permet de décider de ce qui s’affiche avant chaque élément. Utilisez [list=1][/list] pour créer une liste ordonnée numérotée ou [list=a][/list] pour une liste alphabétique. Comme pour les listes non ordonnées, les éléments sont indiqués avec [*]. Par exemple :

[list=1]
[*]Faire les courses
[*]Acheter un nouvel ordinateur
[*]Jurer quand le PC plante
[/list]

affichera
  1. Faire les courses
  2. Acheter un nouvel ordinateur
  3. Jurer quand le PC plante
Alors que pour une liste alphabétique, vous utiliserez :

[list=a]
[*]Réponse 1
[*]Réponse 2
[*]Réponse 3
[/list]

et vous obtiendrez
  1. Réponse 1
  2. Réponse 2
  3. Réponse 3
Haut

Création de liens

Liens vers un autre site
Le BBCode permet de créer des URI (Indicateurs de Ressources Uniformes) ou URL de différentes façons.
  • La première est d’utiliser les balises [url=][/url], ce que vous taperez après le signe = se comportera comme une URL. Par exemple, pour un lien vers phpBB-fr.com, vous pouvez utiliser :

    [url=http://www.phpbb-fr.com/]Visitez phpBB ![/url]

    Ce qui générera le lien, Visitez phpBB ! Vous noterez que le lien s’ouvre soit dans la même fenêtre, soit dans une nouvelle fenêtre selon les préférences du navigateur.
  • Si vous désirez que l’URL elle-même soit affichée comme un lien, vous pouvez simplement utiliser :

    [url]http://www.phpbb-fr.com/[/url]

    Ce qui générera le lien, http://www.phpbb-fr.com/
  • De plus, phpBB autorise les Liens Magiques, ce qui transforme automatiquement les URL correctement écrites en lien sans indiquer de balise ou même http://. Par exemple, si vous tapez www.phpbb-fr.com, un lien www.phpbb-fr.com sera affiché automatiquement à la lecture de votre message.
  • La même chose s’applique aux adresses e-mails, vous pouvez indiquer l’adresse explicitement, comme par exemple :

    [email]personne@domain.adr[/email]

    ce qui affichera personne@domain.adr ou bien vous pouvez simplement taper personne@domain.adr dans votre message et cela sera automatiquement converti lors de la consultation.
Comme avec toutes les balises BBCode, vous pouvez encapsuler avec des URL d’autres balises telles que [img][/img] (voir l’entrée suivante), [b][/b], etc. Comme avec les balises de mise en forme, c’est à vous de vous assurer de les ouvrir et de les fermer correctement, par exemple :

[url=https://www.phpbb.com/][img]http://www.phpbb.com/theme/images/logos/blue/160x52.png[/url][/img]

n’est pas correct ce qui peut entraîner la suppression de votre message, donc faites attention.
Haut

Affichage d’images dans les messages

Ajout d’une image dans un message
Le BBCode permet d’inclure des images dans vos messages à l’aide d’une balise. Il y a deux choses importantes à se rappeler lors de l’utilisation de cette balise qui sont d’une part, que beaucoup d’utilisateurs n’apprécient pas qu’il y ait beaucoup d’images dans les messages et d’autre part, que l’image affichée doit être disponible sur Internet (elle ne peut être uniquement que sur votre ordinateur, sauf si vous avez un serveur Web !). Pour afficher une image, vous devez encadrer son URL entre des balises [img][/img]. Par exemple :

[img]https://www.phpbb.com/theme/images/logos/blue/160x52.png[/img]

Comme noté dans la section URL ci-dessus, vous pouvez entourer l’image entre des balises [url][/url] si désiré, exemple :

[url=https://www.phpbb.com/][img]https://www.phpbb.com/theme/images/logos/blue/160x52.png[/img][/url]

affichera

Haut

Ajout de pièces jointes dans un message
Les pièces jointes peuvent dès à présent être insérées dans les messages en utilisant le nouveau BBCode [attachment=][/attachment], si cette fonctionnalité a été activée par l’administrateur du forum et si vous en avez les permissions appropriées. Pour insérer des pièces jointes en ligne, un onglet à cet effet est affiché en bas de l’écran de rédaction.
Haut

Divers

Puis-je ajouter mes balises ?
Si vous êtes administrateur du forum et avez les autorisations nécessaires, vous pouvez ajouter des BBcodes supplémentaires via la section "BBcodes" dans le sous menu "Messages".
Haut