Modèle:Wikidata/Bac à sable

Ceci est la version bac à sable de Modèle:Wikidata.

Cette sous-page permet de tester des modifications du code sans provoquer de perturbations à grande échelle du modèle de base.

Documentation[voir] [modifier] [historique] [purger]

Ce modèle utilise le module Interface Wikidata, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via sa sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

Utilisation

Ce modèle affiche la valeur d'une propriété donnée de l’élément Wikidata correspondant à l’article.

Attention :

Conformément à cette prise de décision et pour des raisons de maintenance, ce modèle est interdit dans le corps des articles de l'espace principal.

Ce modèle sert essentiellement dans les modèles d’infobox, pour afficher la valeur d’une propriété donnée présente dans Wikidata quand aucune valeur n’est précisée en paramètre d’infobox dans l'article. Une valeur passée via le paramètre d’infobox est toujours affichée, notamment dans le cas où, pour une raison ou une autre, on ne veut pas de la valeur fournie par Wikidata.

Articles connexes : Aide:Wikidata et d:Wikidata:Glossary/fr.

Chaque article, par exemple Nice, est lié à un élément dans Wikidata nommé Q suivi d'un nombre, par exemple Q33959. Ces éléments comportent des affirmations sur le sujet de l’article, constituées d'une propriété, comme par exemple P17 « pays », et d'une valeur (pour Q33959 « Nice », c'est Q142 « France »). Chaque propriété a un rôle bien défini, dans notre exemple de situer dans quel État se trouve le sujet de l'article. Ce modèle permet d'afficher la valeur associée, dans une affirmation au sujet de l'article, à une propriété donnée qui est passée en paramètre du modèle : par exemple dans l'article Nice, la valeur de paramètre du modèle P17 (propriété « pays ») permet d'obtenir la valeur « France ».

Dans certains cas, ce modèle ajoute des marqueurs html, ou d'autres éléments qui n'apparaissent pas forcément au premier regard. Il est déconseillé de l'utiliser à l'intérieur d'un lien interne ou externe, ou d'un modèle exigeant des données très normées. En cas de doute à ce sujet, vous pouvez poser vos questions sur la page de discussion.

Syntaxe

Paramètres non nommés

{{Wikidata| propriété | valeur à afficher }}

n° 1 : propriété – identifiant (ID) de la propriété dans Wikidata, par exemple : P31 (paramètre obligatoire)
n° 2 : si la valeur de ce paramètre n'est pas vide, elle est affichée en priorité au lieu de la valeur de la propriété dans Wikidata ; pour supprimer l'affichage de la valeur Wikidata, utiliser la valeur spéciale du paramètre « - » (tiret) qui n'affiche rien (paramètre optionnel)

Utilisation typique dans un modèle d'infobox : remplacer {{{nom du paramètre|}}} par

{{wikidata| nom de la propriété P… | {{{nom du paramètre|}}} }}.

Paramètres nommés optionnels

Il est possible de préciser la requête à l'aide de paramètres nommés optionnels. La liste ci-dessous est partielle. Pour une liste complète, voir Module:Wikidata/Documentation.

showqualifiers : identifiant du qualificatif (propriété secondaire précisant la valeur de la propriété principale demandée) dont on veut afficher la valeur entre parenthèses
showonlyqualifier : identifiant du qualificatif (propriété secondaire précisant la valeur de la propriété principale demandée) qui sera affiché seul (sans la valeur de la propriété principale)
showdate : affiche entre parenthèse les dates fournies par les qualificatifs date, date de début ou date de fin.
qualifier et qualifiervalue : seulement les déclarations avec ce qualificatif et cette valeur du qualificatif ; par exemple pour afficher les matériaux composant le socle d'une statue : {{Wikidata |P186 (« matériau ») |qualifier=P518 (« partie concernée ») |qualifiervalue=Q12014132 (« piédestal ») }}
rank : seulement les déclarations avec ce rang, les valeurs possibles sont
- rank=deprecated : la valeur de la propriété est déconseillée/obsolète
- rank=normal
- rank=preferred : valeur préférable de la propriété, ce rang peut correspondre par exemple à la valeur la plus récente
- rank=best : le meilleur rang disponible parmi normal et preferred. C'est l'option activée par défaut.
- rank=valid : seulement normal et preferred
conjtype : en cas de plusieurs valeurs retournées, le caractère ou la chaîne de caractères séparant les valeurs (par défaut, virgule et espace, puis « et » entre les deux dernières). Pour ne mettre que des virgules : choisir la valeur comma. Pour que le « et » final soit remplacé par « ou », la valeur or. Toute autre valeur sera insérée entre chaque valeur, par exemple, <br /> insère une ligne entre deux valeurs. Pour plus d'informations, voir la fonction conj de Module:Linguistique.
numval=n : limiter le retour à n valeurs (n=1 peut être utile par exemple pour des images)
link le site vers lequel les liens doivent mener. Par défaut : Wikipédia en français. La valeur « - » supprime complètement les liens (autres options en attente d'activation).
precision : la précision maximale de l'affichage des dates. Valeurs possibles year, month, month et day. Par défaut : dépend de la précision indiquée sur Wikidata.
addcat : ajoute une catégorie permettant de mieux suivre l'usage de la propriété. Souvent utile, mais peut-être source de bugs lorsqu'il est utilisé à une endroit inadapté
linkback : ajoute un lien vers l'endroit de Wikidata où se trouve la valeur.
entity : utiliser un autre élément que celui associé à l’article (si renseigné, ne doit pas être vide).
expl= : n'afficher la valeur de la propriété dans Wikidata que si c'est explicitement demandé en paramètre n° 2 (valeur du paramètre du modèle d'infobox) par la valeur résultat de {{WD}}. Utile pour des données mises à jour mais dont l'utilité dans chaque article est difficile à décider automatiquement.
targetunit : Unité à utiliser dans le cas d'une valeur numérique, par exemple km2 pour une superficie.
displayformat : Format d'affichage du résultat, voir exemples ci-dessous.
labelformat : male ou female pour afficher la forme masculine ou féminine du résultat (si applicable) à la place de son libellé ; gendered pour afficher l'une ou l'autre en fonction du genre de l'élément associé à l'article (ou entity si renseigné).
text : Texte du lien à afficher lorsque le résultat est un lien externe.
default : Résultat à afficher si l'import depuis Wikidata donne un résultat vide.

Formats par défaut

Le format d'affichage peut être modifié par divers paramètres optionnels, mais par défaut les valeurs sont rendues dans les formats suivant :

pour les données de type élément : le libellé Wikidata et le lien vers l'article Wikipédia correspondant s'il existe. En cas d'absence d'article en français, un lien vers Wikipédia en anglais ou vers Wikidata sera ajouté entre parenthèses derrière la valeur.
données de type date : mise en forme semblable à {{date}}.
nombre : format français usuel avec espace après les milliers et virgules avant les décimales. Si la valeur contient une unité de mesure, l'abréviation standard sera utilisée ('m' pour 'mètres').
texte : par défaut majuscule en début de texte. |ucfirst=- permet de désactiver cela.

Exemples

Sur la page présente Modèle:Wikidata :

pour la propriété P31 (« nature de l’élément ») :

{{Wikidata|P31}} → (valeur de la propriété pour l'élément Wikidata lié à la page présente)

{{Wikidata|P31|bla bla}}} → bla bla (valeur fournie par exemple en paramètre d'infobox dans un article, et passant avant celle de Wikidata)

Dans un modèle appelé par l'article Nice (associé à l'élément Wikidata Q33959 (« Nice »)) :

pour la propriété P17 (« pays ») :

{{Wikidata|P17}} → France

{{Wikidata|P17|link=-}} → France

{{Wikidata|P17|displayformat=raw}} → Q142 (l'identifiant de l'élément Wikidata Q142 (« France »))

pour la propriété P856 (« site officiel ») :

{{Wikidata|P856}} → www.nice.fr

{{Wikidata|P856|text=site de la ville}} → site de la ville

Dans un modèle appelé par l'article Allemagne (associé à l'élément Wikidata Q183 (« Allemagne »)) :

pour la propriété P36 (« capitale ») :

{{Wikidata|P36}} → Berlin

{{Wikidata|P36|rank=valid}} → Bonn, Berlin et Berlin

pour afficher en plus le qualificatif P580 (« date de début ») :

{{Wikidata|P36|showqualifiers=P580}} → Berlin (3 octobre 1990)

pour afficher seul le qualificatif P580 (« date de début ») :

{{Wikidata|P36|showonlyqualifier=P580}} → 3 octobre 1990

pour la propriété P1313 (« poste occupé par le chef de l'exécutif ») :

{{Wikidata|P1313}} → Chancelier fédéral

{{Wikidata|P1313|labelformat=female}} → Chancelière fédérale

Dans un modèle au sein d'un article tiers (par exemple une liste de chanteuses) appelant les informations Wikidata à propos de Rihanna (associé à l'élément Wikidata Q36844 (« Rihanna »)) :

pour la propriété P2048 (« hauteur ») :

{{Wikidata|entity=Q36844|P2048}} → 173 cm

La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (modifier) et la page de test (modifier).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.