Principales balises BBCode

PHPBoost gère la mise en forme des messages du forum, articles, commentaires, etc... avec un "langage" simplifié. En effet, qui n'a jamais entendu parler du BBCode ? C'est un langage inventé, qui permet de faciliter la mise en forme d'un message et qui permet entre autres de mettre du texte en gras, de le souligner, de faire un lien ou bien d'autres choses encore. Il permet à des utilisateurs ne connaissant pas du tout le html de formater leurs messages.
Niveau fonctionnement, pour ceux qui sont intéressés, des expressions régulières reconnaissent les balises BBCode et remplacent ce langage à balises à crochets [] par les balises XHTML et CSS correspondantes.
Nous allons voir par l'intermédiaire de cet article comment mettre en forme un message, valable sur toutes les pages de PHPBoost contenant l'éditeur de texte.
Veillez à bien respecter un ordre d'ouverture et de fermeture des balises lorsque vous les imbriquez l'une dans l'autre :

Code :

[b][i]Texte[/b][/i]
est à proscrire et à remplacer par :
[b][i]Texte[/i][/b]

Effectivement vous allez me dire : "mais ça marche aussi!".
Certes, mais cela n'est absolument pas bon pour les navigateurs et la page ne sera plus compatible au standard du W3C.
Veillez aussi à ne pas intercaler d'espaces à l'intérieur des crochets [] qui correspondent à la balise, cela empêcherait tout simplement le fonctionnement de la mise en forme.

Smileys

Pour égayer vos messages, rien de mieux que d'y insérer quelques smileys histoire d'illustrer des réactions récurrentes.
Pour cela vous devez placer le curseur à l'endroit où vous voulez insérer le smiley, à l'intérieur de la zone de texte. Ensuite vous cliquez sur le bouton dans la barre BBCode pour afficher la collection de smileys disponibles (une vingtaine d'origine plus ceux éventuellement rajoutés) et cliquez sur le smiley qui vous intéresse.
Un code va donc s'afficher à l'endroit où vous aviez placé le curseur.
Et oui, vous l'aurez compris, le smiley ne s'insère pas directement mais cela ajoute un "code smiley" qui est propre à chaque motif choisi, qui sera remplacé par le smiley à l'affichage du message.
Vous pourrez donc au bout d'un certain temps et avec de l'habitude ne plus avoir à cliquer sur le bouton smiley car vous aurez retenu les codes correspondants. D'ailleurs pourquoi des caractères si bizarres ?
Effectivement les caractères correspondant aux smileys peuvent être compliqués mais pour cela on a une explication évidente. Par exemple pour le smiley sourire si le code était sourire, dès que le mot sourire apparaîtrait dans le message il serait remplacé par le smiley correspondant.
Et puis pour allez encore plus loin vous allez remarquer quelque chose si ce n'est pas déjà fait.
Par exemple justement le smiley sourire
Son code est :

Et bien faites faire un quart de tour dans le sens horaire et vous verrez vite qu'il forme un visage souriant (avec les deux points : les yeux, et la parenthèse : la bouche).
Vous pouvez faire ça avec beaucoup de smileys classiques comme le clin d'œil par exemple.

Mise en forme du texte

Vous vous demandez comment j'ai mis en page cet article ? Simplement, grâce au BBCode ! En effet le BBCode dérive du HTML par sa syntaxe.

Mises en forme de base : gras, italique, souligné et barré

Pour mettre un texte en gras vous n'aurez qu'à l'encadrer par la balise b comme le montre cet exemple :

Cet exemple affichera:
Texte en gras
Pour l'insérer plus facilement vous pouvez sélectionner le texte que vous voulez mettre en gras et vous cliquez sur , il s'entourera automatiquement des bonnes balises.
Vous pouvez faire de même avec les balises i, u, s qui correspondent à :

• i : italique ()
• u : souligné ()
• s : barré ()

Mais pourquoi des lettres b, i et u ?
A cause de l'anglais tout simplement !
b est l'initiale de "bold" qui signifie "gras", i pour "italic", et u pour "underline" ou "souligné" en français.

Taille du texte

Pour modifier ces propriétés, le principe est le même. On va encadrer le texte désiré par d'autres balises. L'icône de la balise est :

Cet exemple affichera :
<span style="font-size: 25;">Texte</span>
La balise size, admet en argument un chiffre entre 0 et 49
Quelques exemples :
<span style="font-size: 5;">Taille 5</span>
<span style="font-size: 9;">Taille 9</span>
<span style="font-size: 25;">Taille 25</span>
<span style="font-size: 35;">Taille 35</span>
<span style="font-size: 49;">Taille 49</span>
[size=50]Taille 50[/size] Celle la ne marche pas comme prévu.

Couleur

L'icône de la balise est :
Dans color vous mettrez la couleur du texte (en anglais pour les principales couleurs, ou alors en hexadécimal pour les connaisseurs). Liste des couleurs disponibles: red, green, blue, yellow, purple, olive, black, white, grey etc.

Cet exemple affichera :
<span style="font-size: 25;">Texte</span>
<span style="font-size: 25;">Texte</span>

Alignement

Pour l'alignement d'un texte le principe est encore une fois le même. En utilisant les boutons gauche, centré, droite et justifié, vous pourrez aligner le texte qui sera entouré des balises où vous voudrez dans la page.
Les icônes de la balise sont :

• gauche :
• centré :
• droite :
• justifié:

Cet exemple affichera :

Exemple de texte aligné à droite

Élément flottant

Nous avons déjà vu la balise align, elle permet de positionner des éléments.
L'avantage de la balise float c'est qu'elle permet de mettre plusieurs éléments à la même hauteur, par exemple si on veut insérer une image sur la droite, si on lui demande de se positionner à droite par la balise float le texte ne viendra pas se mettre sur l'image mais il l'entourera.
A noter qu'il est possible de faire flotter à droite ou à gauche mais pas au centre.
Les icônes de la balise sont :

• gauche :
• droite :

Cet exemple affichera :

Élément flottant à droite

Les titres

L'icône de la balise est :
La balise title sert à créer des titres. Sélectionnez votre texte à mettre en titre, cliquez sur l'icône et choisissez le niveau de titre.

Cet exemple affichera :

titre 1

titre 2

titre 3

titre 4

Les conteneurs

L'icône de la balise est :
et on y trouve les outils suivants:

La balise Paragraphe permet de mieux mettre en forme un contenu. Votre texte encadré par cette balise sera suivi d'un saut de ligne.

Cela affichera :

Paragraphe

Mise en forme du contenu

Les balises block et fieldset servent à créer un cadre autour d'un texte. Sélectionnez votre texte à encadrer, cliquez sur l'icône et choisissez le type de cadre.

Cet exemple affichera :

Ce texte est aussi un texte encadré.

A noter que la balise fieldset peut aussi s'utiliser avec l'attribut "legend" pour mettre un titre:

Cet exemple affichera :

titre

Ce texte est encadré avec un titre.

La balise Abréviation permettra d'utiliser des abréviations comme cet exemple:
qui affichera ceci: prog.

Les styles

L'icône de la balise est :
Les styles de texte permettent de bien mettre en évidence une zone de texte sous forme de question, remarque, attention et erreur. La balise utilisée est style.
Voici comme exemple les 4 styles disponibles :

Cet exemple affichera :
question
remarque
attention
erreur

Les balises fa (Font Awesome)

Dans la documentation, il faut souvent désigner un outil en faisant référence à sa représentation en tant qu'icone.
Les icones les plus utilisés ont été regroupés dans un tableau :

Un simple clic sur un symbole le placera dans votre texte.
Pour en savoir plus sur les icones Font Awesome, veuillez consulter La bibliothèque Font Awesome.

Autres balises utiles

Liens

L'icône de la balise est :
Pour faire un lien vers une page web quelconque, vous devez suivre la démarche suivante. Vous devez d'abord insérer la balise lien qui est url. Vous mettez le texte ou l'image qui serviront de support pour le lien. Ensuite vous revenez à l'ouverture de la balise url et vous remplacez url par url=votre page.
Voici un exemple :

Cet exemple affichera :
PHPBoost
https://www.phpboost.com
Lors du clic sur l'icône de la balise, l'adresse du lien vous est demandée et le curseur est positionné automatiquement pour ajouter le texte du lien.

Insérer un lien vers un article

Cette balise est une spécificité des modules pages et wiki. Le lien vous redirigera vers l'article concerné.

• Pour le module Pages, consultez cet article.
• Pour le module Wiki, un raccourci dans la barre BBCode permet d'insérer un lien de la même manière :
  

Si vous souhaitez faire pointer votre lien vers un paragraphe d'une page, mettez dans votre balise : ou copiez l'adresse dans la barre de navigation puis collez-la dans votre balise.
Exemple :

Images

L'icône de la balise est :
L'ajout d'image permet d'expliquer un problème, montrer des créations graphiques, images drôles/intéressantes, etc...
Pour cela vous pouvez insérer une image en spécifiant son adresse internet dans les balises img.
Voici un exemple :

Cet exemple affichera :

Combinons avec ce que nous avons appris avant, nous allons centrer l'image :

Cet exemple affichera :

Il est également possible de fixer les propriétés de style de l'image (la largeur ou la hauteur par exemple) directement dans la balise. Exemple avec une largeur à 30% :

Vous savez donc maintenant ajouter des images à vos messages.
Pour écrire sur une image, il vous suffit de faire cela :

est l'élément où vous devriez mettre le lien de l'image
et la largeur.
la hauteur.
est le texte qui sera par dessus l'image.

Lightbox

L'icône de la balise est :
Cette balise permet d'ajouter un effet sur une image. Elle permet d'afficher la miniature d'une image dans un texte et de l'afficher en taille réelle lorsqu'on clique dessus.
Voici un exemple :

Cet exemple affichera :

Lors du clic sur l'icône de la balise, l'adresse de l'image en taille réelle vous est demandée et le curseur est positionné automatiquement pour ajouter l'image miniature (avec la balise img décrite au paragraphe précédent) ou le texte à afficher.

Texte caché

L'icône de la balise est :
La balise hide permet d'afficher une zone de texte caché. Il suffit de cliquer dessus pour afficher le contenu. Elle peut être utilisée pour un article de questionnaire donnant ainsi la réponse à la question.
Exemple :

Cet exemple affichera :

La balise peut être refermée en cliquant sur : Cliquer ici pour cacher le message.

Balises member et moderator

Pour utiliser ces balises, cliquez sur l'icône hide de la barre d'outils du BBCode, une liste déroulante affichera alors les balises Membre et Modérateur.
Ces balises permettent de cacher du contenu et de réserver son accès soit aux membres soit aux modérateurs.
Exemple avec la balise member:
[member]Contenu de la balise membre[/member]
Cela affichera :
Message destiné aux membres
Seuls les membres, les modérateurs et les administrateurs auront accès à "Contenu de la balise membre".
Exemple avec la balise moderator:
[moderator]Contenu de la balise modérateur[/moderator]
Cela affichera :
Message destiné aux modérateurs
Seuls les modérateurs et les administrateurs auront accès à "Contenu de la balise modérateur".
Retrouvez dans cet article la façon de personnaliser ces messages.

Citation

L'icône de la balise est :
La balise quote (citation en anglais) est souvent utilisée pour citer le message d'un autre membre, mais peut avoir d'autres utilisations très pratiques.

Version 5.2

Quand vous insérez une citation, une petite fenêtre apparaît pour vous permettre d'indiquer le nom de l'auteur d'une citation :

Autres versions

Elle peut être utilisée simplement pour citer un texte :

Cet exemple affichera :

Citation :

Texte sans auteur particulier à citer

Maintenant, vous pouvez citer l'auteur du message (ça ne doit pas forcément être le pseudo d'un membre, ça peut être le nom d'un site ou d'un auteur...)

Cet exemple affichera :

CrowkaiT :

Message dont l'auteur est CrowkaiT

Tableaux

Veuillez consulter le lien suivant pour plus de détails :
Insérer des tableaux

Listes

Veuillez consulter le lien suivant pour plus de détails :
Insérer des listes

Insérer du code

Pour afficher du BBCode sans qu'il soit interprété comme par exemple plus haut dans cet article (tous les autres langages y compris le HTML sont bloqués par mesure de sécurité), il faut utiliser la balise BBCode nommée code. Le code ne sera pas interprété, et il sera coloré si le langage est supporté et reconnu par le colorateur syntaxique.
L'icône de la balise est :
Voici un exemple:

L'option " Copier vers le presse-papier" permet d'éviter de sélectionner tout le code pour le copier. Cet outil n'est disponible que si vous avez inséré au moins une balise dans le contenu de votre document.

Préciser le type de code inséré

En précisant le type de code que l'on veut colorer, on met toutes les chances de notre côté pour que l'interpréteur syntaxique gère au mieux la couleur.
Dans le menu déroulant de la balise, choisissez le type de code que vous souhaitez afficher.
Exemple :
Si c'est du code php, l'on peut mettre directement :

Cet exemple affichera :

Vous avez la possibilité de personnaliser l'affichage de la balise en reprenant le nom du fichier d'où provient le code inséré.
Si votre code est issu du fichier design.css, renseignez la balise comme ceci:

Le résultat :

Afficher les lignes

Pour insérer les numéros de ligne à côté du code, il va falloir insérer un argument supplémentaire dans la balise BBCode.
Procéder comme suit :

Cet exemple affichera :

Multimédia

Vidéos

L'icône de la balise est :
La balise movie est maintenant compatible avec le lecteur HTML5 en vue de remplacer le lecteur Flash player dont l'arrêt est annoncé. Cette balise lit les formats MP4, WebM, et Ogg. La balise swf reste en place pour assurer la compatibilité avec les vidéos existantes.
La balise movie fonctionne de la même manière que la balise flash swf mais vous ne pouvez intégrer que des fichiers physiques.
Exemple :

Vous pouvez aussi ajouter un "poster" à votre vidéo. L'image sera affichée avant la lecture.

Youtube

L'icône de la balise est :
Vous pouvez insérer très facilement des vidéos youtube à l'aide de cette balise.
Lorsque vous avez choisi votre vidéo sur le site youtube, copiez l'adresse de cette dernière de votre navigateur internet.
Il suffit maintenant de l'insérer entre la balise youtube.
Exemple :

Vous pouvez modifier la taille de votre vidéo en rajoutant la largeur et la hauteur souhaitées : [youtube=largeur,hauteur].
Exemple :

Résultat centré:

Flash

L'icône de la balise est :
La balise flash swf permet d'intégrer des animations flash directement dans PHPBoost, celle-ci peut prendre deux arguments : largeur et hauteur.

Exemple :

Pour savoir comment utiliser la balise flash pour insérer des vidéos, merci de lire l'article approprié.

Son

L'icône de la balise est :
Vous pouvez bien sur insérer du son sur phpboost. La balise utilisée est sound.
Il faut cependant noter que le lecteur lit uniquement les fichiers .mp3. De plus la lecture optimale se fait pour les fichiers encodés à 44,100kHz. Dans les autres cas, la lecture ne se fera pas normalement.
Exemple :

Cet exemple affichera :

<span style="font-size: 10;">Source: Musique composée par Kak Miortvi Pengvin. Fichier distribué sous licence Creative Commons BY-NC-ND 2.0.
</span>

Insérer des expressions mathématiques

L'icône de la balise est :
La balise math permet d'insérer des expressions mathématiques. Vous trouverez tous les détails sur l'article approprié (explication et démonstration).

Ancres

Qu'est-ce qu'une ancre?

Une ancre permet de définir des lieux dans la page. Elle permet de faire en sorte de se rendre directement sur l'endroit recherché dans la page (voir par exemple les liens du sommaire de cette page, ils mènent directement au paragraphe concerné).
L'icône de la balise est :

Créer une ancre

Pour définir une ancre, il faut définir la syntaxe suivante à l'endroit du texte vers lequel vous souhaitez pointer directement:

Le nom de votre ancre sera réécrite en minuscule avec tirets même si vous l'écrivez en majuscule.

Faire pointer un lien vers une ancre

Pour créer un lien vers un endroit précis de la page, il faut mettre avant tout l'adresse de la page, puis mettre un dièse et le nom de l'ancre précédemment définie.
Nous utiliserons par exemple (uniquement pour les modules Pages et Wiki):

Cet exemple affichera : Créer des ancres en BBCode sur PHPBoost

Pour les autres modules, c'est la balise [url] [/url] qui devra être utilisée à la place de la balise [link]

Flux RSS

Depuis la 4.0, il est possible d'ajouter un flux RSS interne au site via le BBCode.
Il faut utiliser cette balise :

Vous avez la possibilité de personnaliser l'affichage :

• cat="numéro de la catégorie du flux dans le module"
  Pour connaître le numéro de la catégorie du flux, allez dans le module souhaité, allez dans la catégorie souhaitée et cliquez sur cette icone , vous allez être redirigé vers une page avec ce type d'adresse : /syndication/rss/forum/4
  Cela correspond au module forum et la catégorie est la n° 4.
  Si vous souhaitez afficher tous les flux d'un module, dans ce cas ne mettez pas cat"x"
• number="nombre de flux à afficher"
  

Exemple pour afficher les 5 derniers flux du module téléchargement de la catégorie 3 :