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 : Extensions can customize wiki markup by:
- 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 (
<tag>
) , aux modèles ({{...}}
), ou aux balises de liens ([[...]]
). - ajouter des types de balises personnalisés : certaines extensions définissent de nouveaux types de balises.
- 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
The simplest way to extend wiki markup is by adding to a standard token type using one of these features.
Variables
A variable calls a PHP function that outputs a string of Wikitexte that replaces the variable on the page. Ceci est habituellement utilisé pour injecter des informations système dans le marquage wiki (par exemple, l'heure actuelle ou la page courante).
Syntax example:
{{VARIABLENAME}}
To define a variable, see Manual:Variables . For a list of extensions that define custom variables, see Catégorie:Extensions de variables .
Parser functions
Like variables, a parser function calls a PHP function and outputs a wikitext string that replaces the parser function on the page. Unlike variables, a parser function can pass parameters to the PHP function. 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.
Syntax example:
{{#functionname: param1 | param2}}
To define a parser function, see Fonctions d'analyse . For a list of extensions that define custom parser functions, see Catégorie:Extensions des fonctions de l'analyseur syntaxique .
Parser tags
Unlike variables and parser functions, which output wikitext, parser tags output HTML.
A parser tag is an XML tag that calls a PHP function, parses the contents of the tag, and outputs HTML that replaces the tag and its contents on the page.
Parser tags can also pass arguments to the PHP function.
For example, <syntaxhighlight>
is a parser tag defined by Extension:SyntaxHighlight .
Syntax example:
<tagname param1name="param1value" param2name="param2value"> some text </tagname>
To define a parser tag, see Extensions de balise . For a list of extensions that define custom parser tags, see Catégorie:Extensions de balises .
Behavior switches
A behavior switch calls a PHP function, but, unlike other methods of extending wiki markup, behavior switches usually do not output any content.
Instead, they change the behavior of the page or set a page property.
For example, adding __NOTOC__
to a page hides the table of contents.
Syntax example:
__SWITCHNAME__
To define a behavior switch, see Manuel:Mots Magiques . For a list of extensions that define custom behavior switches, see Aide:Mots magiques .
Link markup
Link markup customizations change the way MediaWiki interprets internal links.
Syntax example:
[[ ... ]]
For a list of extensions that define custom link markup, see Catégorie:Extension de balises de liens .
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 :
- Catégorie:Extensions liées à ParserBeforeStrip s'appuie sur l'accroche ParserBeforeStrip . (supprimé en 1.36)
- Catégorie:Extensions liées à ParserBeforeInternalParse s'appuie sur l'accroche ParserBeforeInternalParse .
- Catégorie:Extensions liées à OutputPageBeforeHTML s'appuie sur l'accroche OutputPageBeforeHTML .
- Catégorie:Extensions liées à ParserAfterTidy s'appuie sur l'accroche ParserAfterTidy .
Voir aussi
- Extensions - fournit les instructions générales pour trouver, installer et écrire des extensions.