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 :

For example,, adds several token types: ,  ,
 * ajouter des types de balises standards : l'approche classique du marquage MediaWiki personnalisé est d'ajouter de nouvelles balises 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és : 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 de texte wiki 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. Although any "template name" can be used, custom extensions always begin the function name with a #, as in the example above. Other parser function names are reserved for use by the MediaWiki core. When  is implemented as a parser function, it passes its template parameters to a PHP function instead of the usual template article. This function returns a string of wiki text that replaces the parameterized template. Parser functions are used to handle wiki text generation that involves logic that is too complex or confusing to write using normal template-writing techniques. 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). Instead of the usual article transclusion,  is associated with a PHP function that returns a string of wiki text that replaces it. They are usually used to insert system information into wiki markup (e.g., the current time, the current page).  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.  some text The text between the tags gets passed on to a PHP function which parses the contents of the tag and returns an HTML string that replaces the tag and text. The content inside the tags may be wiki markup, straight text, or text with formatting rules specific to the tag. It is up to the extension implementer. Please check documentation of individual extensions.
 * : * 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.
 * : * extensions de variables : les extensions de variables étendent le traitement des modèles sans paramètres.
 * : * 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 ....
 * : * extensions de syntaxe étendue : les extensions de syntaxe étendue, qui sont dans la plupart des cas des extensions de Mots Magiques, ajoutent à la liste des mots magiques de MediaWiki, des éléments comme . Habituellement, une fonction PHP spécifique interprète ces mots, et soit les remplace avec autre chose, soit initialise certaines conditions pour un traitement ultérieur lors de la génération de la sortie, ou même fait les deux. Dans la plupart des cas, le remplacement est une chaîne vide; ce qui signifie que le mot magique est supprimé, et rien n'est affiché à sa place. Le traitement modifié peut impliquer l'addition d'un morceau supplémentaire de CSS, ou la suppression des paramètres de préférence utilisateur pendant la génération de la page, et peut pratiquement être tout ce que vous voulez. 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.