Module:Wd: Difference between revisions

Content deleted Content added
Another Wikidata bug in geo coordinates has been fixed
update from sandbox
 
(181 intermediate revisions by 12 users not shown)
Line 1:
-- Original module located at [[:en:Module:Wd]] and [[:en:Module:Wd/i18n]].
 
require("strict")
local p = {}
local module_arg = ...
local i18n
local i18nPath
 
local function loadI18n(aliasesP, frame)
local title
 
if frame then
-- current module invoked by page/template, get its title from frame
title = frame:getTitle()
else
-- current module included by other module, get its title from ...
title = module_arg
end
 
if not i18n then
i18nPath = title .. "/i18n"
i18n = require(i18nPath).init(aliasesP)
end
end
 
p.claimCommands = {
property = "property",
properties = "properties",
qualifier = "qualifier",
qualifiers = "qualifiers",
reference = "reference",
references = "references"
}
 
p.generalCommands = {
label = "label",
title = "title",
description = "description",
alias = "alias",
aliases = "aliases",
badge = "badge",
badges = "badges"
}
 
p.flags = {
linked = "linked",
short = "short",
raw = "raw",
multilanguage = "multilanguage",
unit = "unit",
-------------
preferred = "preferred",
normal = "normal",
deprecated = "deprecated",
best = "best",
future = "future",
current = "current",
former = "former",
edit = "edit",
editAtEnd = "edit@end",
mdy = "mdy",
single = "single",
sourced = "sourced"
}
 
p.args = {
eid = "eid",
page = "page",
date = "date",
globalSiteId = "globalSiteId"
}
 
local aliasesP = {
coord = "P625",
-----------------------
authorimage = "P50P18",
publisherauthor = "P123P50",
importedFromauthorNameString = "P143P2093",
statedInpublisher = "P248P123",
publicationDateimportedFrom = "P577P143",
startTime wikimediaImportURL = "P580P4656",
endTimestatedIn = "P582P248",
retrievedpages = "P813P304",
referenceURLlanguage = "P854P407",
archiveURLhasPart = "P1065P527",
title publicationDate = "P1476P577",
quotestartTime = "P1683P580",
shortNameendTime = "P1813P582",
languagechapter = "P2439P792",
archiveDateretrieved = "P2960P813",
referenceURL = "P854",
sectionVerseOrParagraph = "P958",
archiveURL = "P1065",
title = "P1476",
formatterURL = "P1630",
quote = "P1683",
shortName = "P1813",
definingFormula = "P2534",
archiveDate = "P2960",
inferredFrom = "P3452",
typeOfReference = "P3865",
column = "P3903",
subjectNamedAs = "P1810",
wikidataProperty = "P1687",
publishedIn = "P1433",
lastUpdate = "P5017"
}
 
local aliasesQ = {
percentage = "Q11229",
prolepticJulianCalendar = "Q1985786",
citeWeb = "Q5637226",
citeQ = "Q22321052"
}
 
Line 30 ⟶ 118:
qualifier = "%q",
reference = "%r",
separatoralias = "%sa",
badge = "%b",
separator = "%s",
general = "%x"
}
 
Line 37 ⟶ 128:
qualifier = "%q[%s][%r]",
reference = "%r",
propertyWithQualifier = "%p[ <span style=\"font-size:smaller85\\%\">(%q)</span>][%s][%r]",
alias = "%a[%s]",
badge = "%b[%s]"
}
 
local hookNames = { -- {level_1, level_2}
[parameters.property] = {"getProperty"},
-- {level_1, level_2}
[parameters.propertyreference] = {"getPropertygetReferences", "getReference"},
[parameters.qualifier] = {"getQualifiers", "getQualifiergetAllQualifiers"},
[parameters.referencequalifier.."\\d"] = {"getReferencesgetQualifiers", "getReferencegetQualifier"},
[parameters.alias] = {"getAlias"},
[parameters.badge] = {"getBadge"}
}
 
-- default value objects, should NOT be mutated but instead copied
local Config = {}
local defaultSeparators = {
Config.__index = Config
["sep"] = {" "},
["sep%s"] = {","},
["sep%q"] = {"; "},
["sep%q\\d"] = {", "},
["sep%r"] = nil, -- none
["punc"] = nil -- none
}
 
local rankTable = {
-- allows for recursive calls
["preferred"] = 1,
function Config.new()
local["normal"] cfg = {}2,
["deprecated"] = 3
setmetatable(cfg, Config)
}
 
cfg.separators = {
local function replaceAlias(id)
-- use tables so that we can pass by reference
if aliasesP[id] then
["sep"] = {" "},
id = aliasesP[id]
["sep%s"] = {","},
end
["sep%q"] = {", "},
 
["sep%r"] = {""},
return id
["punc"] = {""}
}
cfg.entity = nil
cfg.propertyID = nil
cfg.propertyValue = nil
cfg.qualifierID = nil
cfg.bestRank = true
cfg.foundRank = 3
cfg.maxRank = nil
cfg.minRank = nil
cfg:setRankBoundaries("best")
cfg.period = 0
cfg.mdyDate = false
cfg.pageTitle = false
cfg.langCode = mw.language.getContentLanguage().code
cfg.langName = mw.language.fetchLanguageName(cfg.langCode, cfg.langCode)
cfg.langObj = mw.language.new(cfg.langCode)
cfg.states = {}
cfg.curState = nil
return cfg
end
 
local Statefunction =errorText(code, {}...)
local text = i18n["errors"][code]
State.__index = State
if arg then text = mw.ustring.format(text, unpack(arg)) end
return text
end
 
local function State.newthrowError(cfgerrorMessage, ...)
error(errorText(errorMessage, unpack(arg)))
local stt = {}
setmetatable(stt, State)
stt.conf = cfg
stt.outPreferred = {}
stt.outNormal = {}
stt.outDeprecated = {}
stt.parsedFormat = {}
stt.separator = {}
stt.movSeparator = {}
stt.puncMark = {}
stt.linked = false
stt.rawValue = false
stt.shortName = false
stt.singleValue = false
return stt
end
 
local function unknownDataTypeErrorreplaceDecimalMark(dataTypenum)
return mw.ustring.gsub(num, "[.]", i18n['numeric']['decimal-mark'], 1)
return "<strong class=\"error\">Unknown or unsupported datatype '" .. dataType .. "'.</strong>"
end
 
local function padZeros(num, numDigits)
function missingRequiredParameterError()
local numZeros
return "<strong class=\"error\">No required parameters defined, needing at least one.</strong>"
local negative = false
 
if num < 0 then
negative = true
num = num * -1
end
 
num = tostring(num)
numZeros = numDigits - num:len()
 
for _ = 1, numZeros do
num = "0"..num
end
 
if negative then
num = "-"..num
end
 
return num
end
 
local function extraRequiredParameterErrorreplaceSpecialChar(paramchr)
if chr == '_' then
return "<strong class=\"error\">Parameter '" .. param .. "' must be defined as optional.</strong>"
-- replace underscores with spaces
return ' '
else
return chr
end
end
 
local function parseWikidataURLreplaceSpecialChars(urlstr)
local i, jchr
local esc = false
local strOut = ""
 
for i = 1, #str do
chr = str:sub(i,i)
 
if not esc then
if chr == '\\' then
esc = true
else
strOut = strOut .. replaceSpecialChar(chr)
end
else
strOut = strOut .. chr
esc = false
end
end
 
return strOut
end
 
local function buildWikilink(target, label)
if not label or target == label then
return "[[" .. target .. "]]"
else
return "[[" .. target .. "|" .. label .. "]]"
end
end
 
-- used to make frame.args mutable, to replace #frame.args (which is always 0)
-- with the actual amount and to simply copy tables
local function copyTable(tIn)
if not tIn then
return nil
end
 
local tOut = {}
 
for i, v in pairs(tIn) do
tOut[i] = v
end
 
return tOut
end
 
-- used to merge output arrays together;
-- note that it currently mutates the first input array
local function mergeArrays(a1, a2)
for i = 1, #a2 do
a1[#a1 + 1] = a2[i]
end
 
return a1
end
 
local function split(str, del)
local out = {}
local i, j = str:find(del)
 
if i and j then
out[1] = str:sub(1, i - 1)
out[2] = str:sub(j + 1)
else
out[1] = str
end
 
return out
end
 
local function parseWikidataURL(url)
local id
 
if url:match('^http[s]?://') then
i, jid = url:findsplit(url, "Q")
 
if iid[2] then
return url:sub(i)"Q" .. id[2]
end
end
 
return nil
end
 
local function parseDate(dateStr, precision)
precision = precision or "d"
 
local i, j, index, ptr
local parts = {nil, nil, nil}
 
if dateStr == nil then
return parts[1], parts[2], parts[3] -- year, month, day
end
 
-- 'T' for snak values, '/' for outputs with '/Julian' attached
i, j = dateStr:find("[T/]")
 
if i then
dateStr = dateStr:sub(1, i-1)
end
 
local from = 1
 
if dateStr:sub(1,1) == "-" then
-- this is a negative number, look further ahead
from = 2
end
 
index = 1
ptr = 1
 
i, j = dateStr:find("-", from)
 
if i then
-- year
parts[index] = tonumber(mw.ustring.gsub(dateStr:sub(ptr, i-1), "^\+(.+)$", "%1"), 10) -- removeexplicitly give base 10 to +prevent signerror
 
if parts[index] == -0 then
parts[index] = tonumber("0") -- for some reason, 'parts[index] = 0' may actually store '-0', so parse from string instead
parts[index] = 0
end
 
if precision == "y" then
-- we're done
return parts[1], parts[2], parts[3] -- year, month, day
end
 
index = index + 1
ptr = i + 1
 
i, j = dateStr:find("-", ptr)
 
if i then
-- month
parts[index] = tonumber(dateStr:sub(ptr, i-1), 10)
 
if precision == "m" then
-- we're done
return parts[1], parts[2], parts[3] -- year, month, day
end
 
index = index + 1
ptr = i + 1
end
end
 
if dateStr:sub(ptr) ~= "" then
-- day if we have month, month if we have year, or year
parts[index] = tonumber(dateStr:sub(ptr), 10)
end
 
return parts[1], parts[2], parts[3] -- year, month, day
end
 
local function convertUnitdatePrecedesDate(unitaY, aM, aD, bY, bM, linkbD)
link = link or false
local itemID, label, title
if unit == "" or unit == "1" then
return nil
end
itemID = parseWikidataURL(unit)
if itemID then
if itemID == aliasesQ.percentage then
return "%"
else
label = mw.wikibase.label(itemID)
title = nil
if link or label == nil then
title = mw.wikibase.sitelink(itemID)
end
if link then
if title then
return " " .. "[[" .. title .. "|" .. (label or title) .. "]]"
end
if not label then
return " " .. "[[d:" .. itemID .. "|" .. itemID .. "]]"
end
end
return " " .. (label or title or itemID)
end
end
return " " .. unit
end
 
function getOrdinalSuffix(num)
if tostring(num):sub(-2,-2) == '1' then
return "th" -- 10th, 11th, 12th, 13th, ... 19th
end
num = tostring(num):sub(-1)
if num == '1' then
return "st"
elseif num == '2' then
return "nd"
elseif num == '3' then
return "rd"
else
return "th"
end
end
 
function addDecimalMarks(n)
local left,num,right = string.match(n,'^([^%d]*%d)(%d*)(.-)$')
return left..(num:reverse():gsub('(%d%d%d)','%1,'):reverse())..right
end
 
function convertRank(rank)
if (rank == "preferred") then
return 1
elseif (rank == "normal") then
return 2
elseif (rank == "deprecated") then
return 3
else
return 4 -- default (in its literal sense)
end
end
 
function datePrecedesDate(aY, aM, aD, bY, bM, bD)
if aY == nil or bY == nil then
return nil
Line 291 ⟶ 374:
bM = bM or 1
bD = bD or 1
 
if aY < bY then
return true
end
 
if aY > bY then
return false
end
 
if aM < bM then
return true
end
 
if aM > bM then
return false
end
 
if aD < bD then
return true
end
 
return false
end
 
local function alwaysTruegetHookName(param, index)
if hookNames[param] then
return hookNames[param][index]
elseif param:len() > 2 then
return hookNames[param:sub(1, 2).."\\d"][index]
else
return nil
end
end
 
local function alwaysTrue()
return true
end
 
-- The following function parses a format string.
function parseFormat(str)
--
local chr, esc, param, root, cur
-- The example below shows how a parsed string is structured in memory.
-- Variables other than 'str' and 'child' are left out for clarity's sake.
--
-- Example:
-- "A %p B [%s[%q1]] C [%r] D"
--
-- Structure:
-- [
-- {
-- str = "A "
-- },
-- {
-- str = "%p"
-- },
-- {
-- str = " B ",
-- child =
-- [
-- {
-- str = "%s",
-- child =
-- [
-- {
-- str = "%q1"
-- }
-- ]
-- }
-- ]
-- },
-- {
-- str = " C ",
-- child =
-- [
-- {
-- str = "%r"
-- }
-- ]
-- },
-- {
-- str = " D"
-- }
-- ]
--
local function parseFormat(str)
local chr, esc, param, root, cur, prev, new
local params = {}
 
local function newObject(array)
local obj = {} -- new object
obj.str = ""
 
array[#array + 1] = obj -- array{object}
obj.parent = array
 
return obj
end
 
local function endParam()
if param > 0 then
if cur.str ~= "" then
cur.str = "%"..cur.str
cur.param = true
params[cur.str] = true
cur.parent.req[cur.str] = true
prev = cur
cur = newObject(cur.parent)
end
param = 0
end
end
 
root = {} -- array
root.req = {}
cur = newObject(root)
prev = nil
 
esc = false
param = false0
 
for i = 1, #str do
chr = str:sub(i,i)
 
if not esc then
if chr == '\\' then
endParam()
esc = true
elseif chr == '%' then
endParam()
cur = newObject(cur.parent)
paramif cur.str ~= true"" then
cur = newObject(cur.parent)
end
param = 2
elseif chr == '[' then
endParam()
if prev and cur.str == "" then
table.remove(cur.parent)
cur = prev
end
cur.child = {} -- new array
cur.child.req = {}
cur.child.parent = cur
cur = newObject(cur.child)
elseif chr == ']' then
endParam()
if cur.parent.parent then
new = newObject(cur.parent.parent.parent)
if cur.str == "" then
table.remove(cur.parent)
end
cur = new
end
else
if chrparam ==> '['1 then
cur.childparam = {} param -- new array1
cur.child.reqelseif param == 1 {}then
if not chr:match('%d') then
cur.child.parent = cur
cur = newObject endParam(cur.child)
elseif chr == ']' then
if cur.parent.parent then
cur = newObject(cur.parent.parent.parent)
end
else
cur.str = cur.str .. chr
if param then
cur.str = "%"..cur.str
cur.param = true
params[cur.str] = true
cur.parent.req[cur.str] = true
cur = newObject(cur.parent)
end
end
 
cur.str = cur.str .. replaceSpecialChar(chr)
param = false
end
else
cur.str = cur.str .. chr
esc = false
if param then
cur.str = "%"..cur.str
cur.param = true
params[cur.str] = true
cur.parent.req[cur.str] = true
cur = newObject(cur.parent)
param = false
end
end
 
prev = nil
end
 
endParam()
 
-- make sure that at least one required parameter has been defined
if not next(root.req) then
throwError("missing-required-parameter")
end
 
-- make sure that the separator parameter "%s" is not amongst the required parameters
if root.req[parameters.separator] then
throwError("extra-required-parameter", parameters.separator)
end
 
return root, params
end
 
local function getShortNamesortOnRank(itemIDclaims)
local rankPos
return p._property({itemID, aliasesP.shortName}) -- "property" is single
local ranks = {{}, {}, {}, {}} -- preferred, normal, deprecated, (default)
local sorted = {}
 
for _, v in ipairs(claims) do
rankPos = rankTable[v.rank] or 4
ranks[rankPos][#ranks[rankPos] + 1] = v
end
 
sorted = ranks[1]
sorted = mergeArrays(sorted, ranks[2])
sorted = mergeArrays(sorted, ranks[3])
 
return sorted
end
 
local function isValueInTable(searchedItem, inputTable)
function getLabel(ID)
for _, item in pairs(inputTable) do
return p._label({ID})
if item == searchedItem then
return true
end
end
return false
end
 
local Config = {}
function Config:getValue(snak, raw, link, short, anyLang)
 
raw = raw or false
-- allows for recursive calls
link = link or false
function Config:new()
short = short or false
local cfg = {}
anyLang = anyLang or false
setmetatable(cfg, self)
self.__index = self
 
cfg.separators = {
-- single value objects wrapped in arrays so that we can pass by reference
["sep"] = {copyTable(defaultSeparators["sep"])},
["sep%s"] = {copyTable(defaultSeparators["sep%s"])},
["sep%q"] = {copyTable(defaultSeparators["sep%q"])},
["sep%r"] = {copyTable(defaultSeparators["sep%r"])},
["punc"] = {copyTable(defaultSeparators["punc"])}
}
 
cfg.entity = nil
cfg.entityID = nil
cfg.propertyID = nil
cfg.propertyValue = nil
cfg.qualifierIDs = {}
cfg.qualifierIDsAndValues = {}
 
cfg.bestRank = true
cfg.ranks = {true, true, false} -- preferred = true, normal = true, deprecated = false
cfg.foundRank = #cfg.ranks
cfg.flagBest = false
cfg.flagRank = false
 
cfg.periods = {true, true, true} -- future = true, current = true, former = true
cfg.flagPeriod = false
cfg.atDate = {parseDate(os.date('!%Y-%m-%d'))} -- today as {year, month, day}
 
cfg.mdyDate = false
cfg.singleClaim = false
cfg.sourcedOnly = false
cfg.editable = false
cfg.editAtEnd = false
 
cfg.inSitelinks = false
 
cfg.langCode = mw.language.getContentLanguage().code
cfg.langName = mw.language.fetchLanguageName(cfg.langCode, cfg.langCode)
cfg.langObj = mw.language.new(cfg.langCode)
 
cfg.siteID = mw.wikibase.getGlobalSiteId()
 
cfg.states = {}
cfg.states.qualifiersCount = 0
cfg.curState = nil
 
cfg.prefetchedRefs = nil
 
return cfg
end
 
local State = {}
 
function State:new(cfg, type)
local stt = {}
setmetatable(stt, self)
self.__index = self
 
stt.conf = cfg
stt.type = type
 
stt.results = {}
 
stt.parsedFormat = {}
stt.separator = {}
stt.movSeparator = {}
stt.puncMark = {}
 
stt.linked = false
stt.rawValue = false
stt.shortName = false
stt.anyLanguage = false
stt.unitOnly = false
stt.singleValue = false
 
return stt
end
 
-- if id == nil then item connected to current page is used
function Config:getLabel(id, raw, link, short)
local label = nil
local prefix, title= "", nil
 
if not id then
id = mw.wikibase.getEntityIdForCurrentPage()
 
if not id then
return ""
end
end
 
id = id:upper() -- just to be sure
 
if raw then
-- check if given id actually exists
if mw.wikibase.isValidEntityId(id) and mw.wikibase.entityExists(id) then
label = id
end
 
prefix, title = "d:Special:EntityPage/", label -- may be nil
else
-- try short name first if requested
if short then
label = p._property{aliasesP.shortName, [p.args.eid] = id} -- get short name
 
if label == "" then
label = nil
end
end
 
-- get label
if not label then
label = mw.wikibase.getLabel(id)
end
end
 
if not label then
label = ""
elseif link then
-- build a link if requested
if not title then
if id:sub(1,1) == "Q" then
title = mw.wikibase.getSitelink(id)
elseif id:sub(1,1) == "P" then
-- properties have no sitelink, link to Wikidata instead
prefix, title = "d:Special:EntityPage/", id
end
end
 
label = mw.text.nowiki(label) -- escape raw label text so it cannot be wikitext markup
if title then
label = buildWikilink(prefix .. title, label)
end
end
 
return label
end
 
function Config:getEditIcon()
local value = ""
local prefix = ""
local front = "&nbsp;"
local back = ""
 
if self.entityID:sub(1,1) == "P" then
prefix = "Property:"
end
 
if self.editAtEnd then
front = '<span style="float:'
 
if self.langObj:isRTL() then
front = front .. 'left'
else
front = front .. 'right'
end
 
front = front .. '">'
back = '</span>'
end
 
value = "[[File:OOjs UI icon edit-ltr-progressive.svg|frameless|text-top|10px|alt=" .. i18n['info']['edit-on-wikidata'] .. "|link=https://www.wikidata.org/wiki/" .. prefix .. self.entityID .. "?uselang=" .. self.langCode
 
if self.propertyID then
value = value .. "#" .. self.propertyID
elseif self.inSitelinks then
value = value .. "#sitelinks-wikipedia"
end
 
value = value .. "|" .. i18n['info']['edit-on-wikidata'] .. "]]"
 
return front .. value .. back
end
 
-- used to create the final output string when it's all done, so that for references the
-- function extensionTag("ref", ...) is only called when they really ended up in the final output
function Config:concatValues(valuesArray)
local outString = ""
local j, skip
 
for i = 1, #valuesArray do
-- check if this is a reference
if valuesArray[i].refHash then
j = i - 1
skip = false
 
-- skip this reference if it is part of a continuous row of references that already contains the exact same reference
while valuesArray[j] and valuesArray[j].refHash do
if valuesArray[i].refHash == valuesArray[j].refHash then
skip = true
break
end
j = j - 1
end
 
if not skip then
-- add <ref> tag with the reference's hash as its name (to deduplicate references)
outString = outString .. mw.getCurrentFrame():extensionTag("ref", valuesArray[i][1], {name = valuesArray[i].refHash})
end
else
outString = outString .. valuesArray[i][1]
end
end
 
return outString
end
 
function Config:convertUnit(unit, raw, link, short, unitOnly)
local space = " "
local label = ""
local itemID
 
if unit == "" or unit == "1" then
return nil
end
 
if unitOnly then
space = ""
end
 
itemID = parseWikidataURL(unit)
 
if itemID then
if itemID == aliasesQ.percentage then
return "%"
else
label = self:getLabel(itemID, raw, link, short)
 
if label ~= "" then
return space .. label
end
end
end
 
return ""
end
 
function State:getValue(snak)
return self.conf:getValue(snak, self.rawValue, self.linked, self.shortName, self.anyLanguage, self.unitOnly, false, self.type:sub(1,2))
end
 
function Config:getValue(snak, raw, link, short, anyLang, unitOnly, noSpecial, type)
if snak.snaktype == 'value' then
iflocal datatype = snak.datavalue.type == 'string' then
returnlocal subtype = snak.datavalue.valuedatatype
elseiflocal datavalue = snak.datavalue.type == 'monolingualtext' thenvalue
 
if anyLang then
if datatype == 'string' then
return snak.datavalue.value['text'], snak.datavalue.value['language']
if subtype == 'url' and link then
elseif snak.datavalue.value['language'] == self.langCode then
-- create link explicitly
return snak.datavalue.value['text']
if raw then
-- will render as a linked number like [1]
return "[" .. datavalue .. "]"
else
return "[" .. datavalue .. " " .. datavalue .. "]"
end
elseif subtype == 'commonsMedia' then
if link then
return buildWikilink("c:File:" .. datavalue, datavalue)
elseif not raw then
return "[[File:" .. datavalue .. "]]"
else
return datavalue
end
elseif subtype == 'geo-shape' and link then
return buildWikilink("c:" .. datavalue, datavalue)
elseif subtype == 'math' and not raw then
local attribute = nil
 
if (type == parameters.property or (type == parameters.qualifier and self.propertyID == aliasesP.hasPart)) and snak.property == aliasesP.definingFormula then
attribute = {qid = self.entityID}
end
 
return mw.getCurrentFrame():extensionTag("math", datavalue, attribute)
elseif subtype == 'external-id' and link then
local url = p._property{aliasesP.formatterURL, [p.args.eid] = snak.property} -- get formatter URL
 
if url ~= "" then
url = mw.ustring.gsub(url, "$1", datavalue)
return "[" .. url .. " " .. datavalue .. "]"
else
return datavalue
end
else
return datavalue
end
elseif datatype == 'monolingualtext' then
if anyLang or datavalue['language'] == self.langCode then
return datavalue['text']
else
return nil
end
elseif snak.datavalue.typedatatype == 'quantity' then
local value = ""
-- strip + signs from front
local unit
local value = mw.ustring.gsub(snak.datavalue.value['amount'], "^\+(.+)$", "%1")
 
if not rawunitOnly then
-- get value and strip + signs from front
value = addDecimalMarks(value)
value = mw.ustring.gsub(datavalue['amount'], "^%+(.+)$", "%1")
local unit = convertUnit(snak.datavalue.value['unit'], link)
 
if unit then
valueif =raw value .. unitthen
return value
end
 
-- replace decimal mark based on locale
value = replaceDecimalMark(value)
 
-- add delimiters for readability
value = i18n.addDelimiters(value)
end
 
unit = self:convertUnit(datavalue['unit'], raw, link, short, unitOnly)
 
if unit then
value = value .. unit
end
 
return value
elseif snak.datavalue.typedatatype == 'time' then
local y, m, d, p, yDiv, yRound, yFull, value, calendarID, dateStr
local yFactor = 1
local sign = 1
local prefix = ""
local suffix = ""
local mayAddCalendar = false
local calendar = ""
local precision = snak.datavalue.value['precision']
 
if precision == 11 then
p = "d"
Line 446 ⟶ 927:
yFactor = 10^(9-precision)
end
 
y, m, d = parseDate(snak.datavalue.value['time'], p)
 
if y < 0 then
sign = -1
y = y * sign
end
 
-- if precision is tens/hundreds/thousands/millions/billions of years
if precision <= 8 then
yDiv = y / yFactor
 
-- if precision is tens/hundreds/thousands of years
if precision >= 6 then
mayAddCalendar = true
 
if precision <= 7 then
-- round centuries/millenniums up (e.g. 20th century or 3rd millennium)
yRound = math.ceil(yDiv)
 
if not raw then
if precision == 6 then
suffix = " i18n['datetime']['suffixes']['millennium"']
else
suffix = " i18n['datetime']['suffixes']['century"']
end
 
suffix = i18n.getOrdinalSuffix(yRound) .. suffix
else
-- if not verbose, take the first year of the century/millennium
Line 483 ⟶ 964:
-- round decades down (e.g. 2010s)
yRound = math.floor(yDiv) * yFactor
 
if not raw then
prefix = i18n['datetime']['prefixes']['decade-period']
suffix = "s"
suffix = i18n['datetime']['suffixes']['decade-period']
end
end
 
if raw and sign < 0 then
-- if BCE then compensate for "counting backwards"
Line 496 ⟶ 978:
else
local yReFactor, yReDiv, yReRound
 
-- round to nearest for tens of thousands of years or more
yRound = math.floor(yDiv + 0.5)
 
if yRound == 0 then
if precision <= 2 and y ~= 0 then
Line 505 ⟶ 987:
yReDiv = y / yReFactor
yReRound = math.floor(yReDiv + 0.5)
 
if yReDiv == yReRound then
-- change precision to millions of years only if we have a whole number of them
Line 513 ⟶ 995:
end
end
 
if yRound == 0 then
-- otherwise, take the unrounded (original) number of years
Line 522 ⟶ 1,004:
end
end
 
if precision >= 1 and y ~= 0 then
yFull = yRound * yFactor
 
yReFactor = 1e9
yReDiv = yFull / yReFactor
yReRound = math.floor(yReDiv + 0.5)
 
if yReDiv == yReRound then
-- change precision to billions of years if we're in that range
Line 539 ⟶ 1,021:
yReDiv = yFull / yReFactor
yReRound = math.floor(yReDiv + 0.5)
 
if yReDiv == yReRound then
-- change precision to millions of years if we're in that range
Line 548 ⟶ 1,030:
end
end
 
if not raw then
if precision == 3 then
suffix = " i18n['datetime']['suffixes']['million -years"']
elseif precision == 0 then
suffix = " i18n['datetime']['suffixes']['billion -years"']
else
yRound = yRound * yFactor
if yRound == 1 then
suffix = " i18n['datetime']['suffixes']['year"']
else
suffix = " i18n['datetime']['suffixes']['years"']
end
end
Line 570 ⟶ 1,052:
mayAddCalendar = true
end
 
if mayAddCalendar then
calendarID = parseWikidataURL(snak.datavalue.value['calendarmodel'])
 
if calendarID and calendarID == aliasesQ.prolepticJulianCalendar then
if not raw then
if link then
calendar = " ("..buildWikilink(i18n['datetime'][Julian 'julian-calendar|Julian'], i18n['datetime']['julian'])..")"
else
calendar = " (Julian"..i18n['datetime']['julian']..")"
end
else
calendar = "/Julian"..i18n['datetime']['julian']
end
end
end
 
if not raw then
local ce = nil
 
if sign < 0 then
ce = "i18n['datetime']['BCE"']
elseif precision <= 5 then
ce = "i18n['datetime']['CE"']
end
 
if ce then
if link then
ce = "buildWikilink(i18n['datetime'][Common Era|" ..'common-era'], ce .. "]]")
end
suffix = suffix .. " " .. ce
end
 
value = tostring(yRound)
 
if m then
dateStr = self.langObj:formatDate("F", "1-"..m.."-1")
 
if d then
if self.mdyDate then
Line 615 ⟶ 1,097:
end
end
 
value = dateStr .. " " .. value
end
 
value = prefix .. value .. suffix .. calendar
else
value = tostringpadZeros(yRound * sign, 4)
 
if m then
value = value .. "-" .. padZeros(m, 2)
 
if d then
value = value .. "-" .. padZeros(d, 2)
end
end
 
value = value .. calendar
end
 
return value
elseif snak.datavalue.typedatatype == 'globecoordinate' then
-- logic from https://github.com/DataValues/Geo (v4.0.1)
 
local precision, unitsPerDegree, numDigits, strFormat, value, globe
local latValue, latitude, latDegreeslatConv, latMinuteslatValue, latSecondslatLink
local latDirectionlongitude, =lonConv, "N"lonValue, lonLink
local latDirection, latDirectionN, latDirectionS, latDirectionEN
local lonValue, longitude, lonDegrees, lonMinutes, lonSeconds
local lonDirection, =lonDirectionE, "E"lonDirectionW, lonDirectionEN
local degSymbol, minSymbol, secSymbol, separator
 
local degSymbol = "°"
local minSymbollatDegrees = "'"nil
local secSymbollatMinutes = '"'nil
local partsGluelatSeconds = ", "nil
local lonDegrees = nil
local lonMinutes = nil
if raw then
local lonSeconds = nil
 
local latDegSym = ""
local latMinSym = ""
local latSecSym = ""
local lonDegSym = ""
local lonMinSym = ""
local lonSecSym = ""
 
local latDirectionEN_N = "N"
local latDirectionEN_S = "S"
local lonDirectionEN_E = "E"
local lonDirectionEN_W = "W"
 
if not raw then
latDirectionN = i18n['coord']['latitude-north']
latDirectionS = i18n['coord']['latitude-south']
lonDirectionE = i18n['coord']['longitude-east']
lonDirectionW = i18n['coord']['longitude-west']
 
degSymbol = i18n['coord']['degrees']
minSymbol = i18n['coord']['minutes']
secSymbol = i18n['coord']['seconds']
separator = i18n['coord']['separator']
else
latDirectionN = latDirectionEN_N
latDirectionS = latDirectionEN_S
lonDirectionE = lonDirectionEN_E
lonDirectionW = lonDirectionEN_W
 
degSymbol = "/"
minSymbol = "/"
secSymbol = "/"
partsGlueseparator = "/"
end
 
latitude = snak.datavalue.value['latitude']
longitude = snak.datavalue.value['longitude']
 
if latitude < 0 then
latDirection = "S"latDirectionS
latDirectionEN = latDirectionEN_S
latitude = math.abs(latitude)
else
latDirection = latDirectionN
latDirectionEN = latDirectionEN_N
end
 
if longitude < 0 then
lonDirection = "W"lonDirectionW
lonDirectionEN = lonDirectionEN_W
longitude = math.abs(longitude)
else
lonDirection = lonDirectionE
lonDirectionEN = lonDirectionEN_E
end
 
precision = snak.datavalue.value['precision']
 
if not precision or precision <= 0 then
precision = 1 / 3600 -- precision not set (correctly), set to arcsecond
end
 
-- remove insignificant detail
latitude = math.floor(latitude / precision + 0.5) * precision
longitude = math.floor(longitude / precision + 0.5) * precision
 
if precision >= 1 - (1 / 60) and precision < 1 then
numDigits = math.ceil(-math.log10(3600 * precision))
precision = 1
elseif precision >= (1 / 60) - (1 / 3600) and precision < (1 / 60) then
if numDigits < 0 or numDigits == -0 then
numDigitsprecision = 01 / 60
end
 
if precision >= 1 then
strFormat = "%." .. numDigits .. "f"
unitsPerDegree = 1
elseif precision >= (1 / 60) then
-- use string.format() to strip decimal point followed by a zero (.0) for whole numbers
unitsPerDegree = 60
latSeconds = tonumber(string.format(strFormat, math.floor(latitude * 3600 * 10^numDigits + 0.5) / 10^numDigits))
else
lonSeconds = tonumber(string.format(strFormat, math.floor(longitude * 3600 * 10^numDigits + 0.5) / 10^numDigits))
unitsPerDegree = 3600
latMinutes = math.floor(latSeconds / 60)
lonMinutes = math.floor(lonSeconds / 60)
latSeconds = latSeconds - (latMinutes * 60)
lonSeconds = lonSeconds - (lonMinutes * 60)
latDegrees = math.floor(latMinutes / 60)
lonDegrees = math.floor(lonMinutes / 60)
latMinutes = latMinutes - (latDegrees * 60)
lonMinutes = lonMinutes - (lonDegrees * 60)
latValue = latDegrees .. degSymbol
lonValue = lonDegrees .. degSymbol
if precision < 1 then
latValue = latValue .. latMinutes .. minSymbol
lonValue = lonValue .. lonMinutes .. minSymbol
end
 
numDigits = math.ceil(-math.log10(unitsPerDegree * precision))
if precision < (1 / 60) then
 
latSeconds = string.format(strFormat, latSeconds)
if numDigits <= 0 then
lonSeconds = string.format(strFormat, lonSeconds)
numDigits = tonumber("0") -- for some reason, 'numDigits = 0' may actually store '-0', so parse from string instead
latValue = latValue .. latSeconds .. secSymbol
lonValue = lonValue .. lonSeconds .. secSymbol
end
 
latValuestrFormat = latValue"%." .. numDigits .. latDirection"f"
 
lonValue = lonValue .. lonDirection
if precision >= 1 then
latDegrees = strFormat:format(latitude)
value = latValue .. partsGlue .. lonValue
lonDegrees = strFormat:format(longitude)
 
if link then
if not raw then
globe = parseWikidataURL(snak.datavalue.value['globe'])
latDegSym = replaceDecimalMark(latDegrees) .. degSymbol
lonDegSym = replaceDecimalMark(lonDegrees) .. degSymbol
if globe then
globe = mw.wikibase.label(globe):lower()
else
latDegSym = latDegrees .. degSymbol
globe = "earth"
lonDegSym = lonDegrees .. degSymbol
end
else
latConv = math.floor(latitude * unitsPerDegree * 10^numDigits + 0.5) / 10^numDigits
value = "[https://tools.wmflabs.org/geohack/geohack.php?language="..self.langCode.."&params="..latitude.."_"..latDirection.."_"..longitude.."_"..lonDirection.."_globe:"..globe.." "..value.."]"
lonConv = math.floor(longitude * unitsPerDegree * 10^numDigits + 0.5) / 10^numDigits
end
 
if precision >= (1 / 60) then
return value
latMinutes = latConv
elseif snak.datavalue.type == 'wikibase-entityid' then
local value lonMinutes = ""lonConv
local title = nil
local itemID = "Q" .. snak.datavalue.value['numeric-id']
if raw then
if link then
return "[[d:" .. itemID .. "|" .. itemID .. "]]"
else
returnlatSeconds itemID= latConv
lonSeconds = lonConv
 
latMinutes = math.floor(latSeconds / 60)
lonMinutes = math.floor(lonSeconds / 60)
 
latSeconds = strFormat:format(latSeconds - (latMinutes * 60))
lonSeconds = strFormat:format(lonSeconds - (lonMinutes * 60))
 
if not raw then
latSecSym = replaceDecimalMark(latSeconds) .. secSymbol
lonSecSym = replaceDecimalMark(lonSeconds) .. secSymbol
else
latSecSym = latSeconds .. secSymbol
lonSecSym = lonSeconds .. secSymbol
end
end
 
latDegrees = math.floor(latMinutes / 60)
lonDegrees = math.floor(lonMinutes / 60)
 
latDegSym = latDegrees .. degSymbol
lonDegSym = lonDegrees .. degSymbol
 
latMinutes = latMinutes - (latDegrees * 60)
lonMinutes = lonMinutes - (lonDegrees * 60)
 
if precision >= (1 / 60) then
latMinutes = strFormat:format(latMinutes)
lonMinutes = strFormat:format(lonMinutes)
 
if not raw then
latMinSym = replaceDecimalMark(latMinutes) .. minSymbol
lonMinSym = replaceDecimalMark(lonMinutes) .. minSymbol
else
latMinSym = latMinutes .. minSymbol
lonMinSym = lonMinutes .. minSymbol
end
else
latMinSym = latMinutes .. minSymbol
lonMinSym = lonMinutes .. minSymbol
end
end
 
latValue = latDegSym .. latMinSym .. latSecSym .. latDirection
if short then
lonValue = lonDegSym .. lonMinSym .. lonSecSym .. lonDirection
value = getShortName(itemID)
 
end
value = latValue .. separator .. lonValue
 
if value == "" then
value = mw.wikibase.label(itemID)
end
if link or value == nil then
title = mw.wikibase.sitelink(itemID)
end
if link then
globe = parseWikidataURL(datavalue['globe'])
if title then
 
value = "[[" .. title .. "|" .. (value or title) .. "]]"
elseifif not valueglobe then
globe = mw.wikibase.getLabelByLang(globe, "en"):lower()
value = "[[d:" .. itemID .. "|" .. itemID .. "]]"
else
globe = "earth"
end
 
elseif not value then
latLink = table.concat({latDegrees, latMinutes, latSeconds}, "_")
value = (title or itemID)
lonLink = table.concat({lonDegrees, lonMinutes, lonSeconds}, "_")
 
value = "[https://geohack.toolforge.org/geohack.php?language="..self.langCode.."&params="..latLink.."_"..latDirectionEN.."_"..lonLink.."_"..lonDirectionEN.."_globe:"..globe.." "..value.."]"
end
 
return value
elseif datatype == 'wikibase-entityid' then
local label
local itemID = datavalue['numeric-id']
 
if subtype == 'wikibase-item' then
itemID = "Q" .. itemID
elseif subtype == 'wikibase-property' then
itemID = "P" .. itemID
else
return '<strong class="error">' .. errorText('unknown-data-type', subtype) .. '</strong>'
end
 
label = self:getLabel(itemID, raw, link, short)
 
if label == "" then
label = nil
end
 
return label
else
return '<strong class="error">' .. errorText('unknown-data-type', datatype) .. '</strong>'
return unknownDataTypeError(snak.datavalue.type)
end
elseif snak.snaktype == 'somevalue' and not noSpecial then
if raw then
return " " -- single space represents 'somevalue'
else
return "i18n['values']['unknown"']
end
elseif snak.snaktype == 'novalue' and not noSpecial then
if raw then
return "" -- empty string represents 'novalue'
else
return "i18n['values']['none"']
end
else
Line 789 ⟶ 1,346:
function Config:getSingleRawQualifier(claim, qualifierID)
local qualifiers
 
if claim.qualifiers then qualifiers = claim.qualifiers[qualifierID] end
 
if qualifiers and qualifiers[1] then
return self:getValue(qualifiers[1], true) -- raw = true
Line 801 ⟶ 1,358:
function Config:snakEqualsValue(snak, value)
local snakValue = self:getValue(snak, true) -- raw = true
 
if snakValue and snak.snaktype == 'value' and snak.datavalue.type == 'wikibase-entityid' then value = value:upper() end
 
return snakValue == value
end
 
function Config:setRankBoundariessetRank(rank)
local rankPos
 
if rank == p.flags.best then
self.foundRank = 3 -- must equal the lowest possible rank
if (rank == "best") then
self.bestRank = true
self.flagBest = true -- mark that 'best' flag was given
return
else
self.bestRank = false
end
 
if (rank:sub(1,9) == "p.flags.preferred") then
rankPos = 1
elseif (rank:sub(1,6) == "p.flags.normal") then
rankPos = 2
elseif (rank:sub(1,10) == "p.flags.deprecated") then
rankPos = 3
end
if (rank:sub(-1) == "+") then
self.maxRank = 1
self.minRank = rankPos
elseif (rank:sub(-1) == "-") then
self.maxRank = rankPos
self.minRank = 3
else
return
self.maxRank = rankPos
self.minRank = rankPos
end
end
 
-- one of the rank flags was given, check if another one was given before
function Config:processFlag(flag)
if flagnot == "linked"self.flagRank then
self.ranks = {false, false, false} -- no other rank flag given before, so unset ranks
self.curState.linked = true
self.bestRank = self.flagBest -- unsets bestRank only if 'best' flag was not given before
return true
self.flagRank = true -- mark that a rank flag was given
elseif flag == "raw" then
end
self.curState.rawValue = true
 
if rank:sub(-1) == "+" then
if self.curState == self.states[parameters.reference] then
for i = rankPos, 1, -1 do
-- raw reference values end with periods and require a separator different from ""
self.separatorsranks["sep%r"][1i] = " "true
end
elseif rank:sub(-1) == "-" then
for i = rankPos, #self.ranks do
self.ranks[i] = true
end
return true
elseif flag == "short" then
self.curState.shortName = true
return true
elseif flag == "mdy" then
self.mdyDate = true
return true
elseif flag == "best" or flag:match('^preferred[+-]?$') or flag:match('^normal[+-]?$') or flag:match('^deprecated[+-]?$') then
self:setRankBoundaries(flag)
return true
elseif flag == "future" then
self.period = 1
return true
elseif flag == "current" then
self.period = 2
return true
elseif flag == "former" then
self.period = 3
return true
elseif flag == "" then
-- ignore empty flags and carry on
return true
else
self.ranks[rankPos] = true
return false
end
end
 
function Config:processFlagOrCommandsetPeriod(flagperiod)
local param = ""periodPos
 
if flagperiod == "property" or flag == "properties"p.flags.future then
periodPos = 1
param = parameters.property
elseif flag:match('^qualifier[s]?$')period == p.flags.current then
periodPos = 2
param = parameters.qualifier
elseif flag:match('^reference[s]?$')period == p.flags.former then
periodPos = 3
param = parameters.reference
else
return self:processFlag(flag)
end
 
-- one of the period flags was given, check if another one was given before
if self.states[param] then
if not self.flagPeriod then
return false
self.periods = {false, false, false} -- no other period flag given before, so unset periods
self.flagPeriod = true -- mark that a period flag was given
end
 
self.periods[periodPos] = true
-- create a new State for each command
end
self.states[param] = State.new(self)
 
function Config:qualifierMatches(claim, id, value)
-- use "%x" as the general parameter name
local qualifiers
self.states[param].parsedFormat = parseFormat("%x") -- will be overwritten for param=="%p"
 
if claim.qualifiers then qualifiers = claim.qualifiers[id] end
-- set the separator
if qualifiers then
self.states[param].separator = self.separators["sep"..param] -- will be nil for param=="%p", which will be set separately
for _, v in pairs(qualifiers) do
if string.subself:snakEqualsValue(flagv, -1value) ~= 's' then
return true
self.states[param].singleValue = true
end
end
elseif value == "" then
-- if the qualifier is not present then treat it the same as the special value 'novalue'
return true
end
 
return false
self.curState = self.states[param]
return true
end
 
function Config:rankMatches(rankPos)
if self.bestRank then
return (self.ranks[rankPos] and self.foundRank >= rankPos)
else
return (self.maxRank <= ranks[rankPos and rankPos <= self.minRank)]
end
end
Line 930 ⟶ 1,460:
local endTimeM = nil
local endTimeD = nil
 
if self.periodperiods[1] ==and 0self.periods[2] and self.periods[3] then
-- any time
return true
end
 
local now = os.date('!*t')
startTime = self:getSingleRawQualifier(claim, aliasesP.startTime)
if startTime and startTime ~= "" and startTime ~= " " then
startTimeY, startTimeM, startTimeD = parseDate(startTime)
end
 
endTime = self:getSingleRawQualifier(claim, aliasesP.endTime)
if endTime and endTime ~= "" and endTime ~= " " then
endTimeY, endTimeM, endTimeD = parseDate(endTime)
elseif endTime == " " then
-- end time is 'unknown', assume it is somewhere in the past;
-- we can do this by taking the current date as a placeholder for the end time
endTimeY = now['year']
endTimeM = now['month']
endTimeD = now['day']
end
 
if startTimeY ~= nil and endTimeY ~= nil and datePrecedesDate(endTimeY, endTimeM, endTimeD, startTimeY, startTimeM, startTimeD) then
-- invalidate end time if it precedes start time
Line 960 ⟶ 1,482:
endTimeD = nil
end
 
if self.period == periods[1] then
-- future
if startTimeY == nil or notand datePrecedesDate(nowself.atDate['year'1], nowself.atDate['month'2], nowself.atDate['day'3], startTimeY, startTimeM, startTimeD) then
return false
else
return true
end
end
elseif self.period == 2 then
 
if self.periods[2] then
-- current
if (startTimeY ~== nil andor not datePrecedesDate(nowself.atDate['year'1], nowself.atDate['month'2], nowself.atDate['day'3], startTimeY, startTimeM, startTimeD)) orand
(endTimeY ~== nil and notor datePrecedesDate(nowself.atDate['year'1], nowself.atDate['month'2], nowself.atDate['day'3], endTimeY, endTimeM, endTimeD)) then
return falsetrue
else
return true
end
end
elseif self.period == 3 then
 
if self.periods[3] then
-- former
if endTimeY ==and nil ornot datePrecedesDate(nowself.atDate['year'1], nowself.atDate['month'2], nowself.atDate['day'3], endTimeY, endTimeM, endTimeD) then
return false
else
return true
end
end
 
return false
end
 
function Config:processFlag(flag)
if not flag then
return false
end
 
if flag == p.flags.linked then
self.curState.linked = true
return true
elseif flag == p.flags.raw then
self.curState.rawValue = true
 
if self.curState == self.states[parameters.reference] then
-- raw reference values end with periods and require a separator (other than none)
self.separators["sep%r"][1] = {" "}
end
 
return true
elseif flag == p.flags.short then
self.curState.shortName = true
return true
elseif flag == p.flags.multilanguage then
self.curState.anyLanguage = true
return true
elseif flag == p.flags.unit then
self.curState.unitOnly = true
return true
elseif flag == p.flags.mdy then
self.mdyDate = true
return true
elseif flag == p.flags.single then
self.singleClaim = true
return true
elseif flag == p.flags.sourced then
self.sourcedOnly = true
return true
elseif flag == p.flags.edit then
self.editable = true
return true
elseif flag == p.flags.editAtEnd then
self.editable = true
self.editAtEnd = true
return true
elseif flag == p.flags.best or flag:match('^'..p.flags.preferred..'[+-]?$') or flag:match('^'..p.flags.normal..'[+-]?$') or flag:match('^'..p.flags.deprecated..'[+-]?$') then
self:setRank(flag)
return true
elseif flag == p.flags.future or flag == p.flags.current or flag == p.flags.former then
self:setPeriod(flag)
return true
elseif flag == "" then
-- ignore empty flags and carry on
return true
else
return false
end
end
 
function Config:processFlagOrCommand(flag)
local param = ""
 
if not flag then
return false
end
 
if flag == p.claimCommands.property or flag == p.claimCommands.properties then
param = parameters.property
elseif flag == p.claimCommands.qualifier or flag == p.claimCommands.qualifiers then
self.states.qualifiersCount = self.states.qualifiersCount + 1
param = parameters.qualifier .. self.states.qualifiersCount
self.separators["sep"..param] = {copyTable(defaultSeparators["sep%q\\d"])}
elseif flag == p.claimCommands.reference or flag == p.claimCommands.references then
param = parameters.reference
else
return self:processFlag(flag)
end
 
if self.states[param] then
return false
end
 
-- create a new state for each command
self.states[param] = State:new(self, param)
 
-- use "%x" as the general parameter name
self.states[param].parsedFormat = parseFormat(parameters.general) -- will be overwritten for param=="%p"
 
-- set the separator
self.states[param].separator = self.separators["sep"..param] -- will be nil for param=="%p", which will be set separately
 
if flag == p.claimCommands.property or flag == p.claimCommands.qualifier or flag == p.claimCommands.reference then
self.states[param].singleValue = true
end
 
self.curState = self.states[param]
 
return true
end
 
function Config:processSeparators(args)
local sep
 
for i, v in pairs(self.separators) do
if args[i] then
sep = replaceSpecialChars(args[i])
 
if sep ~= "" then
self.separators[i][1] = {sep}
else
self.separators[i][1] = nil
end
end
end
end
 
function Config:setFormatAndSeparators(state, parsedFormat)
state.parsedFormat = parsedFormat
state.separator = self.separators["sep"]
state.movSeparator = self.separators["sep"..parameters.separator]
state.puncMark = self.separators["punc"]
end
 
-- determines if a claim has references by prefetching them from the claim using getReferences,
-- which applies some filtering that determines if a reference is actually returned,
-- and caches the references for later use
function State:isSourced(claim)
self.conf.prefetchedRefs = self:getReferences(claim)
return (#self.conf.prefetchedRefs > 0)
end
 
function State:resetCaches()
-- any prefetched references of the previous claim must not be used
self.conf.prefetchedRefs = nil
end
 
function State:claimMatches(claim)
local matches, rankPos
 
-- first of all, reset any cached values used for the previous claim
self:resetCaches()
 
-- if a property value was given, check if it matches the claim's property value
if self.conf.propertyValue then
Line 995 ⟶ 1,653:
matches = true
end
 
-- if any qualifier values were given, check if each matches one of the claim's qualifier values
for i, v in pairs(self.conf.qualifierIDsAndValues) do
matches = (matches and self.conf:qualifierMatches(claim, i, v))
end
 
-- check if the claim's rank and time period match
rankPos = convertRank(rankTable[claim.rank)] or 4
matches = (matches and self.conf:rankMatches(rankPos) and self.conf:timeMatches(claim))
return matches, rankPos
end
 
-- if only claims with references must be returned, check if this one has any
function State:appendOutput(result, rankPos)
if self.conf.sourcedOnly then
local done = false
matches = (matches and self:isSourced(claim)) -- prefetches and caches references
-- a rankPos should only apply to complete claims, not to its individual qualifiers or references;
-- for the latter two, no rankPos should be given and their default rankPos must be the highest possible (i.e. 1)
if rankPos then
if (self.conf.bestRank or self.singleValue) and self.conf.foundRank > rankPos then
self.conf.foundRank = rankPos
-- found a better rank, reset worse rank outputs
if self.conf.foundRank == 1 then
self.outNormal = {}
self.outDeprecated = {}
elseif self.conf.foundRank == 2 then
self.outDeprecated = {}
end
end
else
rankPos = 1
end
 
ifreturn matches, rankPos == 1 then
self.outPreferred[#self.outPreferred + 1] = result
if self.singleValue then
done = true
end
elseif rankPos == 2 then
self.outNormal[#self.outNormal + 1] = result
if self.singleValue and not self.conf.bestRank and self.conf.maxRank == 2 then
done = true
end
elseif rankPos == 3 then
self.outDeprecated[#self.outDeprecated + 1] = result
if self.singleValue and not self.conf.bestRank and self.conf.maxRank == 3 then
done = true
end
end
return done
end
 
function State:out()
local result -- collection of arrays with value objects
local out = ""
local valuesArray -- array with value objects
local sep = nil -- value object
local out = {} -- array with value objects
 
local function walk(formatTable, result)
local strvaluesArray = ""{} -- array with value objects
 
for i, v in pairs(formatTable.req) do
if not result[i] or not result[i][1] then
-- we've got no result for a parameter that is required on this level,
-- so skip this level (and its children) by returning an empty stringresult
return ""{}
end
end
 
for i_, v in ipairs(formatTable) do
if v.param then
strvaluesArray = str ..mergeArrays(valuesArray, result[v.str])
elseif v.str ~= "" then
else
strvaluesArray[#valuesArray =+ str1] ..= {v.str}
end
 
if v.child then
strvaluesArray = str ..mergeArrays(valuesArray, walk(v.child, result))
end
end
 
return strvaluesArray
end
 
-- iterate through the results from back to front, so that we know when to add separators
local function prepend(results)
for i = #self.results, 1, -1 do
local sep = ""
local result, value= self.results[i]
 
-- iterateif fromthere backis toalready frontsome output, sothen thatadd we know when to addthe separators
for i =if #results,out 1,> -10 dothen
sep = self.separator[1] -- fixed separator
result = results[i]
result[parameters.separator] = {self.movSeparator[1]} -- movable separator
else
-- if there is already some output, then add the separators
ifsep out ~= "" thennil
sepresult[parameters.separator] = {self.separatorpuncMark[1]} -- fixedoptional separatorpunctuation mark
end
result[parameters.separator] = self.movSeparator[1] -- movable separator
 
else
valuesArray = walk(self.parsedFormat, result)
sep = ""
 
result[parameters.separator] = self.puncMark[1] -- optional punctuation mark
if #valuesArray > 0 then
end
if sep then
valuesArray[#valuesArray + 1] = sep
value = walk(self.parsedFormat, result)
if value ~= "" then
out = value .. sep .. out
end
 
out = mergeArrays(valuesArray, out)
end
end
 
prepend(self.outDeprecated)
prepend(self.outNormal)
prepend(self.outPreferred)
-- reset state before next iteration
self.outDeprecatedresults = {}
 
self.outNormal = {}
self.outPreferred = {}
return out
end
Line 1,115 ⟶ 1,735:
-- level 1 hook
function State:getProperty(claim)
returnlocal value = {self.conf:getValue(claim.mainsnak,)} self.rawValue, self.linked,-- create self.shortName)one value object
 
if #value > 0 then
return {value} -- wrap the value object in an array and return it
else
return {} -- return empty array if there was no value
end
end
 
-- level 1 hook
function State:getQualifiers(claim, param)
local qualifiers
 
if claim.qualifiers then qualifiers = claim.qualifiers[self.conf.qualifierIDqualifierIDs[param]] end
if qualifiers then
-- iterate through claim's qualifier statements to collect their values;
-- return array with multiple value objects
return self.conf.states[parameters.qualifier]:iterate(qualifiers, {["%x"] = hookNames[parameters.qualifier][2], count = 1}) -- pass qualifier State with level 2 hook
return self.conf.states[param]:iterate(qualifiers, {[parameters.general] = hookNames[parameters.qualifier.."\\d"][2], count = 1}) -- pass qualifier state with level 2 hook
else
return nil{} -- return empty array
end
end
Line 1,133 ⟶ 1,760:
-- level 2 hook
function State:getQualifier(snak)
returnlocal value = {self.conf:getValue(snak,)} self.rawValue, self.linked,-- self.shortName)create one value object
 
if #value > 0 then
return {value} -- wrap the value object in an array and return it
else
return {} -- return empty array if there was no value
end
end
 
-- level 1 hook
function State:getAllQualifiers(claim, param, result, hooks)
local out = {} -- array with value objects
local sep = self.conf.separators["sep"..parameters.qualifier][1] -- value object
 
-- iterate through the output of the separate "qualifier(s)" commands
for i = 1, self.conf.states.qualifiersCount do
 
-- if a hook has not been called yet, call it now
if not result[parameters.qualifier..i] then
self:callHook(parameters.qualifier..i, hooks, claim, result)
end
 
-- if there is output for this particular "qualifier(s)" command, then add it
if result[parameters.qualifier..i] and result[parameters.qualifier..i][1] then
 
-- if there is already some output, then add the separator
if #out > 0 and sep then
out[#out + 1] = sep
end
 
out = mergeArrays(out, result[parameters.qualifier..i])
end
end
 
return out
end
 
-- level 1 hook
function State:getReferences(claim)
if self.conf.prefetchedRefs then
-- return references that have been prefetched by isSourced
return self.conf.prefetchedRefs
end
 
if claim.references then
-- iterate through claim's reference statements to collect their values;
-- return array with multiple value objects
return self.conf.states[parameters.reference]:iterate(claim.references, {["%x"] = hookNames[parameters.reference][2], count = 1}) -- pass reference State with level 2 hook
return self.conf.states[parameters.reference]:iterate(claim.references, {[parameters.general] = hookNames[parameters.reference][2], count = 1}) -- pass reference state with level 2 hook
else
return nil{} -- return empty array
end
end
 
-- level 2 hook
-- logic determined based on https://www.wikidata.org/wiki/Help:Sources
function State:getReference(statement)
local citeParamMapping = i18n['cite']['param-mapping']
local snakValue, lang, property
local valueciteConfig = ""i18n['cite']['config']
local snaksciteTypes = {}i18n['cite']['output-types']
local params = {}
local leadParams = {}
-- will hold rendered properties of the reference which are not directly from statement.snaks,
if statement.snaks then
-- Namely, is URL generated from an external ID.
for i, v in pairs(statement.snaks) do
local additionalProcessedProperties = {}
if v[1] then
-- for each citation type, there will be an associative array that associates lists of rendered properties
snaks[i] = v[1]
-- to citation-template parameters
local candidateParams = {}
-- like above, but only associates one rendered property to each parameter; if the above variable
-- contains more strings for a parameter, the strings will be assigned to numbered params (e.g. "author1")
local citeParams = {}
 
local citeErrors = {}
local referenceEmpty = true -- will be set to false if at least one parameter is left unremoved
 
local version = 12 -- increment this each time the below logic is changed to avoid conflict errors
 
if not statement.snaks then
return {}
end
 
-- don't use bot-added references referencing Wikimedia projects or containing "inferred from" (such references are not usable on Wikipedia)
if statement.snaks[aliasesP.importedFrom] or statement.snaks[aliasesP.wikimediaImportURL] or statement.snaks[aliasesP.inferredFrom] then
return {}
end
-- don't include "type of reference"
if statement.snaks[aliasesP.typeOfReference] then
statement.snaks[aliasesP.typeOfReference] = nil
end
 
-- don't include "image" to prevent littering
if statement.snaks[aliasesP.image] then
statement.snaks[aliasesP.image] = nil
end
 
-- don't include "language" if it is equal to the local one
if self:getReferenceDetail(statement.snaks, aliasesP.language) == self.conf.langName then
statement.snaks[aliasesP.language] = nil
end
if statement.snaks[aliasesP.statedIn] and not statement.snaks[aliasesP.referenceURL] then
-- "stated in" was given but "reference URL" was not.
-- get "Wikidata property" properties from the item in "stated in"
-- if any of the returned properties of the external-id datatype is in statement.snaks, generate a link from it and use the link in the reference
-- find the "Wikidata property" properties in the item from "stated in"
local wikidataPropertiesOfSource = mw.text.split(p._properties{p.flags.raw, aliasesP.wikidataProperty, [p.args.eid] = self.conf:getValue(statement.snaks[aliasesP.statedIn][1], true, false)}, ", ", true)
for i, wikidataPropertyOfSource in pairs(wikidataPropertiesOfSource) do
if statement.snaks[wikidataPropertyOfSource] and statement.snaks[wikidataPropertyOfSource][1].datatype == "external-id" then
local tempLink = self:getReferenceDetail(statement.snaks, wikidataPropertyOfSource, false, true) -- not raw, linked
if mw.ustring.match(tempLink, "^%[%Z- %Z+%]$") then -- getValue returned a URL in square brackets.
-- the link is in wiki markup, so strip the square brackets and the display text
-- gsub also returns another, discarted value, therefore the result is assigned to tempLink first
tempLink = mw.ustring.gsub(tempLink, "^%[(%Z-) %Z+%]$", "%1")
additionalProcessedProperties[aliasesP.referenceURL] = {tempLink}
statement.snaks[wikidataPropertyOfSource] = nil
break
end
end
end
end
-- initialize candidateParams and citeParams
for _, citeType in ipairs(citeTypes) do
candidateParams[citeType] = {}
citeParams[citeType] = {}
end
 
-- fill candidateParams
for _, citeType in ipairs(citeTypes) do
-- This will contain value--priority pairs for each param name.
local candidateValuesAndPriorities = {}
 
-- fill candidateValuesAndPriorities
for refProperty in pairs(statement.snaks) do
if citeErrors[citeType] then
break
end
repeat -- just a simple wrapper to emulate "continue"
end
-- set mappingKey and prefix
local mappingKey
local prefix = ""
if statement.snaks[refProperty][1].datatype == 'external-id' then
mappingKey = "external-id"
prefix = self.conf:getLabel(refProperty)
if snaks[aliasesP.importedFrom]prefix ~= "" then
prefix = prefix .. " "
snaks[aliasesP.importedFrom] = nil
end
else
mappingKey = refProperty
end
local paramName = citeParamMapping[citeType][mappingKey]
-- skip properties with empty parameter name
if paramName == "" then
break -- skip this property for this value of citeType
end
-- handle unknown properties in the reference
if not paramName then
referenceEmpty = false
local error_message = errorText("unknown-property-in-ref", refProperty)
assert(error_message) -- Should not be nil
citeErrors[citeType] = error_message
break
end
-- set processedProperty
local processedProperty
local raw = false -- if the value is wanted raw
if isValueInTable(paramName, citeConfig[citeType]["raw-value-params"] or {}) then
raw = true
end
if isValueInTable(paramName, citeConfig[citeType]["numbered-params"] or {}) then
-- Multiple values may be given.
processedProperty = self:getReferenceDetails(statement.snaks, refProperty, raw, self.linked, true) -- anyLang = true
else
-- If multiple values are given, all but the first suitable one are discarted.
processedProperty = {self:getReferenceDetail(statement.snaks, refProperty, raw, self.linked and (statement.snaks[refProperty][1].datatype ~= 'url'), true)} -- link = true/false, anyLang = true
end
if #processedProperty == 0 then
if snaks[aliasesP.referenceURL] and snaks[aliasesP.title] then
break
params["url"] = self.conf:getValue(snaks[aliasesP.referenceURL])
end
params["title"] = self.conf:getValue(snaks[aliasesP.title], false, false, false, true) -- anyLang = true
if snaks[aliasesP.publicationDate] then params["date"] = self.conf:getValue(snaks[aliasesP.publicationDate]) end
if snaks[aliasesP.retrieved] then params["access-date"] = self.conf:getValue(snaks[aliasesP.retrieved]) end
if snaks[aliasesP.archiveURL] then params["archive-url"] = self.conf:getValue(snaks[aliasesP.archiveURL]) end
if snaks[aliasesP.archiveDate] then params["archive-date"] = self.conf:getValue(snaks[aliasesP.archiveDate]) end
if snaks[aliasesP.author] then params["author"] = self.conf:getValue(snaks[aliasesP.author]) end
if snaks[aliasesP.publisher] then params["publisher"] = self.conf:getValue(snaks[aliasesP.publisher]) end
if snaks[aliasesP.quote] then params["quote"] = self.conf:getValue(snaks[aliasesP.quote], false, false, false, true) end -- anyLang = true
if snaks[aliasesP.language] then
snakValue = self.conf:getValue(snaks[aliasesP.language])
referenceEmpty = false
if self.conf.langName ~= snakValue then
params["language"] = snakValue
-- add an empty entry to candidateValuesAndPriorities, if there isn't one already
if not candidateValuesAndPriorities[paramName] then
candidateValuesAndPriorities[paramName] = {}
end
-- find the priority of refProperty
local thisPropertyPriority = -1
local thisParamPrioritization = citeConfig[citeType]["prioritization"][paramName]
if thisParamPrioritization then
for i_priority, i_property in ipairs(thisParamPrioritization) do
if i_property == refProperty then
thisPropertyPriority = i_priority
end
end
end
for _, propertyValue in pairs(processedProperty) do
table.insert(
candidateValuesAndPriorities[paramName],
{prefix .. propertyValue, thisPropertyPriority}
)
end
until true
end
-- fill candidateParams[citeType]
if not citeErrors[citeType] then
local compareValuePriorities = function(pair1, pair2)
if pair1[2] == -1 and pair2[2] ~= -1 then
return false
end
if pair1[2] ~= -1 and pair2[2] == -1 then
return true
end
return pair1[2] < pair2[2]
end
-- fill candidateParams[citeType][paramName] for each used param
value = mw.getCurrentFrame():expandTemplate{title="cite_web", args=params}
for paramName, _ in pairs(candidateValuesAndPriorities) do
else
table.sort(candidateValuesAndPriorities[paramName], compareValuePriorities)
for i, v in pairs(snaks) do
candidateParams[citeType][paramName] = {}
property = getLabel(i)
for _, valuePriorityPair in ipairs(candidateValuesAndPriorities[paramName]) do
table.insert(candidateParams[citeType][paramName], valuePriorityPair[1])
end
end
end
end
-- handle additional properties
for refProperty in pairs(additionalProcessedProperties) do
for _, citeType in ipairs(citeTypes) do
repeat
-- skip if there already have been errors
if citeErrors[citeType] then
break
end
local paramName = citeParamMapping[citeType][refProperty]
if property ~= "" then
-- handle unknown properties in the reference
snakValue, lang = self.conf:getValue(v, false, (i == aliasesP.statedIn), false, true) -- link = true/false, anyLang = true
if not paramName then
-- Skip this additional property, but do not cause an error.
if lang and lang ~= self.conf.langCode then
break
snakValue = "''" .. snakValue .. "'' (" .. mw.language.fetchLanguageName(lang, self.conf.langCode) .. ")"
end
if paramName == "" then
break
if i == aliasesP.referenceURL or i == aliasesP.statedIn then
end
leadParams[#leadParams + 1] = snakValue
elseif i ~= aliasesP.language or self.conf.langName ~= snakValue then
referenceEmpty = false
params[#params + 1] = property .. ": " .. snakValue
end
if not candidateParams[citeType][paramName] then
candidateParams[citeType][paramName] = {}
end
for _, propertyValue in pairs(additionalProcessedProperties[refProperty]) do
table.insert(candidateParams[citeType][paramName], propertyValue)
end
until true
end
end
-- fill citeParams
for _, citeType in ipairs(citeTypes) do
for paramName, paramValues in pairs(candidateParams[citeType]) do
if #paramValues == 1 or not isValueInTable(paramName, citeConfig[citeType]["numbered-params"] or {}) then
citeParams[citeType][paramName] = paramValues[1]
else
-- There is more than one value for this parameter - the values will
-- go into separate numbered parameters (e.g. "author1", "author2")
for paramNum, paramValue in pairs(paramValues) do
citeParams[citeType][paramName .. paramNum] = paramValue
end
end
end
end
value = table.concat(leadParams, "; ")
params = table.concat(params, "; ")
-- handle missing mandatory parameters for the templates
for _, citeType in ipairs(citeTypes) do
if params ~= "" then
for _, requiredCiteParam in pairs(citeConfig[citeType]["mandatory-params"] or {}) do
if value ~= "" then
if not citeParams[citeType][requiredCiteParam] then -- The required param is not present.
value = value .. "; "
if citeErrors[citeType] then -- Do not override the previous error, if it exists.
break
end
local error_message = errorText("missing-mandatory-param", requiredCiteParam)
value = value .. params
assert(error_message) -- Should not be nil
end
citeErrors[citeType] = error_message
if value ~= "" then
value = value .. "."
end
end
end
local citeTypeToUse = nil
 
-- choose the output template
for _, citeType in ipairs(citeTypes) do
if not citeErrors[citeType] then
citeTypeToUse = citeType
break
end
end
 
-- set refContent
local refContent = ""
if citeTypeToUse then
local templateToUse = citeConfig[citeTypeToUse]["template"]
local paramsToUse = citeParams[citeTypeToUse]
if valuenot templateToUse or templateToUse ~== "" then
throwError("no-such-reference-template", tostring(templateToUse), i18nPath, citeTypeToUse)
if not self.rawValue then
end
-- add <ref> tags with the reference's hash as its name (to deduplicate references)
value = mw.getCurrentFrame():extensionTag("ref", value, {name = statement.hash})
-- if this module is being substituted then build a regular template call, otherwise expand the template
if mw.isSubsting() then
for i, v in pairs(paramsToUse) do
refContent = refContent .. "|" .. i .. "=" .. v
end
 
refContent = "{{" .. templateToUse .. refContent .. "}}"
else
value = nilxpcall(
function () refContent = mw.getCurrentFrame():expandTemplate{title=templateToUse, args=paramsToUse} end,
function () throwError("no-such-reference-template", templateToUse, i18nPath, citeTypeToUse) end
)
end
 
-- If the citation couldn't be displayed using any template, but is not empty (barring ignored propeties), throw an error.
elseif not referenceEmpty then
refContent = errorText("malformed-reference-header")
for _, citeType in ipairs(citeTypes) do
refContent = refContent .. errorText("template-failure-reason", citeConfig[citeType]["template"], citeErrors[citeType])
end
refContent = refContent .. errorText("malformed-reference-footer")
end
 
-- wrap refContent
local ref = {}
if refContent ~= "" then
ref = {refContent}
 
if not self.rawValue then
-- this should become a <ref> tag, so save the reference's hash for later
ref.refHash = "wikidata-" .. statement.hash .. "-v" .. (tonumber(i18n['version']) + version)
end
return {ref}
else
return {}
end
end
 
-- gets a detail of one particular type for a reference
function State:getReferenceDetail(snaks, dType, raw, link, anyLang)
local switchLang = anyLang
local value = nil
 
if not snaks[dType] then
return nil
end
 
-- if anyLang, first try the local language and otherwise any language
repeat
for _, v in ipairs(snaks[dType]) do
value = self.conf:getValue(v, raw, link, false, anyLang and not switchLang, false, true) -- noSpecial = true
 
if value then
break
end
end
 
if value or not anyLang then
break
end
 
switchLang = not switchLang
until anyLang and switchLang
 
return value
end
 
-- gets the details of one particular type for a reference
function State:getReferenceDetails(snaks, dType, raw, link, anyLang)
local values = {}
 
if not snaks[dType] then
return {}
end
 
for _, v in ipairs(snaks[dType]) do
-- if nil is returned then it will not be added to the table
values[#values + 1] = self.conf:getValue(v, raw, link, false, anyLang, false, true) -- noSpecial = true
end
 
return values
end
 
-- level 1 hook
function State:getAlias(object)
local value = object.value
local title = nil
 
if value and self.linked then
if self.conf.entityID:sub(1,1) == "Q" then
title = mw.wikibase.getSitelink(self.conf.entityID)
elseif self.conf.entityID:sub(1,1) == "P" then
title = "d:Property:" .. self.conf.entityID
end
 
if title then
value = buildWikilink(title, value)
end
end
 
value = {value} -- create one value object
 
if #value > 0 then
return {value} -- wrap the value object in an array and return it
else
return {} -- return empty array if there was no value
end
end
 
-- level 1 hook
function State:getBadge(value)
value = self.conf:getLabel(value, self.rawValue, self.linked, self.shortName)
 
if value == "" then
value = nil
end
 
value = {value} -- create one value object
 
if #value > 0 then
return {value} -- wrap the value object in an array and return it
else
return {} -- return empty array if there was no value
end
end
 
function State:callHook(param, hooks, statement, result)
-- call a parameter's hook if it has been defined and if it has not been called before
if not result[param] and hooks[param] then
local valuesArray = self[hooks[param]](self, statement, param, result, hooks) -- array with value objects
 
-- add to the result
if #valuesArray > 0 then
result[param] = valuesArray
result.count = result.count + 1
else
result[param] = {} -- an empty array to indicate that we've tried this hook already
return true -- miss == true
end
end
 
return false
end
 
Line 1,237 ⟶ 2,221:
function State:iterate(statements, hooks, matchHook)
matchHook = matchHook or alwaysTrue
 
local done = false
local matches = false
local rankPos = nil
local result, numValues, doAppend, gotRequired
 
for i_, v in ipairs(statements) do
-- rankPos will be nil for non-claim statements (e.g. qualifiers, references, etc.),
-- but let appendOutput handle that
matches, rankPos = matchHook(self, v)
 
if matches then
result = {count = 0} -- collection of arrays with value objects
 
doAppend = true
local function walk(formatTable)
local miss
-- if we need to return a single value, check if we don't have one already
 
if self.singleValue then
for i2, v2 in pairs(formatTable.req) do
if not rankPos or rankPos == 1 then
-- call a hook, adding its return value to the result
numValues = #self.outPreferred
miss = self:callHook(i2, hooks, v, result)
elseif rankPos == 2 then
 
numValues = #self.outNormal
elseif if rankPos == 3miss then
-- we miss a required value for this level, so return false
numValues = #self.outDeprecated
end return false
if numValues > 0 then
doAppend = false
end
end
if doAppend then
local function walk(formatTable)
local value
for i2, v2 in pairs(formatTable.req) do
if not result[i2] and hooks[i2] then
-- call a hook and add its return value to the result
value = self[hooks[i2]](self, v)
if value then
result[i2] = value
result.count = result.count + 1
else
return false -- we miss a required value for this level
end
end
if result.count == hooks.count then
-- we're done if all hooks have been called;
-- returning at this point breaks the loop
return true
end
end
 
if result.count == hooks.count then
for i2, v2 in ipairs(formatTable) do
if-- result.countwe're ==done if all hooks.count thenhave been called;
-- we'rereturning doneat ifthis allpoint hooksbreaks havethe been called;loop
return true
-- returning at this point prevents further childs from being processed
return true
end
if v2.child then
walk(v2.child)
end
end
return true
end
 
gotRequired = walk(self.parsedFormat)
for _, v2 in ipairs(formatTable) do
if result.count == hooks.count then
-- only append the result if we got values for all required parameters on the root level
-- we're done if all hooks have been called;
if gotRequired then
-- returning at this point prevents further childs from being processed
done = self:appendOutput(result, rankPos)
if return done thentrue
breakend
 
if v2.child then
walk(v2.child)
end
end
 
return true
end
gotRequired = walk(self.parsedFormat)
 
-- only append the result if we got values for all required parameters on the root level
if gotRequired then
-- if we have a rankPos (only with matchHook() for complete claims), then update the foundRank
if rankPos and self.conf.foundRank > rankPos then
self.conf.foundRank = rankPos
end
 
-- append the result
self.results[#self.results + 1] = result
 
-- break if we only need a single value
if self.singleValue then
break
end
end
end
end
 
return self:out()
end
 
local function getEntityId(arg, eid, page, allowOmitPropPrefix, globalSiteId)
function p.property(frame)
local id = nil
return p._property(frame.args)
local prop = nil
end
 
if arg then
function p._property(args)
if arg:sub(1,1) == ":" then
return execCommand(args, "property")
page = arg
end
eid = nil
elseif arg:sub(1,1):upper() == "Q" or arg:sub(1,9):lower() == "property:" or allowOmitPropPrefix then
eid = arg
page = nil
else
prop = arg
end
end
 
if eid then
function p.properties(frame)
if eid:sub(1,9):lower() == "property:" then
return p._properties(frame.args)
id = replaceAlias(mw.text.trim(eid:sub(10)))
end
 
if id:sub(1,1):upper() ~= "P" then
function p._properties(args)
id = ""
return execCommand(args, "properties")
end
else
id = replaceAlias(eid)
end
elseif page then
if page:sub(1,1) == ":" then
page = mw.text.trim(page:sub(2))
end
 
id = mw.wikibase.getEntityIdForTitle(page, globalSiteId) or ""
function p.qualifier(frame)
end
return p._qualifier(frame.args)
end
 
if not id then
function p._qualifier(args)
id = mw.wikibase.getEntityIdForCurrentPage() or ""
return execCommand(args, "qualifier")
end
 
id = id:upper()
function p.qualifiers(frame)
return p._qualifiers(frame.args)
end
 
if not mw.wikibase.isValidEntityId(id) then
function p._qualifiers(args)
id = ""
return execCommand(args, "qualifiers")
end
 
return id, prop
function p.reference(frame)
return p._reference(frame.args)
end
 
local function p._referencenextArg(args)
local arg = args[args.pointer]
return execCommand(args, "reference")
end
 
if arg then
function p.references(frame)
args.pointer = args.pointer + 1
return p._references(frame.args)
return mw.text.trim(arg)
else
return nil
end
end
 
local function p._referencesclaimCommand(args, funcName)
local cfg = Config:new()
return execCommand(args, "references")
cfg:processFlagOrCommand(funcName) -- process first command (== function name)
end
 
local lastArg, parsedFormat, formatParams, claims, value
function execCommand(args, funcName)
_ = Config.new()
_:processFlagOrCommand(funcName) -- process first command (== function name)
local parsedFormat, formatParams, claims
local hooks = {count = 0}
 
-- set the date if given;
local nextArg = mw.text.trim(args[1] or "")
-- must come BEFORE processing the flags
local nextIndex = 2
if args[p.args.date] then
cfg.atDate = {parseDate(args[p.args.date])}
cfg.periods = {false, true, false} -- change default time constraint to 'current'
end
 
-- process flags and commands
repeat
while _:processFlagOrCommand(nextArg) do
nextArglastArg = mw.text.trimnextArg(args[nextIndex] or "")
until not cfg:processFlagOrCommand(lastArg)
nextIndex = nextIndex + 1
 
-- get the entity ID from either the positional argument, the eid argument or the page argument
cfg.entityID, cfg.propertyID = getEntityId(lastArg, args[p.args.eid], args[p.args.page], false, args[p.args.globalSiteId])
 
if cfg.entityID == "" then
return "" -- we cannot continue without a valid entity ID
end
 
cfg.entity = mw.wikibase.getEntity(cfg.entityID)
-- check for optional item ID
 
if nextArg:sub(1,1):upper() == "Q" then
if not cfg.propertyID then
_.entity = mw.wikibase.getEntity(nextArg) -- item ID given
_cfg.propertyID = mw.text.trimnextArg(args[nextIndex] or "") -- property ID
nextIndex = nextIndex + 1
else
_.entity = mw.wikibase.getEntity() -- no item ID given, use item connected to current page
_.propertyID = nextArg -- property ID
end
 
cfg.propertyID = replaceAlias(cfg.propertyID)
-- check if given property ID is an alias
 
if aliasesP[_.propertyID] then
_ if not cfg.propertyIDentity =or aliasesP[_not cfg.propertyID] then
return "" -- we cannot continue without an entity or a property ID
end
 
_cfg.propertyID = _cfg.propertyID:upper()
 
if not cfg.entity.claims or not cfg.entity.claims[cfg.propertyID] then
if _.states[parameters.qualifier] then
return "" -- there is no use to continue without any claims
end
 
claims = cfg.entity.claims[cfg.propertyID]
 
if cfg.states.qualifiersCount > 0 then
-- do further processing if "qualifier(s)" command was given
 
if #args - args.pointer + 1 > cfg.states.qualifiersCount then
nextArg = args[nextIndex]
nextIndex = nextIndex + 1
_.qualifierID = nextArg
nextArg = mw.text.trim(args[nextIndex] or "")
nextIndex = nextIndex + 1
if nextArg == "" then
-- claim ID or literal value has NOT been given
_.propertyValue = nil
_.qualifierID = mw.text.trim(_.qualifierID or "")
else
-- claim ID or literal value has been given
 
_.propertyValue = _.qualifierID -- cannot be nil when reached
_cfg.qualifierIDpropertyValue = nextArg(args)
end
 
for i = 1, cfg.states.qualifiersCount do
-- check if given qualifier ID is an alias
-- check if given qualifier ID is an alias and add it
if aliasesP[_.qualifierID] then
cfg.qualifierIDs[parameters.qualifier..i] = replaceAlias(nextArg(args) or ""):upper()
_.qualifierID = aliasesP[_.qualifierID]
end
elseif cfg.states[parameters.reference] then
_.qualifierID = _.qualifierID:upper()
elseif _.states[parameters.reference] then
-- do further processing if "reference(s)" command was given
 
cfg.propertyValue = nextArg(args)
nextArg = args[nextIndex]
nextIndex = nextIndex + 1
_.propertyValue = nextArg -- claim ID or literal value (possibly nil)
end
 
-- check for special property value 'somevalue' or 'novalue'
if _cfg.propertyValue then
if _cfg.propertyValue ~= "" and mw.text.trimreplaceSpecialChars(_cfg.propertyValue) == "" then
 
_.propertyValue = " " -- single space represents 'somevalue', whereas empty string represents 'novalue'
if cfg.propertyValue ~= "" and mw.text.trim(cfg.propertyValue) == "" then
cfg.propertyValue = " " -- single space represents 'somevalue', whereas empty string represents 'novalue'
else
_cfg.propertyValue = mw.text.trim(_cfg.propertyValue)
end
end
 
-- parse the desired format, or choose an appropriate format
if args["format"] then
parsedFormat, formatParams = parseFormat(mw.text.trim(args["format"]))
elseif _cfg.states[parameters.qualifier]qualifiersCount > 0 then -- "qualifier(s)" command given
if _cfg.states[parameters.property] then -- "propert(y|ies)" command given
parsedFormat, formatParams = parseFormat(formats.propertyWithQualifier)
else
parsedFormat, formatParams = parseFormat(formats.qualifier)
end
elseif _cfg.states[parameters.property] then -- "propert(y|ies)" command given
parsedFormat, formatParams = parseFormat(formats.property)
else -- "reference(s)" command given
else
parsedFormat, formatParams = parseFormat(formats.reference)
-- if only "reference(s)" has been given, make the emtpy string the default separator (except when raw)
if not _.states[parameters.reference].rawValue then
_.separators["sep"][1] = ""
end
end
 
-- if a "qualifier(s)" command and no "propert(y|ies)" command has been given, make the movable separator a semicolon
-- process overridden separator values;
if cfg.states.qualifiersCount > 0 and not cfg.states[parameters.property] then
-- must come AFTER parsing the formats
cfg.separators["sep"..parameters.separator][1] = {";"}
for i, v in pairs(_.separators) do
if args[i] then
_.separators[i][1] = args[i]
end
end
 
-- if only "reference(s)" has been given, set the default separator to none (except when raw)
-- make sure that at least one required parameter has been defined
if cfg.states[parameters.reference] and not cfg.states[parameters.property] and cfg.states.qualifiersCount == 0
if not next(parsedFormat.req) then
and not cfg.states[parameters.reference].rawValue then
return missingRequiredParameterError()
cfg.separators["sep"][1] = nil
end
 
-- if exactly one "qualifier(s)" command has been given, make "sep%q" point to "sep%q1" to make them equivalent
-- make sure that the separator parameter "%s" is not amongst the required parameters
if cfg.states.qualifiersCount == 1 then
if parsedFormat.req[parameters.separator] then
cfg.separators["sep"..parameters.qualifier] = cfg.separators["sep"..parameters.qualifier.."1"]
return extraRequiredParameterError(parameters.separator)
end
 
-- process overridden separator values;
-- must come AFTER tweaking the default separators
cfg:processSeparators(args)
 
-- define the hooks that should be called (getProperty, getQualifiers, getReferences);
-- only define a hook if both its command ("propert(y|ies)", "qualifierreference(s)", "referencequalifier(s)") and its parameter ("%p", "%qr", "%rq1", "%q2", "%q3") have been given
for i, v in pairs(_cfg.states) do
-- e.g. 'formatParams["%q1"] or formatParams["%q"]' to define hook even if "%q1" was not defined to be able to build a complete value for "%q"
if formatParams[i] then
hooksif formatParams[i] =or hookNamesformatParams[i][:sub(1, 2)] then
hooks[i] = getHookName(i, 1)
hooks.count = hooks.count + 1
end
end
 
-- the "%q" parameter is not attached to a state, but is a collection of the results of multiple states (attached to "%q1", "%q2", "%q3", ...);
-- so if this parameter is given then this hook must be defined separately, but only if at least one "qualifier(s)" command has been given
if formatParams[parameters.qualifier] and cfg.states.qualifiersCount > 0 then
hooks[parameters.qualifier] = getHookName(parameters.qualifier, 1)
hooks.count = hooks.count + 1
end
 
-- create a state for "properties" if it doesn't exist yet, which will be used as a base configuration for each claim iteration;
-- must come AFTER defining the hooks
if not _cfg.states[parameters.property] then
_cfg.states[parameters.property] = State.:new(_cfg, parameters.property)
 
-- if the "single" flag has been given then this state should be equivalent to "property" (singular)
if cfg.singleClaim then
cfg.states[parameters.property].singleValue = true
end
end
 
-- if the "sourced" flag has been given then create a state for "reference" if it doesn't exist yet, using default values,
-- set the parsed format and the separators (and optional punctuation mark)
-- which must exist in order to be able to determine if a claim has any references;
_.states[parameters.property].parsedFormat = parsedFormat
-- must come AFTER defining the hooks
_.states[parameters.property].separator = _.separators["sep"]
if cfg.sourcedOnly and not cfg.states[parameters.reference] then
_.states[parameters.property].movSeparator = _.separators["sep"..parameters.separator]
cfg:processFlagOrCommand(p.claimCommands.reference) -- use singular "reference" to minimize overhead
_.states[parameters.property].puncMark = _.separators["punc"]
if _.entity and _.entity.claims then claims = _.entity.claims[_.propertyID] end
if claims then
-- iterate through the claims to collect values
return _.states[parameters.property]:iterate(claims, hooks, State.claimMatches) -- pass property State with level 1 hooks and matchHook
else
return ""
end
end
 
-- set the parsed format and the separators (and optional punctuation mark);
function p.label(frame)
-- must come AFTER creating the additonal states
return p._label(frame.args)
cfg:setFormatAndSeparators(cfg.states[parameters.property], parsedFormat)
 
-- process qualifier matching values, analogous to cfg.propertyValue
for i, v in pairs(args) do
i = tostring(i)
 
if i:match('^[Pp]%d+$') or aliasesP[i] then
v = replaceSpecialChars(v)
 
-- check for special qualifier value 'somevalue'
if v ~= "" and mw.text.trim(v) == "" then
v = " " -- single space represents 'somevalue'
end
 
cfg.qualifierIDsAndValues[replaceAlias(i):upper()] = v
end
end
 
-- first sort the claims on rank to pre-define the order of output (preferred first, then normal, then deprecated)
claims = sortOnRank(claims)
 
-- then iterate through the claims to collect values
value = cfg:concatValues(cfg.states[parameters.property]:iterate(claims, hooks, State.claimMatches)) -- pass property state with level 1 hooks and matchHook
 
-- if desired, add a clickable icon that may be used to edit the returned values on Wikidata
if cfg.editable and value ~= "" then
value = value .. cfg:getEditIcon()
end
 
return value
end
 
local function p._labelgeneralCommand(args, _funcName)
_local cfg = _ or Config.:new()
_cfg.curState = State.:new(_cfg)
 
local IDlastArg
local labelvalue = ""nil
 
local title = nil
repeat
local nextArg lastArg = mw.text.trimnextArg(args[1] or "")
until not cfg:processFlag(lastArg)
local nextIndex = 2
 
-- get the entity ID from either the positional argument, the eid argument or the page argument
while _:processFlag(nextArg) do
cfg.entityID = getEntityId(lastArg, args[p.args.eid], args[p.args.page], true, args[p.args.globalSiteId])
nextArg = mw.text.trim(args[nextIndex] or "")
 
nextIndex = nextIndex + 1
if cfg.entityID == "" or not mw.wikibase.entityExists(cfg.entityID) then
return "" -- we cannot continue without an entity
end
 
-- serve according to the given command
ID = nextArg
if funcName == p.generalCommands.label then
value = cfg:getLabel(cfg.entityID, cfg.curState.rawValue, cfg.curState.linked, cfg.curState.shortName)
if ID ~= "" then
elseif funcName == p.generalCommands.title then
if aliasesP[ID] then
cfg.inSitelinks = true
ID = aliasesP[ID]
 
if cfg.entityID:sub(1,1) == "Q" then
value = mw.wikibase.getSitelink(cfg.entityID)
end
 
if cfg.curState.linked and value then
ID = ID:upper()
value = buildWikilink(value)
-- check if this is a valid ID, and if the number is not larger than max int (to prevent error)
if not string.match(ID, '^[QP]%d+$') or tonumber(string.match(ID, '%d+')) > 2147483647 then
return ""
end
if _.curState.rawValue then
if mw.wikibase.getEntity(ID) or mw.wikibase.resolvePropertyId(ID) then
if _.curState.linked then
if ID:sub(1,1) == "P" then
label = "[[d:Property:" .. ID .. "|" .. ID .. "]]"
else
label = "[[d:" .. ID .. "|" .. ID .. "]]"
end
else
label = ID
end
end
else
if ID:sub(1,1) == "P" then
if not _.pageTitle then
label = mw.wikibase.label(ID) or ""
if _.curState.linked and label ~= "" then
label = "[[d:Property:" .. ID .. "|" .. label .. "]]"
end
end
else
if not _.pageTitle then
if _.curState.shortName then
label = getShortName(ID)
end
-- at this point, 'label' will be a string and not nil
if label == "" then
label = mw.wikibase.label(ID)
end
else
-- set 'label' to nil so 'title' will always prevail
label = nil
end
-- at this point, 'label' will be nil or a non-empty string
if _.curState.linked or label == nil then
title = mw.wikibase.sitelink(ID)
end
if _.curState.linked and title then
label = "[[" .. title .. "|" .. (label or title) .. "]]"
else
label = label or title or ""
end
end
end
elseif funcName == p.generalCommands.description then
value = mw.wikibase.getDescription(cfg.entityID)
else
local parsedFormat, formatParams
if _.curState.rawValue then
local hooks = {count = 0}
label = mw.wikibase.getEntityIdForCurrentPage() or ""
 
cfg.entity = mw.wikibase.getEntity(cfg.entityID)
if _.curState.linked and label ~= "" then
 
label = "[[d:" .. label .. "|" .. label .. "]]"
if funcName == p.generalCommands.alias or funcName == p.generalCommands.badge then
cfg.curState.singleValue = true
end
 
if funcName == p.generalCommands.alias or funcName == p.generalCommands.aliases then
if not cfg.entity.aliases or not cfg.entity.aliases[cfg.langCode] then
return "" -- there is no use to continue without any aliasses
end
 
else
local aliases = cfg.entity.aliases[cfg.langCode]
if not _.pageTitle then
 
label = mw.wikibase.label()
-- parse the desired format, or parse the default aliases format
if args["format"] then
parsedFormat, formatParams = parseFormat(args["format"])
else
parsedFormat, formatParams = parseFormat(formats.alias)
-- set 'label' to nil so 'title' will always prevail
label = nil
end
 
-- process overridden separator values;
if _.curState.linked or label == nil then
-- must come AFTER tweaking the default separators
title = mw.title.getCurrentTitle().prefixedText
cfg:processSeparators(args)
 
-- define the hook that should be called (getAlias);
-- only define the hook if the parameter ("%a") has been given
if formatParams[parameters.alias] then
hooks[parameters.alias] = getHookName(parameters.alias, 1)
hooks.count = hooks.count + 1
end
 
-- set the parsed format and the separators (and optional punctuation mark)
if _.curState.linked then
cfg:setFormatAndSeparators(cfg.curState, parsedFormat)
label = "[[" .. title .. "|" .. (label or title) .. "]]" -- not much use since it links to the current page, but does add wiki mark-up
 
-- iterate to collect values
value = cfg:concatValues(cfg.curState:iterate(aliases, hooks))
elseif funcName == p.generalCommands.badge or funcName == p.generalCommands.badges then
if not cfg.entity.sitelinks or not cfg.entity.sitelinks[cfg.siteID] or not cfg.entity.sitelinks[cfg.siteID].badges then
return "" -- there is no use to continue without any badges
end
 
local badges = cfg.entity.sitelinks[cfg.siteID].badges
 
cfg.inSitelinks = true
 
-- parse the desired format, or parse the default aliases format
if args["format"] then
parsedFormat, formatParams = parseFormat(args["format"])
else
parsedFormat, formatParams = parseFormat(formats.badge)
label = label or title
end
 
-- process overridden separator values;
-- must come AFTER tweaking the default separators
cfg:processSeparators(args)
 
-- define the hook that should be called (getBadge);
-- only define the hook if the parameter ("%b") has been given
if formatParams[parameters.badge] then
hooks[parameters.badge] = getHookName(parameters.badge, 1)
hooks.count = hooks.count + 1
end
 
-- set the parsed format and the separators (and optional punctuation mark)
cfg:setFormatAndSeparators(cfg.curState, parsedFormat)
 
-- iterate to collect values
value = cfg:concatValues(cfg.curState:iterate(badges, hooks))
end
end
return label
end
 
value = value or ""
function p.title(frame)
 
return p._title(frame.args)
if cfg.editable and value ~= "" then
-- if desired, add a clickable icon that may be used to edit the returned value on Wikidata
value = value .. cfg:getEditIcon()
end
 
return value
end
 
-- modules that include this module should call the functions with an underscore prepended, e.g.: p._property(args)
function p._title(args, _)
local function establishCommands(commandList, commandFunc)
_ = _ or Config.new()
for _, commandName in pairs(commandList) do
_.pageTitle = true
local function wikitextWrapper(frame)
return p._label(args, _)
local args = copyTable(frame.args)
args.pointer = 1
loadI18n(aliasesP, frame)
return commandFunc(args, commandName)
end
p[commandName] = wikitextWrapper
 
local function luaWrapper(args)
args = copyTable(args)
args.pointer = 1
loadI18n(aliasesP)
return commandFunc(args, commandName)
end
p["_" .. commandName] = luaWrapper
end
end
 
establishCommands(p.claimCommands, claimCommand)
-- main function that may be used by wrapper templates
establishCommands(p.generalCommands, generalCommand)
 
-- main function that is supposed to be used by wrapper templates
function p.main(frame)
if not mw.wikibase then return nil end
local f, args, i, v
 
local f, args
 
loadI18n(aliasesP, frame)
 
-- get the parent frame to take the arguments that were passed to the wrapper template
frame = frame:getParent() or frame
 
f = mw.text.trim(frame.args[1] or "")
if not frame.args[1] then
assert(p[f], 'The function "' .. f .. '" does not exist')
throwError("no-function-specified")
args = {}
-- copy arguments from immutable to mutable table
for i, v in pairs(frame.args) do
args[i] = v
end
 
f = mw.text.trim(frame.args[1])
 
if f == "main" then
throwError("main-called-twice")
end
 
assert(p["_"..f], errorText('no-such-function', f))
 
-- copy arguments from immutable to mutable table
args = copyTable(frame.args)
 
-- remove the function name from the list
table.remove(args, 1)
 
return p["_"..f](args)
end