Le BBCode est une implémentation spéciale du HTML. L'activation de l'utilisation du BBCode est déterminée par l'administrateur. En outre, vous pouvez désactiver le BBCode dans un message lors de sa composition. Le BBCode en lui-même est similaire au style du HTML; les balises sont contenues dans des crochets [ et ] à la place de < et >, et offrent un meilleur contrôle sur la manière dont quelque chose doit être affiché. Selon le modèle de document que vous utilisez, vous pourrez facilement rajouter du BBCode à vos messages à travers une interface de boutons cliquables au-dessus de la zone de texte lors de la composition de votre message. Toutefois, le guide qui suit pourra vous être utile.
Pour changer la couleur ou la taille de votre texte, les balises suivantes peuvent êtres utilisées. Ayez en tête que le rendement du texte dépendra de votre navigateur internet et de votre système d'exploitation :
Le changement de la couleur du texte se réalise en le plaçant dans [color=][/color]. Vous pouvez spécifier soit un nom de couleur reconnu (exemple : red, blue, yellow, etc.), ou soit un code couleur hexadecimal, exemple : #FFFFFF, #000000. Par exemple, pour créer du texte en rouge, vous pouvez utiliser :
[color=red]Salut ![/color]
ou
[color=#FF0000]Salut ![/color]
donneront tous deux Salut !
Le changement de la taille de votre texte se réalise de la même manière que pour la couleur en utilisant [size=][/size]. Cette balise est dépendante du modèle de document que vous utilisez, mais le format recommandé est une valeur numérique représentant la taille du texte en pixels, de 1 (tellement petit que vous le verrez pas) jusqu'à 29 (très grand). Par exemple :
Oui, bien sûr que vous pouvez, par exemple pour attirer l'attention de quelqu'un, vous devriez écrire :
[size=18][color=red][b]REGARDEZ MOI ![/b][/color][/size]
devrait donner REGARDEZ MOI !
Néanmoins, nous ne vous recommandons pas d'écrire beaucoup de texte comme ci-dessus ! Rappelez-vous que c'est à vous de vous assurer de fermer les balises correctement. Par exemple, ce qui suit est incorrect :
Il y a deux méthodes pour citer un texte, avec ou sans référence.
Lorsque vous utilisez la fonction Citer pour répondre à un message sur le forum, vous avez sûrement remarqué que le texte en citation est ajouté dans la zone de texte entre [quote=""] et [/quote]. Cette méthode vous permet de citer avec une référence à une personne ou tout autre chose que vous aurez choisi de mettre ! Par exemple, pour citer un texte écrit par M. Dupont, vous devrez entrer :
[quote="M. Dupont"]Le texte écrit par M. Dupont devra être placé ici[/quote]
Cela ajoutera automatiquement, M. Dupont a écrit : avant votre texte. Rappelez-vous que vous devez inclure les guillemets "" autour de la référence que vous citez, ils ne sont pas optionnels.
La seconde méthode vous permet de citer quelque chose sans faire référence à l'auteur. Pour l'utiliser, placez le texte entre les balises [quote] et [/quote]. Lorsque vous lirez votre message, il montrera simplement Citation : avant votre texte.
Si vous voulez afficher des lignes de code ou toute chose qui nécessite une police à pas fixe, exemple : Police Courrier, vous devez placer le texte ou code dans les balises [code][/code], exemple :
[code]echo "Ceci est du code";[/code]
Toute mise en forme utilisée dans les balises [code][/code] sera appliquée.
Le BBCode supporte deux types de listes : les listes non-ordonnées et les listes ordonnées. Elles sont essentiellement identiques à leurs équivalents en HTML. Une liste non-ordonnée produit une liste dont les entrées sont les unes en-dessous des autres et indentées avec une puce. Pour créer une liste non-ordonnée, utilisez [list][/list] et définissez chaque entrée à l'intérieur de la liste en utilisant [*]. Par exemple, pour établir une liste de vos couleurs favorites, vous pouvez utiliser :
Le second type de liste vous donne le contrôle sur ce qui va être affiché avant chaque entrée. Pour créer une liste ordonnée, vous devez utiliser [list=1][/list] pour créer une liste numérotée ou alternativement [list=a][/list] pour une liste alphabétique. Comme pour les listes non-ordonnées, les entrées sont spécifiées en utilisant [*]. Par exemple :
[list=1] [*]Faire les magasins [*]Acheter un nouvel ordinateur [*]Injurier son ordinateur lorsqu'il plante [/list]
donnera ce qui suit :
Faire les magasins
Acheter un nouvel ordinateur
Injurier son ordinateur lorsqu'il plante
Alors que pour une liste alphabétique, vous devez utiliser :
[list=a] [*]La première réponse possible [*]La seconde réponse possible [*]La troisième réponse possible [/list]
Le BBCode de phpBB supporte plusieurs méthodes pour créer des liens, plus connus sous le sigle URLs.
La première méthode utilise les balises [url=][/url]; tout ce que vous taperez après le signe = sera considéré comme le nom du lien. Par exemple, pour créer un lien vers phpBB.com vous devez utiliser :
[url=http://www.phpbb.com/]Visitez phpBB ![/url]
Ceci générera le lien suivant : Visitez phpBB ! Vous remarquerez que le lien ouvre une nouvelle fenêtre; l'utilisateur peut donc continuer à parcourir les forums s'il le souhaite.
Si vous voulez que le lien affiche directement l'URL, vous devez simplement utiliser :
De plus, phpBB possède une fonctionnalité appelé Magic Links; celle-ci convertira automatiquement une URL en un lien cliquable sans que vous ayez à insérer une balise BBCode ou http://. Par exemple, en tapant www.phpbb.com dans votre message, celui-ci sera automatiquement convertit en www.phpbb.com lorsque vous le lirez.
La même chose s'applique aux adresses e-mail; vous pouvez soit spécifier une adresse e-mail explicitement, par exemple :
[email]personne@domaine.com[/email]
qui donnera no.one@domain.adr, ou soit en tapant personne@domaine.com dans votre message et sera automatiquement convertit lorsque vous le lirez.
Comme pour toutes les balises BBCode, encadrez tout autre balise comme [img][/img] (reportez-vous à la partie suivante), [b][/b], etc. Comme pour les balises de mise en forme, c'est à vous de vous assurer que l'ordre des balises d'ouverture et de fermeture est correct, par exemple :
Le BBCode de phpBB inclut une balise pour incorporer des images à vos messages. Deux points importants à retenir lors de l'utilisation de cette balise sont que premièrement, beaucoup d'utilisateurs n'apprécient guères un trop plein d'images dans un message et que secondement, l'image que vous voulez afficher doit déjà être disponible sur internet (elle ne peut pas seulement exister sur votre ordinateur par exemple, à moins que votre ordinateur soit lui-même un serveur internet !). Il n'y a actuellement aucun moyen de stocker localement des images avec phpBB (ce problème sera traité dans la prochaine version de phpBB). Pour afficher une image, vous devez encadrer l'URL qui pointe vers l'image avec les balises [img][/img]. Par exemple :
Non, je crains que cela soit impossible directement dans phpBB 2.0. Nous offrirons la possibilité de personnaliser les balises BBCode dans la prochaine version majeure.
