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.
