Aide:Rangs

Rangs (dans les rectangles rouges)

Les rangs (ranks en anglais) constituent une mécanique permettant d’annoter plusieurs valeurs pour une déclaration. Le rang par défaut est le rang « normal » ; les couples déclarations-valeurs peuvent également être marqués par un rang « préféré » (preferred) ou « obsolète » (deprecated).

À quoi ressemblent les déclarations avec rang?

• - la déclaration est dite de rang préféré
• - la déclaration est dite de rang normal
• - la déclaration est dite de rang déprécié/désuet/obsolète

À quoi servent les rangs ?

Certaines déclarations possèdent naturellement plusieurs valeurs. Par exemple, pour la propriété child (P40), l’élément Barack Obama (Q76) possède 2 valeurs : Malia Obama (Q15070044) et Sasha Obama (Q15070048).

Les autres déclarations doivent toujours avoir idéalement une seule valeur, mais peuvent contenir des valeurs complémentaires qui fournissent des informations historiques, un point de vue différent ou des résultats différents selon la méthode de mesure ou l’approche scientifique utilisée. Par exemple, l’élément Franklin School (Q100000001) peut posséder plus d’une valeur pour la propriété students count (P2196) : l’une datant de 2012 et une autre datant de 2023.

Dans ce second exemple, seule la valeur de 2023 sera pertinente pour les personnes s’intéressant aux chiffres les plus récents et les plus à jour concernant la population aux États-Unis. Les rangs sont ainsi utilisés pour permettre aux utilisateurs de différencier facilement les multiples valeurs d’une déclaration.

Note pour les requêtes

WDQS permet aux utilisateurs d’effectuer des recherches prédéfinies à travers tous les éléments de Wikidata. Ces recherches peuvent être complexes et composées, c’est-à-dire nécessitant de chercher des résultats correspondant à deux conditions ou plus. Par exemple, ces requêtes Wikidata peuvent être : « tous les éléments dont la population excède un million d’habitants et qui est une ville » ou même « toutes les artistes japonaises qui sont nées dans une ville de plus d’un million d’habitant au Japon ».

Comme vous pouvez le constater, il n’est pas toujours nécessaire d’obtenir toutes les valeurs lorsqu’on effectue une requête. Les rangs permettent alors d’améliorer le résultat des requêtes en sélectionnant parmi les valeurs incluses dans la recherche.

Une mauvaise utilisation des rangs

Les rangs ne doivent pas être confondus avec les références, qui sont utilisées pour pointer les sources spécifiques qui confirment les données de la déclaration. Alors qu’une référence doit idéalement pointer vers une source d’informations fiable et réputée, il est possible pour une source de fournir une information incorrecte, inexacte ou pas aussi précise qu’il le faudrait. Les références indiquent généralement d’où provient la valeur donnée ; les rangs, eux, indiquent quelle valeur est considérée comme étant la plus pertinente, et par extension, quelles valeurs seront incluses dans les requêtes.

Les rangs ne sont pas une façon d’affirmer votre point de vue subjectif pour une donnée contestée. Ils sont en revanche utilisés pour communiquer une opinion qui fait consensus pour une déclaration. Toutes les contestations doivent être discutées sur la page de discussion de l’élément concerné. La guerre d’édition sur les valeurs n’est pas acceptable.

Il y a toutefois une autre manière pour indiquer qu'une déclaration est contestée et par qui : le qualificatif contesté par Search.

Utilisation

Parce que les rangs sont utilisés pour différencier plusieurs valeurs d'une même propriété, si une déclaration n’a qu’une seule valeur, son rang est alors le rang par défaut (c'est à dire « normal ») et il est inutile d'indiquer le rang « préféré » dans ce cas.

Il peut y avoir n’importe quel nombre de déclarations à chaque rang, c’est-à-dire que plusieurs valeurs peuvent être assignées au rang « préféré ».

Rang normal

Le rang « normal » est assigné à toutes les déclarations par défaut. Un rang normal ne fournit ni jugement ni évaluation à propos de l’exactitude ou la véracité d’une valeur et doit ainsi être considéré comme neutre.

Le rang normal est typiquement utilisé pour toutes les déclarations contenant une information pertinente réputée correcte, mais peut être trop coûteux à être affiché par défaut. Il est également utilisé pour les déclarations possédant plusieurs valeurs (déclarations à valeurs multiples) lorsqu’il est insensé d’indiquer qu’une valeur est « plus correcte » qu’une autre.

Pour les modèles (par exemples les infoboxes) et les requêtes (une fois qu’elles seront implémentées), les valeurs marquées par le rang « normal » seront utilisées par défaut si la propriété n’a pas de rang « préféré ».

Exemples :

• L’élément Barack Obama (Q76) possède 2 valeurs pour la propriété child (P40) ; chaque valeur sera affectée au rang « normal », car aucune des deux valeurs n’est « plus correcte » que l’autre.
• L’élément Jacques Chirac (Q2105) possède plusieurs valeurs pour la propriété position held (P39), dont President of the French Republic (Q191954), Prime Minister of France (Q1587677) et mayor of Paris (Q19822699) ; toutes les fonctions tenues dans le passé sont affectées au rang « normal ».

Rang préféré

Le rang « préféré » est affecté à la déclaration la plus récente ou aux déclarations qui représentent le mieux un consensus (qu’il s’agisse d’un consensus scientifique ou d’un consensus établi par la communauté de Wikidata).

Dans l’idéal, le rang préféré sera utilisé pour les déclarations sourcées et/ou pour les déclarations avec des qualificateurs qui fournissent plus de détails pour appuyer la validité de leurs valeurs, par exemple, grâce à l'utilisation de qualificatifs associés aux propriétés point in time (P585), determination method (P459), etc. Il est souvent utile d'indiquer pourquoi la déclaration a été mise au rang préféré avec un qualificateur reason for preferred rank (P7452) .

Pour les modèles et les requêtes, par défaut les déclarations préférées d'une propriété seront utilisées si elles existent, autrement les déclarations normales seront utilisées.

Exemples :

• Un élément concernant une ville peut représenter la liste de ses maires. Le maire actuel sera marqué avec le rang « préféré ».
• Il peut y avoir plusieurs façons de mesurer la longueur d’une rivière, et donc plusieurs mesures seront possibles en fonction de la méthode utilisée. Dans ce cas, la mesure correspondant à la méthode utilisée la plus courante ou celle qui est scientifiquement valide, sera marquée avec le rang « préféré ».
• On peut avoir plusieurs rangs préférés pour un élément. Par exemple un projet logiciel avec deux développeurs actuels ou davantage parmi ceux qui l'ont été dans le passé, ou les contributeurs.

Rang obsolète

Le rang obsolète est utilisé pour des déclarations connues comme étant erronées (par exemple les données fournies par des processus de mesure défectueux) ou qui représentent des connaissances dépassées (comme des informations qui ont toujours été fausses mais qui ont pu paraître correctes à un moment donné). Il est souvent utile d'indiquer le motif de l'obsolescence avec un qualificatif reason for deprecated rank (P2241). Ceci ne s'applique pas aux données historiques correctes telles que les valeurs antérieures d'une déclaration, tant qu'elles représentent l'information vraie à la période indiquée. De telles déclarations doivent à la place être complétées avec les qualificateurs start time (P580)/end time (P582) appropriés.

Marquer une déclaration erronée comme obsolète plutôt que de simplement la supprimer a trois avantages :

1. cela permet aux autres utilisateurs de ne pas réassigner une nouvelle fois la valeur de l'élément
2. cela fournit un mécanisme pour représenter l'évolution des théories et des idées et ainsi créer un contexte plus riche pour la compréhension de la connaissance humaine
3. cela confirme et fixe l'intégrité de Wikidata comme une base de connaissances secondaire (qui recueille et lie des références), plutôt que d'une base de données primaire des faits. Wikidata fournit simplement des informations selon des sources spécifiques; ces sources peuvent refléter ou ne pas refléter la pensée contemporaine ou le consensus scientifique

Pour les modèles et les requêtes, les déclarations obsolètes ne seront jamais utilisées à moins que ce soit expressément demandé.

Exemples :

• La Terre qui est au centre du cosmos fut autrefois le sujet d’un grand débat scientifique, qui fut étayé par de nombreuses références. Toutefois, le modèle géocentrique est aujourd’hui obsolète.

Comment affecter un rang

Les rangs sont ajoutés à la page d’un élément sous la section « Déclaration ».

1. Pour ajouter un rang à une déclaration, cliquer sur le bouton [modifier].
2. Une fois en mode de modification, le système de rangs apparaît : il s’agit d’une petite icône bleue située à gauche de la valeur de la déclaration (l’icône est grise si la page n’est pas en mode de modification).
3. Cliquer sur l’icône et sélectionner dans le menu soit le rang « préféré », le rang « normal », ou le rang « obsolète » .
4. L’icône du rang doit alors être :

   pour le rang « préféré »;

   pour le rang « normal »;

   pour le rang « obsolète »

5. Cliquer sur le bouton [sauvegarder] une fois terminé.

Comment visualiser les rangs

Ils sont affichés par défaut avec une petite icône.

En plus, les déclarations dans les rangs préférés apparaissent en vert et les rangs obsolètes sont en rouge.

Vous pouvez personnaliser vos propres couleurs pour distinguer plus nettement les rangs obsolètes et les rangs préférés grâce à ces exemples de code que vous insèrerez dans votre page common.css locale ou global.css. Bien sûr vous pouvez adapter les couleurs à vos goûts et à vos capacités visuelles.

• Pour afficher une couleur de fond :

.wb-deprecated { background-color: #FFE0E0; } /* deprecated claims with red-ish background */ 
.wb-preferred { background-color: #E0FFE0; } /* preferred claims with green-ish background */

• Pour mettre des icônes de couleur :

/* Color non-default ranks */
.wikibase-rankselector-preferred {
    filter: grayscale(100%) brightness(70%) sepia(100%) hue-rotate(50deg) saturate(1000%);

}
.wikibase-rankselector-deprecated {
	filter: grayscale(100%) brightness(70%) sepia(100%) hue-rotate(-20deg) saturate(1000%)
}
.wikibase-rankselector {
	padding: 1em;
	margin: -1em;
}
.wikibase-snakview-typeselector {
	left: 21px;
}
.wikibase-statementview-mainsnak .wikibase-snakview .wikibase-snakview-value-container {
	margin-left: 25px;
}

Comment requêter et filtrer en jouant sur les rangs?

Wikidata Query Service enregistre deux versions des déclarations :

1. Un pour le meilleur rang avec la valeur. Une déclaration avec le meilleur rang est une déclaration avec le rang préféré et s'il n'y en n'a pas, une déclaration avec le rang normal.
2. Un pour tout rang avec valeur, qualificatifs et références.

Requêtes d'exemple pour Q16#P1082 (population du Canada):

1. SELECT * { wd:Q16 wdt:P1082 ?value }

1. SELECT * { wd:Q16 p:P1082 ?st . ?st ps:P1082 ?value . ?st wikibase:rank ?rank . ?st pq:P585 ?date . }

La première équivaut à :

• SELECT * { wd:Q16 p:P1082 ?st . ?st ps:P1082 ?value . ?st a wikibase:BestRank . ?st pq:P585 ?date . }

Requête de rangs spécifiques pour Q692#P569 (date de naissance de William Shakespeare)

meilleur rang

SELECT * { wd:Q692 wdt:P569 ?value }

meilleur rang

SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st rdf:type wikibase:BestRank }

vous pouvez remplacer rdf:type par a si vous préférez le raccourci syntaxique, puisque c'est la même chose.

rang préféré

SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st wikibase:rank wikibase:PreferredRank }

rang normal

SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st wikibase:rank wikibase:NormalRank }

rang obsolète

SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st wikibase:rank wikibase:DeprecatedRank }

rang non obsolète

SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . MINUS { ?st wikibase:rank wikibase:DeprecatedRank } }

rang non obsolète

SELECT * WHERE 
 { 
  VALUES ?ranks { wikibase:PreferredRank wikibase:NormalRank }
  wd:Q692 p:P569 ?st. ?st ps:P569 ?value.  ?st wikibase:rank ?ranks. 
 }

Pour une explication technique, voir les types de déclation.

Voir aussi

Pour des pages d’aide similaires, consulter :

• Help:Statements, explique ce qu’est une déclaration et les règles attachées
• Help:Sources, explique ce qu’est une source et les règles attachées
• Help:Qualifiers, explique ce qu’est un qualificateur et les règles attachées
• Help:Deprecation, explique et justifie les décisions pour ajouter et marquer les valeurs incorrectes
• Help:Evolving knowledge, explique comment utiliser les rangs pour représenter les données qui évoluent dans le temps ainsi que les anciennes valeurs.

Pour des informations et des conseils complémentaires, consulter :

• Project chat : place de discussion pour tous les aspects de Wikidata
• Wikidata:Glossary : glossaire des termes utilisés dans les pages d’aide
• Help:FAQ (foire aux questions) : questions fréquentes et les réponses de la communauté
• Help:Contents : portail d’accueil de la documentation disponible sur Wikidata