Módulo:Manutenção/doc

Este módulo é responsável por colocar as categorias de manutenção por data e assunto nas marcas de manutenção, o que antigamente era feito pela {{Manutenção/Categorizando por assunto}}.

Uso

Coloque no código da predefinição de manutenção:

{{#invoke:manutenção|categorizar|tipo de manutenção}}

Isso vai fazer com que os artigos em que a marca de manutenção for colocada sejam categorizados em "!Artigos tipo de manutenção", se for indicada data categoriza em "!Artigos tipo de manutenção data", e se for indicado assunto categoriza em "!Artigos de assunto tipo de manutenção".

Opcionalmente pode ser indicado no parâmetro seção um tipo de manutenção diferente para quando o primeiro parâmetro da marca de manutenção for "Esta seção"

{{#invoke:manutenção|categorizar|tipo de manutenção|seção=outro tipo de manutenção}}

Exemplo

Por exemplo se for colocado no código da {{sem fontes}}

{{#invoke:manutenção|categorizar|que carecem de fontes|seção=que necessitam de referências adicionais}}

e a marca for usada em um artigo da seguinte forma

{{sem fontes|data=novembro de 2015||arte}}

serão adicionadas as categorias "!Artigos que carecem de fontes desde novembro de 2015" e "!Artigos de arte que carecem de fontes". Já se for usado

{{sem fontes|Esta seção|data=abril de 2020}}

será adicionada a categoria "!Artigos que necessitam de referencias adicionais desde abril de 2020".

Primeiro argumento na marca de manutenção

As marcas de manutenção geralmente usam o primeiro argumento para colocar "Esta seção" quando a marca é inserida em uma seção, mas para garantir compatibilidade com predefinições fora do padrão o módulo também procura a data e o assunto no primeiro argumento. Se o primeiro argumento não começar por "Esta " ou "Este " e não for data e nem assunto a página é colocada na Categoria:!Páginas com argumentos incorretos em marca de manutenção. Opcionalmente pode-se usar o parâmetro |arg1= para indicar um Lua pattern para testar se o primeiro argumento da marca está correto, substituindo o ^Este[ae] ., que é o padrão.

Categorias de datas

Quando for indicada uma data válida mas não existir a categoria do mês, o módulo irá colocar na categoria do ano, mesmo se a categoria do ano não existir. Se for indicado o ano como data, também se usada a categoria de ano.

Se uma data não for indicada na marca de manutenção é colocada a categoria genérica.

É possível também indicar uma segunda categoria para data usando o parâmetro |cat2=. Essa segunda categoria deve ser passada por completo, como no exemplo abaixo:

{{#invoke:manutenção|categorizar|que carecem de fontes|cat2=!Biografias de pessoas vivas sem fontes}}

Isso irá categorizar tanto em "!Artigos que carecem de fontes desde ..." quanto em "!Biografias de pessoas vivas sem fonte desde...".

Categorias de assunto

Somente serão considerados os assuntos configurados no início do código do módulo.

Se um assunto não for informado a página será categorizada em "!Artigos tipo de manutenção sem indicação de tema", se essa categoria existir. Se um assunto válido é informado e a categoria do assunto ainda não existir, a página é categorizada em "!Artigos tipo de manutenção por assunto" ou "!Artigos tipo de manutenção por tema", se uma dessas categorias existirem.