Module:Wikidata/Documentation

Utilisation

Fonctions utilisables depuis un modèle

• fonction formatStatements(frame) – retourne des valeurs répondant aux critères donnés, dans le format demandé. Elle peut prendre les paramètres suivant :

• property (obligatoire) la propriété associée aux déclarations demandées (par exemple property=P569 signifie que les déclaration recherchées concernent la date de naissance (wikidata:Property:P19).
• conjtype caractère ou chaîne de caractère séparant les différentes valeurs. Par défaut, une virgule, sauf, entre la dernière et la dernière : " et " (pour plus de détails, voir p.conj dans Module:Linguistic)
• rank : rang des déclarations (preferred, normal ou deprecated). Par défault : preferred. rank = validretourne à la fois les déclarations de rang normal et celles de rang preferred.
• excludespecial : « excludespecial = true » retire toutes les déclarations ayant pour valeur « inconnu » ou « pas de valeur »
• qualifier : sert à indiquer que les déclarations retournées devraient toutes contenir le qualificatif qualifier.
• qualifiervalue : sert à indiquer quelle valeur devrait avoir le qualficatif utilisé dans le paramètre qualifier. Par exemple pour afficher les matériaux composant le socle d'une statue, on peut utiliser{{invoke:Wikidata | formatStatements|property=P186 [=matériau] |qualifier=P518 [=partie concernée]|qualifiervalue=Q12014132 [=piédestal]}}
• showdate showdata =true affiche les dates entre parenthèse à la fin de l'affirmation, en utilisant les qualificatifs date, date, et date de fin.
• showqualifiers qualificatifs à afficher entre parenthèse à la fin de l'affirmation (sous forme de table Lua ou de chaînes de caracètre séparés par une virgule
• source : sert à restreindre les déclarations à celles faites par une source particulière. Par défaut, il s'agit de la source déclarée wikidata:Property:P248 (« affirmé dans »). Si l’on veut utiliser une autre propriété, il faut la signaler dans le paramètre sourceproperty.
• showsource : indique que les sources indiquées sur Wikidata doivent être affichées.
• sorttype

• sorttype = chronological classe les affirmation en ordre chronologique, en utilisant les qualificatifs date, date, et date de fin.
• sorttype = inverted classe les affirmation en ordre chronologique inversé
• En Lua, il est également possible de mettre une fonction en valeur de ce paramètre pour un classement personnalisé.

• numval : nombre de valeurs maximales à retourner
• format : format souhaité (encore très incomplet)
• precision : pour les dates : permet de ne pas afficher la date à sa précision maximale.

• precision = year n'affiche que l'année (pas le mois)
• precision = month n'affiche que le mois et l'année (pas le jour)

• function p.FormatAndCat(frame) même paramètres que formatStatements mais ajoute une catégorie de maintenance (voir Catégorie:page utilisant des données de Wikidata). Cette fonction permet de surveiller l'usage de Wikidata et garder un œil sur la pertinence des données. Elle est à privilégier lorsque c’est possible, mais, pour son usage peut être délicat dans les modèles complexes.
• fonction getQualifier(frame): – retourne des qualificatifs répondant aux critères donnés, dans le format demandé. Mêmes paramètres que formatStatements. Exemple d'utilisation : {{Date clé}}. Mêmes paramètres plus :

• qualifier le qualificatif à retourner

• fonction numOfClaims(frame): retourne le nombre de déclaration répondant aux criètres donné (peut-être utilisé dans les modèles, pour adapter le format)
• fonction numOfClaims(frame):

fonctions utilisables depuis un autre module

• getClaims : retourne une table des déclarations répondant à des critères donnés.
• getDatavalue : convertit un "snak" (donnée de base) d'une table en une chaîne ayant le format désiré.

Exemples

Pour des raisons techniques (impossibilité de transclusion), les exemples ne peuvent être lus que sur w:Wikipédia:Wikidata/Bac à sable