Module:Interface Wikidata/Documentation

Ceci est la page de documentation pour Module:Interface Wikidata

Cette page donne accès à un ensemble de fonction permettant de traiter les données de Wikidata.

Elle contient deux parties : les fonctions "frame", que l'on peut utiliser depuis du Wikicode, et une partie plus fournie comportant également des fonctions qui ne peuvent être utilisées que depuis Lua.

Ce module fait appel au Module:Wikidata.

Utilisation

modifier

Fonctions Lua

modifier
nom paramètres description exemple
getClaims table d'arguments (voir Projet:Wikidata/Atelier/Manuel ) récupère une série de "déclarations" Wikidata répondant aux critères données en arguments
stringTable table d'arguments (voir Projet:Wikidata/Atelier/Manuel ) même fonctionnement que getClaims, mais retourne une liste de chaîne plutôt qu'une liste de déclarations brutes
tableToText table de valeurs, paramètres transforme une liste de chaîne en une chaîne unique (plus ou moins redondant avec linguistic.conj pourrait peut-être être supprimé)
formatStatements table d'arguments (voir Projet:Wikidata/Atelier/Manuel ) récupère et formate une série de "déclarations" Wikidata répondant aux critères données en argument (comme stringTable), puis les assemble en une chaîne unique selon le paramètre donné par le paramètre "conjtype"
formatQualifiers table d'arguments (voir Projet:Wikidata/Atelier/Manuel ) similaire à formatStatements, mais ne retourne que des valeurs stockées dans des qualificatifs des déclarations, pas dans son mainsnak
formatAndCat table d'arguments (voir Projet:Wikidata/Atelier/Manuel ) comme formatStatents, mais ajoute en plus un catégorie de maintenance et un rétrolien vers Wikidata
formatClaimList
wikidataDate
addLinkback
addtrackingcat
getmainid statement retourne l'identifiant de la valeur principal de la déclaration
formatStatement statement, args formate une déclaration individuelle en utilisant les paramètres données en arguments (voir Projet:Wikidata/Atelier/Manuel )
getFormattedQualifiers statement, table de qualificatifs, paramètres d'affichage sumilair à formatStatemnt (formatage d'une déclaration individuelle), mais n'affiche que des qualificatifs
statementDate statement, params affiche la date associée à une déclaration en recherchant dans différents qualificatifs (P580, P582, P585, P1319, P1326, P1480
getQualifiers
getReferences
getid snak récupère l'identifiant de la valeur d'un snak
formatSnak snak, params formate un snak individuel, selon une logique identique à formatStatement
getEntity id charge les données d'un élément Wikidata
formatEntity entity, params retourne une chaîne affichant un libellé et éventuellement un lien vers l'entité indiquée, en utilisant les paramètres de mise en forme indiqués dans la table param. le paramètre "id" peut être soit un identifiant Qdd soit une table Wikidata déjà chargée.
getLink entity, linktype, lang retourne un lien vers la page wiki demande. Linktype doit être 'wikipedia', 'commons', wikisource' ou 'wikidata' (défaut : wikipédia) et "lang" le code Wiki de la langue désirée (défaut : français)
getLabel entity, lang, labelformat Par défaut, retourne le libellé Wikidata de l'élément dans la langue indiquée dans le paramètre lang. Le paramètre labelformat permet de changer ce comportement en générant un libellé à partir de n'importe quelle fonction prenant pour argument l'entité.
IsInstance classe cible, élément source, profondeur max retourne true Si l'élément source est une "instance" de la classe cible (utilise P31 et P279)
IsSubclass classe cible, élément source, profondeur max retourn true Si l'élément source est une "sous-classe" de la classe cible (P279)
addVals list, query, maxdepth, maxnodes, stopval ajoute des éléments Wikidata à une liste, en se basant sur le paramètre query, et en s'arrêtant lorsque maxdepth ou maxnodes est ateint, ou lorsque l'élément stopval est trouvé
transitiveVals item, query, maxdepth, maxnodes, stopval retourne les éléments correspondant aux paramètres définis par query, et les élémennts correspondant aux paramètre définis par query effectués sur les valeurs de query...
transitiveVals searchedval, sourceval, query, maxdepth, maxnodes retourne true si searchedval se trouve dans les valeurs retournée par la fonction transitiveVals( sourceval, query, maxdepth, maxnodes )
findVal source, targetclass, query, maxrecursion, maxinstancedepth trouver la première valeur pour un propriété "transitive" qui appartient à une class donnée. Par exemple, pour trouver dans quelle région administrative se trouve Toulouse.
findVal("Q7880", "Q36784", "P131")
{{#invoke:Interface Wikidata|findVal|source=Q7880|target=Q36784|property=P131}}

->Q18678265

mainDate item retourne la date associée à un élément (en utilisant P585, P571 et certains qualificatifs
keyDate item, event retourne la date associée à une événement sur l'élément Wikidata. L'élément peut-être de la forme PXX (P1619 (« date d'ouverture officielle »), ou de la forme QXX, dans ce cas il sera recherché dans la propriété P793 (« événement clé »))
citeItem item crée une référence bibliographique à partir des données de l'élément item
Dump item affiche l'intégralité des données Wikidata de l'élément

Exemples

modifier

Pour des exemples, voir la page de test permettant de tester diverses modifications apportées.