Diferenças entre edições de "Ajuda:Como criar predefinições"

1 978 bytes adicionados ,  18h16min de 6 de novembro de 2008
+esboço; adaptando explicação que havia colocado na esplanada [visível na versão http://pt.wikibooks.org/w/index.php?title=Wikibooks:Staff_lounge&oldid=108391]
(formatando)
(+esboço; adaptando explicação que havia colocado na esplanada [visível na versão http://pt.wikibooks.org/w/index.php?title=Wikibooks:Staff_lounge&oldid=108391])
 
O conteúdo <code><nowiki>{{{1}}}</nowiki></code> é um parâmetro que o utilizador da predefinição deve passar. Por exemplo, se o utilizador usar <code><nowiki>{{fusão|Nova Pagina}}</nowiki></code> terá a seguinte mensagem:
 
{{fusão|Nova Pagina}}
 
== Categorização ==
É comum utilizar incluir em certas predefinições o código necessário para que elas categorizem as páginas onde forem inseridas. Por exemplo, a predefinição {{tl|esboço}} além de exibir um aviso na página em que for inserida, adiciona a mesma à [[categoria:esboço]].
 
Esse recurso pode ser usado em qualquer predefinição, bastando adicionar ao seu código um comando como:
 
<nowiki><includeonly>[[Categoria: BaBeBi|BoBu]]</includeonly></nowiki>
 
Embora o recurso seja muito útil, as vezes é necessário impedir que uma página seja categorizada por uma predefinição que vamos inserir (e que normalmente categorizaria tal página). Isso normalmente ocorre quando estamos exemplificando o uso de uma predefinição, como é feito, por exemplo, na página [[Wikibooks:Predefinições]], que lista as predefinições mais importantes do projeto.
 
O que fazer nesses casos?
 
A solução é bastante simples, apesar de utilizar recursos do que é conhecido por ''[[meta:Help:Parser function|parser function]]''.
 
O que se precisa fazer é aprimorar a predefinição, colocando algo do seguinte estilo:
<nowiki>{{#ifeq: {{uc: {{{cat|SIM}}} }} <!-- Se o usuário usar "cat=Sim", ou deixar em branco -->
|SIM
|<includeonly>[[Categoria: BaBeBi|BoBu]]</includeonly> <!-- pode categorizar -->
|<!-- senão, simplesmente não categoriza -->
}}</nowiki>
 
que de forma sintética (em uma única linha) fica assim:
<nowiki>{{#ifeq:{{uc:{{{cat|SIM}}}}}|SIM|<includeonly>[[Categoria: BaBeBi|BoBu]]</includeonly>|}}</nowiki>
 
Com isso, sempre que for necessário usar a predefinição tem-se a opção de desabilitar a categorização, usando:
<nowiki>{{NomeDaPredefinição|cat=não}}</nowiki>
ou usá-la normalmente, como se nada tivesse acontecido:
<nowiki>{{NomeDaPredefinição}}</nowiki>
 
Na verdade, se no lugar do "não" for escrito <u>qualquer coisa diferente de "SIM"</u> (ou ainda "sim", "siM", etc) a página <u>não será categorizada</u>.
 
{{esboço}}
 
{{clear}}