Modul:Wikidata2
--[[
- Modulo per implementare le funzionalità dei template:
- Lua error in Modul:Wd at line 208: attempt to index field 'errors' (a nil value)., Templat:WikidataQ, Templat:WikidataIdx, Templat:WikidataN, Templat:WikidataLabel, Templat:WikidataDescription
- Templat:WikidataLink, Templat:WikidataId, Templat:WikidataTipo e Templat:WikidataIstanza.
- Permette di accedere a Wikidata in modo più avanzato rispetto a {{#property}}.
- Per la maggior parte riscritto e ampliato a partire dalla versione iniziale a:
- http://test2.wikipedia.org/w/index.php?title=Module:Wikidata&oldid=52322
]]
-- ============================================================================= -- Non utilizzare mai mw.wikibase.getEntity, per esempio un solo utilizzo di -- mw.wikibase.getEntity('Q183') fa aumentare di 7 MB l'utilizzo di memoria -- per Lua ed è molto lenta se ripetuta (unico utilizzo in getDatatype, -- solo per proprietà, non essendoci alternative). -- =============================================================================
require('strict')
local getArgs = require('Module:Arguments').getArgs local mConvert = require('Module:Conversione') local mLanguages = require('Module:Linguaggi')
-- Categoria per le pagine con errori local errorCategory = 'Categoria:Voci con errori del modulo Wikidata'
-- Messaggi local i18n = { errors = { ['entityid-param-not-provided'] = "Parametro entityid non fornito", ['property-param-not-provided'] = "Parametro property non fornito", ['qualifier-param-not-provided'] = "Parametro qualifier non fornito", ['value-param-not-provided'] = "Parametro valore da ricercare non fornito", ['entity-not-found'] = 'Entità non trovata', ['unknown-claim-type'] = 'Tipo asserzione sconosciuta', ['unknown-snak-type'] = 'Tipo di snak sconosciuto', ['unknown-datavalue-type'] = 'Tipo di dato sconosciuto', ['unknown-entity-type'] = 'Tipo di entità sconosciuta', ['unknown-output-format'] = 'Formato di output sconosciuto' }, somevalue = "valore sconosciuto", novalue = "nessun valore", datatypes = { ['commonsMedia'] = 'file multimediale su Commons', ['external-id'] = 'identificativo esterno', ['geo-shape'] = 'forma geografica', ['globe-coordinate'] = 'coordinate geografiche', ['math'] = 'espressione matematica', ['monolingualtext'] = 'testo monolingua', ['quantity'] = 'quantità', ['string'] = 'stringa', ['tabular-data'] = 'tabular data', ['time'] = 'data e ora', ['url'] = 'URL', ['wikibase-item'] = 'elemento', ['wikibase-property'] = 'proprietà' } }
local p = {}
-- Formatters
local function errhandler(msg) local cat = mw.title.getCurrentTitle().namespace == 0 and errorCategory or return string.format('%s%s', msg, cat) end
local function formatList(values, ordered)
local fmt = ordered and '
- %s
' or '
- %s
' return #values > 0 and string.format(fmt, mw.text.listToText(values, '
-- Lettura e selezione statement
-- Restituisce true se lo statement contiene il qualifier richiesto con un dato valore (o uno tra più valori separati da virgola) local function hasQualifierValue(statement, qualifierId, qualifierValue) local ret = false for _, qualifier in ipairs(statement.qualifiers[qualifierId]) do local isItem = qualifier.snaktype == 'value' and qualifier.datavalue.type == 'wikibase-entityid' local qualifierValues = mw.text.split(qualifierValue, ',') for _, qualifierHas in ipairs(qualifierValues) do -- per le proprietà di tipo item il confronto è eseguito sull'id if formatSnak(qualifier, isItem and { formatting = 'raw' } or {}) == qualifierHas then ret = true break end end end return ret end
-- Restituisce i claim con il rank richiesto local function filterRankValue(claims, rank) local ret = {} for _, claim in ipairs(claims) do if claim.rank == rank then table.insert(ret, claim) end end return ret end
-- Restituisce una sequence Lua contenente gli statement per la property richiesta, -- anche vuota se la proprietà non esiste, o non ci sono valori che soddisfano i criteri -- ("rank", "qualifier", "qualifiertype", "noqualifier", ...). -- Restituisce nil solo se la pagina non è collegata a un elemento Wikidata e non è indicato il from. local function getClaims(propertyId, args) local entityId, claims, filteredClaims
entityId = args.from or mw.wikibase.getEntityIdForCurrentPage() if not entityId then return nil end
-- il default rank è 'best' args.rank = args.rank or 'best' if args.rank == 'best' then claims = mw.wikibase.getBestStatements(entityId, propertyId) else -- statements filtrati per rank claims = mw.wikibase.getAllStatements(entityId, propertyId) claims = filterRankValue(claims, args.rank) end
-- statements filtrati per snaktype, default "value" args.snaktype = args.snaktype or 'value' if args.snaktype and args.snaktype ~= 'all' then filteredClaims = {} for _, claim in ipairs(claims) do if claim.mainsnak.snaktype == args.snaktype then table.insert(filteredClaims, claim) end end claims = filteredClaims end
-- statements filtrati per qualifier if args.qualifier then filteredClaims = {} for _, claim in ipairs(claims) do if claim.qualifiers and claim.qualifiers[args.qualifier] then if args.qualifiervalue then if hasQualifierValue(claim, args.qualifier, args.qualifiervalue) then table.insert(filteredClaims, claim) end else table.insert(filteredClaims, claim) end end end claims = filteredClaims end
-- statements filtrati per essere senza un qualifier if args.noqualifier then filteredClaims = {} for _, claim in ipairs(claims) do if not (claim.qualifiers and claim.qualifiers[args.noqualifier]) then table.insert(filteredClaims, claim) end end claims = filteredClaims end
-- statements filtrati per non avere un certo valore a un certo qualifier opzionale if args.qualifieroptnovalue and args.qualifiervalue then filteredClaims = {} for _, claim in ipairs(claims) do if claim.qualifiers and claim.qualifiers[args.qualifieroptnovalue] then if not hasQualifierValue(claim, args.qualifieroptnovalue, args.qualifiervalue) then table.insert(filteredClaims, claim) end else table.insert(filteredClaims, claim) end end claims = filteredClaims end
-- con args.qualifiertype=latest restituisce solo il più recente if args.qualifier and args.qualifiertype == 'latest' then local latest, latestTime for _, claim in ipairs(claims) do if claim.qualifiers and claim.qualifiers[args.qualifier] then for _, qualifier in ipairs(claim.qualifiers[args.qualifier]) do if qualifier.datavalue.type == 'time' then if not latestTime or qualifier.datavalue.value.time > latestTime then latest = claim latestTime = qualifier.datavalue.value.time end end end end end claims = latest and { latest } or {} end
-- con args.n restituisce solo l'n-esimo elemento if args.n then local n = tonumber(args.n) claims = (n and n <= #claims) and { claims[n] } or {} end
return claims end
-- Funzioni esportate per altri moduli
function p._getClaims(propertyId, args) return getClaims(propertyId, args or {}) end
function p._formatStatement(statement, args) return formatStatement(statement, args or {}) end
function p._formatQualifiers(claim, qualifierId, args, rawTable, retTable) return formatQualifiers(claim, qualifierId, args or {}, rawTable, retTable) end
-- Restituisce il valore di una proprietà di Wikidata oppure nil se l'entity o -- la proprietà non esistono, o se per parametri di selezione gli statement sono zero. function p._getProperty(args, rawTable) local propertyId, value, claims, ret
-- parametri posizionali propertyId = args[1] and string.upper(args[1]) if not propertyId then error(i18n.errors['property-param-not-provided'], 2) end value = args[2] -- fix uppercase args.qualifier = args.qualifier and string.upper(args.qualifier)
if value then ret = formatUserValue(value, args) elseif args.wd ~= 'no' then claims = getClaims(propertyId, args) ret = (claims and #claims > 0) and formatStatements(claims, args, rawTable) or nil end
return ret end
-- Restituisce il valore di un qualifier di una proprietà di Wikidata, -- o nil se l'entity o la proprietà non esistono, o se per parametri di selezione non ci sono risultati. function p._getQualifier(args) local propertyId, qualifierId, value, claims, ret
-- parametri posizionali propertyId = args[1] and string.upper(args[1]) if not propertyId then error(i18n.errors['property-param-not-provided'], 2) end qualifierId = args[2] and string.upper(args[2]) if not qualifierId then error(i18n.errors['qualifier-param-not-provided'], 2) end value = args[3]
if value then ret = formatUserValue(value, args) elseif args.wd ~= 'no' then claims = getClaims(propertyId, args) if claims and #claims > 0 then local formattedQualifiers = {} for _, claim in ipairs(claims) do formattedQualifiers = formatQualifiers(claim, qualifierId, args, true, formattedQualifiers) end ret = #formattedQualifiers > 0 and mw.text.listToText(formattedQualifiers, args.separator, args.conjunction) or nil end end
return ret end
-- Restituisce l'indice dello statement con il valore richiesto, o nil se non trovato. function p._indexOf(args) local ret, propertyId, value, claims
-- parametri posizionali propertyId = args[1] and string.upper(args[1]) if not propertyId then error(i18n.errors['property-param-not-provided'], 2) end value = args[2] if not value then error(i18n.errors['value-param-not-provided'], 2) end
claims = getClaims(propertyId, args) if claims and #claims > 0 then args.formatting = 'raw' for i, claim in ipairs(claims) do if formatStatement(claim, args) == value then ret = i break end end end
return ret end
-- Restituisce il numero di statement di una proprietà di Wikidata. function p._N(args) local propertyId, claims
-- parametri posizionali propertyId = args[1] and string.upper(args[1]) if not propertyId then error(i18n.errors['property-param-not-provided'], 2) end -- get claims claims = getClaims(propertyId, args)
return claims and #claims or 0 end
-- Restituisce true se la propriertà specificata ha come valore -- almeno uno tra gli entityId passati come argomento. function p._propertyHasEntity(propertyId, args) local statements = p._getProperty({ propertyId, from = args.from, formatting = 'raw' }, true) if statements then for _, statement in ipairs(statements) do for _, entityId in ipairs(args) do if statement == entityId then return true end end end
-- Se non è stato trovato alcun valore, controlla se questo sia ereditato -- tramite la proprietà "sottoclasse di" (P279) scavando in profondità -- fino all'esaurirsi del numero specificato in args.recursion. --[[ TODO: Valutare se sia opportuna una ricerca ricorsiva potenzialmente infinita. Per farlo si può aggiungere un parametro (opzionale) maxDepth che svolga l'attuale funzione di recursion e cambiare quest'ultimo in un parametro booleano. ]] args.recursion = tonumber(args.recursion) or 0 if args.recursion > 0 then local recursion = args.recursion if type(args.loadedEntities) ~= 'table' then args.loadedEntities = setmetatable({}, { __newindex = function(t, k, v) rawset(t, k, v) rawset(t, #t+1, k) end }) args.loadedEntities[args.from or mw.wikibase.getEntityIdForCurrentPage()] = true end for _, statement in ipairs(statements) do if not args.loadedEntities[statement] then args.loadedEntities[statement] = true args.recursion = args.recursion - 1 args.from = statement if p._propertyHasEntity('P279', args) then return true, args.loadedEntities end args.recursion = recursion end end end end
return false, args.loadedEntities end
-- Restituisce true se la proprietà P31 (instance of) ha come valore almeno uno tra gli entityId specificati function p._instanceOf(args) return p._propertyHasEntity('P31', args) end
-- Restituisce true se la proprietà P279 (subclass of) ha come valore almeno uno tra gli entityId specificati function p._subclassOf(args) return p._propertyHasEntity('P279', args) end
-- Restituisce l'etichetta di un item o di una proprietà Wikidata. function p._getLabel(args) local entityId = args[1] and string.upper(args[1]) local ret if args[2] then ret = mw.wikibase.getLabelByLang(entityId, args[2]) else ret = mw.wikibase.getLabel(entityId) end return ret end
-- Restituisce la descrizione di un item o di una proprietà Wikidata. function p._getDescription(args) local entityId = args[1] and string.upper(args[1]) local ret = mw.wikibase.getDescription(entityId) return ret end
-- Restituisce il titolo della pagina collegata a un dato item Wikidata. function p._getLink(args) -- parametri posizionali local entityId = args[1] and string.upper(args[1]) if not entityId then error(i18n.errors['entityid-param-not-provided'], 2) end
return entityId:sub(1, 1) == 'Q' and formatEntityId(entityId) or nil end
-- Restituisce il datatype di una proprietà Wikidata. function p._getDatatype(args) local propertyId, entity
-- parametri posizionali propertyId = args[1] and string.upper(args[1]) if not propertyId then error(i18n.errors['property-param-not-provided'], 2) end
entity = mw.wikibase.getEntity(propertyId) if not entity then error(i18n.errors['entity-not-found'], 2) end
if not i18n.datatypes[entity.datatype] then error(i18n.errors['unknown-datavalue-type'], 2) end
return i18n.datatypes[entity.datatype] end
-- Restituisce l'ID dell'item Wikidata collegato alla pagina corrente o a una pagina specificata -- (nota: se il parametro followRedirects è valorizzato con "no", segue i redirect fermandosi al primo redirect collegato a un elemento) function p._getId(args) local ret local followRedirects = not args.followRedirects or args.followRedirects ~= "no" if args[1] then local title = mw.title.new(args[1]) while title do local id = mw.wikibase.getEntityIdForTitle(title.prefixedText) if id then ret = id break else title = followRedirects and title.redirectTarget or nil end end else ret = mw.wikibase.getEntityIdForCurrentPage() end return ret end
-- Funzioni esportate per i template
-- Funzione per il template Lua error in Modul:Wd at line 208: attempt to index field 'errors' (a nil value). function p.getProperty(frame) return select(2, xpcall(function() return p._getProperty(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataQ function p.getQualifier(frame) return select(2, xpcall(function() return p._getQualifier(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataIdx function p.indexOf(frame) return select(2, xpcall(function() return p._indexOf(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataN function p.N(frame) return select(2, xpcall(function() return p._N(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataLabel function p.getLabel(frame) return select(2, xpcall(function() return p._getLabel(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataDescription function p.getDescription(frame) return select(2, xpcall(function() return p._getDescription(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataLink function p.getLink(frame) return select(2, xpcall(function() return p._getLink(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataIstanza function p.instanceOf(frame) return select(2, xpcall(function() return p._instanceOf(getArgs(frame, { parentOnly = true })) and 1 or end, errhandler)) end
-- Funzione per il template Templat:WikidataTipo function p.getDatatype(frame) return select(2, xpcall(function() return p._getDatatype(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataId function p.getId(frame) return select(2, xpcall(function() return p._getId(getArgs(frame, { parentOnly = true })) end, errhandler)) end
-- Funzione per il template Templat:WikidataValido function p.checkProperty(frame) return select(2, xpcall(function() return p._N(getArgs(frame, { parentOnly = true })) > 0 and 1 or end, errhandler)) end
-- Funzione per il template Templat:WikidataClasse function p.propertyHasEntity(frame) local args = getArgs(frame) local propertyId = args[1] return select(2, xpcall(function() return p._propertyHasEntity(propertyId, args) and 1 or end, errhandler)) end
-- Wikivoyage custom functions function p.prefisso_completo(frame) local prefisso_nazionale = p._getProperty( { 'P474', n = 1, from = 'P17', formatting = 'raw' } ) local prefissi_locali = p._getProperty( { 'P473', conjunction=', ' } ) or if prefisso_nazionale then return prefisso_nazionale .. ' ' .. prefissi_locali else return prefissi_locali end end
function p.unescoCategories(frame) local entityId = frame.args and frame.args.from or mw.wikibase.getEntityIdForCurrentPage() local output = local dataFine =
local claims = entityId and p._getClaims('P17', { from = entityId }) or {} for _, claim in ipairs(claims) do local Paese = mw.wikibase.getLabel( claim.mainsnak.datavalue.value.id ) local dataFine = p._formatQualifiers(claim, 'P582') if Paese and not dataFine then output = output .. "Categoria:Patrimoni Mondiali dell'Umanità (" .. Paese .. ')' end end
return output end
local function _getFormattedProperty(property, frame) if property == nil then return nil end local rounding = frame.args and frame.args.rounding or 0 -- uso "de", al posto di "it" per dafult perché la sua sintassi è in linea con quella italiana: -- it: 1234.56 -> 1 234,56 -- de: 1234.56 -> 1.234,56 local lang = frame.args and frame.args.lang or 'de' local value = p._getProperty( { property, unit='metro', n=1, rounding=rounding } )
return value and mw.language.new( lang ):formatNum( tonumber(value) ) end
function p.altitudine(frame) return _getFormattedProperty('P2044', frame) end
return p