Manual: Marcação de wiki estendida
MediaWiki fornece uma marcação de texto padrão que pode ser facilmente personalizada. As extensões podem personalizar a marcação de wiki por:
- Adding custom token types – Some extensions define new token types.
- Making fundamental changes to the parser – A few extensions attempt to fundamentally change the parsing strategy so that other markup languages can be used instead of the standard wiki markup.
Adicionar aos tipos de código padrão
The simplest way to extend wiki markup is by adding to a standard token type using one of these features.
Variáveis
A variable calls a PHP function that outputs a string of Texto Wiki (Wikitext) that replaces the variable on the page. Variables are usually used to insert system information into wiki markup, such as the current time or the current page.
Exemplo de sintaxe:
{{VARIABLENAME}}
Para definir uma variável, consulte Manual:Variables. Para uma lista de extensões que definem variáveis personalizadas, consulte Categoria: Extensões de variável.
Funções do analisador
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. Parser functions are used to handle wikitext generation that involves logic that is too complex or confusing to write using templates.
Exemplo de sintaxe:
{{#functionname: param1 | param2}}
Para definir uma função de analisador, consulte Manual: Funções do Analisador. Para uma lista de extensões que define as funções do analisador personalizado, consulte Categoria: Extensões de função do analisador.
Etiquetas do analisador
Ao contrário das variáveis e funções do analisador, que resultam em texto wiki, etiquetas de analisador de saída HTML.
Uma etiqueta de analisador é uma etiqueta XML que chama uma função PHP, analisa os conteúdos da etiqueta, e produz HTML que substitui uma etiqueta e os seus conteúdos na página.
As etiquetas de analisador também podem passar argumentos para a função PHP.
Por exemplo, <syntaxhighlight> é uma etiqueta de analisador definido por Extensão: SyntaxHighlight.
Exemplo de sintaxe:
<tagname param1name="param1value" param2name="param2value"> some text </tagname>
Para definir uma etiqueta de analisador, consulte Manual: Extensões de etiqueta. Para uma lista de extensões que define as etiquetas do analisador personalizado, consulte Categoria: Extensões de etiqueta.
Modificadores de comportamento
Um modificador de comportamento chama uma função PHP, mas, diferentemente de outros métodos de estender a marcação da wiki, os modificadores de comportamento geralmente não produzem conteúdo.
Em vez disso, eles alteram o comportamento da página ou definem uma propriedade da página.
Por exemplo, adicionar __NOTOC__ à página oculta a tabela de conteúdos.
Exemplo de sintaxe:
__SWITCHNAME__
Para definir cursor de comportamento, consulte Ajuda: Palavras Mágicas. Para uma lista de extensões que definem os cursores de comportamento personalizados, consulte Ajuda: Palavras Mágicas.
Marcação de hiperligação
Link markup customizations change the way MediaWiki interprets internal links.
Exemplo de sintaxe:
[[ ... ]]
Para uma lista de extensões que definem a marcação de hiperligação personalizada, consulte Category:Link markup extensions.
Adicionar novos tipos de código
To add new token types or to change the entire markup strategy, implementers need to add functions to one or more of the various parser and page output hooks:
- Category:ParserBeforeStrip extensions rely on the ParserBeforeStrip hook.
(removed in 1.36)
- Category:ParserBeforeInternalParse extensions rely on the ParserBeforeInternalParse hook.
- Category:OutputPageBeforeHTML extensions/pt rely on the OutputPageBeforeHTML hook.
- Category:ParserAfterTidy extensions rely on the ParserAfterTidy hook.
Consulte também Category:Extensions by hook usage.
Consultar também
- Manual: Extensões - proporciona instruções gerais para encontrar, instalar, e escrever extensões.