Ajuda:Como criar predefinições: diferenças entre revisões

Origem: Wikilivros, livros abertos por um mundo aberto.
[edição não verificada][edição não verificada]
Conteúdo apagado Conteúdo adicionado
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]
Linha 12: Linha 12:


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:
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}}
{{clear}}

Revisão das 18h16min de 6 de novembro de 2008

Criar uma conta   Começar uma página   Começar um livro   Classificar um livro   Formatar módulos   Ligar módulos a projetos relacionados            
Usar imagens   Criar predefinições

  Renomear uma página   Reverter edições   Usar redirecionamentos   Truques e dicas            

As predefinições são páginas que devem iniciar com o nome "Predefinição:", por exemplo a predefinição fusão está na página Predefinição:fusão. Ao editar a página, deve-se usar o seguinte formato com as chaves:

{{ FPM | Image:SuaImagem.extensao | "Aqui vai o texto da sua predefinição" | [[Categoria:!SuaCategoria]]''}}


Como vemos, a predefinição deve estar entre chaves, começando com FPM, seguido pelo nome da imagem da wikicommons. Veja como exemplo, novamente, a predefinição fusão:

{{FPM|Image:Merge-arrows.svg|Foi proposta a fusão deste módulo com: ''[[{{{1}}}]]''.|[[Categoria:Módulos a sofrerem fusão]]}}


O conteúdo {{{1}}} é um parâmetro que o utilizador da predefinição deve passar. Por exemplo, se o utilizador usar {{fusão|Nova Pagina}} terá a seguinte mensagem:


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 {{esboço}} além de exibir um aviso na página em que for inserida, adiciona a mesma à.

Esse recurso pode ser usado em qualquer predefinição, bastando adicionar ao seu código um comando como:

<includeonly>[[Categoria: BaBeBi|BoBu]]</includeonly>

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 parser function.

O que se precisa fazer é aprimorar a predefinição, colocando algo do seguinte estilo:

{{#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 -->
}}

que de forma sintética (em uma única linha) fica assim:

{{#ifeq:{{uc:{{{cat|SIM}}}}}|SIM|<includeonly>[[Categoria: BaBeBi|BoBu]]</includeonly>|}}

Com isso, sempre que for necessário usar a predefinição tem-se a opção de desabilitar a categorização, usando:

{{NomeDaPredefinição|cat=não}}

ou usá-la normalmente, como se nada tivesse acontecido:

{{NomeDaPredefinição}}

Na verdade, se no lugar do "não" for escrito qualquer coisa diferente de "SIM" (ou ainda "sim", "siM", etc) a página não será categorizada.


Esta página é somente um esboço.
Ampliando-a você ajudará a melhorar o Wikilivros.
Próximo: Renomear uma página