Módulo:Wd/doc
 | Esta é uma subpágina de documentação para o Módulo:Wd. 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. |
 | Este módulo está classificado como pronto para uso geral. Ele chegou a uma forma madura e pensa-se que está livre de erros e pronto para ser usado onde é apropriado. Ele está pronto para ser mencionado nas páginas de discussão e em outros recursos da Wikipédia como opção para novos usuários aprenderem. Para reduzir cargas nos servidores e mostrar texto estragado, ele deve ser melhorado pelo Exemplos para testes em vez de tentativas de edição a experimentar e erro. |
Este módulo tem como propósito consumir dados da Wikidata os quais tenham ou não relação com o artigo conectado da Wikipédia, além de apresentar diversos outros recursos.
Uso
[editar código-fonte]A estrutura geral de uma chamada para esse módulo é como se segue. Perceba que a estrutura básica consiste de comandos posicionais, flags e argumentos, os quais todos têm sua posição fixa.
{{wd|comando1|flag1a|flag1b|flag1c|comando2|flag2a|flag2b|flag2c|flag0a|flag0b|flag0c|arg1|arg2|arg3}}
Use diferentes comandos para obter diferentes tipos de valores da Wikidata. Ao menos um comando deve ser fornecido e múltiplos comandos podem ser combinados em uma chamada única como demonstrado acima (em qualquer ordem, e mais de dois também são possíveis), mas isso se aplica apenas a comandos de uma mesma classe de enunciação; chamadas contendo um comando da classe genérica não podem conter qualquer outro comando. Cada comando pode ser seguido por um número qualquer de flags de comandos, as quais são opcionais e podem ser usadas para incrementar a saída gerada pelo comando.
Os comandos e suas flags podem ser seguidos de um número qualquer de flags de configuração, as quais também são opcionais e afetam a seleção dos dados e o comportamento geral do módulo. A chamada é fechada com argumentos posicionais, os quais podem ser necessários dependendo dos comandos dados. Alguns argumentos nomeados (i.e. pares nome-valor) também existem, bem como um conjunto de flags nomeadas para uso avançado que podem ser utilizadas para alterar a forma como os valores obtidos são integrados à saída.
Esse módulo foi desenhado para prover necessidades básicas de consumo de dados da Wikidata, mas muito mais poder obtido através de diferentes combinações de chamadas. Por conveniência, tais combinações poderiam ser condensadas em novos templates de uso específico. Veja também a seção de casos de uso comuns abaixo para mais exemplos de "blocos de construção" úteis. No mesmo sentido, a funcionalidade deste módulo pode ser estendida por meio da criação de templates de encapsulamento que usem o comando main provido por este módulo.
Ver também
[editar código-fonte]