*************************
* BBCode parser v0.1    *
*************************
* LAlex 2003            *
* lalex@lalex.com       *
* http://www.lalex.com/ *
*************************

****************
* INSTRUCTIONS *
****************

Avant tout appel de la fontion 'render', il faut importer un fichier XML contenant les informations de traduction des tags BBCode vers une mise en forme (HTML ou autre) au moyen de l'instruction getBBTags(<nom du fichier>).

Le fichier XML doit être encodé avec la norme UTF-8 et il est structuré de la facon suivante :

Tag d'ouverture du fichier : < bbcode >
 |
 | >> Partie à répéter pour la definition de plusieurs BBCode
 |
 | Tag de description d'un BBCode : < tag name="<nom du tag>" >
 |  |   
 |  | * Options du tag :
 |  |    - close="no" : Le tag n'a pas besoin d'avoir un tag de fermeture.
 |  |    - render="no" : Les bbcode contenus dans ce tag ne seront pas interprétés.
 |  |    - param="yes" : Le tag d'ouverture doit avoir un paramètre sous la forme [<nom du tag>=<valeur du parametre>].
 |  |    - keepvalue="no" : Le texte contenu dans ce tag ne sera pas réinséré entre la valeur de début et la valeur de fin de la mise en forme.
 |  |    - function="<nomDeFonction>" : Un nom de fonction qui prend une chaine de caractères en paramètre et en retourne une. Le texte contenu dans le tag sera évalué par cette fonction. Cette fonction doit exister à l'appel de la fonction 'render'.
 |  |
 |  | Tag de début de la mise en forme : < begin > Mise en forme à insérer avant le contenu du tag < /begin >
 |  |
 |  | Tag de fin de la mise en forme : < finish > Mise en forme à insérer après le contenu du tag < /finish >
 |  |
 | Tag de fermeture de la description d'un BBCode : < /tag >
 |
 | >> Fin de la partie à répéter
 |
Tag de fermeture du fichier : < /bbcode >

Pour utiliser des balises HTML (avec < et >) dans vos mises en formes, vous pouvez utiliser un tag <![CDATA[<votre mise en forme]]> a l'interieur des tags <begin> et <finish>.
Un fichier d'exemple 'bbcode.xml' est fourni avec cette distribution.

***********
* CREDITS *
***********

Le terme BBCode est la propriété de phpBB : http://www.phpBB.com/

Ce code est protégé par les lois sur la propriété intellectuelle et ne peut être vendu ni utilisé a des fins commerciales.
Il peut être redistribué gratuitement en comportant ce même fichier, ainsi que les références de son auteur, et toute modification lors de sa diffusion doit être signalée dans l'entête du code et/ou dans le fichier 'lisezmoi.txt' fourni avec.

Soyez gentil de m'envoyer un ch'tit mail si vous utilisez ce code avec l'URL du site sur lequel il tourne.
Si en plus vous pouvez faire une lien sur mon site, c'est le bonheur !!!
Merci d'avance !