Módulo:Info/doc

Origem: Wikipédia, a enciclopédia livre.
Saltar para a navegação Saltar para a pesquisa
Edit-copy green.svg Esta é uma subpágina de documentação para o Módulo:Info.
Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte do módulo original.
Padlock.svg Este módulo está na categoria sujeitos a proteção de página. Ele é um módulo de alta visibilidade em uso por um grande número de páginas, ou é transcluído muito frequentemente. Por causa do vandalismo ou erros que podem afectar muitas páginas, e mesmo edições triviais podem causar cargas substanciais nos servidores, ele está protegido de editar.


Módulo de suporte de {{Info}}

Descrição[editar código-fonte]

Este módulo gera infoboxes semelhante à {{Info}}

Uso[editar código-fonte]

O módulo funciona de modo semelhante à {{Info}} e em muitos casos vai funcionar da mesma forma ao trocar a linha

{{Info

por

{{#invoke:Info|base

Exemplo de preenchimento usando a mesma forma de preenchimento da Info:

Título
Tópico
A x
B y
{{#invoke:Info|base
|título = Título
|tópico1 = Tópico
|rótulo1 = A
|dados1 = x
|rótulo2 = B
|dados2 = y
|rótulo3 = C
|dados3 = {{{campo z|}}}
}}

Exemplo de preenchimento usando a forma simplificada de preenchimento:

Título
dados sem rótulo
Tópico 1
A x
B y
Rodapé
{{#invoke:Info|base
|cor = 6.3
|título = Título
|rodapé = Rodapé
|:dados sem rótulo
|#tópico: tópico1
|A: x
|B: y
|C: {{{campo z|}}}
|C: #wd:P123
}}

Essa forma simplificada não precisa de números de rótulos e dados, tornando mais rápida a criação e atualização da Infobox.

Quando existem dois rótulos iguais, como o rótulo "C" no exemplo acima, será criado somente um campo com esse rótulo, usando o primeiro campo que possui dados.

Wikidata[editar código-fonte]

Se os dados estiverem no formato #wd:P<número da propriedade>, os dados dessa propriedade serão obtidos do Wikidata, por exemplo |país: #wd:P17 vai gerar o rótulo "país" e pegar o nome do país no Wikidata. Para colocar ligação interna coloque ":link" depois da propriedade, por exemplo #wd:P17:link. Outras funções também estão disponíveis para modificar o valor obtido do Wikidata, veja a documentação do Módulo:Info/wd para detalhes.

Todo campo que estiver usando dados do Wikidata tem a classe de estilo "dadoswd", isso é útil para visualizar quais campos usam dados do Wikidata e quais usam dados locais, para isso edite o seu common.css e adicione algum estilo para diferenciar os campos do Wikidata dos campos locais. O exemplo abaixo coloca um borda roxa a direita do campo:

/* Exibir borda roxa ao lado dos campos da infobox que usam dados do Wikidata */
.dadoswd {
    border-right: 1px solid #CC99FF
}
Diferenciar campos do Wikidata
Rótulo1 dado preenchido localmente
Rótulo2 dado obtido do Wikidata

O código acima em seu common.css produz o efeito ao lado nas infoboxes com dados do Wikidata. O efeito é sutil mas suficiente para diferenciar visualmente qual campo usa dados do Wikidata, para marcar a diferença de forma mais forte use cores mais fortes, bordas mais espessas ou qualquer outro estilo que quiser, só você verá o estilo que configurar no seu common.css.

Cor e estilos[editar código-fonte]

Este módulo segue o padrão visual, nenhuma classe de estilo ou estilos em linha podem ser adicionados, isso garante a acessibilidade das informações e garante uma consistência visual. Somente a cor pode ser alterada usando as cores padrões.

Para usar cores preencha o parâmetro |cor= com uma das cores do padrão visual ou os respectivos números na tabela de cores abaixo, essa cor será usada como fundo do título, as cores mais claras da mesma matiz serão automaticamente usadas no fundo dos tópicos (primeira mais clara) e rótulos (segunda mais clara).

Cor 9.3
dados sem rótulo
Tópico
Rótulo1 dados
Rótulo2 dados
Rodapé
Cor 2.1
dados sem rótulo
Tópico
Rótulo1 dados
Rótulo2 dados
Rodapé
Tom escuro Tom médio Tom claro Tom mais claro
1.1 1.2 1.3 1.4
2.1 2.2 2.3 2.4
3.1 3.2 3.3 3.4
4.1 4.2 4.3 4.4
5.1 5.2 5.3 5.4
6.1 6.2 6.3 6.4
7.1 7.2 7.3 7.4
8.1 8.2 8.3 8.4
9.1 9.2 9.3 9.4
10.1 10.2 10.3 10.4
11.1 11.2 11.3 11.4
12.1 12.2 12.3 12.4
13.1 13.2 13.3 13.4

Extensões[editar código-fonte]

O módulo pode ser estendido com um submódulo para adicionar funções especiais. O campo |estender= deve conter o nome da subpágina do módulo, por exemplo |estender=local carrega o Módulo:Info/local.

Os submódulos devem colocar funções na tabela global 'especial' para que os rótulos ou dados contendo '#nome' chame a função especial['nome'], note que a função especial['imagem'] já existe, então a tabela especial não deve ser declarada novamente para não apagá-la. A tabela ext.prop pode ser criada para colocar funções especiais para pegar dados do Wikidata, se por exemplo a função ext.prop['P123'] existir, o Módulo:Info/wd irá chamá-la para obter dados da propriedade P123 no Wikidata. E se existir a função ext.extra, ela será chamada antes de terminar de montar a infobox, o que for retornado será colocado após a infobox.

Campo debug[editar código-fonte]

Para facilitar a identificação de erros durante o preenchimento da infobox ou erros no funcionamento do módulo, o campo 'debug' pode ser usado de diferentes formas:

Campo resultado
| debug = vazio Exibe todos os campos que não foram preenchidos
| debug = campos Exibe o processamento dos campos no rodapé
| debug = erros Exibe erros durante o processamento no rodapé
| debug = wikidata Exibe processamento dos campos do Wikidata no rodapé

Ver também[editar código-fonte]