Modèle:Wikidata/Documentation

Ceci est la page de documentation de Modèle:Wikidata [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

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 une 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 :

Ce modèle est déconseillé 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 sélection ci-dessous est très 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.

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 («  ») :

{{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 («  »)) :

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

{{Wikidata|P17}} →

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

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

• pour la propriété P856 («  ») :

{{Wikidata|P856}} →

{{Wikidata|P856|displayformat=weblink}} →

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

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

{{Wikidata|P36}} →

{{Wikidata|P36|rank=valid}} →

• pour afficher en plus le qualificatif P580 («  ») :

{{Wikidata|P36|showqualifiers=P580}} →

• pour afficher seul le qualificatif P580 («  ») :

{{Wikidata|P36|showonlyqualifier=P580}} →