Módulo:WikidataIB/doc
Este módulo está classificado como alfa na Wikipédia em Português. Ele está pronto para aceitar dados de terceiros, e pode ser utilizado em algumas páginas para ver se aparecem problemas, mas deve ser vigiado. Sugestões para novas funções ou alterações dos seus mecanismos de dados de entrada e saída são bem-vindas.
Este módulo toma dados de uma ou mais propriedades do Wikidata.
Este módulo foi projetado especificamente para implementar um mecanismo que move o controle de se os valores do Wikidata são usados em uma infobox do programador da predefinição no nível de design da infobox para o editor no nível de artigo. Ele só deve ser usado dentro de uma infobox.
Uso
[editar código-fonte]O módulo provê essas chamadas especificamente para o uso em infoboxes no presente:
getValuegetPreferredValuegetSourcedValuegetCoordsgetQualifierValue
A chamada getSourcedValue é mantida para compatibilidade com versões anteriores, pois agora é redundante para getValue que pode fazer o mesmo trabalho usando o parâmetro |onlysourced=true
Existem também essas chamadas úteis:
getLinkgetLabelgetATformatDatecheckBlacklistpredDnipredMorte
Chamadas generalizadas:
{{#invoke:WikidataIB |getValue |<PropertyID> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no> |noicon=<yes/no> |df=<dmy/mdy/y> |bc=<BC/BCE> |<local parameter>}}
{{#invoke:WikidataIB |getPreferredValue |<PropertyID> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no> |noicon=<yes/no> |df=<dmy/mdy/y> |bc=<BC/BCE> |<local parameter>}}
{{#invoke:WikidataIB |getSourcedValue |<PropertyID> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |<local parameter>}}
{{#invoke:WikidataIB |getCoords |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |<local parameter>}}
{{#invoke:WikidataIB |getQualifierValue |<PropertyID> |pval=<ID of target value for the property> |qual=<qualifier ID for that target value> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}
Função getValue
[editar código-fonte]- getValue pode também pegar um parâmetro
|qid= - A propriedade a ser retornada é passada na primeira propriedade não nomeada.
- O nome do campo que a função é chamada é passada no parâmetro
|name= - O nome é compulsório quando a blacklist ou a whitelist é usada, então o módulo retorna nil se não é fornecido.
- A blacklist é passada no parâmetro
|suppressfields= - A whitelist é passada no parâmetro
|fetchwikidata=
A função getValue aceitará um parâmetro booleano |onlysourced=|onlysourced vazio e uma string vazia ("") têm como default para verdadeiro (i.e. somente os valores referenciados são retornados). Os valores no, false e 0 são tratados como falsos (i.e. todos os valores são retornados); qualquer outro valor é verdadeiro (embora |onlysourced=yes
A função getValue aceitará um parâmetro booleano noicon que suprimirá o ícone "edite no Wikidata" para quando o valor retornado for processado futuramente pela infobox (e.g. uma url). A ausência do parâmetro ou um parâmetro |noicon vazio default para falso (i.e. o parâmetro é adicionado). A string vazia ("") e os valores no, false e 0 são tratados como falsos; qualquer outro valor é verdadeiro (embora |noicon=true
Em ordem de lidar com o requerimento para datas em my, dmy ou y, getValue aceita um parâmetro |df=
Se um artigo exigir o sufixo a.C., getValue retornará a data com esse sufixo;
Em uma invocação do módulo para extrair datas, getValue aceita um parâmetro |idioma=
- A propriedade a ser retornada é passada na primeira propriedade não nomeada.
A função getValue aceitará um especificador de uso de unidade de medida (ao invés da unidade por extenso) na terceira propriedade não nomeada. A unidade de medida será exibida somente se o valor passado for unidade
Função getPreferredValue
[editar código-fonte]A função getPreferredValue trabalha exatamente como getValue, tomando os mesmos parâmetros, mas se qualquer um dos valores para a propriedade tem um rank set preferido, ela retornará esses valores.
Exemplo
[editar código-fonte]Obtendo o(s) nome(s) da P170 de Q29016906:
{{#invoke:WikidataIB |getValue |P170 |fetchwikidata=ALL |qid=Q29016906 |onlysourced=no}}→ Artemisia Gentileschi, Diana Rosa, Massimo Stanzioni
{{#invoke:WikidataIB |getPreferredValue |P170 |fetchwikidata=ALL |qid=Q29016906 |onlysourced=no}}→ Artemisia Gentileschi
Função getSourcedValue
[editar código-fonte]- getSourcedValue trabalha exatamente como getValue, mas somente retorna valores que tenham referência a algo mais do que a Wikipedia. Não há garantias de fontes confiáveis, mas ajuda separar o joio do trigo.
Exemplo de getSourcedValue
[editar código-fonte]De Q151973:
Burton correntemente tem quatro valores para P106 no Wikidata:
- Q10800557 (referenciado a Dutch Wikipedia);
- Q33999 (referenciado a http://www.nytimes.com/1983/05/09/theater/theater-private-lives-burton-and-miss-taylor.html);
- Q18939491 (referenciado a Wikipédia);
- Q2259451 (não referenciado).
Usando getValue em Richard Burton:
{{#invoke:WikidataIB |getValue |P106 |name=occupation |fetchwikidata=ALL}}-> ator/atriz de cinema, diarista, ator de teatro, ator, diretor(a) de cinema, produtor de cinema, produtor, realizador
Usando getSourcedValue em Richard Burton:
{{#invoke:WikidataIB |getSourcedValue |P106 |name=occupation |fetchwikidata=ALL}}-> ator/atriz de cinema, diarista, ator, produtor de cinema
Função getCoords
[editar código-fonte]- getCoords pode também pegar um parâmetro
|qid= - As coordenadas do Wikidata são passadas a Predefinição:Coord que retorna o display como se fosse chamado manualmente.
- O nome do campo que a função é chamada é passada no parâmetro
|name, que é primeiramente checado em uma blacklist de campos que não devem ser mostradas nunca, (i.e. a chamada retorna nil em todas as circunstâncias). Se o campo não está na blacklist, é então checado contra uma whitelist. Se o nome do campo concorda, a chamada retornará qualquer valor fornecido localmente se é fornecido como segundo parâmetro não nomeado, ou o valor do Wikidata caso contrário. - O nome é compulsório quando a blacklist ou a whitelist é usada, então o módulo retorna nil se não é fornecido.
- A blacklist é passada no parâmetro
|suppressfields= - A whitelist é passada no parâmetro
|fetchwikidata=
Função getQualifierValue
[editar código-fonte]O getQualifierValue é para usar quando queremos concordar o valor de um qualificador. Nós precisamos saber a propriedade e o valor da propriedade que a qualifica. Os parâmetros são:
- A propriedade ID passada no parâmetro não nomeado (ou
|1) - O valor alvo para esta propriedade em
|pval - O ID qualificador para o valor alvo em
|qual - O nome do campo onde é chamada para implementar "whitelisting" e "blacklisting" da propriedade nele
- A lista de campos para concordância ("whitelist") em
|fetchwikidata=|fetchwikidata=ALL - Lista opcional de campos para não serem exibidos ("blacklist") em
|suppressfields= - booleano opcional para especificar se apenas valores referenciados da propriedade são retornados (default para "no") em
|onlysourced= - Item ID opcional para acesso arbitrário (chamada carísssima!) em
|qid=
Exemplo de getQualifierValue
[editar código-fonte]Em Q1513315 existe uma propriedade P793, que tem um valor Q385378. Tem dois qualificadores, P580 e P582. Para obter a data de início:
{{#invoke:WikidataIB |getQualifierValue |P793 |pval=Q385378 |qual=P580 |name=xyz |fetchwikidata=ALL }}
Em Telescópio do Polo Sul retorna:
- novembro 2006
Função getLink
[editar código-fonte]getLink retorna o rótulo para um Qid ligado a wiki para o artigo local (se o artigo existe).
Função getLabel
[editar código-fonte]getLabel retorna o rótulo para uma Qid. Se o rótulo não existe, retorna o Qid. Note que este é o rótulo dado para a entrada no Wikidata na mesma linguagem da corrende Wikipédia, se o rótulo existe.
{{#invoke:WikidataIB |getLabel |Q29016906}}→ Corisca e Sátiro{{#invoke:WikidataIB |getLabel |Q3621491}}→ arqueólogo
Função getAT
[editar código-fonte]getAT retorna o título do artigo para uma Qid. Se o título do artigo não existe, não retorna nada. Note que este é o título do artigo na corrente Wikipedia, se o interwiki existe na entrada Wikidata.
{{#invoke:WikidataIB |getAT |Q29016906}}→{{#invoke:WikidataIB |getAT |Q3621491}}→
Função predDni
[editar código-fonte]predDni toma uma data de nascimento passada pelo usuário (tal como devolvida pela função getValue ou getPreferredValue ou da forma DD{{!}}MM{{!}}AAAA) e a insere dentro da predefinição:Dni. Também aceita os argumentos "|idioma=" caso se deseje exibir a data na variante do português angolano e a variável não nomeada "sem idade" quando não se desejar exibir a idade.
{{#invoke:WikidataIB |predDni |<data de nascimento obtida através da função getValue ou getPreferredValue acrescentada opcionalmente dos parâmetros "|idioma=" e "|sem idade" ou então a data por extenso como "01{{!}}04{{!}}2018">}}
Exemplo:
{{#invoke:WikidataIB|predDni|01{{!}}04{{!}}2016}}→ 01 de Abril de 2016 (8 anos)
Função predMorte
[editar código-fonte]Tal qual predDni, predMorte toma uma data de morte e uma data de nascimento passada pelo usuário (novamente: tal como devolvida pela função getValue ou getPreferredValue ou da forma DD{{!}}MM{{!}}AAAA) e a insere dentro da predefinição:Morte. Também aceita o argumento "|idioma=" caso se deseje exibir a data na variante do português angolano.
{{#invoke:WikidataIB |predMorte |<data de morte obtida através da função getValue ou getPreferredValue ou então a data por extenso como "01{{!}}04{{!}}2018">|<data de nascimento obtida através da função getValue ou getPreferredValue ou então a data por extenso como "01{{!}}04{{!}}2017">}}
Exemplo:
{{#invoke:WikidataIB|predMorte|01{{!}}04{{!}}2018|01{{!}}04{{!}}2016}}→ 01 de Abril de 2018 (2 anos)
Função formatDate*
[editar código-fonte]formatDate aceita uma data no formato usual de mw.wikibase.entity:formatPropertyValues, como "1 de agosto de 30 a.C." como parâmetro 1 e o formata de acordo com os parâmetros df e bc.
{{#invoke:WikidataIB |formatDate | 1 de agosto de 30 | bc=BC |df=dmy}}→ 1{{#invoke:WikidataIB |formatDate | 1 de agosto de 20 | bc=BCE |df=mdy}}→ 1- df = "dmy" / "mdy" / "y" - default é "dmy"
- bc = "BC" / "BCE" - default é "BCE"
* Não está funcionando normalmente
Adendo sobre o idioma de retorno
[editar código-fonte]Por padrão, os rótulos retornados pelo módulo serão retornados por default na variante brasileira do português. Caso um editor deseje que o rótulo seja retornado em português europeu (essas são, infelizmente, as duas únicas variantes implementadas no Wikidata), ao utilizar qualquer uma das funções apresentadas, basta adicionar |idioma=pt ou |idioma=pt-ao (neste caso, os rótulos serão retornados em português europeu, e as datas serão retornadas no formato angolano) nos parâmetros da função.
Ver também
[editar código-fonte]- Módulo:Wikidata, lidando com o Wikidata de forma mais básica
Esta é a página de documentação de Módulo:WikidataIB