Manual:Extending wiki markup/fr

MediaWiki fournit un marquage standard du texte pouvant être facilement adapté. Il est possible de faire à la fois des adaptations individuelles et des adaptations globales :


 * ajouter des types de balises standards : l'approche classique du marquage MediaWiki personnalisé est d'ajouter de nouvelles marques qui ressemblent aux balises XML déjà embarquées dans MediaWiki, aux modèles , ou aux balises de liens.


 * ajouter des types de balises personnalisées : certaines extensions définissent de nouveaux types de balises. Par exemple, Extension:ParserPhase2, ajoute plusieurs types de balises : ,  , et.


 * modifier fondamentalement l'analyseur syntaxique : quelques extensions essaient de modifier fondamentalement la stratégie d'analyse afin que les balises d'autres types de wikis et la gestion de contenu puissent être (... doivent être) utilisées à la place du marquage standard.

Ajouts aux types de balises standards
Lorsque  est implémenté en tant que fonction d'analyseur, elle passe ses paramètres de modèle à une fonction PHP au lieu de les passer à l'article de modèle habituel. Cette fonction retourne une chaîne wiki text qui remplace le modèle paramètré. Les fonctions d'analyseur sont utilisées pour manipuler la génération du texte wiki nécessitant une logique trop complexe ou trop confuse pour être codée à l'aide des techniques d'écriture habituelle des modèles.
 * Les extensions des fonctions d'analyse: les extensions des fonctions d'analyse étendent le traitement des modèles paramétrés et typiquement ressemblent à ceci : .  Bien qu'aucun "nom de modèle" ne puisse être utilisé, les extensions personnalisées se trouvent toujours devant le nom de la fonction avec un #, comme dans l'exemple ci-dessus. Les autres noms des fonctions de l'analyseur sont réservés pour l'utilisation par le coeur de MediaWiki.

A la place de la transclusion habituelle d'article,  est associé à une fonction PHP qui retourne une chaîne de texte wiki qui le remplace. Ceci est habituellement utilisé pour injecter des informations système dans le marquage wiki (par exemple, l'heure actuelle ou la page courante).
 * Les extensions de variables : les extensions de variables étendent le traitement des modèles sans paramètres.

 texte quelconque Le texte entre les balises est passé à une fonction PHP qui analyse le contenu de la balise et retourne une chaîne HTML qui remplace la balise et son texte. Le contenu à l'intérieur des balises peut être du marquage wiki, du texte brut ou formaté selon les règles imposées par la balise. Cela dépend de celui qui implémente l'extension. Veuillez lire la documentation propre à chaque extension.
 * extensions du marquage XML : les extensions du marquage XML (appelées aussi extensions de balises) définissent des balises personnalisées dans le style XML à l'intérieur du texte wiki :


 * extension de marquage des liens : les extensions de marquage des liens modifient la manière dont MediaWiki interprète les liens internes, par exemple le marquage wiki du type ....


 * Extended syntax extensions: Extended syntax extensions, mostly Magic Word extensions, add to the list of MediaWiki Magic Words, such as . Usually, a specific PHP function interprets these words, and either replaces them with something, or sets some conditions for later processing during output generation, or both. Most usually, the replacement is the empty string; that is, the Magic Word is deleted, and nothing is shown in its place. Altered processing may involve addition of an extra piece of CSS, or suppression of user preference settings during page generation, and can be almost anything.

Ajouter de nouveaux types de balises
Pour ajouter de nouveaux types de balises ou pour changer toute la stratégie du marquage, les développeurs doivent ajouter des fonctions à l'un ou à plusieurs des analyseurs existants et aux accroches de sortie des pages :
 * Category:ParserBeforeStrip extensions s'appuie sur l'accroche ParserBeforeStrip.


 * Category:ParserAfterStrip extensions s'appuie sur l'accroche ParserAfterStrip.


 * Category:ParserBeforeInternalParse extensions s'appuie sur l'accroche ParserBeforeInternalParse.


 * Category:OutputPageBeforeHTML extensions s'appuie sur l'accroche OutputPageBeforeHTML.


 * Category:ParserBeforeTidy extensions s'appuie sur l'accroche ParserBeforeTidy.


 * Category:ParserAfterTidy extensions s'appuie sur l'accroche ParserAfterTidy.

Voir aussi

 * - fournit les instructions générales pour trouver, installer et écrire des extensions.