「モジュール:Wd」の版間の差分

48版 をインポートしました
template>K-iczn
(en:Module:Wd 2017年8月28日 (月) 14:24(UTC)より)
(48版 をインポートしました)
 
(7人の利用者による、間の23版が非表示)
5行目: 5行目:
local i18n
local i18n


function loadSubmodules(frame)
local function loadI18n(aliasesP, frame)
-- internationalization
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 = arg
end
 
if not i18n then
if not i18n then
if frame then
i18n = require(title .. "/i18n").init(aliasesP)
-- module invoked by page/template, get its title from frame
i18n = require(frame:getTitle().."/i18n")
else
-- module included by other module, get its title from ...
i18n = require(arg.."/i18n")
end
end
end
end
end


local aliasesP = {
p.claimCommands = {
coord          = "P625",
property  = "property",
---------------
properties = "properties",
author          = "P50",
qualifier  = "qualifier",
publisher      = "P123",
qualifiers = "qualifiers",
importedFrom    = "P143",
reference  = "reference",
statedIn        = "P248",
references = "references"
pages          = "P304",
publicationDate = "P577",
startTime      = "P580",
endTime        = "P582",
chapter        = "P792",
retrieved      = "P813",
referenceURL    = "P854",
archiveURL      = "P1065",
title          = "P1476",
quote          = "P1683",
shortName      = "P1813",
language        = "P2439",
archiveDate    = "P2960"
}
}


local aliasesQ = {
p.generalCommands = {
percentage              = "Q11229",
label      = "label",
prolepticJulianCalendar = "Q1985786"
title      = "title",
description = "description",
alias      = "alias",
aliases    = "aliases",
badge      = "badge",
badges      = "badges"
}
}


local flags = {
p.flags = {
linked        = "linked",
linked        = "linked",
short        = "short",
raw          = "raw",
raw          = "raw",
short        = "short",
multilanguage = "multilanguage",
multilanguage = "multilanguage",
unit          = "unit",
unit          = "unit",
mdy          = "mdy",
-------------
single        = "single",
sourced      = "sourced",
edit          = "edit",
editAtEnd    = "edit@end",
best          = "best",
preferred    = "preferred",
preferred    = "preferred",
normal        = "normal",
normal        = "normal",
deprecated    = "deprecated",
deprecated    = "deprecated",
best          = "best",
future        = "future",
future        = "future",
current      = "current",
current      = "current",
former        = "former"
former        = "former",
edit          = "edit",
editAtEnd    = "edit@end",
mdy          = "mdy",
single        = "single",
sourced      = "sourced"
}
}


local parameters = {
p.args = {
property  = "%p",
eid  = "eid",
qualifier = "%q",
page = "page",
reference = "%r",
date = "date"
separator = "%s",
}
general  = "%x"
 
local aliasesP = {
coord                  = "P625",
-----------------------
image                  = "P18",
author                  = "P50",
publisher              = "P123",
importedFrom            = "P143",
statedIn                = "P248",
pages                  = "P304",
language                = "P407",
hasPart                = "P527",
publicationDate        = "P577",
startTime              = "P580",
endTime                = "P582",
chapter                = "P792",
retrieved              = "P813",
referenceURL            = "P854",
sectionVerseOrParagraph = "P958",
archiveURL              = "P1065",
title                  = "P1476",
formatterURL            = "P1630",
quote                  = "P1683",
shortName              = "P1813",
definingFormula        = "P2534",
archiveDate            = "P2960",
inferredFrom            = "P3452",
typeOfReference        = "P3865",
column                  = "P3903"
}
 
local aliasesQ = {
percentage              = "Q11229",
prolepticJulianCalendar = "Q1985786",
citeWeb                = "Q5637226",
citeQ                  = "Q22321052"
}
 
local parameters = {
property  = "%p",
qualifier = "%q",
reference = "%r",
alias    = "%a",
badge    = "%b",
separator = "%s",
general  = "%x"
}
}


77行目: 118行目:
qualifier            = "%q[%s][%r]",
qualifier            = "%q[%s][%r]",
reference            = "%r",
reference            = "%r",
propertyWithQualifier = "%p[ <span style=\"font-size:smaller\">(%q)</span>][%s][%r]"
propertyWithQualifier = "%p[ <span style=\"font-size:85\\%\">(%q)</span>][%s][%r]",
alias                = "%a[%s]",
badge                = "%b[%s]"
}
}


84行目: 127行目:
[parameters.reference]        = {"getReferences", "getReference"},
[parameters.reference]        = {"getReferences", "getReference"},
[parameters.qualifier]        = {"getAllQualifiers"},
[parameters.qualifier]        = {"getAllQualifiers"},
[parameters.qualifier.."\\d"] = {"getQualifiers", "getQualifier"}
[parameters.qualifier.."\\d"] = {"getQualifiers", "getQualifier"},
[parameters.alias]            = {"getAlias"},
[parameters.badge]            = {"getBadge"}
}
}


95行目: 140行目:
["sep%r"]    = nil,  -- none
["sep%r"]    = nil,  -- none
["punc"]    = nil  -- none
["punc"]    = nil  -- none
}
local rankTable = {
["preferred"]  = 1,
["normal"]    = 2,
["deprecated"] = 3
}
}


local Config = {}
local Config = {}
Config.__index = Config


-- allows for recursive calls
-- allows for recursive calls
function Config.new()
function Config:new()
local cfg = {}
local cfg = {}
setmetatable(cfg, Config)
setmetatable(cfg, self)
self.__index = self
 
cfg.separators = {
cfg.separators = {
-- single value objects wrapped in arrays so that we can pass by reference
-- single value objects wrapped in arrays so that we can pass by reference
113行目: 164行目:
["punc"]  = {copyTable(defaultSeparators["punc"])}
["punc"]  = {copyTable(defaultSeparators["punc"])}
}
}
 
cfg.entity = nil
cfg.entity = nil
cfg.entityID = nil
cfg.entityID = nil
120行目: 171行目:
cfg.qualifierIDs = {}
cfg.qualifierIDs = {}
cfg.qualifierIDsAndValues = {}
cfg.qualifierIDsAndValues = {}
 
cfg.bestRank = true
cfg.bestRank = true
cfg.ranks = {true, true, false}  -- preferred = true, normal = true, deprecated = false
cfg.ranks = {true, true, false}  -- preferred = true, normal = true, deprecated = false
126行目: 177行目:
cfg.flagBest = false
cfg.flagBest = false
cfg.flagRank = false
cfg.flagRank = false
 
cfg.periods = {true, true, true}  -- future = true, current = true, former = true
cfg.periods = {true, true, true}  -- future = true, current = true, former = true
cfg.flagPeriod = false
cfg.flagPeriod = false
cfg.atDate = {parseDate(os.date('!%Y-%m-%d'))}  -- today as {year, month, day}
 
cfg.mdyDate = false
cfg.mdyDate = false
cfg.singleClaim = false
cfg.singleClaim = false
135行目: 187行目:
cfg.editable = false
cfg.editable = false
cfg.editAtEnd = false
cfg.editAtEnd = false
 
cfg.pageTitle = false
cfg.inSitelinks = false
 
cfg.langCode = mw.language.getContentLanguage().code
cfg.langCode = mw.language.getContentLanguage().code
cfg.langName = mw.language.fetchLanguageName(cfg.langCode, cfg.langCode)
cfg.langName = mw.language.fetchLanguageName(cfg.langCode, cfg.langCode)
cfg.langObj = mw.language.new(cfg.langCode)
cfg.langObj = mw.language.new(cfg.langCode)
 
cfg.siteID = mw.wikibase.getGlobalSiteId()
 
cfg.states = {}
cfg.states = {}
cfg.states.qualifiersCount = 0
cfg.states.qualifiersCount = 0
cfg.curState = nil
cfg.curState = nil
 
cfg.prefetchedRefs = nil
cfg.prefetchedRefs = nil
 
return cfg
return cfg
end
end


local State = {}
local State = {}
State.__index = State


function State.new(cfg)
function State:new(cfg, type)
local stt = {}
local stt = {}
setmetatable(stt, State)
setmetatable(stt, self)
self.__index = self
 
stt.conf = cfg
stt.conf = cfg
stt.type = type
 
stt.results = {}
stt.results = {}
 
stt.parsedFormat = {}
stt.parsedFormat = {}
stt.separator = {}
stt.separator = {}
stt.movSeparator = {}
stt.movSeparator = {}
stt.puncMark = {}
stt.puncMark = {}
 
stt.linked = false
stt.linked = false
stt.rawValue = false
stt.rawValue = false
173行目: 228行目:
stt.unitOnly = false
stt.unitOnly = false
stt.singleValue = false
stt.singleValue = false
 
return stt
return stt
end
end


function replaceAlias(ID)
local function replaceAlias(id)
if aliasesP[ID] then
if aliasesP[id] then
ID = aliasesP[ID]
id = aliasesP[id]
end
end
 
return ID
return id
end
end


function applyStringParams(str, ...)
local function errorText(code, param)
for i, v in ipairs(arg) do
local text = i18n["errors"][code]
str = mw.ustring.gsub(str, "$"..i, v)
if param then text = mw.ustring.gsub(text, "$1", param) end
end
return text
return str
end
end


function unknownDataTypeError(dataType)
local function throwError(errorMessage, param)
return applyStringParams(i18n['errors']['unknown-data-type'], dataType)
error(errorText(errorMessage, param))
end
end


function missingRequiredParameterError()
local function replaceDecimalMark(num)
return i18n['errors']['missing-required-parameter']
return mw.ustring.gsub(num, "[.]", i18n['numeric']['decimal-mark'], 1)
end
end


function extraRequiredParameterError(param)
local function padZeros(num, numDigits)
return applyStringParams(i18n['errors']['extra-required-parameter'], param)
local numZeros
end
local negative = false
 
if num < 0 then
negative = true
num = num * -1
end
 
num = tostring(num)
numZeros = numDigits - num:len()


function getOrdinalSuffix(num)
for _ = 1, numZeros do
return i18n.getOrdinalSuffix(num)
num = "0"..num
end
end


function addDelimiters(num)
if negative then
return i18n.addDelimiters(num)
num = "-"..num
end
end


function replaceDecimalMark(num)
return num
return mw.ustring.gsub(num, "[.]", i18n['numeric']['decimal-mark'], 1)
end
end


function replaceSpecialChar(chr)
local function replaceSpecialChar(chr)
if chr == '_' then
if chr == '_' then
-- replace underscores with spaces
-- replace underscores with spaces
226行目: 286行目:
end
end


function replaceSpecialChars(str)
local function replaceSpecialChars(str)
local chr
local chr
local esc = false
local esc = false
local strOut = ""
local strOut = ""
 
for i = 1, #str do
for i = 1, #str do
chr = str:sub(i,i)
chr = str:sub(i,i)
 
if not esc then
if not esc then
if chr == '\\' then
if chr == '\\' then
245行目: 305行目:
end
end
end
end
 
return strOut
return strOut
end
end


function buildWikilink(target, label)
local function buildWikilink(target, label)
if target == label then
if not label or target == label then
return "[[" .. target .. "]]"
return "[[" .. target .. "]]"
else
else
263行目: 323行目:
return nil
return nil
end
end
 
local tOut = {}
local tOut = {}
 
for i, v in pairs(tIn) do
for i, v in pairs(tIn) do
tOut[i] = v
tOut[i] = v
end
end
 
return tOut
return tOut
end
end
275行目: 335行目:
-- used to merge output arrays together;
-- used to merge output arrays together;
-- note that it currently mutates the first input array
-- note that it currently mutates the first input array
function mergeArrays(a1, a2)
local function mergeArrays(a1, a2)
for i = 1, #a2 do
for i = 1, #a2 do
a1[#a1 + 1] = a2[i]
a1[#a1 + 1] = a2[i]
end
end
 
return a1
return a1
end
end


function parseWikidataURL(url)
local function split(str, del)
local i, j
local out = {}
local i, j = str:find(del)
if url:match('^http[s]?://') then
 
i, j = url:find("Q")
if i and j then
out[1] = str:sub(1, i - 1)
if i then
out[2] = str:sub(j + 1)
return url:sub(i)
else
end
out[1] = str
end
end
 
return out
end
 
local function parseWikidataURL(url)
local id
 
if url:match('^http[s]?://') then
id = split(url, "Q")
 
if id[2] then
return "Q" .. id[2]
end
end
 
return nil
return nil
end
end
299行目: 373行目:
function parseDate(dateStr, precision)
function parseDate(dateStr, precision)
precision = precision or "d"
precision = precision or "d"
local i, j, index, ptr
local i, j, index, ptr
local parts = {nil, nil, nil}
local parts = {nil, nil, nil}
 
if dateStr == nil then
if dateStr == nil then
return parts[1], parts[2], parts[3]  -- year, month, day
return parts[1], parts[2], parts[3]  -- year, month, day
end
end
 
-- 'T' for snak values, '/' for outputs with '/Julian' attached
-- 'T' for snak values, '/' for outputs with '/Julian' attached
i, j = dateStr:find("[T/]")
i, j = dateStr:find("[T/]")
 
if i then
if i then
dateStr = dateStr:sub(1, i-1)
dateStr = dateStr:sub(1, i-1)
end
end
 
local from = 1
local from = 1
 
if dateStr:sub(1,1) == "-" then
if dateStr:sub(1,1) == "-" then
-- this is a negative number, look further ahead
-- this is a negative number, look further ahead
from = 2
from = 2
end
end
 
index = 1
index = 1
ptr = 1
ptr = 1
 
i, j = dateStr:find("-", from)
i, j = dateStr:find("-", from)
 
if i then
if i then
-- year
-- year
parts[index] = tonumber(mw.ustring.gsub(dateStr:sub(ptr, i-1), "^\+(.+)$", "%1"), 10)  -- remove '+' sign (explicitly give base 10 to prevent error)
parts[index] = tonumber(mw.ustring.gsub(dateStr:sub(ptr, i-1), "^\+(.+)$", "%1"), 10)  -- remove '+' sign (explicitly give base 10 to prevent error)
 
if parts[index] == -0 then
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] = tonumber("0")  -- for some reason, 'parts[index] = 0' may actually store '-0', so parse from string instead
end
end
 
if precision == "y" then
if precision == "y" then
-- we're done
-- we're done
return parts[1], parts[2], parts[3]  -- year, month, day
return parts[1], parts[2], parts[3]  -- year, month, day
end
end
 
index = index + 1
index = index + 1
ptr = i + 1
ptr = i + 1
 
i, j = dateStr:find("-", ptr)
i, j = dateStr:find("-", ptr)
 
if i then
if i then
-- month
-- month
parts[index] = tonumber(dateStr:sub(ptr, i-1), 10)
parts[index] = tonumber(dateStr:sub(ptr, i-1), 10)
 
if precision == "m" then
if precision == "m" then
-- we're done
-- we're done
return parts[1], parts[2], parts[3]  -- year, month, day
return parts[1], parts[2], parts[3]  -- year, month, day
end
end
 
index = index + 1
index = index + 1
ptr = i + 1
ptr = i + 1
end
end
end
end
 
if dateStr:sub(ptr) ~= "" then
if dateStr:sub(ptr) ~= "" then
-- day if we have month, month if we have year, or year
-- day if we have month, month if we have year, or year
parts[index] = tonumber(dateStr:sub(ptr), 10)
parts[index] = tonumber(dateStr:sub(ptr), 10)
end
end
 
return parts[1], parts[2], parts[3]  -- year, month, day
return parts[1], parts[2], parts[3]  -- year, month, day
end
end


function datePrecedesDate(aY, aM, aD, bY, bM, bD)
local function datePrecedesDate(aY, aM, aD, bY, bM, bD)
if aY == nil or bY == nil then
if aY == nil or bY == nil then
return nil
return nil
373行目: 448行目:
bM = bM or 1
bM = bM or 1
bD = bD or 1
bD = bD or 1
 
if aY < bY then
if aY < bY then
return true
return true
end
end
 
if aY > bY then
if aY > bY then
return false
return false
end
end
 
if aM < bM then
if aM < bM then
return true
return true
end
end
 
if aM > bM then
if aM > bM then
return false
return false
end
end
 
if aD < bD then
if aD < bD then
return true
return true
end
end
 
return false
return false
end
end


function getHookName(param, index)
local function getHookName(param, index)
if hookNames[param] then
if hookNames[param] then
return hookNames[param][index]
return hookNames[param][index]
407行目: 482行目:
end
end


function alwaysTrue()
local function alwaysTrue()
return true
return true
end
end
456行目: 531行目:
-- ]
-- ]
--
--
function parseFormat(str)
local function parseFormat(str)
local chr, esc, param, root, cur, prev, new
local chr, esc, param, root, cur, prev, new
local params = {}
local params = {}
 
local function newObject(array)
local function newObject(array)
local obj = {}  -- new object
local obj = {}  -- new object
obj.str = ""
obj.str = ""
 
array[#array + 1] = obj  -- array{object}
array[#array + 1] = obj  -- array{object}
obj.parent = array
obj.parent = array
 
return obj
return obj
end
end
 
local function endParam()
local function endParam()
if param > 0 then
if param > 0 then
483行目: 558行目:
end
end
end
end
 
root = {}  -- array
root = {}  -- array
root.req = {}
root.req = {}
cur = newObject(root)
cur = newObject(root)
prev = nil
prev = nil
 
esc = false
esc = false
param = 0
param = 0
 
for i = 1, #str do
for i = 1, #str do
chr = str:sub(i,i)
chr = str:sub(i,i)
 
if not esc then
if not esc then
if chr == '\\' then
if chr == '\\' then
532行目: 607行目:
end
end
end
end
 
cur.str = cur.str .. replaceSpecialChar(chr)
cur.str = cur.str .. replaceSpecialChar(chr)
end
end
539行目: 614行目:
esc = false
esc = false
end
end
 
prev = nil
prev = nil
end
end
 
endParam()
endParam()
return root, params
end


function convertRank(rank)
-- make sure that at least one required parameter has been defined
if rank == "preferred" then
if not next(root.req) then
return 1
throwError("missing-required-parameter")
elseif rank == "normal" then
end
return 2
 
elseif rank == "deprecated" then
-- make sure that the separator parameter "%s" is not amongst the required parameters
return 3
if root.req[parameters.separator] then
else
throwError("extra-required-parameter", parameters.separator)
return 4  -- default (in its literal sense)
end
end
return root, params
end
end


function sortOnRank(claims)
local function sortOnRank(claims)
local rankPos
local rankPos
local ranks = {{}, {}, {}, {}}  -- preferred, normal, deprecated, (default)
local ranks = {{}, {}, {}, {}}  -- preferred, normal, deprecated, (default)
local sorted = {}
local sorted = {}
 
for i, v in ipairs(claims) do
for _, v in ipairs(claims) do
rankPos = convertRank(v.rank)
rankPos = rankTable[v.rank] or 4
ranks[rankPos][#ranks[rankPos] + 1] = v
ranks[rankPos][#ranks[rankPos] + 1] = v
end
end
 
sorted = ranks[1]
sorted = ranks[1]
sorted = mergeArrays(sorted, ranks[2])
sorted = mergeArrays(sorted, ranks[2])
sorted = mergeArrays(sorted, ranks[3])
sorted = mergeArrays(sorted, ranks[3])
 
return sorted
return sorted
end
end


function getShortName(ID)
-- if id == nil then item connected to current page is used
if ID then
function Config:getLabel(id, raw, link, short)
return p._property({ID, aliasesP.shortName}) -- "property" is single
local label = nil
else
local title = nil
return p._property({aliasesP.shortName})  -- "property" is single
local prefix= ""
 
if not id then
id = mw.wikibase.getEntityIdForCurrentPage()
 
if not id then
return ""
end
end
end
end


function getLabel(ID, args)
id = id:upper() -- just to be sure
args = args or {}
 
if raw then
if ID then
-- check if given id actually exists
args[#args + 1] = ID
if mw.wikibase.isValidEntityId(id) and mw.wikibase.entityExists(id) then
end
label = id
return p._label(args)
end


function Config:getEditIcon()
if id:sub(1,1) == "P" then
local value = ""
prefix = "Property:"
local prefix = ""
end
local front = " "
end
local back = ""
 
prefix = "d:" .. prefix
if self.entityID:sub(1,1) == "P" then
 
prefix = "Property:"
title = label  -- may be nil
end
else
-- try short name first if requested
if self.editAtEnd then
if short then
front = '<span style="float:'
label = p._property{aliasesP.shortName, [p.args.eid] = id}  -- get short name
 
if self.langObj:isRTL() then
if label == "" then
front = front .. 'left'
label = nil
else
end
front = front .. 'right'
end
 
-- get label
if not label then
label = mw.wikibase.getLabelByLang(id, self.langCode)
end
end
front = front .. '">'
back = '</span>'
end
end
 
value = "[[File:Blue pencil.svg|frameless|text-top|10px|alt=" .. i18n['info']['edit-on-wikidata'] .. "|link=https://www.wikidata.org/wiki/" .. prefix .. self.entityID .. "?uselang=" .. self.langCode
if not label then
label = ""
if self.propertyID then
elseif link then
value = value .. "#" .. self.propertyID
-- 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
title = id
prefix = "d:Property:"
end
end
 
if title then
label = buildWikilink(prefix .. title, label)
end
end
end
 
value = value .. "|" .. i18n['info']['edit-on-wikidata'] .. "]]"
return label
return front .. value .. back
end
end


-- used to create the final output string when it's all done, so that for references the
function Config:getEditIcon()
-- function extensionTag("ref", ...) is only called when they really ended up in the final output
local value = ""
function Config:concatValues(valuesArray)
local prefix = ""
local outString = ""
local front = "&nbsp;"
local j, skip
local back = ""
 
for i = 1, #valuesArray do
if self.entityID:sub(1,1) == "P" then
-- check if this is a reference
prefix = "Property:"
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 = "wikidata-" .. valuesArray[i].refHash})
end
else
outString = outString .. valuesArray[i][1]
end
end
end
 
-- if desired, add a clickable icon that may be used to edit the returned values on Wikidata
if self.editAtEnd then
if self.editable and outString ~= "" then
front = '<span style="float:'
outString = outString .. self:getEditIcon()
 
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
end
 
return outString
value = value .. "|" .. i18n['info']['edit-on-wikidata'] .. "]]"
 
return front .. value .. back
end
end


function Config:convertUnit(unit, raw, link, short, unitOnly)
-- used to create the final output string when it's all done, so that for references the
raw = raw or false
-- function extensionTag("ref", ...) is only called when they really ended up in the final output
link = link or false
function Config:concatValues(valuesArray)
short = short or false
local outString = ""
unitOnly = unitOnly or false
local j, skip
local args = {}
local space = " "
local label = ""
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
if raw then
args[#args + 1] = flags.raw
end
if link then
args[#args + 1] = flags.linked
end
if short then
args[#args + 1] = flags.short
end
label = getLabel(itemID, args)
if label ~= "" then
return space .. label
end
end
end
return ""
end


function Config:getValue(snak, raw, link, short, anyLang, unitOnly, noSpecial)
for i = 1, #valuesArray do
raw = raw or false
-- check if this is a reference
link = link or false
if valuesArray[i].refHash then
short = short or false
j = i - 1
anyLang = anyLang or false
skip = false
unitOnly = unitOnly or false
 
noSpecial = noSpecial or 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 snak.snaktype == 'value' then
if valuesArray[i].refHash == valuesArray[j].refHash then
if snak.datavalue.type == 'string' then
skip = true
if snak.datatype == 'url' and link then
break
-- create link explicitly
if raw then
-- will render as a linked number like [1]
return "[" .. snak.datavalue.value .. "]"
else
return "[" .. snak.datavalue.value .. " " .. snak.datavalue.value .. "]"
end
end
elseif snak.datatype == 'commonsMedia' then
j = j - 1
if link then
return buildWikilink("c:File:" .. snak.datavalue.value, snak.datavalue.value)
elseif not raw then
return "[[File:" .. snak.datavalue.value .. "]]"
else
return snak.datavalue.value
end
elseif snak.datatype == 'geo-shape' and link then
return buildWikilink("c:" .. snak.datavalue.value, snak.datavalue.value)
elseif snak.datatype == 'math' and not raw then
return mw.getCurrentFrame():extensionTag("math", snak.datavalue.value)
else
return snak.datavalue.value
end
end
elseif snak.datavalue.type == 'monolingualtext' then
 
if anyLang then
if not skip then
return snak.datavalue.value['text'], snak.datavalue.value['language']
-- add <ref> tag with the reference's hash as its name (to deduplicate references)
elseif snak.datavalue.value['language'] == self.langCode then
outString = outString .. mw.getCurrentFrame():extensionTag("ref", valuesArray[i][1], {name = valuesArray[i].refHash})
return snak.datavalue.value['text']
else
return nil
end
end
elseif snak.datavalue.type == 'quantity' then
else
local value = ""
outString = outString .. valuesArray[i][1]
local unit
end
end
if not unitOnly then
 
-- get value and strip + signs from front
return outString
value = mw.ustring.gsub(snak.datavalue.value['amount'], "^\+(.+)$", "%1")
end
 
if raw then
function Config:convertUnit(unit, raw, link, short, unitOnly)
return value
local space = " "
end
local label = ""
local itemID
-- replace decimal mark based on locale
 
value = replaceDecimalMark(value)
if unit == "" or unit == "1" then
return nil
-- add delimiters for readability
end
value = addDelimiters(value)
 
end
if unitOnly then
space = ""
unit = self:convertUnit(snak.datavalue.value['unit'], raw, link, short, unitOnly)
end
 
if unit then
itemID = parseWikidataURL(unit)
value = value .. unit
 
end
if itemID then
if itemID == aliasesQ.percentage then
return value
return "%"
elseif snak.datavalue.type == 'time' then
else
local y, m, d, p, yDiv, yRound, yFull, value, calendarID, dateStr
label = self:getLabel(itemID, raw, link, short)
local yFactor = 1
 
local sign = 1
if label ~= "" then
local prefix = ""
return space .. label
local suffix = ""
local mayAddCalendar = false
local calendar = ""
local precision = snak.datavalue.value['precision']
if precision == 11 then
p = "d"
elseif precision == 10 then
p = "m"
else
p = "y"
yFactor = 10^(9-precision)
end
end
end
y, m, d = parseDate(snak.datavalue.value['time'], p)
end
 
if y < 0 then
return ""
sign = -1
end
y = y * sign
 
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
local datatype = snak.datavalue.type
local subtype = snak.datatype
local datavalue = snak.datavalue.value
 
if datatype == 'string' then
if subtype == 'url' and link then
-- create link explicitly
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
end
elseif datatype == 'monolingualtext' then
-- if precision is tens/hundreds/thousands/millions/billions of years
if anyLang or datavalue['language'] == self.langCode then
if precision <= 8 then
return datavalue['text']
yDiv = y / yFactor
else
return nil
-- if precision is tens/hundreds/thousands of years
end
if precision >= 6 then
elseif datatype == 'quantity' then
mayAddCalendar = true
local value = ""
local unit
if precision <= 7 then
 
-- round centuries/millenniums up (e.g. 20th century or 3rd millennium)
if not unitOnly then
yRound = math.ceil(yDiv)
-- get value and strip + signs from front
value = mw.ustring.gsub(datavalue['amount'], "^\+(.+)$", "%1")
if not raw then
 
if precision == 6 then
if raw then
suffix = i18n['datetime']['suffixes']['millennium']
return value
else
end
suffix = i18n['datetime']['suffixes']['century']
 
end
-- replace decimal mark based on locale
value = replaceDecimalMark(value)
suffix = getOrdinalSuffix(yRound) .. suffix
 
else
-- add delimiters for readability
-- if not verbose, take the first year of the century/millennium
value = i18n.addDelimiters(value)
-- (e.g. 1901 for 20th century or 2001 for 3rd millennium)
end
yRound = (yRound - 1) * yFactor + 1
 
end
unit = self:convertUnit(datavalue['unit'], raw, link, short, unitOnly)
else
 
-- precision == 8
if unit then
-- round decades down (e.g. 2010s)
value = value .. unit
yRound = math.floor(yDiv) * yFactor
end
 
if not raw then
return value
prefix = i18n['datetime']['prefixes']['decade-period']
elseif datatype == 'time' then
suffix = i18n['datetime']['suffixes']['decade-period']
local y, m, d, p, yDiv, yRound, yFull, value, calendarID, dateStr
end
local yFactor = 1
end
local sign = 1
local prefix = ""
if raw and sign < 0 then
local suffix = ""
-- if BCE then compensate for "counting backwards"
local mayAddCalendar = false
-- (e.g. -2019 for 2010s BCE, -2000 for 20th century BCE or -3000 for 3rd millennium BCE)
local calendar = ""
yRound = yRound + yFactor - 1
local precision = datavalue['precision']
end
 
else
if precision == 11 then
local yReFactor, yReDiv, yReRound
p = "d"
elseif precision == 10 then
-- round to nearest for tens of thousands of years or more
p = "m"
yRound = math.floor(yDiv + 0.5)
else
p = "y"
if yRound == 0 then
yFactor = 10^(9-precision)
if precision <= 2 and y ~= 0 then
end
yReFactor = 1e6
 
yReDiv = y / yReFactor
y, m, d = parseDate(datavalue['time'], p)
yReRound = math.floor(yReDiv + 0.5)
 
if y < 0 then
if yReDiv == yReRound then
sign = -1
-- change precision to millions of years only if we have a whole number of them
y = y * sign
precision = 3
end
yFactor = yReFactor
 
yRound = yReRound
-- 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
end
suffix = i18n.getOrdinalSuffix(yRound) .. suffix
else
-- if not verbose, take the first year of the century/millennium
-- (e.g. 1901 for 20th century or 2001 for 3rd millennium)
yRound = (yRound - 1) * yFactor + 1
end
end
else
if yRound == 0 then
-- precision == 8
-- otherwise, take the unrounded (original) number of years
-- round decades down (e.g. 2010s)
precision = 5
yRound = math.floor(yDiv) * yFactor
yFactor = 1
 
yRound = y
if not raw then
mayAddCalendar = true
prefix = i18n['datetime']['prefixes']['decade-period']
suffix = i18n['datetime']['suffixes']['decade-period']
end
end
end
end
 
if precision >= 1 and y ~= 0 then
if raw and sign < 0 then
yFull = yRound * yFactor
-- if BCE then compensate for "counting backwards"
-- (e.g. -2019 for 2010s BCE, -2000 for 20th century BCE or -3000 for 3rd millennium BCE)
yReFactor = 1e9
yRound = yRound + yFactor - 1
yReDiv = yFull / yReFactor
end
yReRound = math.floor(yReDiv + 0.5)
else
local yReFactor, yReDiv, yReRound
if yReDiv == yReRound then
 
-- change precision to billions of years if we're in that range
-- round to nearest for tens of thousands of years or more
precision = 0
yRound = math.floor(yDiv + 0.5)
yFactor = yReFactor
 
yRound = yReRound
if yRound == 0 then
else
if precision <= 2 and y ~= 0 then
yReFactor = 1e6
yReFactor = 1e6
yReDiv = yFull / yReFactor
yReDiv = y / yReFactor
yReRound = math.floor(yReDiv + 0.5)
yReRound = math.floor(yReDiv + 0.5)
 
if yReDiv == yReRound then
if yReDiv == yReRound then
-- change precision to millions of years if we're in that range
-- change precision to millions of years only if we have a whole number of them
precision = 3
precision = 3
yFactor = yReFactor
yFactor = yReFactor
898行目: 983行目:
end
end
end
end
end
 
if yRound == 0 then
if not raw then
-- otherwise, take the unrounded (original) number of years
if precision == 3 then
precision = 5
suffix = i18n['datetime']['suffixes']['million-years']
yFactor = 1
elseif precision == 0 then
yRound = y
suffix = i18n['datetime']['suffixes']['billion-years']
mayAddCalendar = true
else
yRound = yRound * yFactor
if yRound == 1 then
suffix = i18n['datetime']['suffixes']['year']
else
suffix = i18n['datetime']['suffixes']['years']
end
end
end
else
yRound = yRound * yFactor
end
end
end
 
else
if precision >= 1 and y ~= 0 then
yRound = y
yFull = yRound * yFactor
mayAddCalendar = true
 
end
yReFactor = 1e9
yReDiv = yFull / yReFactor
if mayAddCalendar then
yReRound = math.floor(yReDiv + 0.5)
calendarID = parseWikidataURL(snak.datavalue.value['calendarmodel'])
 
if yReDiv == yReRound then
if calendarID and calendarID == aliasesQ.prolepticJulianCalendar then
-- change precision to billions of years if we're in that range
if not raw then
precision = 0
if link then
yFactor = yReFactor
calendar = " ("..buildWikilink(i18n['datetime']['julian-calendar'], i18n['datetime']['julian'])..")"
yRound = yReRound
else
else
calendar = " ("..i18n['datetime']['julian']..")"
yReFactor = 1e6
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
precision = 3
yFactor = yReFactor
yRound = yReRound
end
end
end
else
calendar = "/"..i18n['datetime']['julian']
end
end
end
 
end
if not raw then
if precision == 3 then
if not raw then
suffix = i18n['datetime']['suffixes']['million-years']
local ce = nil
elseif precision == 0 then
suffix = i18n['datetime']['suffixes']['billion-years']
if sign < 0 then
else
ce = i18n['datetime']['BCE']
yRound = yRound * yFactor
elseif precision <= 5 then
if yRound == 1 then
ce = i18n['datetime']['CE']
suffix = i18n['datetime']['suffixes']['year']
end
else
suffix = i18n['datetime']['suffixes']['years']
if ce then
end
if link then
end
ce = buildWikilink(i18n['datetime']['common-era'], ce)
else
yRound = yRound * yFactor
end
end
suffix = suffix .. " " .. ce
end
end
else
value = tostring(yRound)
yRound = y
mayAddCalendar = true
if m then
end
dateStr = self.langObj:formatDate("F", "1-"..m.."-1")
 
if mayAddCalendar then
if d then
calendarID = parseWikidataURL(datavalue['calendarmodel'])
if self.mdyDate then
 
dateStr = dateStr .. " " .. d .. ","
if calendarID and calendarID == aliasesQ.prolepticJulianCalendar then
if not raw then
if link then
calendar = " ("..buildWikilink(i18n['datetime']['julian-calendar'], i18n['datetime']['julian'])..")"
else
else
dateStr = d .. " " .. dateStr
calendar = " ("..i18n['datetime']['julian']..")"
end
end
end
else
calendar = "/"..i18n['datetime']['julian']
value = dateStr .. " " .. value
end
value = prefix .. value .. suffix .. calendar
else
value = tostring(yRound * sign)
if m then
value = value .. "-" .. m
if d then
value = value .. "-" .. d
end
end
end
end
value = value .. calendar
end
end
 
return value
if not raw then
elseif snak.datavalue.type == 'globecoordinate' then
local ce = nil
-- logic from https://github.com/DataValues/Geo
 
if sign < 0 then
local precision, numDigits, strFormat, value, globe
ce = i18n['datetime']['BCE']
local latValue, latitude, latDegrees, latMinutes, latSeconds
elseif precision <= 5 then
local lonValue, longitude, lonDegrees, lonMinutes, lonSeconds
ce = i18n['datetime']['CE']
local latDirection, latDirectionN, latDirectionS, latDirectionEN
end
local lonDirection, lonDirectionE, lonDirectionW, lonDirectionEN
 
if ce then
local latDirectionEN_N = "N"
if link then
local latDirectionEN_S = "S"
ce = buildWikilink(i18n['datetime']['common-era'], ce)
local lonDirectionEN_E = "E"
end
local lonDirectionEN_W = "W"
suffix = suffix .. " " .. ce
end
if not raw then
 
latDirectionN = i18n['coord']['latitude-north']
value = tostring(yRound)
latDirectionS = i18n['coord']['latitude-south']
 
lonDirectionE = i18n['coord']['longitude-east']
if m then
lonDirectionW = i18n['coord']['longitude-west']
dateStr = self.langObj:formatDate("F", "1-"..m.."-1")
 
degSymbol = i18n['coord']['degrees']
if d then
minSymbol = i18n['coord']['minutes']
if self.mdyDate then
secSymbol = i18n['coord']['seconds']
dateStr = dateStr .. " " .. d .. ","
separator = i18n['coord']['separator']
else
dateStr = d .. " " .. dateStr
end
end
 
value = dateStr .. " " .. value
end
 
value = prefix .. value .. suffix .. calendar
else
else
latDirectionN = latDirectionEN_N
value = padZeros(yRound * sign, 4)
latDirectionS = latDirectionEN_S
 
lonDirectionE = lonDirectionEN_E
if m then
lonDirectionW = lonDirectionEN_W
value = value .. "-" .. padZeros(m, 2)
 
degSymbol = "/"
if d then
minSymbol = "/"
value = value .. "-" .. padZeros(d, 2)
secSymbol = "/"
end
separator = "/"
end
 
value = value .. calendar
end
end
 
latitude = snak.datavalue.value['latitude']
return value
longitude = snak.datavalue.value['longitude']
elseif datatype == 'globecoordinate' then
-- logic from https://github.com/DataValues/Geo (v4.0.1)
if latitude < 0 then
 
latDirection = latDirectionS
local precision, unitsPerDegree, numDigits, strFormat, value, globe
latDirectionEN = latDirectionEN_S
local latitude, latConv, latValue, latLink
latitude = math.abs(latitude)
local longitude, lonConv, lonValue, lonLink
else
local latDirection, latDirectionN, latDirectionS, latDirectionEN
latDirection = latDirectionN
local lonDirection, lonDirectionE, lonDirectionW, lonDirectionEN
latDirectionEN = latDirectionEN_N
local degSymbol, minSymbol, secSymbol, separator
end
 
local latDegrees = nil
if longitude < 0 then
local latMinutes = nil
lonDirection = lonDirectionW
local latSeconds = nil
lonDirectionEN = lonDirectionEN_W
local lonDegrees = nil
longitude = math.abs(longitude)
local lonMinutes = nil
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
else
lonDirection = lonDirectionE
latDirectionN = latDirectionEN_N
lonDirectionEN = lonDirectionEN_E
latDirectionS = latDirectionEN_S
lonDirectionE = lonDirectionEN_E
lonDirectionW = lonDirectionEN_W
 
degSymbol = "/"
minSymbol = "/"
secSymbol = "/"
separator = "/"
end
end
 
precision = snak.datavalue.value['precision']
latitude = datavalue['latitude']
longitude = datavalue['longitude']
latitude = math.floor(latitude / precision + 0.5) * precision
 
longitude = math.floor(longitude / precision + 0.5) * precision
if latitude < 0 then
latDirection = latDirectionS
numDigits = math.ceil(-math.log10(3600 * precision))
latDirectionEN = latDirectionEN_S
latitude = math.abs(latitude)
if numDigits < 0 or numDigits == -0 then
else
numDigits = tonumber("0")  -- for some reason, 'numDigits = 0' may actually store '-0', so parse from string instead
latDirection = latDirectionN
latDirectionEN = latDirectionEN_N
end
end
 
strFormat = "%." .. numDigits .. "f"
if longitude < 0 then
lonDirection = lonDirectionW
-- use string.format() to strip decimal point followed by a zero (.0) for whole numbers
lonDirectionEN = lonDirectionEN_W
latSeconds = tonumber(strFormat:format(math.floor(latitude * 3600 * 10^numDigits + 0.5) / 10^numDigits))
longitude = math.abs(longitude)
lonSeconds = tonumber(strFormat:format(math.floor(longitude * 3600 * 10^numDigits + 0.5) / 10^numDigits))
else
lonDirection = lonDirectionE
latMinutes = math.floor(latSeconds / 60)
lonDirectionEN = lonDirectionEN_E
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
end
 
if precision < (1 / 60) then
precision = datavalue['precision']
latSeconds = strFormat:format(latSeconds)
 
lonSeconds = strFormat:format(lonSeconds)
if not precision or precision <= 0 then
precision = 1 / 3600  -- precision not set (correctly), set to arcsecond
if not raw then
-- replace decimal marks based on locale
latSeconds = replaceDecimalMark(latSeconds)
lonSeconds = replaceDecimalMark(lonSeconds)
end
latValue = latValue .. latSeconds .. secSymbol
lonValue = lonValue .. lonSeconds .. secSymbol
end
end
 
latValue = latValue .. latDirection
-- remove insignificant detail
lonValue = lonValue .. lonDirection
latitude = math.floor(latitude / precision + 0.5) * precision
longitude = math.floor(longitude / precision + 0.5) * precision
value = latValue .. separator .. lonValue
 
if precision >= 1 - (1 / 60) and precision < 1 then
if link then
precision = 1
globe = parseWikidataURL(snak.datavalue.value['globe'])
elseif precision >= (1 / 60) - (1 / 3600) and precision < (1 / 60) then
precision = 1 / 60
if globe then
globe = mw.wikibase.getEntity(globe):getLabel("en"):lower()
else
globe = "earth"
end
value = "[https://tools.wmflabs.org/geohack/geohack.php?language="..self.langCode.."&params="..latitude.."_"..latDirectionEN.."_"..longitude.."_"..lonDirectionEN.."_globe:"..globe.." "..value.."]"
end
end
 
return value
if precision >= 1 then
elseif snak.datavalue.type == 'wikibase-entityid' then
unitsPerDegree = 1
local lang
elseif precision >= (1 / 60)  then
local value = ""
unitsPerDegree = 60
local title = nil
local prefix = ""
local itemID = snak.datavalue.value['numeric-id']
if snak.datatype == 'wikibase-item' then
itemID = "Q" .. itemID
elseif snak.datatype == 'wikibase-property' then
itemID = "P" .. itemID
prefix = "Property:"
else
else
return '<strong class="error">' .. unknownDataTypeError(snak.datatype) .. '</strong>'
unitsPerDegree = 3600
end
 
numDigits = math.ceil(-math.log10(unitsPerDegree * precision))
 
if numDigits <= 0 then
numDigits = tonumber("0")  -- for some reason, 'numDigits = 0' may actually store '-0', so parse from string instead
end
end
 
if raw then
strFormat = "%." .. numDigits .. "f"
if link then
 
return buildWikilink("d:" .. prefix .. itemID, itemID)
if precision >= 1 then
latDegrees = strFormat:format(latitude)
lonDegrees = strFormat:format(longitude)
 
if not raw then
latDegSym = replaceDecimalMark(latDegrees) .. degSymbol
lonDegSym = replaceDecimalMark(lonDegrees) .. degSymbol
else
else
return itemID
latDegSym = latDegrees .. degSymbol
end
lonDegSym = lonDegrees .. degSymbol
end
end
else
if short then
latConv = math.floor(latitude * unitsPerDegree * 10^numDigits + 0.5) / 10^numDigits
value = getShortName(prefix .. itemID)
lonConv = math.floor(longitude * unitsPerDegree * 10^numDigits + 0.5) / 10^numDigits
end
 
if precision >= (1 / 60) then
if value == "" then
latMinutes = latConv
value, lang = mw.wikibase.getLabelWithLang(itemID)
lonMinutes = lonConv
else
-- don't allow language fallback
latSeconds = latConv
if lang ~= self.langCode then
lonSeconds = lonConv
value = nil
 
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
end
end
 
if (link or value == nil) and snak.datatype == 'wikibase-item' then
latValue = latDegSym .. latMinSym .. latSecSym .. latDirection
title = mw.wikibase.sitelink(itemID)
lonValue = lonDegSym .. lonMinSym .. lonSecSym .. lonDirection
end
 
value = latValue .. separator .. lonValue
 
if link then
if link then
if title then
globe = parseWikidataURL(datavalue['globe'])
value = buildWikilink(title, (value or title))
 
elseif not value or snak.datatype == 'wikibase-property' then
if globe then
value = buildWikilink("d:" .. prefix .. itemID, (value or itemID))
globe = mw.wikibase.getLabelByLang(globe, "en"):lower()
else
globe = "earth"
end
end
elseif not value then
 
value = (title or itemID)
latLink = table.concat({latDegrees, latMinutes, latSeconds}, "_")
lonLink = table.concat({lonDegrees, lonMinutes, lonSeconds}, "_")
 
value = "[https://tools.wmflabs.org/geohack/geohack.php?language="..self.langCode.."&params="..latLink.."_"..latDirectionEN.."_"..lonLink.."_"..lonDirectionEN.."_globe:"..globe.." "..value.."]"
end
end
 
return value
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
else
return '<strong class="error">' .. unknownDataTypeError(snak.datavalue.type) .. '</strong>'
return '<strong class="error">' .. errorText('unknown-data-type', datatype) .. '</strong>'
end
end
elseif snak.snaktype == 'somevalue' and not noSpecial then
elseif snak.snaktype == 'somevalue' and not noSpecial then
1,186行目: 1,334行目:
function Config:getSingleRawQualifier(claim, qualifierID)
function Config:getSingleRawQualifier(claim, qualifierID)
local qualifiers
local qualifiers
 
if claim.qualifiers then qualifiers = claim.qualifiers[qualifierID] end
if claim.qualifiers then qualifiers = claim.qualifiers[qualifierID] end
 
if qualifiers and qualifiers[1] then
if qualifiers and qualifiers[1] then
return self:getValue(qualifiers[1], true)  -- raw = true
return self:getValue(qualifiers[1], true)  -- raw = true
1,198行目: 1,346行目:
function Config:snakEqualsValue(snak, value)
function Config:snakEqualsValue(snak, value)
local snakValue = self:getValue(snak, true)  -- raw = true
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
if snakValue and snak.snaktype == 'value' and snak.datavalue.type == 'wikibase-entityid' then value = value:upper() end
 
return snakValue == value
return snakValue == value
end
end
1,206行目: 1,354行目:
function Config:setRank(rank)
function Config:setRank(rank)
local rankPos
local rankPos
 
if rank == flags.best then
if rank == p.flags.best then
self.bestRank = true
self.bestRank = true
self.flagBest = true  -- mark that 'best' flag was given
self.flagBest = true  -- mark that 'best' flag was given
return
return
end
end
 
if rank:sub(1,9) == flags.preferred then
if rank:sub(1,9) == p.flags.preferred then
rankPos = 1
rankPos = 1
elseif rank:sub(1,6) == flags.normal then
elseif rank:sub(1,6) == p.flags.normal then
rankPos = 2
rankPos = 2
elseif rank:sub(1,10) == flags.deprecated then
elseif rank:sub(1,10) == p.flags.deprecated then
rankPos = 3
rankPos = 3
else
else
return
return
end
end
 
-- one of the rank flags was given, check if another one was given before
-- one of the rank flags was given, check if another one was given before
if not self.flagRank then
if not self.flagRank then
1,229行目: 1,377行目:
self.flagRank = true                -- mark that a rank flag was given
self.flagRank = true                -- mark that a rank flag was given
end
end
 
if rank:sub(-1) == "+" then
if rank:sub(-1) == "+" then
for i = rankPos, 1, -1 do
for i = rankPos, 1, -1 do
1,245行目: 1,393行目:
function Config:setPeriod(period)
function Config:setPeriod(period)
local periodPos
local periodPos
 
if period == flags.future then
if period == p.flags.future then
periodPos = 1
periodPos = 1
elseif period == flags.current then
elseif period == p.flags.current then
periodPos = 2
periodPos = 2
elseif period == flags.former then
elseif period == p.flags.former then
periodPos = 3
periodPos = 3
else
else
return
return
end
end
 
-- one of the period flags was given, check if another one was given before
-- one of the period flags was given, check if another one was given before
if not self.flagPeriod then
if not self.flagPeriod then
1,261行目: 1,409行目:
self.flagPeriod = true                -- mark that a period flag was given
self.flagPeriod = true                -- mark that a period flag was given
end
end
 
self.periods[periodPos] = true
self.periods[periodPos] = true
end
end


function Config:processFlag(flag)
function Config:qualifierMatches(claim, id, value)
if not flag then
local qualifiers
return false
 
else
if claim.qualifiers then qualifiers = claim.qualifiers[id] end
flag = mw.text.trim(flag)
if qualifiers then
end
for _, v in pairs(qualifiers) do
if self:snakEqualsValue(v, value) then
if flag == flags.linked then
return true
self.curState.linked = true
end
return true
elseif flag == 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
end
elseif value == "" then
-- if the qualifier is not present then treat it the same as the special value 'novalue'
return true
return true
elseif flag == flags.short then
end
self.curState.shortName = true
 
return true
return false
elseif flag == flags.multilanguage then
end
self.curState.anyLanguage = true
 
return true
function Config:rankMatches(rankPos)
elseif flag == flags.unit then
if self.bestRank then
self.curState.unitOnly = true
return (self.ranks[rankPos] and self.foundRank >= rankPos)
return true
else
elseif flag == flags.mdy then
return self.ranks[rankPos]
self.mdyDate = true
return true
elseif flag == flags.single then
self.singleClaim = true
return true
elseif flag == flags.sourced then
self.sourcedOnly = true
return true
elseif flag == flags.edit then
self.editable = true
return true
elseif flag == flags.editAtEnd then
self.editable = true
self.editAtEnd = true
return true
elseif flag == flags.best or flag:match('^'..flags.preferred..'[+-]?$') or flag:match('^'..flags.normal..'[+-]?$') or flag:match('^'..flags.deprecated..'[+-]?$') then
self:setRank(flag)
return true
elseif flag == flags.future or flag == flags.current or flag == flags.former then
self:setPeriod(flag)
return true
elseif flag == "" then
-- ignore empty flags and carry on
return true
else
return false
end
end
end
end


function Config:processFlagOrCommand(flag)
function Config:timeMatches(claim)
local param = ""
local startTime = nil
local startTimeY = nil
if not flag then
local startTimeM = nil
return false
local startTimeD = nil
else
local endTime = nil
flag = mw.text.trim(flag)
local endTimeY = nil
local endTimeM = nil
local endTimeD = nil
 
if self.periods[1] and self.periods[2] and self.periods[3] then
-- any time
return true
end
end
 
if flag == "property" or flag == "properties" then
startTime = self:getSingleRawQualifier(claim, aliasesP.startTime)
param = parameters.property
if startTime and startTime ~= "" and startTime ~= " " then
elseif flag:match('^qualifier[s]?$') then
startTimeY, startTimeM, startTimeD = parseDate(startTime)
self.states.qualifiersCount = self.states.qualifiersCount + 1
param = parameters.qualifier .. self.states.qualifiersCount
self.separators["sep"..param] = {copyTable(defaultSeparators["sep%q\\d"])}
elseif flag:match('^reference[s]?$') then
param = parameters.reference
else
return self:processFlag(flag)
end
end
 
if self.states[param] then
endTime = self:getSingleRawQualifier(claim, aliasesP.endTime)
return false
if endTime and endTime ~= "" and endTime ~= " " then
endTimeY, endTimeM, endTimeD = parseDate(endTime)
end
end
 
-- create a new state for each command
if startTimeY ~= nil and endTimeY ~= nil and datePrecedesDate(endTimeY, endTimeM, endTimeD, startTimeY, startTimeM, startTimeD) then
self.states[param] = State.new(self)
-- invalidate end time if it precedes start time
endTimeY = nil
-- use "%x" as the general parameter name
endTimeM = nil
self.states[param].parsedFormat = parseFormat(parameters.general) -- will be overwritten for param=="%p"
endTimeD = nil
-- set the separator
self.states[param].separator = self.separators["sep"..param]  -- will be nil for param=="%p", which will be set separately
if flag:sub(-1) ~= 's' then
self.states[param].singleValue = true
end
end
self.curState = self.states[param]
return true
end


function Config:qualifierMatches(claim, ID, value)
if self.periods[1] then
local qualifiers
-- future
if startTimeY and datePrecedesDate(self.atDate[1], self.atDate[2], self.atDate[3], startTimeY, startTimeM, startTimeD) then
if claim.qualifiers then qualifiers = claim.qualifiers[ID] end
return true
if qualifiers then
for i, v in pairs(qualifiers) do
if self:snakEqualsValue(v, value) then
return true
end
end
end
elseif value == "" then
-- if the qualifier is not present then treat it the same as the special value 'novalue'
return true
end
end
return false
end


function Config:rankMatches(rankPos)
if self.periods[2] then
if self.bestRank then
-- current
return (self.ranks[rankPos] and self.foundRank >= rankPos)
if (startTimeY == nil or not datePrecedesDate(self.atDate[1], self.atDate[2], self.atDate[3], startTimeY, startTimeM, startTimeD)) and
else
  (endTimeY == nil or datePrecedesDate(self.atDate[1], self.atDate[2], self.atDate[3], endTimeY, endTimeM, endTimeD)) then
return self.ranks[rankPos]
return true
end
end
 
if self.periods[3] then
-- former
if endTimeY and not datePrecedesDate(self.atDate[1], self.atDate[2], self.atDate[3], endTimeY, endTimeM, endTimeD) then
return true
end
end
end
return false
end
end


function Config:timeMatches(claim)
function Config:processFlag(flag)
local startTime = nil
if not flag then
local startTimeY = nil
return false
local startTimeM = nil
end
local startTimeD = nil
 
local endTime = nil
if flag == p.flags.linked then
local endTimeY = nil
self.curState.linked = true
local endTimeM = nil
local endTimeD = nil
if self.periods[1] and self.periods[2] and self.periods[3] then
-- any time
return true
return true
end
elseif flag == p.flags.raw then
self.curState.rawValue = true
local now = os.date('!*t')
 
if self.curState == self.states[parameters.reference] then
startTime = self:getSingleRawQualifier(claim, aliasesP.startTime)
-- raw reference values end with periods and require a separator (other than none)
if startTime and startTime ~= "" and startTime ~= " " then
self.separators["sep%r"][1] = {" "}
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
endTimeY = nil
endTimeM = nil
endTimeD = nil
end
if self.periods[1] then
-- future
if startTimeY and datePrecedesDate(now['year'], now['month'], now['day'], startTimeY, startTimeM, startTimeD) then
return true
end
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
end
if self.periods[2] then
 
-- current
function Config:processFlagOrCommand(flag)
if (startTimeY == nil or not datePrecedesDate(now['year'], now['month'], now['day'], startTimeY, startTimeM, startTimeD)) and
local param = ""
  (endTimeY == nil or datePrecedesDate(now['year'], now['month'], now['day'], endTimeY, endTimeM, endTimeD)) then
 
return true
if not flag then
end
return false
end
end
 
if self.periods[3] then
if flag == p.claimCommands.property or flag == p.claimCommands.properties then
-- former
param = parameters.property
if endTimeY and not datePrecedesDate(now['year'], now['month'], now['day'], endTimeY, endTimeM, endTimeD) then
elseif flag == p.claimCommands.qualifier or flag == p.claimCommands.qualifiers then
return true
self.states.qualifiersCount = self.states.qualifiersCount + 1
end
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
end
return false
end


-- determines if a claim has references by prefetching them from the claim using getReferences,
if self.states[param] then
-- which applies some filtering that determines if a reference is actually returned,
return false
-- and caches the references for later use
end
function State:isSourced(claim)
 
self.conf.prefetchedRefs = self:getReferences(claim)
-- create a new state for each command
return (#self.conf.prefetchedRefs > 0)
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
end


function State:resetCaches()
function Config:processSeparators(args)
-- any prefetched references of the previous claim must not be used
local sep
self.conf.prefetchedRefs = nil
end


function State:claimMatches(claim)
for i, v in pairs(self.separators) do
local matches, rankPos
if args[i] then
sep = replaceSpecialChars(args[i])
-- first of all, reset any cached values used for the previous claim
 
self:resetCaches()
if sep ~= "" then
self.separators[i][1] = {sep}
-- if a property value was given, check if it matches the claim's property value
else
if self.conf.propertyValue then
self.separators[i][1] = nil
matches = self.conf:snakEqualsValue(claim.mainsnak, self.conf.propertyValue)
end
else
end
matches = true
end
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(claim.rank)
matches = (matches and self.conf:rankMatches(rankPos) and self.conf:timeMatches(claim))
-- if only claims with references must be returned, check if this one has any
if self.conf.sourcedOnly then
matches = (matches and self:isSourced(claim))  -- prefetches and caches references
end
return matches, rankPos
end
end


function State:out()
function Config:setFormatAndSeparators(state, parsedFormat)
local result  -- collection of arrays with value objects
state.parsedFormat = parsedFormat
local valuesArray  -- array with value objects
state.separator = self.separators["sep"]
local sep = nil  -- value object
state.movSeparator = self.separators["sep"..parameters.separator]
local out = {}  -- array with value objects
state.puncMark = self.separators["punc"]
end
local function walk(formatTable, result)
 
local valuesArray = {}  -- array with value objects
-- 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,
for i, v in pairs(formatTable.req) do
-- and caches the references for later use
if not result[i] or not result[i][1] then
function State:isSourced(claim)
-- we've got no result for a parameter that is required on this level,
self.conf.prefetchedRefs = self:getReferences(claim)
-- so skip this level (and its children) by returning an empty result
return (#self.conf.prefetchedRefs > 0)
return {}
end
end
 
end
function State:resetCaches()
-- any prefetched references of the previous claim must not be used
for i, v in ipairs(formatTable) do
self.conf.prefetchedRefs = nil
if v.param then
end
valuesArray = mergeArrays(valuesArray, result[v.str])
 
elseif v.str ~= "" then
function State:claimMatches(claim)
valuesArray[#valuesArray + 1] = {v.str}
local matches, rankPos
end
 
-- first of all, reset any cached values used for the previous claim
if v.child then
self:resetCaches()
valuesArray = mergeArrays(valuesArray, walk(v.child, result))
 
end
-- if a property value was given, check if it matches the claim's property value
end
if self.conf.propertyValue then
matches = self.conf:snakEqualsValue(claim.mainsnak, self.conf.propertyValue)
return valuesArray
else
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
end
 
-- iterate through the results from back to front, so that we know when to add separators
-- check if the claim's rank and time period match
for i = #self.results, 1, -1 do
rankPos = rankTable[claim.rank] or 4
result = self.results[i]
matches = (matches and self.conf:rankMatches(rankPos) and self.conf:timeMatches(claim))
 
-- if there is already some output, then add the separators
-- if only claims with references must be returned, check if this one has any
if #out > 0 then
if self.conf.sourcedOnly then
sep = self.separator[1]  -- fixed separator
matches = (matches and self:isSourced(claim)) -- prefetches and caches references
result[parameters.separator] = {self.movSeparator[1]}  -- movable separator
else
sep = nil
result[parameters.separator] = {self.puncMark[1]} -- optional punctuation mark
end
valuesArray = walk(self.parsedFormat, result)
if #valuesArray > 0 then
if sep then
valuesArray[#valuesArray + 1] = sep
end
out = mergeArrays(valuesArray, out)
end
end
end
 
-- reset state before next iteration
return matches, rankPos
self.results = {}
return out
end
end


-- level 1 hook
function State:out()
function State:getProperty(claim)
local result -- collection of arrays with value objects
local value = {self.conf:getValue(claim.mainsnak, self.rawValue, self.linked, self.shortName, self.anyLanguage, self.unitOnly)} -- create one value object
local valuesArray  -- array with value objects
local sep = nil -- value object
if #value > 0 then
local out = {}  -- array with value objects
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
local function walk(formatTable, result)
function State:getQualifiers(claim, param)
local valuesArray = {}  -- array with value objects
local qualifiers
if claim.qualifiers then qualifiers = claim.qualifiers[self.conf.qualifierIDs[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[param]:iterate(qualifiers, {[parameters.general] = hookNames[parameters.qualifier.."\\d"][2], count = 1})  -- pass qualifier state with level 2 hook
else
return {}  -- return empty array
end
end


-- level 2 hook
for i, v in pairs(formatTable.req) do
function State:getQualifier(snak)
if not result[i] or not result[i][1] then
local value = {self.conf:getValue(snak, self.rawValue, self.linked, self.shortName, self.anyLanguage, self.unitOnly)}  -- create one value object
-- 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 result
if #value > 0 then
return {}
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
end
out = mergeArrays(out, result[parameters.qualifier..i])
end
end
end
return out
end


-- level 1 hook
for _, v in ipairs(formatTable) do
function State:getReferences(claim)
if v.param then
if self.conf.prefetchedRefs then
valuesArray = mergeArrays(valuesArray, result[v.str])
-- return references that have been prefetched by isSourced
elseif v.str ~= "" then
return self.conf.prefetchedRefs
valuesArray[#valuesArray + 1] = {v.str}
end
end
 
if claim.references then
if v.child then
-- iterate through claim's reference statements to collect their values;
valuesArray = mergeArrays(valuesArray, walk(v.child, result))
-- return array with multiple value objects
end
return self.conf.states[parameters.reference]:iterate(claim.references, {[parameters.general] = hookNames[parameters.reference][2], count = 1}) -- pass reference state with level 2 hook
end
else
 
return {}  -- return empty array
return valuesArray
end
end
end


-- level 2 hook
-- iterate through the results from back to front, so that we know when to add separators
-- logic determined based on https://www.wikidata.org/wiki/Help:Sources
for i = #self.results, 1, -1 do
function State:getReference(statement)
result = self.results[i]
local language, referenceURL, title, statedIn, statedInRaw
 
local authors = {}
-- if there is already some output, then add the separators
local params = {}
if #out > 0 then
local citeParams = {}
sep = self.separator[1]  -- fixed separator
local value = ""
result[parameters.separator] = {self.movSeparator[1]}  -- movable separator
local ref = {}
else
sep = nil
-- number of parameters that do not go along with "stated in"-sources other than web pages as per https://www.wikidata.org/wiki/Help:Sources;
result[parameters.separator] = {self.puncMark[1]}  -- optional punctuation mark
-- these are parameters of properties other than "pages(s)" and "chapter" (for books) and "title" and "publication date" (for databases) and also "stated in"
local hasExtraParams = false
if statement.snaks then
-- don't include "imported from", which has been added by a bot
if statement.snaks[aliasesP.importedFrom] then
statement.snaks[aliasesP.importedFrom] = nil
end
end
 
-- not linked yet because we need the plain value for comparison first
valuesArray = walk(self.parsedFormat, result)
language = self:getReferenceDetail(statement.snaks, aliasesP.language, false, false, false, true)  -- (noUnset = true)
 
if language then
if #valuesArray > 0 then
-- not part of a "stated in"-source
if sep then
hasExtraParams = true
valuesArray[#valuesArray + 1] = sep
-- only add language to the reference if it differs from the local one
if self.conf.langName ~= language then
if self.linked then
-- retrieve language again, but this time with link
params[aliasesP.language] = self:getReferenceDetail(statement.snaks, aliasesP.language, false, true)  -- link = true
else
params[aliasesP.language] = language
end
end
end
 
-- we have to manually unset, since the first call to getReferenceDetail was with noUnset and the second call might not have happened
out = mergeArrays(valuesArray, out)
statement.snaks[aliasesP.language] = nil
end
authors = self:getReferenceDetails(statement.snaks, aliasesP.author, false, self.linked)  -- link = true/false
if #authors > 0 then
-- not part of a "stated in"-source
hasExtraParams = true
end
referenceURL = self:getReferenceDetail(statement.snaks, aliasesP.referenceURL)
if referenceURL then
-- not part of a "stated in"-source
hasExtraParams = true
end
-- the next two may be part of a "stated in"-source, so retrieve them already so that they won't count as hasExtraParams
title    = self:getReferenceDetail(statement.snaks, aliasesP.title, false, false, true)  -- anyLang = true
statedIn = self:getReferenceDetail(statement.snaks, aliasesP.statedIn, false, true, false, true)  -- link = true, (noUnset = true)
-- (1) if both "reference URL" and "title" are present, then use the general template for citing web references
if referenceURL and title and i18n['cite']['cite-web'] and i18n['cite']['cite-web'] ~= "" then
citeParams[i18n['cite']['url']]    = referenceURL
citeParams[i18n['cite']['title']]  = title
citeParams[i18n['cite']['website']] = statedIn
citeParams[i18n['cite']['language']] = params[aliasesP.language]
citeParams[i18n['cite']['date']]        = self:getReferenceDetail(statement.snaks, aliasesP.publicationDate)
citeParams[i18n['cite']['access-date']]  = self:getReferenceDetail(statement.snaks, aliasesP.retrieved)
citeParams[i18n['cite']['archive-url']]  = self:getReferenceDetail(statement.snaks, aliasesP.archiveURL)
citeParams[i18n['cite']['archive-date']] = self:getReferenceDetail(statement.snaks, aliasesP.archiveDate)
citeParams[i18n['cite']['publisher']]    = self:getReferenceDetail(statement.snaks, aliasesP.publisher, false, self.linked)  -- link = true/false
citeParams[i18n['cite']['quote']]        = self:getReferenceDetail(statement.snaks, aliasesP.quote, false, false, true)  -- anyLang = true
for i, v in ipairs(authors) do
citeParams[i18n['cite']['author']..i] = v
end
-- 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(citeParams) do
value = value .. "|" .. i .. "=" .. v
end
value = "{{" .. i18n['cite']['cite-web'] .. value .. "}}"
else
value = mw.getCurrentFrame():expandTemplate{title=i18n['cite']['cite-web'], args=citeParams}
end
else
-- we need the raw Q-identifier for the next template
statedInRaw = self:getReferenceDetail(statement.snaks, aliasesP.statedIn, true)  -- raw = true
-- the next three may be part of a "stated in"-source, so retrieve them already so that they won't count as hasExtraParams
params[aliasesP.pages]          = self:getReferenceDetail(statement.snaks, aliasesP.pages)
params[aliasesP.chapter]        = self:getReferenceDetail(statement.snaks, aliasesP.chapter)
params[aliasesP.publicationDate] = self:getReferenceDetail(statement.snaks, aliasesP.publicationDate)
-- retrieve the rest of the parameters and make them count as hasExtraParams
for i in pairs(statement.snaks) do
params[i] = self:getReferenceDetail(statement.snaks, i, false, self.linked, true)  -- link = true/false, anyLang = true
hasExtraParams = true
end
-- (2) if "stated in" is present without any parameters not belonging to a "stated in"-source, then use this template which expands the stated-in item
if statedInRaw and not hasExtraParams and i18n['cite']['cite-q'] and i18n['cite']['cite-q'] ~= "" then
citeParams[i18n['cite']['pages']]  = params[aliasesP.pages]
citeParams[i18n['cite']['chapter']] = params[aliasesP.chapter]
citeParams[i18n['cite']['date']]    = params[aliasesP.publicationDate]
if mw.isSubsting() then
for i, v in pairs(citeParams) do
value = value .. "|" .. i .. "=" .. v
end
value = "{{" .. i18n['cite']['cite-q'] .. "|" .. statedInRaw .. value .. "}}"
else
citeParams[1] = statedInRaw
value = mw.getCurrentFrame():expandTemplate{title=i18n['cite']['cite-q'], args=citeParams}
end
-- (3) else, do some default rendering of name-value pairs, but only if at least "stated in" or "reference URL" is present
elseif statedIn or referenceURL then
-- authors were already retrieved; start by adding them up front
if #authors > 0 then
citeParams[#citeParams + 1] = table.concat(authors, " & ")
end
-- combine "reference URL" and "title" into one link if both are present
if referenceURL and title then
citeParams[#citeParams + 1] = "[" .. referenceURL .. " " .. title .. "]"
elseif referenceURL then
citeParams[#citeParams + 1] = referenceURL
elseif title then
citeParams[#citeParams + 1] = title
end
if statedIn then
citeParams[#citeParams + 1] = statedIn
end
for i, v in pairs(params) do
i = getLabel(i)
if i ~= "" then
citeParams[#citeParams + 1] = i .. ": " .. v
end
end
value = table.concat(citeParams, "; ")
if value ~= "" then
value = value .. "."
end
end
end
if value ~= "" then
value = {value}  -- create one value object
if not self.rawValue then
-- this should become a <ref> tag, so safe the reference's hash for later
value.refHash = statement.hash
end
ref = {value}  -- wrap the value object in an array
end
end
end
end
 
return ref
-- reset state before next iteration
self.results = {}
 
return out
end
 
-- level 1 hook
function State:getProperty(claim)
local value = {self:getValue(claim.mainsnak)}  -- 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
end


-- gets a detail of one particular type for a reference
-- level 1 hook
function State:getReferenceDetail(snaks, dType, raw, link, anyLang, noUnset)
function State:getQualifiers(claim, param)
raw = raw or false
local qualifiers
link = link or false
 
anyLang = anyLang or false
if claim.qualifiers then qualifiers = claim.qualifiers[self.conf.qualifierIDs[param]] end
noUnset = noUnset or false
if qualifiers then
-- iterate through claim's qualifier statements to collect their values;
local switchLang = anyLang
-- return array with multiple value objects
local value = nil
return self.conf.states[param]:iterate(qualifiers, {[parameters.general] = hookNames[parameters.qualifier.."\\d"][2], count = 1})  -- pass qualifier state with level 2 hook
else
if not snaks[dType] then
return {}  -- return empty array
return nil
end
-- if anyLang, first try the local language and otherwise any language
repeat
for i, 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
if not noUnset then
-- remove detail(s) to make it possible to get the rest of the details in one loop
snaks[dType] = nil
end
end
return value
end
end


-- gets the details of one particular type for a reference
-- level 2 hook
function State:getReferenceDetails(snaks, dType, raw, link, anyLang, noUnset)
function State:getQualifier(snak)
raw = raw or false
local value = {self:getValue(snak)}  -- create one value object
link = link or false
 
anyLang = anyLang or false
if #value > 0 then
noUnset = noUnset or false
return {value} -- wrap the value object in an array and return it
else
local values = {}
return {} -- return empty array if there was no value
if not snaks[dType] then
return {}
end
end
for i, 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
if not noUnset then
-- remove detail(s) to make it possible to get the rest of the details in one loop
snaks[dType] = nil
end
return values
end
end


function State:callHook(param, hooks, statement, result)
-- level 1 hook
local valuesArray, refHash
function State:getAllQualifiers(claim, param, result, hooks)
local out = {} -- array with value objects
-- call a parameter's hook if it has been defined and if it has not been called before
local sep = self.conf.separators["sep"..parameters.qualifier][1]  -- value object
if not result[param] and hooks[param] then
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


-- iterate through claims, claim's qualifiers or claim's references to collect values
-- iterate through the output of the separate "qualifier(s)" commands
function State:iterate(statements, hooks, matchHook)
for i = 1, self.conf.states.qualifiersCount do
matchHook = matchHook or alwaysTrue
 
-- if a hook has not been called yet, call it now
local matches = false
if not result[parameters.qualifier..i] then
local rankPos = nil
self:callHook(parameters.qualifier..i, hooks, claim, result)
local result, gotRequired
end
 
for i, v in ipairs(statements) do
-- if there is output for this particular "qualifier(s)" command, then add it
-- rankPos will be nil for non-claim statements (e.g. qualifiers, references, etc.)
if result[parameters.qualifier..i] and result[parameters.qualifier..i][1] then
matches, rankPos = matchHook(self, v)
 
-- if there is already some output, then add the separator
if matches then
if #out > 0 and sep then
result = {count = 0}  -- collection of arrays with value objects
out[#out + 1] = sep
end
local function walk(formatTable)
 
local miss
out = mergeArrays(out, result[parameters.qualifier..i])
end
for i2, v2 in pairs(formatTable.req) do
end
-- call a hook, adding its return value to the result
 
miss = self:callHook(i2, hooks, v, result)
return out
end
if miss then
 
-- we miss a required value for this level, so return false
-- level 1 hook
return false
function State:getReferences(claim)
end
if self.conf.prefetchedRefs then
-- return references that have been prefetched by isSourced
if result.count == hooks.count then
return self.conf.prefetchedRefs
-- we're done if all hooks have been called;
end
-- returning at this point breaks the loop
 
return true
if claim.references then
end
-- iterate through claim's reference statements to collect their values;
end
-- return array with multiple value objects
return self.conf.states[parameters.reference]:iterate(claim.references, {[parameters.general] = hookNames[parameters.reference][2], count = 1})  -- pass reference state with level 2 hook
for i2, v2 in ipairs(formatTable) do
else
if result.count == hooks.count then
return {}  -- return empty array
-- we're done if all hooks have been called;
-- 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)
-- 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
end
return self:out()
end
end


function p.property(frame)
-- level 2 hook
loadSubmodules(frame)
function State:getReference(statement)
return p._property(copyTable(frame.args))
local key, citeWeb, citeQ, label
end
local params = {}
local citeParams = {['web'] = {}, ['q'] = {}}
local citeMismatch = {}
local useCite = nil
local useParams = nil
local value = ""
local ref = {}


function p._property(args)
local version = 1  -- increment this each time the below logic is changed to avoid conflict errors
loadSubmodules()
return execCommand(args, "property")
end


function p.properties(frame)
if statement.snaks then
loadSubmodules(frame)
-- don't include "imported from", which is added by a bot
return p._properties(copyTable(frame.args))
if statement.snaks[aliasesP.importedFrom] then
end
statement.snaks[aliasesP.importedFrom] = nil
end


function p._properties(args)
-- don't include "inferred from", which is added by a bot
loadSubmodules()
if statement.snaks[aliasesP.inferredFrom] then
return execCommand(args, "properties")
statement.snaks[aliasesP.inferredFrom] = nil
end
end


function p.qualifier(frame)
-- don't include "type of reference"
loadSubmodules(frame)
if statement.snaks[aliasesP.typeOfReference] then
return p._qualifier(copyTable(frame.args))
statement.snaks[aliasesP.typeOfReference] = nil
end
end


function p._qualifier(args)
-- don't include "image" to prevent littering
loadSubmodules()
if statement.snaks[aliasesP.image] then
return execCommand(args, "qualifier")
statement.snaks[aliasesP.image] = nil
end
end


function p.qualifiers(frame)
-- don't include "language" if it is equal to the local one
loadSubmodules(frame)
if self:getReferenceDetail(statement.snaks, aliasesP.language) == self.conf.langName then
return p._qualifiers(copyTable(frame.args))
statement.snaks[aliasesP.language] = nil
end
end


function p._qualifiers(args)
-- retrieve all the parameters
loadSubmodules()
for i in pairs(statement.snaks) do
return execCommand(args, "qualifiers")
label = ""
end


function p.reference(frame)
-- multiple authors may be given
loadSubmodules(frame)
if i == aliasesP.author then
return p._reference(copyTable(frame.args))
params[i] = self:getReferenceDetails(statement.snaks, i, false, self.linked, true) -- link = true/false, anyLang = true
end
else
params[i] = {self:getReferenceDetail(statement.snaks, i, false, (self.linked or (i == aliasesP.statedIn)) and (statement.snaks[i][1].datatype ~= 'url'), true)}  -- link = true/false, anyLang = true
end


function p._reference(args)
if #params[i] == 0 then
loadSubmodules()
params[i] = nil
return execCommand(args, "reference")
else
end
if statement.snaks[i][1].datatype == 'external-id' then
key = "external-id"
label = self.conf:getLabel(i)


function p.references(frame)
if label ~= "" then
loadSubmodules(frame)
label = label .. " "
return p._references(copyTable(frame.args))
end
end
else
key = i
end


function p._references(args)
-- add the parameter to each matching type of citation
loadSubmodules()
for j in pairs(citeParams) do
return execCommand(args, "references")
-- do so if there was no mismatch with a previous parameter
end
if not citeMismatch[j] then
-- check if this parameter is not mismatching itself
if i18n['cite'][j][key] then
-- continue if an option is available in the corresponding cite template
if i18n['cite'][j][key] ~= "" then
citeParams[j][i18n['cite'][j][key]] = label .. params[i][1]


function execCommand(args, funcName)
-- if there are multiple parameter values (authors), add those too
_ = Config.new()
for k=2, #params[i] do
_:processFlagOrCommand(funcName)  -- process first command (== function name)
citeParams[j][i18n['cite'][j][key]..k] = label .. params[i][k]
end
local parsedFormat, formatParams, claims, sep
end
local hooks = {count = 0}
else
citeMismatch[j] = true
local nextArg = args[1]
end
local nextIndex = 2
end
end
-- process flags and commands
end
while _:processFlagOrCommand(nextArg) do
nextArg = args[nextIndex]
nextIndex = nextIndex + 1
end
if nextArg then
nextArg = mw.text.trim(nextArg)
else
nextArg = ""
end
-- check for optional entity ID of either item or property
if nextArg:sub(1,1):upper() == "Q" then
_.entityID = nextArg:upper()  -- entity ID of an item was given
_.entity = mw.wikibase.getEntity(_.entityID)  -- get the item-entity based on the given ID
_.propertyID = mw.text.trim(args[nextIndex] or "")  -- property ID
nextIndex = nextIndex + 1
elseif nextArg:sub(1,9):lower() == "property:" then
_.entityID = replaceAlias(mw.text.trim(nextArg:sub(10))):upper()  -- entity ID of a property was given
_.entity = mw.wikibase.getEntity(_.entityID)  -- get the property-entity based on the given ID
_.propertyID = mw.text.trim(args[nextIndex] or "")  -- property ID
nextIndex = nextIndex + 1
else
_.entityID = mw.wikibase.getEntityIdForCurrentPage()  -- no entity ID given, use item-entity connected to current page
_.entity = mw.wikibase.getEntity()  -- get the item-entity connected to the current page
_.propertyID = nextArg  -- property ID
end
-- check if given property ID is an alias
_.propertyID = replaceAlias(_.propertyID):upper()
if _.states.qualifiersCount > 0 then
-- do further processing if "qualifier(s)" command was given
if #args - nextIndex + 1 > _.states.qualifiersCount then
-- claim ID or literal value has been given
_.propertyValue = mw.text.trim(args[nextIndex])
nextIndex = nextIndex + 1
end
end
 
for i = 1, _.states.qualifiersCount do
-- get title of general template for citing web references
nextArg = mw.text.trim(args[nextIndex] or "")  -- is a qualifierID
citeWeb = split(mw.wikibase.getSitelink(aliasesQ.citeWeb) or "", ":")[2]  -- split off namespace from front
nextIndex = nextIndex + 1
 
-- get title of template that expands stated-in references into citations
-- check if given qualifier ID is an alias and add it
citeQ = split(mw.wikibase.getSitelink(aliasesQ.citeQ) or "", ":")[2] -- split off namespace from front
_.qualifierIDs[parameters.qualifier..i] = replaceAlias(nextArg):upper()
 
-- (1) use the general template for citing web references if there is a match and if at least both "reference URL" and "title" are present
if citeWeb and not citeMismatch['web'] and citeParams['web'][i18n['cite']['web'][aliasesP.referenceURL]] and citeParams['web'][i18n['cite']['web'][aliasesP.title]] then
useCite = citeWeb
useParams = citeParams['web']
 
-- (2) use the template that expands stated-in references into citations if there is a match and if at least "stated in" is present
elseif citeQ and not citeMismatch['q'] and citeParams['q'][i18n['cite']['q'][aliasesP.statedIn]] then
-- we need the raw "stated in" Q-identifier for the this template
citeParams['q'][i18n['cite']['q'][aliasesP.statedIn]] = self:getReferenceDetail(statement.snaks, aliasesP.statedIn, true) -- raw = true
 
useCite = citeQ
useParams = citeParams['q']
end
end
elseif _.states[parameters.reference] then
 
-- do further processing if "reference(s)" command was given
if useCite and useParams then
-- if this module is being substituted then build a regular template call, otherwise expand the template
nextArg = args[nextIndex] -- claim ID or literal value (possibly nil)
if mw.isSubsting() then
nextIndex = nextIndex + 1
for i, v in pairs(useParams) do
value = value .. "|" .. i .. "=" .. v
if nextArg then
end
_.propertyValue = mw.text.trim(nextArg)
 
value = "{{" .. useCite .. value .. "}}"
else
value = mw.getCurrentFrame():expandTemplate{title=useCite, args=useParams}
end
 
-- (3) else, do some default rendering of name-value pairs, but only if at least "stated in", "reference URL" or "title" is present
elseif params[aliasesP.statedIn] or params[aliasesP.referenceURL] or params[aliasesP.title] then
citeParams['default'] = {}
 
-- start by adding authors up front
if params[aliasesP.author] and #params[aliasesP.author] > 0 then
citeParams['default'][#citeParams['default'] + 1] = table.concat(params[aliasesP.author], " & ")
end
 
-- combine "reference URL" and "title" into one link if both are present
if params[aliasesP.referenceURL] and params[aliasesP.title] then
citeParams['default'][#citeParams['default'] + 1] = '[' .. params[aliasesP.referenceURL][1] .. ' "' .. params[aliasesP.title][1] .. '"]'
elseif params[aliasesP.referenceURL] then
citeParams['default'][#citeParams['default'] + 1] = params[aliasesP.referenceURL][1]
elseif params[aliasesP.title] then
citeParams['default'][#citeParams['default'] + 1] = '"' .. params[aliasesP.title][1] .. '"'
end
 
-- then add "stated in"
if params[aliasesP.statedIn] then
citeParams['default'][#citeParams['default'] + 1] = "''" .. params[aliasesP.statedIn][1] .. "''"
end
 
-- remove previously added parameters so that they won't be added a second time
params[aliasesP.author] = nil
params[aliasesP.referenceURL] = nil
params[aliasesP.title] = nil
params[aliasesP.statedIn] = nil
 
-- add the rest of the parameters
for i, v in pairs(params) do
i = self.conf:getLabel(i)
 
if i ~= "" then
citeParams['default'][#citeParams['default'] + 1] = i .. ": " .. v[1]
end
end
 
value = table.concat(citeParams['default'], "; ")
 
if value ~= "" then
value = value .. "."
end
end
end
end
 
if value ~= "" then
-- check for special property value 'somevalue' or 'novalue'
value = {value}  -- create one value object
if _.propertyValue then
 
_.propertyValue = replaceSpecialChars(_.propertyValue)
if not self.rawValue then
-- this should become a <ref> tag, so save the reference's hash for later
if _.propertyValue ~= "" and mw.text.trim(_.propertyValue) == "" then
value.refHash = "wikidata-" .. statement.hash .. "-v" .. (tonumber(i18n['cite']['version']) + version)
_.propertyValue = " "  -- single space represents 'somevalue', whereas empty string represents 'novalue'
end
else
 
_.propertyValue = mw.text.trim(_.propertyValue)
ref = {value}  -- wrap the value object in an array
end
end
end
end
 
-- parse the desired format, or choose an appropriate format
return ref
if args["format"] then
end
parsedFormat, formatParams = parseFormat(args["format"])
 
elseif _.states.qualifiersCount > 0 then  -- "qualifier(s)" command given
-- gets a detail of one particular type for a reference
if _.states[parameters.property] then  -- "propert(y|ies)" command given
function State:getReferenceDetail(snaks, dType, raw, link, anyLang)
parsedFormat, formatParams = parseFormat(formats.propertyWithQualifier)
local switchLang = anyLang
else
local value = nil
parsedFormat, formatParams = parseFormat(formats.qualifier)
 
end
if not snaks[dType] then
elseif _.states[parameters.property] then -- "propert(y|ies)" command given
return nil
parsedFormat, formatParams = parseFormat(formats.property)
else  -- "reference(s)" command given
parsedFormat, formatParams = parseFormat(formats.reference)
end
end
 
-- if a "qualifier(s)" command and no "propert(y|ies)" command has been given, make the movable separator a semicolon
-- if anyLang, first try the local language and otherwise any language
if _.states.qualifiersCount > 0 and not _.states[parameters.property] then
repeat
_.separators["sep"..parameters.separator][1] = {";"}
for _, v in ipairs(snaks[dType]) do
end
value = self.conf:getValue(v, raw, link, false, anyLang and not switchLang, false, true) -- noSpecial = true
 
-- if only "reference(s)" has been given, set the default separator to none (except when raw)
if value then
if _.states[parameters.reference] and not _.states[parameters.property] and _.states.qualifiersCount == 0
break
  and not _.states[parameters.reference].rawValue then
_.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;
-- must come BEFORE overriding the separator values
if _.states.qualifiersCount == 1 then
_.separators["sep"..parameters.qualifier] = _.separators["sep"..parameters.qualifier.."1"]
end
-- process overridden separator values;
-- must come AFTER parsing the formats
for i, v in pairs(_.separators) do
if args[i] then
sep = replaceSpecialChars(args[i])
if sep ~= "" then
_.separators[i][1] = {sep}
else
_.separators[i][1] = nil
end
end
end
end
end
 
if value or not anyLang then
-- make sure that at least one required parameter has been defined
break
if not next(parsedFormat.req) then
error(missingRequiredParameterError())
end
-- make sure that the separator parameter "%s" is not amongst the required parameters
if parsedFormat.req[parameters.separator] then
error(extraRequiredParameterError(parameters.separator))
end
-- define the hooks that should be called (getProperty, getQualifiers, getReferences);
-- only define a hook if both its command ("propert(y|ies)", "reference(s)", "qualifier(s)") and its parameter ("%p", "%r", "%q1", "%q2", "%q3") have been given
for i, v in pairs(_.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] or formatParams[i:sub(1, 2)] then
hooks[i] = getHookName(i, 1)
hooks.count = hooks.count + 1
end
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
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", ...);
for _, v in ipairs(snaks[dType]) do
-- 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 nil is returned then it will not be added to the table
if formatParams[parameters.qualifier] and _.states.qualifiersCount > 0 then
values[#values + 1] = self.conf:getValue(v, raw, link, false, anyLang, false, true) -- noSpecial = true
hooks[parameters.qualifier] = getHookName(parameters.qualifier, 1)
hooks.count = hooks.count + 1
end
end
 
-- create a state for "properties" if it doesn't exist yet, which will be used as a base configuration for each claim iteration;
return values
-- must come AFTER defining the hooks
end
if not _.states[parameters.property] then
 
_.states[parameters.property] = State.new(_)
-- level 1 hook
function State:getAlias(object)
-- if the "single" flag has been given then this state should be equivalent to "property" (singular)
local value = object.value
if _.singleClaim then
local title = nil
_.states[parameters.property].singleValue = true
 
end
if value and self.linked then
end
if self.conf.entityID:sub(1,1) == "Q" then
title = mw.wikibase.getSitelink(self.conf.entityID)
-- if the "sourced" flag has been given then create a state for "reference" if it doesn't exist yet, using default values,
elseif self.conf.entityID:sub(1,1) == "P" then
-- which must exist in order to be able to determine if a claim has any references;
title = "d:Property:" .. self.conf.entityID
-- must come AFTER defining the hooks
end
if _.sourcedOnly and not _.states[parameters.reference] then
 
_:processFlagOrCommand("reference") -- use singular "reference" to minimize overhead
if title then
end
value = buildWikilink(title, value)
-- set the parsed format and the separators (and optional punctuation mark)
_.states[parameters.property].parsedFormat = parsedFormat
_.states[parameters.property].separator = _.separators["sep"]
_.states[parameters.property].movSeparator = _.separators["sep"..parameters.separator]
_.states[parameters.property].puncMark = _.separators["punc"]
-- process qualifier matching values, analogous to _.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
_.qualifierIDsAndValues[replaceAlias(i):upper()] = v
end
end
end
end
 
if _.entity and _.entity.claims then claims = _.entity.claims[_.propertyID] end
value = {value}  -- create one value object
if claims then
 
-- first sort the claims on rank to pre-define the order of output (preferred first, then normal, then deprecated)
if #value > 0 then
claims = sortOnRank(claims)
return {value} -- wrap the value object in an array and return it
-- then iterate through the claims to collect values
return _:concatValues(_.states[parameters.property]:iterate(claims, hooks, State.claimMatches)) -- pass property state with level 1 hooks and matchHook
else
else
return ""
return {}  -- return empty array if there was no value
end
end
end
end


function p.label(frame)
-- level 1 hook
loadSubmodules(frame)
function State:getBadge(value)
return p._label(copyTable(frame.args))
value = self.conf:getLabel(value, self.rawValue, self.linked, self.shortName)
end


function p._label(args, _)
if value == "" then
_ = _ or Config.new()
value = nil
_.curState = State.new(_)
loadSubmodules()
local ID = nil
local label = nil
local title = nil
local prefix= ""
local lang
local nextArg = args[1]
local nextIndex = 2
while _:processFlag(nextArg) do
nextArg = args[nextIndex]
nextIndex = nextIndex + 1
end
end
 
if nextArg then
value = {value}  -- create one value object
ID = mw.text.trim(nextArg)
 
if #value > 0 then
if ID == "" then
return {value}  -- wrap the value object in an array and return it
ID = nil
else
elseif ID:sub(1,9):lower() == "property:" then
return {}  -- return empty array if there was no value
ID = mw.text.trim(ID:sub(10))
end
end
end
end
if ID then
 
ID = replaceAlias(ID):upper()
function State:callHook(param, hooks, statement, result)
local valuesArray, refHash
-- check if this is a valid ID, and if the number is not larger than max int (to prevent error)
 
if not ID:match('^[QP]%d+$') or tonumber(ID:match('%d+')) > 2147483647 then
-- call a parameter's hook if it has been defined and if it has not been called before
return ""
if not result[param] and hooks[param] then
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
_.entityID = ID
else
_.entityID = mw.wikibase.getEntityIdForCurrentPage()
end
end
 
if not _.curState.rawValue or _.pageTitle then
return false
if not _.pageTitle then
end
-- (1) try short name
 
if _.curState.shortName then
-- iterate through claims, claim's qualifiers or claim's references to collect values
if ID and ID:sub(1,1) == "P" then
function State:iterate(statements, hooks, matchHook)
label = getShortName("Property:" .. ID)
matchHook = matchHook or alwaysTrue
else
 
label = getShortName(ID)
local matches = false
end
local rankPos = nil
local result, gotRequired
if label == "" then
 
label = nil
for _, v in ipairs(statements) do
end
-- rankPos will be nil for non-claim statements (e.g. qualifiers, references, etc.)
end
matches, rankPos = matchHook(self, v)
 
-- (2) try label
if matches then
if not label then
result = {count = 0}  -- collection of arrays with value objects
label, lang = mw.wikibase.getLabelWithLang(ID)
 
local function walk(formatTable)
-- don't allow language fallback
local miss
if lang ~= _.langCode then
 
label = nil
for i2, v2 in pairs(formatTable.req) do
end
-- call a hook, adding its return value to the result
end
miss = self:callHook(i2, hooks, v, result)
end
 
if miss then
-- (3) try sitelink/title
-- we miss a required value for this level, so return false
if not label or _.curState.linked then
return false
if not ID then
end
title = mw.title.getCurrentTitle().prefixedText
 
elseif ID:sub(1,1) == "Q" then
if result.count == hooks.count then
title = mw.wikibase.sitelink(ID)
-- we're done if all hooks have been called;
elseif label then
-- returning at this point breaks the loop
-- properties have no sitelink, 'title = ID' should only be set
return true
-- if there is a 'label' already and if it needs to be linked;
end
-- otherwise, it would be 'label = title == ID' even if '_.pageTitle' is set
end
title = ID
 
prefix = "d:Property:"
for _, v2 in ipairs(formatTable) do
if result.count == hooks.count then
-- we're done if all hooks have been called;
-- 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
end
gotRequired = walk(self.parsedFormat)
label = label or title
 
end
-- 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)
local id = nil
local prop = nil
 
if arg then
if arg:sub(1,1) == ":" then
page = arg
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
end
-- (4) try entity ID (i.e. raw value)
if not label and not _.pageTitle then
if not ID then
label = _.entityID
elseif mw.wikibase.getEntity(ID) then
label = ID
if ID:sub(1,1) == "P" then
prefix = "Property:"
end
end
prefix = "d:" .. prefix
title = label
end
-- add optional link
if _.curState.linked and title then
label = buildWikilink(prefix .. title, label)  -- label is never nil if title is not nil
end
if not label then
label = ""
elseif _.editable then
-- if desired, add a clickable icon that may be used to edit the returned value on Wikidata
label = label .. _:getEditIcon()
end
return label
end
function p.title(frame)
loadSubmodules(frame)
return p._title(copyTable(frame.args))
end
function p._title(args, _)
_ = _ or Config.new()
_.pageTitle = true
-- loadSubmodules() will already be called by _label()
return p._label(args, _)
end


-- main function that is supposed to be used by wrapper templates
if eid then
function p.main(frame)
if eid:sub(1,9):lower() == "property:" then
local f, args, i, v
id = replaceAlias(mw.text.trim(eid:sub(10)))
 
loadSubmodules(frame)
if id:sub(1,1):upper() ~= "P" then
id = ""
-- get the parent frame to take the arguments that were passed to the wrapper template
end
frame = frame:getParent() or frame
else
id = replaceAlias(eid)
if not frame.args[1] then
end
error(i18n["errors"]["no-function-specified"])
elseif page then
end
if page:sub(1,1) == ":" then
page = mw.text.trim(page:sub(2))
f = mw.text.trim(frame.args[1])
end
 
if f == "main" then
id = mw.wikibase.getEntityIdForTitle(page) or ""
error(i18n["errors"]["main-called-twice"])
end
end
 
if not id then
assert(p["_"..f], applyStringParams(i18n['errors']['no-such-function'], f))
id = mw.wikibase.getEntityIdForCurrentPage() or ""
end
-- copy arguments from immutable to mutable table
 
args = copyTable(frame.args)
id = id:upper()
 
-- remove the function name from the list
if not mw.wikibase.isValidEntityId(id) then
table.remove(args, 1)
id = ""
end
 
return id, prop
end
 
local function nextArg(args)
local arg = args[args.pointer]
 
if arg then
args.pointer = args.pointer + 1
return mw.text.trim(arg)
else
return nil
end
end
 
local function claimCommand(args, funcName)
local cfg = Config:new()
cfg:processFlagOrCommand(funcName)  -- process first command (== function name)
 
local lastArg, parsedFormat, formatParams, claims, value
local hooks = {count = 0}
 
-- set the date if given;
-- must come BEFORE processing the flags
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
lastArg = nextArg(args)
until not cfg:processFlagOrCommand(lastArg)
 
-- 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])
 
if cfg.entityID == "" then
return ""  -- we cannot continue without a valid entity ID
end
 
cfg.entity = mw.wikibase.getEntity(cfg.entityID)
 
if not cfg.propertyID then
cfg.propertyID = nextArg(args)
end
 
cfg.propertyID = replaceAlias(cfg.propertyID)
 
if not cfg.entity or 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
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
-- claim ID or literal value has been given
 
cfg.propertyValue = nextArg(args)
end
 
for i = 1, cfg.states.qualifiersCount do
-- check if given qualifier ID is an alias and add it
cfg.qualifierIDs[parameters.qualifier..i] = replaceAlias(nextArg(args) or ""):upper()
end
elseif cfg.states[parameters.reference] then
-- do further processing if "reference(s)" command was given
 
cfg.propertyValue = nextArg(args)
end
 
-- check for special property value 'somevalue' or 'novalue'
if cfg.propertyValue then
cfg.propertyValue = replaceSpecialChars(cfg.propertyValue)
 
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(args["format"])
elseif cfg.states.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
parsedFormat, formatParams = parseFormat(formats.reference)
end
 
-- if a "qualifier(s)" command and no "propert(y|ies)" command has been given, make the movable separator a semicolon
if cfg.states.qualifiersCount > 0 and not cfg.states[parameters.property] then
cfg.separators["sep"..parameters.separator][1] = {";"}
end
 
-- if only "reference(s)" has been given, set the default separator to none (except when raw)
if cfg.states[parameters.reference] and not cfg.states[parameters.property] and cfg.states.qualifiersCount == 0
  and not cfg.states[parameters.reference].rawValue then
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
if cfg.states.qualifiersCount == 1 then
cfg.separators["sep"..parameters.qualifier] = cfg.separators["sep"..parameters.qualifier.."1"]
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)", "reference(s)", "qualifier(s)") and its parameter ("%p", "%r", "%q1", "%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] or formatParams[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,
-- which must exist in order to be able to determine if a claim has any references;
-- must come AFTER defining the hooks
if cfg.sourcedOnly and not cfg.states[parameters.reference] then
cfg:processFlagOrCommand(p.claimCommands.reference)  -- use singular "reference" to minimize overhead
end
 
-- set the parsed format and the separators (and optional punctuation mark);
-- must come AFTER creating the additonal states
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 generalCommand(args, funcName)
local cfg = Config:new()
cfg.curState = State:new(cfg)
 
local lastArg
local value = nil
 
repeat
lastArg = nextArg(args)
until not cfg:processFlag(lastArg)
 
-- get the entity ID from either the positional argument, the eid argument or the page argument
cfg.entityID = getEntityId(lastArg, args[p.args.eid], args[p.args.page], true)
 
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
if funcName == p.generalCommands.label then
value = cfg:getLabel(cfg.entityID, cfg.curState.rawValue, cfg.curState.linked, cfg.curState.shortName)
elseif funcName == p.generalCommands.title then
cfg.inSitelinks = true
 
if cfg.entityID:sub(1,1) == "Q" then
value = mw.wikibase.getSitelink(cfg.entityID)
end
 
if cfg.curState.linked and value then
value = buildWikilink(value)
end
elseif funcName == p.generalCommands.description then
value = mw.wikibase.getDescription(cfg.entityID)
else
local parsedFormat, formatParams
local hooks = {count = 0}
 
cfg.entity = mw.wikibase.getEntity(cfg.entityID)
 
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
 
local aliases = cfg.entity.aliases[cfg.langCode]
 
-- 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)
end
 
-- process overridden separator values;
-- must come AFTER tweaking the default separators
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)
cfg:setFormatAndSeparators(cfg.curState, parsedFormat)
 
-- 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)
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
 
value = value or ""
 
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)
local function establishCommands(commandList, commandFunc)
for _, commandName in pairs(commandList) do
local function wikitextWrapper(frame)
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)
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
 
loadI18n(aliasesP, frame)
 
-- get the parent frame to take the arguments that were passed to the wrapper template
frame = frame:getParent() or frame
 
if not frame.args[1] then
throwError("no-function-specified")
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)
return p["_"..f](args)
end
end


return p
return p