2 425
modifications
Modifications
Modèle:Wikidata/Documentation (voir la source)
Version du 30 novembre 2017 à 23:50
, 30 novembre 2017 à 23:501 révision importée
{{Sous-page de documentation}}
{{Modèle utilisant les modules Lua|Module:Interface Wikidata}}
== Utilisation ==
Ce modèle affiche la valeur d'une propriété donnée de l’élément [[Wikidata]] correspondant à l’article.
{{avertissement|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.
{{notice|{{Voir aussi|Aide:Wikidata|d:Wikidata:Glossary/fr}}
Chaque article, par exemple [[Nice]], est lié à un élément dans Wikidata nommé ''Q'' suivi d'un nombre, par exemple ''[[d:Q33959|Q33959]]''. Ces éléments comportent des ''affirmations'' sur le sujet de l’article, constituées d'une propriété, comme par exemple ''[[d:Property:P17|P17]]'' « pays », et d'une valeur (pour ''[[d:Q33959|Q33959]]'' « Nice », c'est ''[[d:Q142|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 [[Discussion modèle:Wikidata|la page de discussion]].
}}
== Syntaxe ==
=== Paramètres non nommés ===
<code><nowiki>{{</nowiki>Wikidata| </code>''propriété''<code> | </code>''valeur à afficher''<code> }}</code>
* n° 1 : propriété – identifiant (ID) de la propriété dans Wikidata, par exemple : <code>P31</code> (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 <code><nowiki>{{{</nowiki></code>''nom du paramètre''<code>|}}}</code>
par
:<code><nowiki>{{</nowiki>wikidata| </code>''nom de la propriété P…''<code> | <nowiki>{{{</nowiki></code>''nom du paramètre''<code><nowiki>|}}}</nowiki> }}</code>.
=== 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]].
* <code>showqualifiers</code> : 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
* <code>showonlyqualifier</code> : 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)
* <code>showdate</code> : affiche entre parenthèse les dates fournies par les qualificatifs [[:d:P:P585|date]], [[:d:P:P580|date de début]] ou [[:d:P:P582|date de fin]].
* <code>qualifier</code> et <code>qualifiervalue</code> : 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 : <code><nowiki>{{</nowiki>Wikidata |P186 </code>''(« matériau »)''<code> |qualifier=P518 </code>''(« partie concernée »)''<code> |qualifiervalue=Q12014132 </code>''(« piédestal »)'' <code>}}</code>
* <code>rank</code> : seulement les déclarations avec ce [[m:Wikidata/Data model#Ranks of Statements|rang]], les valeurs possibles sont
** <code>rank=deprecated</code> : la valeur de la propriété est déconseillée/obsolète
** <code>rank=normal</code>
** <code>rank=preferred</code> : valeur préférable de la propriété, ce rang peut correspondre par exemple à la valeur la plus récente
** <code>rank=best</code> : le meilleur rang disponible parmi <code>normal</code> et <code>preferred</code>. C'est l'option activée par défaut.
** <code>rank=valid</code> : seulement <code>normal</code> et <code>preferred</code>
* <code>conjtype</code> : en cas de plusieurs valeurs retournées, le caractère ou la chaîne de caractères séparant les valeurs (par défaut, [[MediaWiki:Comma-separator|virgule et espace]], puis « [[MediaWiki:And|et]] » entre les deux dernières). Pour ne mettre que des virgules : choisir la valeur <code>comma</code>. Pour que le « et » final soit remplacé par « ou », la valeur <code>or</code>. Toute autre valeur sera insérée entre chaque valeur, par exemple, <nowiki><br /></nowiki> insère une ligne entre deux valeurs. Pour plus d'informations, voir la fonction <code>conj</code> de [[Module:Linguistique]].
* <code>numval=''n''</code> : limiter le retour à ''n'' valeurs (n=1 peut être utile par exemple pour des images)
* <code>link</code> 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).
* <code>precision</code> : la précision maximale de l'affichage des dates. Valeurs possibles <code>year</code>, <code>month</code>, <code>month</code> et <code>day</code>. Par défaut : dépend de la précision indiquée sur Wikidata.
* <code>addcat</code> : 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é
* <code>linkback </code> : ajoute un lien vers l'endroit de Wikidata où se trouve la valeur.
* <code>entity </code> : utiliser un autre élément que celui associé à l’article (si renseigné, ne doit pas être vide).
* <code>expl=</code> : 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 {{m|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 à {{m|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. <code>|ucfirst=-</code> permet de désactiver cela.
== Exemples ==
Sur la page présente [[Modèle:Wikidata]] :
* pour la propriété {{WD P|31}} :
: <code><nowiki>{{</nowiki>Wikidata|P31}}</code> → {{Wikidata|P31}} (valeur de la propriété pour l'élément Wikidata lié à la page présente)
: <code><nowiki>{{</nowiki>Wikidata|P31|bla bla}}}</code> → {{Wikidata|P31|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 {{WD Q|33959}}) :
* pour la propriété {{WD P|17}} :
: <code><nowiki>{{</nowiki>Wikidata|P17}}</code> → {{Wikidata|entity=Q33959|P17}}
: <code><nowiki>{{</nowiki>Wikidata|P17|link=-}}</code> → {{Wikidata|entity=Q33959|P17|link=-}}
: <code><nowiki>{{</nowiki>Wikidata|P17|displayformat=raw}}</code> → {{Wikidata|entity=Q33959|P17|displayformat=raw}} (l'identifiant de l'élément Wikidata {{WD Q|142}})
* pour la propriété {{WD P|856}} :
: <code><nowiki>{{</nowiki>Wikidata|P856}}</code> → {{Wikidata|entity=Q33959|P856}}
: <code><nowiki>{{</nowiki>Wikidata|P856|displayformat=weblink}}</code> → {{Wikidata|entity=Q33959|P856|displayformat=weblink}}
Dans un modèle appelé par l'article [[Allemagne]] (associé à l'élément Wikidata {{WD Q|183}}) :
* pour la propriété {{WD P|36}} :
: <code><nowiki>{{</nowiki>Wikidata|P36}}</code> → {{Wikidata|entity=Q183|P36}}
: <code><nowiki>{{</nowiki>Wikidata|P36|rank=valid}}</code> → {{Wikidata|entity=Q183|P36|rank=valid}}
* pour afficher en plus le qualificatif {{WD P|580}} :
: <code><nowiki>{{</nowiki>Wikidata|P36|showqualifiers=P580}}</code> → {{Wikidata|entity=Q183|P36|showqualifiers=P580}}
* pour afficher seul le qualificatif {{WD P|580}} :
: <code><nowiki>{{</nowiki>Wikidata|P36|showonlyqualifier=P580}}</code> → {{Wikidata|entity=Q183|P36|showonlyqualifier=P580}}
<includeonly>
<!-- Catégories pour le modèle -->
[[Catégorie:Modèle Wikidata]]
</includeonly>
{{Modèle utilisant les modules Lua|Module:Interface Wikidata}}
== Utilisation ==
Ce modèle affiche la valeur d'une propriété donnée de l’élément [[Wikidata]] correspondant à l’article.
{{avertissement|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.
{{notice|{{Voir aussi|Aide:Wikidata|d:Wikidata:Glossary/fr}}
Chaque article, par exemple [[Nice]], est lié à un élément dans Wikidata nommé ''Q'' suivi d'un nombre, par exemple ''[[d:Q33959|Q33959]]''. Ces éléments comportent des ''affirmations'' sur le sujet de l’article, constituées d'une propriété, comme par exemple ''[[d:Property:P17|P17]]'' « pays », et d'une valeur (pour ''[[d:Q33959|Q33959]]'' « Nice », c'est ''[[d:Q142|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 [[Discussion modèle:Wikidata|la page de discussion]].
}}
== Syntaxe ==
=== Paramètres non nommés ===
<code><nowiki>{{</nowiki>Wikidata| </code>''propriété''<code> | </code>''valeur à afficher''<code> }}</code>
* n° 1 : propriété – identifiant (ID) de la propriété dans Wikidata, par exemple : <code>P31</code> (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 <code><nowiki>{{{</nowiki></code>''nom du paramètre''<code>|}}}</code>
par
:<code><nowiki>{{</nowiki>wikidata| </code>''nom de la propriété P…''<code> | <nowiki>{{{</nowiki></code>''nom du paramètre''<code><nowiki>|}}}</nowiki> }}</code>.
=== 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]].
* <code>showqualifiers</code> : 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
* <code>showonlyqualifier</code> : 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)
* <code>showdate</code> : affiche entre parenthèse les dates fournies par les qualificatifs [[:d:P:P585|date]], [[:d:P:P580|date de début]] ou [[:d:P:P582|date de fin]].
* <code>qualifier</code> et <code>qualifiervalue</code> : 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 : <code><nowiki>{{</nowiki>Wikidata |P186 </code>''(« matériau »)''<code> |qualifier=P518 </code>''(« partie concernée »)''<code> |qualifiervalue=Q12014132 </code>''(« piédestal »)'' <code>}}</code>
* <code>rank</code> : seulement les déclarations avec ce [[m:Wikidata/Data model#Ranks of Statements|rang]], les valeurs possibles sont
** <code>rank=deprecated</code> : la valeur de la propriété est déconseillée/obsolète
** <code>rank=normal</code>
** <code>rank=preferred</code> : valeur préférable de la propriété, ce rang peut correspondre par exemple à la valeur la plus récente
** <code>rank=best</code> : le meilleur rang disponible parmi <code>normal</code> et <code>preferred</code>. C'est l'option activée par défaut.
** <code>rank=valid</code> : seulement <code>normal</code> et <code>preferred</code>
* <code>conjtype</code> : en cas de plusieurs valeurs retournées, le caractère ou la chaîne de caractères séparant les valeurs (par défaut, [[MediaWiki:Comma-separator|virgule et espace]], puis « [[MediaWiki:And|et]] » entre les deux dernières). Pour ne mettre que des virgules : choisir la valeur <code>comma</code>. Pour que le « et » final soit remplacé par « ou », la valeur <code>or</code>. Toute autre valeur sera insérée entre chaque valeur, par exemple, <nowiki><br /></nowiki> insère une ligne entre deux valeurs. Pour plus d'informations, voir la fonction <code>conj</code> de [[Module:Linguistique]].
* <code>numval=''n''</code> : limiter le retour à ''n'' valeurs (n=1 peut être utile par exemple pour des images)
* <code>link</code> 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).
* <code>precision</code> : la précision maximale de l'affichage des dates. Valeurs possibles <code>year</code>, <code>month</code>, <code>month</code> et <code>day</code>. Par défaut : dépend de la précision indiquée sur Wikidata.
* <code>addcat</code> : 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é
* <code>linkback </code> : ajoute un lien vers l'endroit de Wikidata où se trouve la valeur.
* <code>entity </code> : utiliser un autre élément que celui associé à l’article (si renseigné, ne doit pas être vide).
* <code>expl=</code> : 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 {{m|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 à {{m|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. <code>|ucfirst=-</code> permet de désactiver cela.
== Exemples ==
Sur la page présente [[Modèle:Wikidata]] :
* pour la propriété {{WD P|31}} :
: <code><nowiki>{{</nowiki>Wikidata|P31}}</code> → {{Wikidata|P31}} (valeur de la propriété pour l'élément Wikidata lié à la page présente)
: <code><nowiki>{{</nowiki>Wikidata|P31|bla bla}}}</code> → {{Wikidata|P31|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 {{WD Q|33959}}) :
* pour la propriété {{WD P|17}} :
: <code><nowiki>{{</nowiki>Wikidata|P17}}</code> → {{Wikidata|entity=Q33959|P17}}
: <code><nowiki>{{</nowiki>Wikidata|P17|link=-}}</code> → {{Wikidata|entity=Q33959|P17|link=-}}
: <code><nowiki>{{</nowiki>Wikidata|P17|displayformat=raw}}</code> → {{Wikidata|entity=Q33959|P17|displayformat=raw}} (l'identifiant de l'élément Wikidata {{WD Q|142}})
* pour la propriété {{WD P|856}} :
: <code><nowiki>{{</nowiki>Wikidata|P856}}</code> → {{Wikidata|entity=Q33959|P856}}
: <code><nowiki>{{</nowiki>Wikidata|P856|displayformat=weblink}}</code> → {{Wikidata|entity=Q33959|P856|displayformat=weblink}}
Dans un modèle appelé par l'article [[Allemagne]] (associé à l'élément Wikidata {{WD Q|183}}) :
* pour la propriété {{WD P|36}} :
: <code><nowiki>{{</nowiki>Wikidata|P36}}</code> → {{Wikidata|entity=Q183|P36}}
: <code><nowiki>{{</nowiki>Wikidata|P36|rank=valid}}</code> → {{Wikidata|entity=Q183|P36|rank=valid}}
* pour afficher en plus le qualificatif {{WD P|580}} :
: <code><nowiki>{{</nowiki>Wikidata|P36|showqualifiers=P580}}</code> → {{Wikidata|entity=Q183|P36|showqualifiers=P580}}
* pour afficher seul le qualificatif {{WD P|580}} :
: <code><nowiki>{{</nowiki>Wikidata|P36|showonlyqualifier=P580}}</code> → {{Wikidata|entity=Q183|P36|showonlyqualifier=P580}}
<includeonly>
<!-- Catégories pour le modèle -->
[[Catégorie:Modèle Wikidata]]
</includeonly>