Différences entre les pages « Modèle:Infobox/Ligne mixte latitude longitude optionnelle » et « Module:Wikidata »

De Les Mots de l'agronomie
(Différence entre les pages)
imported>Jacques Ducloy
m (1 révision importée)
 
imported>Jacques Ducloy
m (1 révision importée)
 
Ligne 1 : Ligne 1 :
<includeonly>{{#if: {{#ifeq: {{{géolocalisation|}}} | pas pertinent | 1}}{{#ifeq: {{{géolocalisation|}}} | non | 1}}
+
--script that retrieves basic data stored in Wikidata, for the datamodel, see https://www.mediawiki.org/wiki/Extension:Wikibase_Client/Lua
|<!-- à ne pas géolocaliser
 
-->{{#ifeq:{{NAMESPACE}}|{{ns:0}}|[[Catégorie:Article à ne pas géolocaliser]]}}<!--
 
  
-->| {{#if: {{#invoke: coordinates|latitude|{{{2|}}}|wikidata={{#if: {{{wikidata|}}} | {{{wikidata}}} | true }}}} | <!--
+
local wd = {}
  
à ne géolocaliser que dans le titre
+
local modules = { }
-->{{#ifeq: {{{inline|}}} | non | {{#if: {{{title|}}} | {{#ifeq:{{NAMESPACE}}|{{ns:0}}|{{#invoke:Coordinates|coord|{{{2|}}}|{{{3|}}}|display=title|name={{{name|}}}|formatitle={{#if: {{{formatitle|}}}| {{{formatitle}}}| dms}}|type:{{#if:{{{4|}}}|{{{4}}}|landmark}}|wikidata={{#if: {{{wikidata|}}} | {{{wikidata}}} | true }}}} }} }}<!--
+
local modulesNames = {
 +
reference = 'Module:Wikidata/Références',
 +
linguistic = 'Module:Linguistique',
 +
formatDate = 'Module:Date complexe',
 +
formatNum = 'Module:Conversion',
 +
langmodule = 'Module:Langue',
 +
cite = 'Module:Biblio',
 +
getData = 'Module:Wikidata/Récup',
 +
entities = 'Module:Wikidata/Formatage entité',
 +
tools = 'Module:Wikidata/Outils',
 +
globes = 'Module:Wikidata/Globes',
 +
langcodes = 'Module:Dictionnaire Wikidata/Codes langue', -- gros et rarement utilisé
 +
weblink = 'Module:Weblink'
 +
}
  
à géolocaliser dans l'infobox
+
local function loadModule( t, key )
-->|<th scope=row {{#if:{{{6|}}}|width="{{{6}}}%"|}}>{{#if:{{{1|}}}|{{{1}}}|Coordonnées}} </th><td {{#if:{{{7|}}}|colspan="{{{7}}}"|}}>{{#if: {{{2|}}} || [[Catégorie:Page géolocalisée par Wikidata]] }}{{#invoke:Coordinates|coord|{{{2|}}}|{{{3|}}}|display={{#ifeq: {{{inline|}}} | non ||inline,}}{{#if:{{{title|}}}|{{#ifeq:{{NAMESPACE}}|{{ns:0}}|title}}}}|name={{{name|}}}|format={{#if:{{{5|}}}|{{{5}}}|dms long}}|formatitle={{#if: {{{formatitle|}}}| {{{formatitle}}}| dms}}|type:{{#if:{{{4|}}}|{{{4}}}|landmark}}|wikidata={{#if: {{{wikidata|}}} | {{{wikidata}}} | true }}}}{{{référence|{{{8|}}} }}}</td></tr>
+
if modulesNames[key] then
<tr>}}<!--
+
local m = require( modulesNames[key] )
 +
t[key] = m
 +
return m
 +
end
 +
end
 +
setmetatable( modules, { __index = loadModule } )
  
à géolocaliser mais pas de coordonnées
+
local tools = require 'Module:Wikidata/Outils'
-->|{{#if:{{{nocat|}}}||{{#ifeq:{{NAMESPACE}}|{{ns:0}}|[[Catégorie:Page géolocalisable sans coordonnées paramétrées]]}}}}
+
local translate = tools.translate
}} }}</includeonly><noinclude>{{Documentation}}</noinclude>
+
local defaultlang = mw.getContentLanguage():getCode()
 +
 
 +
function wd.getLabel(entity, args)
 +
modules.entities.getLabel(entity)
 +
end
 +
 
 +
function wd.formatEntity(entity, args)
 +
return modules.entities.formatEntity(entity, args)
 +
end
 +
 
 +
function wd.addtrackingcat(prop, cat) -- doit parfois être appelé par d'autres modules
 +
if type(prop) == 'table' then
 +
prop = prop[1] -- devrait logiquement toutes les ajouter
 +
end
 +
if not prop and not cat then
 +
return error("no property provided")
 +
end
 +
if not cat then
 +
cat = translate('trackingcat', prop or 'P??')
 +
end
 +
return tools.addcat(cat )
 +
end
 +
 
 +
local function removeblanks(args)
 +
for i, j in pairs(args) do
 +
if j == '' then args[i] = nil end
 +
end
 +
return args
 +
end
 +
 
 +
local function unknownvalue(snak, label)
 +
local str = label
 +
 
 +
if type(str) == "function" then
 +
str = str(snak)
 +
end
 +
 
 +
if (not str) then
 +
if snak.datatype == 'time' then
 +
str = translate('sometime')
 +
else
 +
str = translate('somevalue')
 +
end
 +
end
 +
 
 +
if type(str) ~= "string" then
 +
return tools.formatError(snak.datatype)
 +
end
 +
return str
 +
end
 +
 
 +
local function novalue(displayformat)
 +
if not displayformat then
 +
return translate('novalue')
 +
end
 +
if type(displayformat) == 'string' then
 +
return displayformat
 +
end
 +
return tools.formatError()
 +
end
 +
 
 +
local function getlangcode(entityid)
 +
return modules.langcodes[tonumber(entityid:sub(2))]
 +
end
 +
 
 +
local  function showlang(statement) -- retourne le code langue entre paranthèse avant la valeur (par exemple pour les biblios et liens externes)
 +
local mainsnak = statement.mainsnak
 +
if mainsnak.snaktype ~= 'value' then
 +
return nil
 +
end
 +
local langlist = {}
 +
if mainsnak.datavalue.type == 'monolingualtext' then
 +
langlist = {mainsnak.datavalue.value.language}
 +
elseif (not statement.qualifiers) or (not statement.qualifiers.P407) then
 +
return
 +
else
 +
for i, j in pairs( statement.qualifiers.P407 ) do
 +
if  j.snaktype == 'value' then
 +
local langentity = tools.getId(j)
 +
local langcode =  getlangcode(langentity)
 +
table.insert(langlist, langcode)
 +
end
 +
end
 +
end
 +
if (#langlist > 1) or (#langlist == 1 and langlist[1] ~= defaultlang) then -- si c'est en français, pas besoin de le dire
 +
return modules.langmodule.indicationMultilingue(langlist)
 +
end
 +
end
 +
 
 +
local function formattable(statements, params) -- transform a table of claims into a table of formatted values
 +
for i, j in pairs(statements) do
 +
j = wd.formatStatement(j, params)
 +
end
 +
return statements
 +
end
 +
 
 +
function wd.tableToText(values, params) -- takes a list of already formatted values and make them a text
 +
if not values then
 +
return nil
 +
end
 +
 
 +
-- filters out nil values to avoid error in subsequent table.concat
 +
local filteredValues = {}
 +
for i, v in ipairs(values) do
 +
if v ~= nil then
 +
table.insert(filteredValues, v)
 +
end
 +
end
 +
 
 +
return modules.linguistic.quickconj( filteredValues, params.conjtype)--modules.linguistic.conj( values, params.lang, params.conjtype )
 +
end
 +
 
 +
 
 +
function wd.addStandardQualifs(str, statement)
 +
if (not statement) or (not statement.qualifiers) then
 +
return str
 +
end
 +
if not str then
 +
return tools.formatError("adding qualifs to a nil str !")-- il y a un problème
 +
end
 +
if statement.qualifiers.P1480 then
 +
for i, j in pairs(statement.qualifiers.P1480) do
 +
local v = tools.getId(j)
 +
if (v == "Q21818619") then
 +
str = str .. " (ou environs)"
 +
elseif (v == "Q18122778") or (v == "Q18912752") then
 +
str = str.. " (?)"
 +
elseif (v == "Q5727902") then -- traité séparément, car plus complexe séparément
 +
end
 +
end
 +
end
 +
return str
 +
end
 +
 
 +
function wd.rangeobject(begin, ending, params)
 +
--[[
 +
objet comportant un timestamp pour le classement chronologique et deux dateobject (begin et ending)
 +
]]--
 +
local timestamp
 +
if begin then
 +
timestamp = begin.timestamp
 +
else
 +
timestamp = ending.timestamp
 +
end
 +
return {begin = begin, ending = ending, timestamp = timestamp, type = 'rangeobject'}
 +
end
 +
 
 +
function wd.dateobject(orig, params)
 +
--[[ transforme un snak en un nouvel objet utilisable par Module:Date complexe
 +
{type = 'dateobject', timestamp = str, era = '+' ou '-', year = number, month = number, day = number, calendar = calendar}
 +
]]--
 +
if not params then
 +
params = {}
 +
end
 +
 +
local newobj = modules.formatDate.splitDate(orig.time, orig.calendar)
 +
 +
newobj.precision = params.precision or orig.precision
 +
newobj.type = 'dateobject'
 +
return newobj
 +
end
 +
 
 +
function wd.objecttotext(obj, params)
 +
if obj.type == 'dateobject' then
 +
return modules.formatDate.simplestring(obj, params)
 +
elseif obj.type == 'rangeobject' then
 +
return modules.formatDate.daterange(obj.begin, obj.ending, params)
 +
end
 +
end
 +
 
 +
local function getDatefromQualif(statement, qualif)
 +
if (not statement) or (not statement.qualifiers) or not (statement.qualifiers[qualif]) then
 +
return nil
 +
end
 +
local v = statement.qualifiers[qualif][1]
 +
if v.snaktype ~= 'value' then -- que faire dans ce cas ?
 +
return nil
 +
end
 +
return wd.dateobject(v.datavalue.value)
 +
end
 +
 
 +
function wd.getDate(statement)
 +
local period = getDatefromQualif(statement, 'P585') -- retourne un dateobject
 +
if period then
 +
return period
 +
end
 +
local begin, ending = getDatefromQualif(statement, 'P580'),  getDatefromQualif(statement, 'P582')
 +
if begin or ending then
 +
return wd.rangeobject(begin, ending) -- retourne un rangeobject fait de deux dateobject
 +
end
 +
end
 +
function wd.getFormattedDate(statement, params, useallqualifiers)
 +
if not statement then
 +
return nil
 +
end
 +
local str
 +
 
 +
local fuzzy = modules.getData.hasqualifier(statement, {"P1480"}, {"Q5727902"})
 +
if fuzzy then
 +
fuzzy = true
 +
end
 +
 
 +
--cherche la date avec les qualifs P580/P582
 +
local datetable = wd.getDate(statement)
 +
if datetable then
 +
str = wd.objecttotext(datetable, params)
 +
end
 +
 +
-- puis limite intérieur / supérieur
 +
if not str then
 +
local start, ending = getDatefromQualif(statement, 'P1319'), getDatefromQualif(statement, 'P1326')
 +
str = modules.formatDate.between(start, ending, params)
 +
end
 +
 
 +
-- sinon, le mainsnak, pour les données de type time
 +
if (not str) and (statement.mainsnak.datatype == 'time') then
 +
local mainsnak = statement.mainsnak
 +
if
 +
(mainsnak.snaktype == 'value' and mainsnak.datavalue.value.precision > 7)
 +
or
 +
(mainsnak.snaktype == 'somevalue')
 +
then
 +
str = wd.formatSnak(mainsnak, params)
 +
end
 +
end
 +
 
 +
-- ajouter le qualificatif "environ"
 +
if fuzzy then
 +
str = modules.formatDate.fuzzydate(str)
 +
end
 +
-- autres valeurs de qualité de l'information
 +
if str and (useallqualifiers ~= "-") then
 +
str = wd.addStandardQualifs(str, statement)
 +
if params.showqualifiers then
 +
str = wd.showQualifiers(str, statement, params)
 +
end
 +
end
 +
return str
 +
end
 +
 
 +
-- Fonction qui trie des Claims de type time selon l'ordre chronologique
 +
-- Une clé de tri nomée « dateSortKey » est ajouté à chaque claim.
 +
-- Si des clés de tri de ce nom existent déjà, elles sont utilisées sans modification.
 +
function wd.sortDateClaims( claims )
 +
for _, claim in ipairs( claims ) do
 +
if not claim.dateSortKey then
 +
local iso = wd.formatSnak( claim.mainsnak, { displayformat = 'raw' } )
 +
-- transformation en nombre (indication de la base car gsub retourne deux valeurs)
 +
iso = tonumber( iso:gsub( '(%d)%D', '%1' ), 10 ) or 0
 +
claim.dateSortKey = iso
 +
end
 +
end
 +
table.sort(
 +
claims,
 +
function ( c1, c2 )
 +
return c1.dateSortKey < c2.dateSortKey
 +
end
 +
)
 +
end
 +
 
 +
function wd.wikidataDate(prop, item, params)
 +
local claims = wd.getClaims{entity = item, property = prop}
 +
if not claims then
 +
return nil
 +
end
 +
wd.sortDateClaims( claims )
 +
params = params or {}
 +
local vals = {}
 +
for i, j in ipairs(claims) do
 +
local v = wd.getFormattedDate(j, params)
 +
if v then
 +
table.insert(vals, v)
 +
end
 +
end
 +
 +
local str = modules.linguistic.conj(vals, params.conjtype or 'or')
 +
 
 +
if not str then
 +
return
 +
end
 +
 
 +
if params.addcat ~= '-' then
 +
str = str .. wd.addtrackingcat(prop)
 +
end
 +
 
 +
if params.linkback ~= '-' then
 +
str = wd.addLinkback(str, item, prop)
 +
end
 +
return str
 +
end
 +
 
 +
function wd.getReferences(statement)
 +
local refdata = statement.references
 +
if not refdata then
 +
return nil
 +
end
 +
 
 +
local function firstsnak(prop)
 +
return wd.formatSnak(prop[1])
 +
end
 +
 
 +
local refs = {}
 +
for i, ref in pairs(refdata) do
 +
local s
 +
local function hasValue(prop) -- checks that the prop is here with valid value
 +
if ref.snaks[prop] and ref.snaks[prop][1].snaktype == 'value' then
 +
return true
 +
end
 +
return false
 +
end
 +
 
 +
if ref.snaks.P248 then
 +
for j, source in pairs(ref.snaks.P248) do
 +
if source.snaktype == 'value' then
 +
local page, accessdate
 +
if hasValue('P304') then
 +
page = wd.formatSnak(ref.snaks.P304[1])
 +
end
 +
if hasValue('P813') then
 +
accessdate = wd.formatSnak(ref.snaks.P813[1])
 +
end
 +
s = modules.reference.citeitem(tools.getId(source), {['page'] = page, ['accessdate'] = accessdate})
 +
table.insert(refs, s)
 +
end
 +
end
 +
 +
elseif hasValue('P854') and hasValue('P1476') then
 +
local url, title, accessdate, publishdate, publishlang
 +
url, title = wd.formatSnak(ref.snaks.P854[1], {text = "-"}), wd.formatSnak(ref.snaks.P1476[1])
 +
if hasValue('P813') then
 +
accessdate = wd.formatSnak(ref.snaks.P813[1])
 +
end
 +
-- publishdate avec P577 ? (ne semble pas vraiment correspondre)
 +
if hasValue('P407') then
 +
local id = tools.getId(ref.snaks.P407[1])
 +
publishlang = getlangcode(id)
 +
end
 +
s = modules.cite.lienWeb{titre = title, url = url, langue = publishlang, ['en ligne le'] = publishdate, ['consulté le'] = accessdate}
 +
table.insert(refs, s)
 +
elseif ref.snaks.P854 and ref.snaks.P854[1].snaktype == 'value' then
 +
s = wd.formatSnak(ref.snaks.P854[1], {text = "-"})
 +
table.insert(refs, s)
 +
end
 +
end
 +
if #refs > 0 then
 +
return refs
 +
end
 +
end
 +
 
 +
function wd.getDatavalue(snak, params)
 +
if not params then
 +
params = {}
 +
end
 +
local speciallabels = params.speciallabels -- parfois on a besoin de faire une liste d'éléments pour lequel le libellé doit être changé, pas très pratique d'utiliser une fonction pour ça
 +
 
 +
if snak.snaktype ~= 'value' then
 +
return nil
 +
end
 +
 
 +
local datatype = snak.datatype
 +
local value = snak.datavalue.value
 +
 +
local displayformat = params.displayformat
 +
if type(displayformat) == 'function' then
 +
return displayformat(snak, params)
 +
end
 +
 
 +
if datatype == 'wikibase-item' then
 +
return modules.entities.formatEntity(tools.getId(snak), params)
 +
end
 +
 
 +
if datatype == 'url' then
 +
return modules.weblink.makelink(value, params.text)
 +
end
 +
 
 +
if datatype == 'math' then
 +
return mw.getCurrentFrame():extensionTag( "math", value)
 +
end
 +
 
 +
if (datatype == 'string') or (datatype == 'external-id') or (datatype == 'commonsMedia') then -- toutes les données de type string sauf "math"
 +
if params.urlpattern then
 +
local urlpattern = params.urlpattern
 +
if type(urlpattern) == 'function' then
 +
urlpattern = urlpattern(value)
 +
end
 +
local url = mw.ustring.gsub(urlpattern, '$1', (value:gsub('%%', '%%%%'))):gsub(' ', '%%20')
 +
value = '[' .. url .. ' ' .. (params.text or value) .. ']'
 +
end
 +
return value
 +
end
 +
 +
if datatype == 'time' then -- format example: +00000001809-02-12T00:00:00Z
 +
local precision = params.precision -- degré de précision à afficher ('day', 'month', 'year'), inférieur ou égal à value.precision
 +
if displayformat == 'raw' then
 +
return value.time
 +
else
 +
return wd.objecttotext(wd.dateobject(value, {precision = precision}), {linktopic = params.linktopic})
 +
end
 +
end
 +
 
 +
if datatype == 'globe-coordinate' then
 +
-- retourne une table avec clés latitude, longitude, précision et globe à formater par un autre module (à changer ?)
 +
if displayformat == 'latitude' then
 +
return value.latitude
 +
elseif displayformat == 'longitude' then
 +
return value.longitude
 +
else
 +
local coordvalue = mw.clone( value )
 +
coordvalue.globe = modules.globes[value.globe] -- transforme l'ID du globe en nom anglais utilisable par geohack
 +
return coordvalue -- note : les coordonnées Wikidata peuvent être utilisée depuis Module:Coordinates. Faut-il aussi autoriser à appeler Module:Coordiantes ici ?
 +
end
 +
end
 +
 
 +
if datatype == 'quantity' then -- todo : gérer les paramètre précision
 +
local amount, unit = value.amount, value.unit
 +
 
 +
if unit then
 +
unit = unit:match('Q%d+')
 +
end
 +
 
 +
local showunit = params.showunit or true
 +
if showunit == '-' then
 +
showunit = false
 +
end
 +
local raw
 +
if displayformat == "raw" then
 +
raw = true
 +
end
 +
return modules.formatNum.displayvalue(amount, unit,
 +
{targetunit = params.targetunit, raw = raw, rounding = params.rounding, showunit = showunit}
 +
)
 +
end
 +
if datatype == 'monolingualtext' then
 +
if value.language == defaultlang then
 +
return value.text
 +
else
 +
return modules.langmodule.langue({value.language, value.text})
 +
end
 +
end
 +
return tools.formatError('unknown-datavalue-type' )
 +
 
 +
end
 +
 
 +
function wd.getClaims( args ) -- returns a table of the claims matching some conditions given in args
 +
return modules.getData.getClaims(args)
 +
end
 +
 
 +
 
 +
function wd.stringTable(args) -- like getClaims, but get a list of string rather than a list of snaks, for easier manipulation
 +
 +
local claims = args.claims
 +
if not claims then
 +
claims = wd.getClaims(args)
 +
end
 +
if not claims or claims == {} then
 +
return nil
 +
end
 +
local props = {} -- liste des propriétés associété à chaque string pour catégorisation et linkback
 +
for i, j in pairs(claims) do
 +
claims[i] = wd.formatStatement(j, args)
 +
table.insert(props, j.mainsnak.property)
 +
end
 +
if args.removedupes and (args.removedupes ~= '-') then
 +
claims = tools.addnewvalues({}, claims) -- devrait aussi supprimer de props celles qui ne sont pas utilisées
 +
end
 +
return claims, props
 +
end
 +
 
 +
function wd.getQualifiers(statement, qualifs, params)
 +
if not statement.qualifiers then
 +
return nil
 +
end
 +
local vals = {}
 +
if type(qualifs) == 'string' then
 +
qualifs = tools.splitStr(qualifs)
 +
end
 +
for i, j in pairs(qualifs) do
 +
if statement.qualifiers[j] then
 +
for k, l in pairs(statement.qualifiers[j]) do
 +
table.insert(vals, l)
 +
end
 +
end
 +
end
 +
if #vals == 0 then
 +
return nil
 +
end
 +
return vals
 +
end
 +
 
 +
function wd.getFormattedQualifiers(statement, qualifs, params)
 +
if not params then params = {} end
 +
local qualiftable = wd.getQualifiers(statement, qualifs)
 +
if not qualiftable then
 +
return nil
 +
end
 +
for i, j in pairs(qualiftable) do
 +
qualiftable[i] = wd.formatSnak(j, params)
 +
end
 +
return modules.linguistic.conj(qualiftable, params.conjtype)
 +
end
 +
 
 +
function wd.showQualifiers(str, statement, args) -- utilisée par formatStatement et par wikidatadate
 +
local qualifs =  args.showqualifiers
 +
if not qualifs then
 +
return str -- or error ?
 +
end
 +
if type(qualifs) == 'string' then
 +
qualifs = tools.splitStr(qualifs)
 +
end
 +
local qualifargs = args.qualifargs or {}
 +
-- formatage des qualificatifs = args commençant par "qualif", ou à défaut, les mêmes que pour la valeur principale
 +
qualifargs.displayformat = args.qualifdisplayformat or args.displayformat
 +
qualifargs.labelformat = args.qualiflabelformat or args.labelformat
 +
qualifargs.link = args.qualiflink or args.link
 +
qualifargs.conjtype = args.qualifconjtype
 +
 +
local formattedqualifs = wd.getFormattedQualifiers(statement, qualifs, qualifargs)
 +
if formattedqualifs and str then
 +
str = str .. modules.linguistic.inparentheses(formattedqualifs, defaultlang)
 +
end
 +
return str
 +
end
 +
 
 +
 
 +
function wd.sourceStr(sources)
 +
if not sources or (#sources == 0) then
 +
return nil
 +
end
 +
for i, j in pairs(sources) do
 +
sources[i] = mw.getCurrentFrame():extensionTag( "ref", j)
 +
end
 +
return table.concat(sources, '<sup class="reference cite_virgule">,</sup>')
 +
end
 +
 
 +
function wd.formatStatement( statement, args )
 +
if not args then
 +
args = {}
 +
end
 +
if not statement.type or statement.type ~= 'statement' then
 +
return tools.formatError( 'unknown-claim-type' )
 +
end
 +
local prop = statement.mainsnak.property
 +
 
 +
local str
 +
 
 +
-- partie principale
 +
if args.showonlyqualifier and (args.showonlyqualifier ~= '') then
 +
str = wd.getFormattedQualifiers(statement, args.showonlyqualifier, args)
 +
if not str then
 +
return nil
 +
end
 +
elseif args.statementformat and (type(args.statementformat) == 'function') then
 +
str = args.statementformat(statement, args)
 +
else
 +
str = wd.formatSnak( statement.mainsnak, args )
 +
end
 +
 
 +
-- ajouts divers
 +
if args.showlang == true then
 +
str = (showlang(statement) or '') .. '&#32;' .. str
 +
end
 +
if args.showqualifiers then
 +
str = wd.showQualifiers(str, statement, args)
 +
end
 +
 
 +
if args.showdate then -- when "showdate and chronosort are both set, date retrieval is performed twice
 +
local period = wd.getFormattedDate(statement, args, "-") -- 3 arguments indicate the we should not use additional qualifiers, alrady added by wd.formatStatement
 +
if period then
 +
str = str .. " <small>(" .. period ..")</small>"
 +
end
 +
end
 +
 
 +
if args.showsource then
 +
local sources = wd.getReferences(statement)
 +
if sources then
 +
local source = wd.sourceStr(sources)
 +
str = str .. (source or "")
 +
end
 +
end
 +
if statement.qualifiers then
 +
str = wd.addStandardQualifs(str, statement)
 +
end
 +
return str
 +
end
 +
 
 +
function wd.formatSnak( snak, params )
 +
if not params then params = {} end -- pour faciliter l'appel depuis d'autres modules
 +
if snak.snaktype == 'somevalue' then
 +
return unknownvalue(snak, params.unknownlabel)
 +
elseif snak.snaktype == 'novalue' then
 +
return novalue(params.novaluelabel)
 +
elseif snak.snaktype == 'value' then
 +
return wd.getDatavalue( snak, params)
 +
else
 +
return tools.formatError( 'unknown-snak-type' )
 +
end
 +
end
 +
 
 +
function wd.getDescription(entity, lang)
 +
lang = lang or defaultlang
 +
 
 +
local description
 +
if lang == defaultlang then
 +
return  mw.wikibase.descriptionl(qid)
 +
end
 +
if not entity.descriptions then
 +
return translate('no description')
 +
end
 +
local descriptions = entity.descriptions
 +
if not descriptions then
 +
return nil
 +
end
 +
if descriptions[lang] then
 +
return descriptions[delang].value
 +
end
 +
return entity.id
 +
end
 +
 
 +
function wd.addLinkback(str, id, property)
 +
if not id then
 +
id = tools.getEntity()
 +
end
 +
if not id then
 +
return str
 +
end
 +
if type(property) == 'table' then
 +
property = property[1]
 +
end
 +
if type(id) == 'table' then
 +
id = id.id
 +
end
 +
 +
local class = ''
 +
if property then
 +
class = 'wd_' .. string.lower(property)
 +
end
 +
local icon = '[[File:Blue pencil.svg|%s|10px|baseline|class=noviewer|link=%s]]'
 +
local title = translate('see-wikidata-value')
 +
local url = mw.uri.fullUrl('d:' .. id, 'uselang=fr')
 +
url.fragment = property -- ajoute une #ancre si paramètre "property" défini
 +
url = tostring(url)
 +
local v = mw.html.create('span')
 +
:addClass(class)
 +
:wikitext(str)
 +
:tag('span')
 +
:addClass('noprint wikidata-linkback')
 +
:css('padding-left', '0.5em')
 +
:wikitext(icon:format(title, url))
 +
:allDone()
 +
return tostring(v)
 +
end
 +
 
 +
function wd.addRefAnchor(str, id)
 +
--[[
 +
Insère une ancre pour une référence générée à partir d'un élément wd.
 +
L'id Wikidata sert d'identifiant à l'ancre, à utiliser dans les modèles type "harvsp"
 +
--]]
 +
return tostring(
 +
mw.html.create('span')
 +
:attr('id', id)
 +
:attr('class', "ouvrage")
 +
:wikitext(str)
 +
)
 +
end
 +
 
 +
function wd.formatStatements( args )--Format statement and concat them cleanly
 +
if args.value == '-' then
 +
return nil
 +
end
 +
local valueexpl = translate("activate-query")
 +
--If a value is already set, use it
 +
if args.value and (args.value ~= '') and (args.value ~= valueexpl) then
 +
return args.value
 +
end
 +
-- if args.expl: return something only one if explicitly required in Wikitext
 +
if args.expl and (args.value ~= valueexpl) then
 +
return nil
 +
end
 +
args.entity = tools.getEntity(args.entity)
 +
 
 +
if args.grouped and args.grouped ~= '' then
 +
args.grouped = false
 +
return wd.groupedStatements(args)
 +
end
 +
local valuetable = args.valuetable -- dans le cas où les valeurs sont déjà formtées
 +
local props -- les prorpriétés réellement utilisées (dans certainse cas, ce ne sont pas toutes celles de ags.property
 +
if not valuetable then -- cas le plus courant
 +
valuetable, props = wd.stringTable(args)
 +
end
 +
 
 +
local str = wd.tableToText(valuetable, args)
 +
if not str then
 +
return nil
 +
end
 +
if not props then
 +
props = tools.splitStr(args.property)[1]
 +
end
 +
if args.ucfirst ~= '-' then
 +
str = modules.linguistic.ucfirst(str)
 +
end
 +
 
 +
if args.addcat and (args.addcat ~= '-') then
 +
str = str .. wd.addtrackingcat(props)
 +
end
 +
if args.linkback and (args.linkback ~= '-') then
 +
str = wd.addLinkback(str, args.entity, props)
 +
end
 +
return str
 +
end
 +
 
 +
function wd.showQualifier( args )
 +
local qualifs = args.qualifiers or args.qualifier
 +
 +
if not qualifs then
 +
return tools.formatError( 'property-param-not-provided' )
 +
end
 +
if type(qualifs) == 'string' then
 +
qualifs = tools.splitStr(qualifs)
 +
end
 +
 
 +
local claims = wd.getClaims(args)
 +
if not claims then
 +
return nil
 +
end
 +
local str = ''
 +
for i, j in pairs(claims) do
 +
local new = wd.getFormattedQualifiers(j, qualifs, args) or ''
 +
str = str .. new
 +
end
 +
return str
 +
end
 +
 
 +
function wd.formatAndCat(args)
 +
if not args then
 +
return nil
 +
end
 +
args.linkback = true
 +
args.addcat = true
 +
if args.value then -- do not ignore linkback and addcat, as formatStatements do
 +
local val = args.value .. wd.addtrackingcat(args.property)
 +
val = wd.addLinkback(val, args.entity, args.property)
 +
return val
 +
end
 +
return wd.formatStatements( args )
 +
end
 +
 
 +
function wd.getTheDate(args)
 +
local claims = wd.getClaims(args)
 +
if not claims then
 +
return nil
 +
end
 +
local formattedvalues = {}
 +
for i, j in pairs(claims) do
 +
local v = wd.getFormattedDate(j, args)
 +
if v then
 +
table.insert(formattedvalues, v )
 +
end
 +
end
 +
local val = modules.linguistic.conj(formattedvalues)
 +
if not val then
 +
return nil
 +
end
 +
if args.addcat == true then
 +
val = val .. wd.addtrackingcat(args.property)
 +
end
 +
val = wd.addLinkback(val, args.entity, args.property)
 +
return val
 +
end
 +
 
 +
 
 +
-- Complex functions using several items
 +
local function getids(query)
 +
query.excludespecial = true
 +
query.displayformat = 'raw'
 +
return wd.stringTable(query)
 +
end
 +
 
 +
 
 +
function wd.Dump(entity)
 +
entity = tools.getEntity(entity)
 +
if not entity then
 +
return tools.formatError("entity-param-not-provided")
 +
end
 +
return "<pre>"..mw.dumpObject(entity).."</pre>"
 +
end
 +
 
 +
function wd.groupedStatements(args, type)
 +
-- regroupe les affirmations ayant la même valeur en mainsnak, mais des qualificatifs différents
 +
-- (seulement pour les propriétés de type élément)
 +
 
 +
local claims = wd.getClaims(args)
 +
if not claims then
 +
return nil
 +
end
 +
local groupedClaims = {}
 +
 
 +
-- regroupe les affirmations par valeur de mainsnak
 +
local function addClaim(claim)
 +
local id = tools.getMainId(claim)
 +
for i, j in pairs(groupedClaims) do
 +
if (j.id == id) then
 +
table.insert(groupedClaims[i].claims, claim)
 +
return
 +
end
 +
end
 +
table.insert(groupedClaims, {id = id, claims = {claim}})
 +
end
 +
for i, claim in pairs(claims) do
 +
addClaim(claim)
 +
end
 +
 
 +
local stringTable = {}
 +
 
 +
-- instructions ad hoc pour les paramètres concernant la mise en forme d'une déclaration individuelle
 +
local funs = {
 +
{param = "showqualifiers", fun = function(str, claims)
 +
local qualifs = {}
 +
for i, claim in pairs(claims) do
 +
local news = wd.getFormattedQualifiers(claim, args.showqualifiers, args)
 +
if news then
 +
table.insert(qualifs, news)
 +
end
 +
end
 +
local qualifstr = modules.linguistic.conj(qualifs, " ; ") -- point virgule pour séparer les années
 +
if not qualifstr then
 +
return str
 +
end
 +
return str .. " " .. modules.linguistic.inparentheses(qualifstr)
 +
end
 +
},
 +
{param = "showdate", fun = function(str, claims)
 +
-- toutes les dates sont regroupées à l'intérieur des mêmes parenthèses ex "médaille d'or (1922, 1924)"
 +
local dates = {}
 +
for i, statement in pairs(claims) do
 +
local s = wd.getFormattedDate(statement, args, true) -- l'option useallqualifiers ne doit pas être désactivée dans ce cas
 +
if statement then table.insert(dates, s) end
 +
end
 +
local datestr = modules.linguistic.conj(dates)
 +
if not datestr then
 +
return str
 +
end
 +
return str .. "<small>" .. modules.linguistic.inparentheses(datestr) .. "</small>"
 +
end
 +
},
 +
{param = "showsource", fun = function(str, claims)
 +
-- les sources sont toutes affichées au même endroit, à la fin
 +
-- si deux affirmations ont la même source, on ne l'affiche qu'une fois
 +
local sources = {}
 +
 +
local function dupeRef(old, new)
 +
for i, j in pairs(old) do
 +
if j == new then
 +
return true
 +
end
 +
end
 +
end
 +
for i, claim in pairs(claims) do
 +
local refs = wd.getReferences(claim)
 +
if refs then
 +
for i, j in pairs(refs) do
 +
if not dupeRef(sources, j) then
 +
table.insert(sources, j)
 +
end
 +
end
 +
end
 +
end
 +
return str .. (wd.sourceStr(sources) or "")
 +
end
 +
}
 +
}
 +
 
 +
for i, group in pairs(groupedClaims) do -- bricolage pour utiliser les arguments de formatStatements
 +
local str = wd.formatEntity(group.id, args)
 +
for i, fun in pairs(funs) do
 +
if args[fun.param] then
 +
str = fun.fun(str, group.claims, args)
 +
end
 +
end
 +
table.insert(stringTable, str)
 +
end
 +
 +
args.valuetable = stringTable
 +
return wd.formatStatements(args)
 +
end
 +
 
 +
return wd

Version actuelle datée du 28 décembre 2020 à 11:45

La documentation pour ce module peut être créée à Module:Wikidata/doc

--script that retrieves basic data stored in Wikidata, for the datamodel, see https://www.mediawiki.org/wiki/Extension:Wikibase_Client/Lua

local wd = {}

local modules = { }
local modulesNames = {
	reference = 'Module:Wikidata/Références',
	linguistic = 'Module:Linguistique',
	formatDate = 'Module:Date complexe',
	formatNum = 'Module:Conversion',
	langmodule = 'Module:Langue',
	cite = 'Module:Biblio',
	getData = 'Module:Wikidata/Récup',
	entities = 'Module:Wikidata/Formatage entité',
	tools = 'Module:Wikidata/Outils',
	globes = 'Module:Wikidata/Globes',
	langcodes = 'Module:Dictionnaire Wikidata/Codes langue', -- gros et rarement utilisé
	weblink = 'Module:Weblink'
}

local function loadModule( t, key )
	if modulesNames[key] then
		local m = require( modulesNames[key] )
		t[key] = m
		return m
	end
end
setmetatable( modules, { __index = loadModule } )

local tools = require 'Module:Wikidata/Outils'
local translate = tools.translate
local defaultlang = mw.getContentLanguage():getCode()

function wd.getLabel(entity, args)
	modules.entities.getLabel(entity)
end

function wd.formatEntity(entity, args)
	return modules.entities.formatEntity(entity, args)
end

function wd.addtrackingcat(prop, cat) -- doit parfois être appelé par d'autres modules
	if type(prop) == 'table' then
		prop = prop[1] -- devrait logiquement toutes les ajouter
	end
	if not prop and not cat then
		return error("no property provided")
	end
	if not cat then
		cat = translate('trackingcat', prop or 'P??')
	end
	return tools.addcat(cat )
end

local function removeblanks(args)
	for i, j in pairs(args) do
		if j == '' then args[i] = nil end
	end
	return args
end

local function unknownvalue(snak, label)
	local str = label

	if type(str) == "function" then
		str = str(snak)
	end

	if (not str) then
		if snak.datatype == 'time' then
			str = translate('sometime')
		else
			str = translate('somevalue')
		end
	end

	if type(str) ~= "string" then
		return tools.formatError(snak.datatype)
	end
	return str
end

local function novalue(displayformat)
	if not displayformat then
		return translate('novalue')
	end
	if type(displayformat) == 'string' then
		return displayformat
	end
	return tools.formatError()
end

local function getlangcode(entityid)
	return modules.langcodes[tonumber(entityid:sub(2))]
end

local  function showlang(statement) -- retourne le code langue entre paranthèse avant la valeur (par exemple pour les biblios et liens externes)
	local mainsnak = statement.mainsnak
	if mainsnak.snaktype ~= 'value' then
		return nil
	end
	local langlist = {}
	if mainsnak.datavalue.type == 'monolingualtext' then
		langlist = {mainsnak.datavalue.value.language}
	elseif (not statement.qualifiers) or (not statement.qualifiers.P407) then
		return
	else
		for i, j in pairs( statement.qualifiers.P407 ) do
			if  j.snaktype == 'value' then
				local langentity = tools.getId(j)
				local langcode =  getlangcode(langentity)
				table.insert(langlist, langcode)
			end
		end
	end
	if (#langlist > 1) or (#langlist == 1 and langlist[1] ~= defaultlang) then -- si c'est en français, pas besoin de le dire
		return modules.langmodule.indicationMultilingue(langlist)
	end
end

local function formattable(statements, params) -- transform a table of claims into a table of formatted values
	for i, j in pairs(statements) do
		j = wd.formatStatement(j, params)
	end
	return statements
end

function wd.tableToText(values, params) -- takes a list of already formatted values and make them a text
	if not values then
		return nil
	end

	-- filters out nil values to avoid error in subsequent table.concat
	local filteredValues = {}
	for i, v in ipairs(values) do
		if v ~= nil then
			table.insert(filteredValues, v)
		end
	end

	return modules.linguistic.quickconj( filteredValues, params.conjtype)--modules.linguistic.conj( values, params.lang, params.conjtype )
end


function wd.addStandardQualifs(str, statement)
	if (not statement) or (not statement.qualifiers) then
		return str
	end
	if not str then
		return tools.formatError("adding qualifs to a nil str !")-- il y a un problème
	end
	if statement.qualifiers.P1480 then
		for i, j in pairs(statement.qualifiers.P1480) do
			local v = tools.getId(j)
			if (v == "Q21818619") then
				str = str .. " (ou environs)"
			elseif (v == "Q18122778") or (v == "Q18912752") then
				str = str.. " (?)"
			elseif (v == "Q5727902") then -- traité séparément, car plus complexe séparément
			end			
		end
	end
	return str
end

function wd.rangeobject(begin, ending, params)
	--[[
		objet comportant un timestamp pour le classement chronologique et deux dateobject (begin et ending)
	]]-- 
	local timestamp
	if begin then
		timestamp = begin.timestamp
	else
		timestamp = ending.timestamp
	end
	return {begin = begin, ending = ending, timestamp = timestamp, type = 'rangeobject'}
end

function wd.dateobject(orig, params)
	--[[ transforme un snak en un nouvel objet utilisable par Module:Date complexe
		{type = 'dateobject', timestamp = str, era = '+' ou '-', year = number, month = number, day = number, calendar = calendar}
	]]-- 
	if not params then
		params = {}
	end
	
	local newobj = modules.formatDate.splitDate(orig.time, orig.calendar)
	
	newobj.precision = params.precision or orig.precision
	newobj.type = 'dateobject'
	return newobj
end

function wd.objecttotext(obj, params)
	if obj.type == 'dateobject' then
		return modules.formatDate.simplestring(obj, params)
	elseif obj.type == 'rangeobject' then
		return modules.formatDate.daterange(obj.begin, obj.ending, params)
	end
end

local function getDatefromQualif(statement, qualif)
	if (not statement) or (not statement.qualifiers) or not (statement.qualifiers[qualif]) then
		return nil
	end
	local v = statement.qualifiers[qualif][1]
	if v.snaktype ~= 'value' then -- que faire dans ce cas ?
		return nil
	end
	return wd.dateobject(v.datavalue.value)
end

function wd.getDate(statement)
	local period = getDatefromQualif(statement, 'P585') -- retourne un dateobject
	if period then
		return period
	end
	local begin, ending = getDatefromQualif(statement, 'P580'),  getDatefromQualif(statement, 'P582')
	if begin or ending then
		return wd.rangeobject(begin, ending) -- retourne un rangeobject fait de deux dateobject
	end
end
function wd.getFormattedDate(statement, params, useallqualifiers)
	if not statement then
		return nil
	end
	local str

	local fuzzy = modules.getData.hasqualifier(statement, {"P1480"}, {"Q5727902"})
	if fuzzy then
		fuzzy = true
	end

	--cherche la date avec les qualifs P580/P582
	local datetable = wd.getDate(statement)
	if datetable then
		str = wd.objecttotext(datetable, params)
	end
	
	-- puis limite intérieur / supérieur
	if not str then
		local start, ending = getDatefromQualif(statement, 'P1319'), getDatefromQualif(statement, 'P1326')
		str = modules.formatDate.between(start, ending, params)
	end

	 -- sinon, le mainsnak, pour les données de type time
	if (not str) and (statement.mainsnak.datatype == 'time') then
		local mainsnak = statement.mainsnak
		if
			(mainsnak.snaktype == 'value' and mainsnak.datavalue.value.precision > 7)
			or
			(mainsnak.snaktype == 'somevalue')
		then
		str = wd.formatSnak(mainsnak, params)
		end
	end

	-- ajouter le qualificatif "environ"
	if fuzzy then
		str = modules.formatDate.fuzzydate(str)
	end
	-- autres valeurs de qualité de l'information
	if str and (useallqualifiers ~= "-") then
		str = wd.addStandardQualifs(str, statement)
		if params.showqualifiers then
			str = wd.showQualifiers(str, statement, params)
		end
	end
	return str
end

-- Fonction qui trie des Claims de type time selon l'ordre chronologique
-- Une clé de tri nomée « dateSortKey » est ajouté à chaque claim.
-- Si des clés de tri de ce nom existent déjà, elles sont utilisées sans modification.
function wd.sortDateClaims( claims )
	for _, claim in ipairs( claims ) do
		if not claim.dateSortKey then
			local iso = wd.formatSnak( claim.mainsnak, { displayformat = 'raw' } ) 
			-- transformation en nombre (indication de la base car gsub retourne deux valeurs)
			iso = tonumber( iso:gsub( '(%d)%D', '%1' ), 10 ) or 0
			claim.dateSortKey = iso
		end
	end
	table.sort( 
		claims,
		function ( c1, c2 )
			return c1.dateSortKey < c2.dateSortKey
		end
	)
end

function wd.wikidataDate(prop, item, params)
	local claims = wd.getClaims{entity = item, property = prop}
	if not claims then
		return nil
	end
	wd.sortDateClaims( claims )
	params = params or {}
	local vals = {}
	for i, j in ipairs(claims) do
		local v = wd.getFormattedDate(j, params)
		if v then
			table.insert(vals, v)
		end
	end
	
	local str = modules.linguistic.conj(vals, params.conjtype or 'or')

	if not str then
		return
	end

	if params.addcat ~= '-' then
		str = str .. wd.addtrackingcat(prop)
	end

	if params.linkback ~= '-' then
		str = wd.addLinkback(str, item, prop)
	end
	return str
end

function wd.getReferences(statement)
	local refdata = statement.references
	if not refdata then
		return nil
	end

	local function firstsnak(prop)
		return wd.formatSnak(prop[1])
	end

	local refs = {}
	for i, ref in pairs(refdata) do
		local s
		local function hasValue(prop) -- checks that the prop is here with valid value
			if ref.snaks[prop] and ref.snaks[prop][1].snaktype == 'value' then
				return true
			end
			return false
		end		

		if ref.snaks.P248 then
			for j, source in pairs(ref.snaks.P248) do
				if source.snaktype == 'value' then
					local page, accessdate
					if hasValue('P304') then
						page = wd.formatSnak(ref.snaks.P304[1])
					end
					if hasValue('P813') then
						accessdate = wd.formatSnak(ref.snaks.P813[1])
					end
					s = modules.reference.citeitem(tools.getId(source), {['page'] = page, ['accessdate'] = accessdate})
					table.insert(refs, s)
				end
			end
	
		elseif hasValue('P854') and hasValue('P1476') then
			local url, title, accessdate, publishdate, publishlang
			url, title = wd.formatSnak(ref.snaks.P854[1], {text = "-"}), wd.formatSnak(ref.snaks.P1476[1])
			if hasValue('P813') then
				accessdate = wd.formatSnak(ref.snaks.P813[1])
			end
			-- publishdate avec P577 ? (ne semble pas vraiment correspondre) 
			if hasValue('P407') then
				local id = tools.getId(ref.snaks.P407[1])
				publishlang = getlangcode(id)
			end
			s = modules.cite.lienWeb{titre = title, url = url, langue = publishlang, ['en ligne le'] = publishdate, ['consulté le'] = accessdate}
			table.insert(refs, s)			
		elseif ref.snaks.P854 and ref.snaks.P854[1].snaktype == 'value' then
			s = wd.formatSnak(ref.snaks.P854[1], {text = "-"})
			table.insert(refs, s)
		end
	end
	if #refs > 0 then
		return refs
	end
end

function wd.getDatavalue(snak, params)
	if not params then
		params = {}
	end
	local speciallabels = params.speciallabels -- parfois on a besoin de faire une liste d'éléments pour lequel le libellé doit être changé, pas très pratique d'utiliser une fonction pour ça

	if snak.snaktype ~= 'value' then
		return nil
	end

	local datatype = snak.datatype
	local value = snak.datavalue.value
	
	local displayformat = params.displayformat
	if type(displayformat) == 'function' then
		return displayformat(snak, params)
	end

	if datatype == 'wikibase-item' then
		return modules.entities.formatEntity(tools.getId(snak), params)
	end

	if datatype == 'url' then
		return modules.weblink.makelink(value, params.text)
	end

	if datatype == 'math' then
		return mw.getCurrentFrame():extensionTag( "math", value)
	end

	if (datatype == 'string') or (datatype == 'external-id') or (datatype == 'commonsMedia') then -- toutes les données de type string sauf "math"
		if params.urlpattern then
			local urlpattern = params.urlpattern
			if type(urlpattern) == 'function' then
				urlpattern = urlpattern(value)
			end
			local url = mw.ustring.gsub(urlpattern, '$1', (value:gsub('%%', '%%%%'))):gsub(' ', '%%20')
			value = '[' .. url .. ' ' .. (params.text or value) .. ']'
		end
		return value
	end
	
	if datatype == 'time' then -- format example: +00000001809-02-12T00:00:00Z
		local precision = params.precision -- degré de précision à afficher ('day', 'month', 'year'), inférieur ou égal à value.precision
		if displayformat == 'raw' then
			return value.time
		else
			return wd.objecttotext(wd.dateobject(value, {precision = precision}), {linktopic = params.linktopic})
		end
	end

	if datatype == 'globe-coordinate' then
		-- retourne une table avec clés latitude, longitude, précision et globe à formater par un autre module (à changer ?)
		if displayformat == 'latitude' then
			return value.latitude
		elseif displayformat == 'longitude' then
			return value.longitude
		else
			local coordvalue = mw.clone( value )
			coordvalue.globe = modules.globes[value.globe] -- transforme l'ID du globe en nom anglais utilisable par geohack
			return coordvalue -- note : les coordonnées Wikidata peuvent être utilisée depuis Module:Coordinates. Faut-il aussi autoriser à appeler Module:Coordiantes ici ?
		end
	end

	if datatype == 'quantity' then -- todo : gérer les paramètre précision
		local amount, unit = value.amount, value.unit

		if unit then
			unit = unit:match('Q%d+')
		end

		local showunit = params.showunit or true		
		if showunit == '-' then
			showunit = false
		end
		local raw	
		if displayformat == "raw" then
			raw = true
		end
		return modules.formatNum.displayvalue(amount, unit,
			{targetunit = params.targetunit, raw = raw, rounding = params.rounding, showunit = showunit}
		)
	end
	if datatype == 'monolingualtext' then
		if value.language == defaultlang then
			return value.text
		else
			return modules.langmodule.langue({value.language, value.text})
		end
	end	
	return tools.formatError('unknown-datavalue-type' )

end

function wd.getClaims( args ) -- returns a table of the claims matching some conditions given in args
	return modules.getData.getClaims(args)
end


function wd.stringTable(args) -- like getClaims, but get a list of string rather than a list of snaks, for easier manipulation
	
	local claims = args.claims
	if not claims then
		claims = wd.getClaims(args)
	end
	if not claims or claims == {} then
		return nil
	end
	local props = {} -- liste des propriétés associété à chaque string pour catégorisation et linkback
	for i, j in pairs(claims) do
		claims[i] = wd.formatStatement(j, args)
		table.insert(props, j.mainsnak.property)
	end
	if args.removedupes and (args.removedupes ~= '-') then
		claims = tools.addnewvalues({}, claims) -- devrait aussi supprimer de props celles qui ne sont pas utilisées
	end
	return claims, props
end

function wd.getQualifiers(statement, qualifs, params)
	if not statement.qualifiers then
		return nil
	end
	local vals = {}
	if type(qualifs) == 'string' then
		qualifs = tools.splitStr(qualifs)
	end
	for i, j in pairs(qualifs) do
		if statement.qualifiers[j] then
			for k, l in pairs(statement.qualifiers[j]) do
				table.insert(vals, l)
			end
		end
	end
	if #vals == 0 then
		return nil
	end
	return vals
end

function wd.getFormattedQualifiers(statement, qualifs, params)
	if not params then params = {} end
	local qualiftable = wd.getQualifiers(statement, qualifs)
	if not qualiftable then
		return nil
	end
	for i, j in pairs(qualiftable) do
		qualiftable[i] = wd.formatSnak(j, params)
	end
	return modules.linguistic.conj(qualiftable, params.conjtype)
end

function wd.showQualifiers(str, statement, args) -- utilisée par formatStatement et par wikidatadate
	local qualifs =  args.showqualifiers
	if not qualifs then
		return str -- or error ?
	end
	if type(qualifs) == 'string' then
			qualifs = tools.splitStr(qualifs)
	end
	local qualifargs = args.qualifargs or {}
	-- formatage des qualificatifs = args commençant par "qualif", ou à défaut, les mêmes que pour la valeur principale
	qualifargs.displayformat = args.qualifdisplayformat or args.displayformat
	qualifargs.labelformat = args.qualiflabelformat or args.labelformat
	qualifargs.link = args.qualiflink or args.link
	qualifargs.conjtype = args.qualifconjtype
			
	local formattedqualifs = wd.getFormattedQualifiers(statement, qualifs, qualifargs)
	if formattedqualifs and str then
		str = str .. modules.linguistic.inparentheses(formattedqualifs, defaultlang)
	end
	return str
end


function wd.sourceStr(sources)
	if not sources or (#sources == 0) then
		return nil
	end
	for i, j in pairs(sources) do
		sources[i] = mw.getCurrentFrame():extensionTag( "ref", j)
	end
	return table.concat(sources, '<sup class="reference cite_virgule">,</sup>')
end

function wd.formatStatement( statement, args )
	if not args then
		args = {}
	end
	if not statement.type or statement.type ~= 'statement' then
		return tools.formatError( 'unknown-claim-type' )
	end
	local prop = statement.mainsnak.property

	local str

	-- partie principale
	if args.showonlyqualifier and (args.showonlyqualifier ~= '') then
		str = wd.getFormattedQualifiers(statement, args.showonlyqualifier, args)
		if not str then
			return nil
		end
	elseif args.statementformat and (type(args.statementformat) == 'function') then
		str = args.statementformat(statement, args)
	else 
		str = wd.formatSnak( statement.mainsnak, args )
	end

	-- ajouts divers	
	if args.showlang == true then
		str = (showlang(statement) or '') .. '&#32;' .. str
	end
	if args.showqualifiers then
		str = wd.showQualifiers(str, statement, args)
	end

	if args.showdate then -- when "showdate and chronosort are both set, date retrieval is performed twice
	local period = wd.getFormattedDate(statement, args, "-") -- 3 arguments indicate the we should not use additional qualifiers, alrady added by wd.formatStatement
	if period then
		str = str .. " <small>(" .. period ..")</small>"
	end
	end

	if args.showsource then
		local sources = wd.getReferences(statement)
		if sources then
			local source = wd.sourceStr(sources)
			str = str .. (source or "")
		end
	end
	if statement.qualifiers then
		str = wd.addStandardQualifs(str, statement)
	end
	return str
end

function wd.formatSnak( snak, params )
	if not params then params = {} end -- pour faciliter l'appel depuis d'autres modules
	if snak.snaktype == 'somevalue' then
		return unknownvalue(snak, params.unknownlabel)
	elseif snak.snaktype == 'novalue' then
		return novalue(params.novaluelabel)
	elseif snak.snaktype == 'value' then
		return wd.getDatavalue( snak, params)
	else
		return tools.formatError( 'unknown-snak-type' )
	end
end

function wd.getDescription(entity, lang)
	lang = lang or defaultlang

	local description
	if lang == defaultlang then
		return  mw.wikibase.descriptionl(qid)
	end
	if not entity.descriptions then
		return translate('no description')
	end
	local descriptions = entity.descriptions
	if not descriptions then
		return nil
	end
	if descriptions[lang] then
		return descriptions[delang].value
	end
	return entity.id
end

function wd.addLinkback(str, id, property)
	if not id then
		id = tools.getEntity()
	end
	if not id then
		return str
	end
	if type(property) == 'table' then
		property = property[1]
	end
	if type(id) == 'table' then
		id = id.id
	end
	
	local class = ''
	if property then
		class = 'wd_' .. string.lower(property)
	end
	local icon = '[[File:Blue pencil.svg|%s|10px|baseline|class=noviewer|link=%s]]'
	local title = translate('see-wikidata-value')
	local url = mw.uri.fullUrl('d:' .. id, 'uselang=fr')
	url.fragment = property -- ajoute une #ancre si paramètre "property" défini
	url = tostring(url)
	local v = mw.html.create('span')
		:addClass(class)
		:wikitext(str)
		:tag('span')
			:addClass('noprint wikidata-linkback')
			:css('padding-left', '0.5em')
			:wikitext(icon:format(title, url))
		:allDone()
	return tostring(v)
end

function wd.addRefAnchor(str, id)
--[[
	Insère une ancre pour une référence générée à partir d'un élément wd.
	L'id Wikidata sert d'identifiant à l'ancre, à utiliser dans les modèles type "harvsp"
--]]
	return tostring(
		mw.html.create('span')
			:attr('id', id)
			:attr('class', "ouvrage")
			:wikitext(str)
	)
end

function wd.formatStatements( args )--Format statement and concat them cleanly
	if args.value == '-' then
		return nil
	end
	local valueexpl = translate("activate-query")
	--If a value is already set, use it
	if args.value and (args.value ~= '') and (args.value ~= valueexpl) then
		return args.value
	end
	-- if args.expl: return something only one if explicitly required in Wikitext
	if args.expl and (args.value ~= valueexpl) then
		return nil
	end
	args.entity = tools.getEntity(args.entity)

	if args.grouped and args.grouped ~= '' then
		args.grouped = false
		return wd.groupedStatements(args)
	end
	local valuetable = args.valuetable -- dans le cas où les valeurs sont déjà formtées
	local props -- les prorpriétés réellement utilisées (dans certainse cas, ce ne sont pas toutes celles de ags.property
	if not valuetable then -- cas le plus courant
		valuetable, props = wd.stringTable(args)
	end

	local str = wd.tableToText(valuetable, args)
	if not str then
		return nil
	end
	if not props then
		props = tools.splitStr(args.property)[1]
	end
	if args.ucfirst ~= '-' then
		str = modules.linguistic.ucfirst(str)
	end

	if args.addcat and (args.addcat ~= '-') then
		str = str .. wd.addtrackingcat(props)
	end
	if args.linkback and (args.linkback ~= '-') then
		str = wd.addLinkback(str, args.entity, props)
	end
	return str
end

function wd.showQualifier( args )
	local qualifs = args.qualifiers or args.qualifier
	
	if not qualifs then
		return tools.formatError( 'property-param-not-provided' )
	end
	if type(qualifs) == 'string' then
		qualifs = tools.splitStr(qualifs)
	end

	local claims = wd.getClaims(args)
	if not claims then
		return nil
	end
	local str = ''
	for i, j in pairs(claims) do
		local new = wd.getFormattedQualifiers(j, qualifs, args) or ''
		str = str .. new
	end
	return str
end

function wd.formatAndCat(args)
	if not args then
		return nil
	end
	args.linkback = true
	args.addcat = true
	if args.value then -- do not ignore linkback and addcat, as formatStatements do
		local val = args.value .. wd.addtrackingcat(args.property)
		val = wd.addLinkback(val, args.entity, args.property)
		return val
	end 
	return wd.formatStatements( args )
end

function wd.getTheDate(args)
	local claims = wd.getClaims(args)
	if not claims then
		return nil
	end
	local formattedvalues = {}
	for i, j in pairs(claims) do
		local v = wd.getFormattedDate(j, args)
		if v then
			table.insert(formattedvalues, v )
		end
	end
	local val = modules.linguistic.conj(formattedvalues)
	if not val then
		return nil
	end
	if args.addcat == true then
		val = val .. wd.addtrackingcat(args.property)
	end
	val = wd.addLinkback(val, args.entity, args.property)
	return val
end


-- Complex functions using several items
local function getids(query)
	query.excludespecial = true
	query.displayformat = 'raw'
	return wd.stringTable(query)
end


function wd.Dump(entity)
	entity = tools.getEntity(entity)
	if not entity then
		return tools.formatError("entity-param-not-provided")
	end
	return "<pre>"..mw.dumpObject(entity).."</pre>"
end

function wd.groupedStatements(args, type)
	-- regroupe les affirmations ayant la même valeur en mainsnak, mais des qualificatifs différents
	-- (seulement pour les propriétés de type élément)

	local claims = wd.getClaims(args)
	if not claims then
		return nil
	end
	local groupedClaims = {}

	-- regroupe les affirmations par valeur de mainsnak
	local function addClaim(claim)
		local id = tools.getMainId(claim)
		for i, j in pairs(groupedClaims) do 
			if (j.id == id) then
				table.insert(groupedClaims[i].claims, claim)
				return
			end
		end
		table.insert(groupedClaims, {id = id, claims = {claim}})
	end
	for i, claim in pairs(claims) do	
		addClaim(claim)
	end

	local stringTable = {}

	-- instructions ad hoc pour les paramètres concernant la mise en forme d'une déclaration individuelle
	local funs = {
		{param = "showqualifiers", fun = function(str, claims)
			local qualifs = {}
			for i, claim in pairs(claims) do
				local news = wd.getFormattedQualifiers(claim, args.showqualifiers, args)
				if news then
					table.insert(qualifs, news)
				end
			end
			local qualifstr = modules.linguistic.conj(qualifs, " ; ") -- point virgule pour séparer les années
			if not qualifstr then
				return str
			end
			return str .. " " .. modules.linguistic.inparentheses(qualifstr)
			end
		},
		{param = "showdate", fun = function(str, claims)
			-- toutes les dates sont regroupées à l'intérieur des mêmes parenthèses ex "médaille d'or (1922, 1924)"
			local dates = {}
			for i, statement in pairs(claims) do
				local s = wd.getFormattedDate(statement, args, true) -- l'option useallqualifiers ne doit pas être désactivée dans ce cas
				if statement then table.insert(dates, s) end
			end
			local datestr = modules.linguistic.conj(dates)
			if not datestr then
				return str
			end
			return str .. "<small>" .. modules.linguistic.inparentheses(datestr) .. "</small>"
			end
		},
		{param = "showsource", fun = function(str, claims)
			-- les sources sont toutes affichées au même endroit, à la fin
			-- si deux affirmations ont la même source, on ne l'affiche qu'une fois
			local sources = {}
		
			local function dupeRef(old, new)
				for i, j in pairs(old) do
					if j == new then
						return true
					end
				end
			end
			for i, claim in pairs(claims) do
				local refs = wd.getReferences(claim)
				if refs then
					for i, j in pairs(refs) do
						if not dupeRef(sources, j) then
							table.insert(sources, j)
						end
					end
				end
			end
			return str .. (wd.sourceStr(sources) or "")
			end
		}
	}

	for i, group in pairs(groupedClaims) do -- bricolage pour utiliser les arguments de formatStatements
		local str = wd.formatEntity(group.id, args)
		for i, fun in pairs(funs) do
			if args[fun.param] then
				str = fun.fun(str, group.claims, args)
			end
		end
		table.insert(stringTable, str)
	end
				
	args.valuetable = stringTable
	return wd.formatStatements(args)
end

return wd