Calimero0000: Criou nova página com '{{Subpágina de documentação}} Esta é a metapredefinição {{tl|cat handler}}. Ela ajuda ...'

2013-05-03T23:05:03Z

Criou nova página com '{{Subpágina de documentação}}  Esta é a metapredefinição {{tl|cat handler}}. Ela ajuda ...'

Página nova

{{Subpágina de documentação}}


Esta é a metapredefinição {{tl|cat handler}}.

Ela ajuda outras predefinições a automatizar ambas categorização e [[:en:Wikipedia:Category suppression|supressões de categoria]].

Quando usada com suas configurações padrão esta predefinição previne auto-categorização em alguns espaços nominais e em algumas páginas onde geralmente não se quer categorização. Portanto, mesmo o mais simples dos usos: "<code><nowiki>{{cat handler|[[Categoria:Alguma]]}}</nowiki></code>" faz com que a predefinição não categorize nos locais errados.

Esta predefinição torna fácil escolher em quais espaços nominais a predefinição rá categorizar ou não. E ela torna fácil usar diferentes categorias em diferentes espaços nominais, além de utilizar uma lista negra centralizada onde pode-se adicionar páginas e tipos de páginas onde predefinições nunca irão categorizar.

=== Quando não utilizar esta predefinição ===

Se uma predefinição só precisa categorizar no espaço nominal principal (artigos), ficheiros (imagens) ou categoria, então usar esta predefinição é um exagero. Então, ao invés disto utiliza uma das {{tl|artigos e outros}}, {{tl|ficheiros e outros}}, or {{tl|categorias e outros}}. Mas se sua predefinição precisa categorizar em qualquer outro espaço nominal, então é recomendado utilizar esta predefinição, já que ela fornece a supressão de categorias propriamente dita, e torna fácil selecionar como categorizar em diferentes espaços nominais.

=== Espaços nominais ===

Esta predefinição detecta e agrupa todos diferentes [[Wikimotorpedia:Domínio|espaços nominais]] usados na Wikimotorpédia, em vários tipos. Estes tipos são usados como nomes de parâmetros nesta predefinição.

:'''principal''' = Espaço principal/artigos, como nos artigos normais da Wikimotorpédia.
:'''discussão''' = Qualquer espaço de discussão, como nomes que terminam com "Discussão", "Usuário discussão:", "Ficheiro Discussão:" e assim por diante.
:'''usuário, wikimotorpedia, ficheiro, mediawiki, predefinição, ajuda, categoria, portal''' e '''livro''' = Outros espaços nominais excepto as páginas de discussão.
:'''outro''' = Qualquer espaço nominal que não especificada como um parâmetro para a predefinição. Veja os exemplos abaixo.

=== Uso básico ===

Esta predefinição leva dois ou mais parâmetros. Aqui vão exemplos explicativos sobre o código completo para uma caixa de mensagem de artigo:

<pre>
{{ambox
| texto = Esta é uma caixa usada em artigos.
}}{{cat handler
| [[Category:Somecat]]
| semcat = {{{semcat|}}} 
}}<noinclude>

{{documentação}}
</noinclude>
</pre>

O exemplo acima usa as configurações padrão para {{tlx|cat handler|...}}. Isto significa que a caixa vai categorizar nas páginas nos seguintes espaços nominais:
:'''principal''', '''ficheiro''', '''ajuda''', '''categoria''', '''portal''' e '''livro'''
Mas '''não''' vai nos seguintes:
:'''discussão''', '''usuário''', '''wikimotorpedia''', '''mediawiki''' e '''predefinição'''

E '''não''' vai categorizar nas páginas listadas na lista negra. (Veja a [[#Lista netra|lista negra]] abaixo.)

A razão para esta predefinição não categorizar em alguns dos espaços nominais é que nestes espaços a maioria das predefinições são apenas demonstradas ou listadas, não usadas. Portanto a maioria das predefinições não devem categorizar estes espaços.

Qualquer predefinição que deve categorizar em um ou mais destes espaços deve utilizar a sintaxe básica mostrada abaixo.

=== Uso estendido ===

Esta predefinição utiliza um ou mais parâmetros para categorizar diferentes espaços nominais, como listadas na seção [[#Espaços nominais|espaços nominais]], acima. Ao usar um ou mais destes parâmetros, você pode escolher onde ocorrerá categorização. Deste modo:

<pre>
{{mbox
| texto = Esta é uma caixa para artigos e páginas de discussão.
}}{{cat handler
| principal = [[Categoria:Alguma1]] 
| discussão = [[Categoria:Alguma2]] 
| semcat = {{{semcat|}}} 
}}
</pre>

A caixa acima só irá funcionar nos espaços principal e de discussão. Mas não irá categorizar nas páginas de /arquivo, já que elas estão na lista negra. (Veja a seção [[#Lista negra|lista negra]] abaixo.) E se você precisa demonstrar (discutir) esta caixa em uma página de discussão, então você pode utilizar o parâmetro "<code>semcat=sim</code>" para evitar a categorização da página. (Veja seção [[#Semcat|semcat]] abaixo.) Deste modo:

<pre>
== Minha nova predefinição ==
Olá, vocês já viram a minha nova predefinição?
{{mytemp|semcat=sim}}
Legal, né?
--~~~~
</pre>

às vezes nós queremos utilizar a mesma categoria em vários espaços nominais, então para facilitar, lembre-se de fazer deste modo:

<pre>
{{mbox
| texto = Esta caixa é utilizada em vários espaços nominais.
}}{{cat handler
| principal = [[Categoria:Alguma1]]
| ajuda
| usuário = [[Categoria:Alguma2]] 
| discussão = 
| outro = [[Categoria:Alguma3]] 
| semcat = {{{semcat|}}} 
}}
</pre>

No exemplo acima nós utilizados o encadeamento de parâmetros para fornecer a mesma resposta para dois parâmetros, há ainda outra maneira de fazer isto, utilizando a numeração de parâmetros, que pode ser vista abaixo:

<pre>
{{mbox
| texto = Esta caixa é utilizada em vários espaços nominais.
}}{{cat handler
| principal = [[Categoria:Alguma1]]
| 1 = [[Categoria:Alguma2]] 
| ajuda = 1
| usuário = 1
| discussão = 
| outro = [[Categoria:Alguma3]] 
| semcat = {{{semcat|}}} 
}}
</pre>

Esta predefinição entende parâmetros numerados até 10.

O parâmetro '''outro''' define o que deve ser utilizado nos espaços restantes, que não foram especificados.

Perceba que o parâmetro vazio, mas definido, '''discussão''' foi enviado para o parâmetro '''outro''', quando no espaço de discussão, e portanto será categorizado neste caso.

Esta predefinição também possui um parâmetro chamado '''todos''', que funciona assim:

<pre>
{{mbox
| texto = Caixa usada em todos espaços.
}}{{cat handler
| todos = [[Categoria:Alguma1]] 
| semcat = {{{semcat|}}} 
}}
</pre>

O exemplo acima irá categorizar sempre, menos nas páginas listadas na lista negra. Para demonstrar a predefinição você ainda pode utilizar "<code>semcat=sim</code>" para evitar a categorização.

Você deve evitar o parâmetro '''todos''', já que predefinições jamais precisam categorizar em todos espaços nominais.

O parâmetro '''todos''' também pode ser usato em combinação com o resto deles. Deste modo:

<pre>
{{mbox
| texto = Em todos
}}{{cat handler
| todos = [[Categoria:Alguma1]] 
| principal = [[Categoria:Alguma2]] 
| outro = [[Categoria:Alguma3]] 
| semcat = {{{semcat|}}} 
}}
</pre>

Se a caixa for colocada em um artigo, então ela irá adicionar as categorias 1 e 2. Mas em todos outros espaços, serão as categorias 1 e 3. Como o exemplo mostra, o parâmetro todos funciona independentemente dos outros parâmetros.

=== Subpáginas ===

A predefinição entende o parâmetro '''subpágina'''. Deste modo:

<pre>
{{cat handler
| subpágina = não 
| wikipedia = [[Categoria:Categoria1]]
| semcat = {{{semcat|}}} 
}}
</pre>

Caso "<code>subpágina=não</code>" a predefinição '''não''' irá categorizar em subpáginas. Para a rara ocasião em que você queira categorizar '''apenas''' subpáginas, use "<code>subpágina=apenas</code>". Se '''subpágina''' estiver vazio ou indefinido, a predefinição categorizará em ambos casos.

=== Lista negra ===

Esta predefinição possui uma lista negra de páginas e tipos de páginas em que predefinições não devem auto-categorizar. Predefinições que usarem esta metapredefinição, não irão, por sua vez, categorizar em páginas de /arquivo e nas subpáginas de [[Wikimotorpedia:Lista de predefinições]].

Se você quer que uma predefinição categorize em uma página na lista negra, então forneça "<code><nowiki>semcat = não</nowiki></code>" para a predefinição ao usá-la, porém isto é muito desaconselhável.

Lembre-se de que esta predeifnição somente categoriza espaços que foram fornecidos, então no [[#Uso básico|uso básico]] acima, mesmo se você fornecer "<code>semcat = não</code>" a predefinição '''não''' irá categorizar em páginas de discussão, já que este comportamento não foi especificado. Mas ela possui informações para o espaço de ajuda, então nenhuma página na lista negra de ajuda irá categorizar.

Consulte a lista negra na sub-predefinição {{tl|cat handler/blacklist}}, para ver ou atualizar a lista.

=== O parâmetro "semcat" ===

Esta predefinição entende o parâmetro '''semcat''':

* Caso "<code>semcat = sim</code>" a predefinição ''não'' categorizará.
* Caso '''semcat''' esta vazio ou indefinido, a predefinição categorizará normalmente.
* Caso "<code>semcat = não</code>" a predefinição categorizará até em páginas negras listadas. (Ver seção [[#Lista negra|lista negra]] acima.)

Predefinições que utilizarem {{tlx|cat handler|...}} '''devem''' encaminhar o parâmetro '''semcat''' para cá, para que ele possa ser utilizado. O código para iso é "<code><nowiki>semcat = {{{semcat|}}}</nowiki></code>", como exibido em '''todos''' exemplos anteriores.

=== O parâmetro "categoria2" ===

Para compatibilidade reversa, esta predefinição suporta o antigo parâmetro "categoria =". Mas o parâmetro "categoria" já é usado para fornecer nomes de categoria para o espaço de categorias. Então ao invés esta predefinição utiliza '''categoria2''' para um uso similar ao '''semcat'''. Sendo assim:

* Caso "<code>categoria2 = </code>" (vazio, mas definido), ou "<code>categoria2 = não</code>", ou se receber outro valor (exceto nos dois casos seguintes), a predefinição '''não categoriza'''.
* Caso '''categoria2''' não é definido ou "<code>categoria = ¬</code>", então a predefinição categoriza normalmente.
* Caso "<code>categoria2 = sim</code>" categoriza até em páginas negras listadas.

Ao adicionar esta predeifnição em uma predefiniçãoq eu já utiliza a lógica "<code>categoria =</code>", você deve fazer o seguinte para não quebrar nenhuma utilização pré-existente:

<pre>
{{cat handler
| [[Categoria:Alguma]]
| semcat = {{{semcat|}}} 
| categoria = {{{categoria2|¬}}} 
}}
</pre>

Lembre-se que "<code>¬</code>" é necessário, ele ajuda a predefinição a detectar se o parâmetro esta definido mas vazio.

=== Categorias e texto ===

Além das categorias, você pode fornecer qualquer coisa a esta predefinição, por exemplo algum texto. Deste modo:

<pre>
{{tmbox
| texto = Esta é uma caixa de mensagem para discussões.
}}{{cat handler
| discussão = [[Categoria:Alguma]]
| outro = :::::Esta predefinição deve apenas ser utilizada em páginas de discussão.
| semcat = {{{semcat|}}} 
}}
</pre>

Quando a predefinição acima for utilizada em qualquer lugar que não nas página de discussão, uma mensagem parecida com esta será mostrada (perceba o texto sob a baixa):

{{tmbox
| texto = Esta é uma caixa de mensagem para discussões.
| semcat = claro 
}}{{cat handler
| discussões = [[Categoria:Qualquer]]
| outro = :::::Esta predefinição deve apenas ser utilizada em páginas de discussão.
| semcat = {{{semcat|}}} 
}}

Este texto não aparecerá nas páginas da lista negra, então não use este método para mostrar informações importantes. Fornecer "<code>semcat = claro</code>" para a predefinição esconde o texto, já que ele suprime qualquer categoria.

=== O parâmetro "página" ===

Para demonstrações esta predefinição pode levar um parâmetro '''{{parâmetro|página}}'''. Deste modo:

<pre>
{{cat handler
| principal = Categoria:Alguma
| discussão = Categoria:Discute
| semcat = {{{semcat|}}} 
| página = Usuário Discussão:Exemplo
}}
</pre>

No código acima nós deixamos de fora de propósito os colchetes ao redor dos nomes das categorias, para que possamos ver a saída do texto na página. Não importa em que tipo de página o código acima seja usado, o resultado será:

:{{cat handler
| principal = Categoria:Alguma
| discussão = Categoria:Discute
| semcat = {{{semcat|}}} 
| página = Usuário Discussão:Exemplo
}}

O parâmetro '''página''' faz com que a predefinição se comporte exatamente como se estivesse naquela página. Mesmo se a lista negra estar ativa. O nome da página nem precisa existir realmente.

Se o parâmetro '''página''' estiver vazio ou indefinido, o nome da página atual é utilizado.

Você também pode fazer com que a sua predefinição entenda o parâmetro '''página'''. Isso significa que você pode testar como a sua predefinição vai categorizar diferentes páginas, sem ter que fazer as edições nestas páginas. Para tanto:

<pre>
{{cat handler
| principal = Categoria:Alguma
| discussão = Categoria:Discute
| semcat = {{{semcat|}}} 
| página = Usuário Discussão:Exemplo
}}
</pre>

=== Parâmetros ===

Sintaxe de parâmetros:

<pre>
{{cat handler
| [[Categoria:Alguma]]
| subpágina = não / apenas
| 1 =
...
| 10 =
| todos = [[Categoria:Alguma]] / Texto
| principal = 1 / ... / 10 / [[Categoria:Alguma]] / Texto
...
| outro = 1 / ... / 10 / [[Categoria:Alguma]] / Texto

| semcat = {{{semcat|}}} / não / sim
| categorias = {{{categories|}}} / não / sim
| categoria2 = {{{category|¬}}} / 'vazio' / não / 'indefinido' / ¬ / sim

| página = {{{página|}}} / Usuário:Exemplo
}}
</pre>

Lembre-se que valores vazios para os espaços nominais possuem um significado especial (vide exemplos). O parâmetro "todos" não entende parâmetros numerados, já que esta necessidade não deve existir.

=== Detalhes técnicos ===

A lista negra de supressão de categorias na sub-predefinição {{tl|cat handler/blacklist}} é utilizada para consultar ou atualizá-la.

Devido a seu processamento interno de parâmetros, esta predefinição usa a sub-predefinição {{tl|cat handler/numbered}}.

Para mais detalhes técnicos consulte a [[Predefinição Discussão:Cat handler|discussão]].

== {{Ver também}} ==
[[Wikimotorpedia:Domínio|Wikimotorpedia:Espaços nominais]]

<includeonly>
[[Categoria:!Predefinições de manutenção]]

[[en:Template:Cat handler]]
[[ml:ഫലകം:Cat handler]]
[[or:ଛାଞ୍ଚ:Cat handler]]
[[sco:Template:Cat handler]]
[[tpi:Template:Cat handler]]
</includeonly>

Predefinição:Cat handler/doc - Histórico de revisões

Calimero0000: Criou nova página com '{{Subpágina de documentação}} Esta é a metapredefinição {{tl|cat handler}}. Ela ajuda ...'