User:Vieux têtard/QuickStatements-fr

Icône utilisée sur Commons par les modèles qui alimentent Wikidata en utilisant QuickStatements

QuickStatements est un outil, écrit par Magnus Manske, qui peut éditer les éléments Wikidata, à partir d'un ensemble de commandes texte. L'outil peut ajouter ou enlever des déclarations, des libellés, des descriptions et des alias ; et aussi bien, ajouter des déclarations avec des qualificatifs et des sources. La suite des commmandes peut être tapée dans la fenêtre d'entrée ou créée dans une feuille de calcul un éditeur de texte et collée dedans. Elle peut aussi être créée par un programme externe, comme Lua appelé par un modèle et passée dans l'URL.

Les outils

• QuickStatements Version 2
• QuickStatements Version 1 (n'est plus maintenu)

Syntaxe des commandes

Ajouter une déclaration simple

Vous pouvez spécifier les déclarations à ajouter en tapant/collant une ligne par instruction dans la zone d'entée de texte de l'outil. Les différentes parties de la déclaration sont séparées par un caractère TAB, ou dans QuickStatements version 2 par "|". Chaque commande est sur une nouvelle ligne ou dans QuickStatements version 2 séparée par "||". Conseil: Vous pouvez aussi utiliser une feuille de calcul Excel ou Calc ; copier/coller les cellules insère automatiquement un caractère TAB entre chacune. Des éditeurs comme Notepad++ permettent le remplacement de n'importe quel caractère par un caractère TAB.

Chaque déclaration doit consister en un élément, une propriété, et une valeur. Une valeur peut être un autre élément, une chaîne, un temps, les coordonnées d'un lieu, ou une quantité, selon le type de la propriété.

Format de chaque partie:

• Les éléments sont toujours de la forme Qxx. Dans la Version 1 de l'outil one could use an article name instead of the q-code, if one filled in a xxwiki value in the input box above the text area; the correct item number (if available) was be retrieved automatically.

  Exemple: Q4115189 TAB P31 TAB Q1

  Signifiant: ajouter Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

• Les propriétés de la forme Pxx.
• Les chaînes (incluant les URLs et les valeurs numériques stockées comme texte, par exemple dans les valeurs des propriétés d'identifiant externes) doivent être "en double quotes". Beaucoup de déclarations ont des valeurs en format chaîne, y compris les identifiants externes (comme VIAF ID (P214)), les noms de fichiers (comme image (P18)) ou autre noms de pages (comme Commons category (P373)). Pour une chaîne monolingue, la préfixer du code langue et de deux points, e.g. fr:"texte"

  Exemple: Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"

  Signifiant: ajouter à Antoni Ignacy Mietelski (Q41576278)Commons category (P373)Antoni Ignacy Mietelski

  Exemple: Q1214098 TAB P1476 TAB pl:"Krzyżacy"

  Signifiant: ajouter à The Knights of the Cross (Q1214098)title (P1476)"Krzyżacy" (Polish)

• Les valeurs de temps doivent être de la forme +1967-01-17T00:00:00Z/11, avec le /11 désignant la précision. Une précision est de 11 pour le jour, 10 pour le mois, 9 pour l'année; le défaut est 9.

  Exemple: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9

  Signifiant: ajouter à Bronisław Podbielski (Q41576483)date of birth (P569)+1839

• Les coordonnées d'un lieu sont de la forme of @LAT/LON, avec LAT et LON en nombres décimaux.

  Example: Q3669835 TAB P625 @043.26193/010.92708

  Signifiant: ajouter des coordonnées à San Dalmazio (Q3669835)

• Quantités sont de la forme montant[minimum,maximum]Uxx, avec montant, minimum et maximum esprimés en nombres rationnels, Uxx étant l'identifiant de l'unité préfixé par "U" au lieu de "Q".

  unité est optionnel. En juillet 2017 il semblait y avoir quelques problèmes avec les unités, voir ici.

  minimum, maximum sont optionnels. minimum et maximum doivent être présents ou absents ensembles. Quand ils sont présents, ils sont entourés de crochets et séparés par une virgule.

  montant, minimum et maximum doivent utiliser le . comme séparateur décimal, ne doivent pas utiliser de séparateur de milliers et peuvent être préfixés par + or -.

  Ne laissez aucun espace dans les quantités.
  10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 sont des quantités valides (U11573 étant le metre (Q11573)).

  Les quantités avec un facteur d'erreur peuvent être spécifiées comme 1.2~0.3 (pour 1.2±0.3) (dans la Version 2 de l'outil).

Ajouter une déclaration avec qualificatifs

Chaque déclaration en "triplet" peut être suivie par un nombre illimité de qualificatifs sous la forme de "paires" propriété TAB valeur.

Exemple: Q41577083 TAB P570 +1891-00-00T00:00:00Z/11 TAB P1319 TAB +1891-00-00T00:00:00Z/9

Signifiant: ajouter à Gian Federigo Bonzagna (Q41577083)date of death (P570)19. siècleearliest date (P1319)+1891

Ajouter une déclaration avec des sources

Chaque déclaration peut être suivie par un nombre illimité de sources sous la forme de "paires" propriété source TAB valeur. La propriété source est identique à une propriété "normale", sauf qu'on la spécifie sous la forme Sxx au lieu de Pxx.

Exemple: Q41577600 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11

Signifiant: ajouter à Gotō Ichijō (Q41577600)sex or gender (P21)male (Q6581097) la référence interne imported from Wikimedia project (P143)Commons Creator page (Q24731821)retrieved (P813)4 October 2017

Notes:

• Les déclarations existantes avec propriétés et valeurs identiques ne seront pas rajoutées une nouvelle fois ; cependant des références supplémentaires peuvent être ajoutées à une déclaration.
• Avant, chaque affirmation de source représentait une référence individuelle, c.a.d. qu'elles n'étaient pas groupées en une seule référence ; ceci fonctionne maintenant correctement dans la version 2 de QS.

Ajouter des libellés, des alias, des description et des liens inter-sites (sitelinks)

Comme pour ajouter des déclarations en texte simple, chaque instruction consiste en un élément, une commande, et une chaîne entre double quotes.

• Pour ajouter un libellé dans un langage spécifique à un élément, utilisez "Lxx" au lieu d'une propriété, avec "xx" comme code langue.

  Exemple: Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"

  Signifiant: ajouter le libellé polonais "Cyprian Kamil Norwid" à Cyprian Norwid (Q340122)

• Pour ajouter un alias dans un langage spécifique à un élément, utilisez "Axx" au lieu d'une propriété, avec "xx" comme code langue.

  Exemple: Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"

  Signifiant: ajouter l'alias anglais "Cyprjan Kamil Norwid" à Cyprian Norwid (Q340122)

• Pour ajouter une description dans un langage spécifique à un élément, utilisez "Dxx" au lieu d'une propriété, avec "xx" comme code langue.

  Exemple: Q340122 TAB Dde TAB "polnischer Dichter"

  Signifiant: ajouter la description en allemand "polnischer Dichter" à Cyprian Norwid (Q340122)

• Pour ajouter un lien inter-sites vers une page spécifique d'un site à un élément, utilisez "Sxxx" au lieu d'une propriété, avec "xxx" comme site (e.g. enwiki).

  Exemple: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"

  Signifiant: ajouter le lien inter-sites vers Wikipedia en chinois (塞浦路斯·諾爾維特) à Cyprian Norwid (Q340122)

Création d'élément

Vous pouvez aussi créer de nouveaux éléments en insérant une ligne contenant seulement l'instruction "CREATE". Pour ajouter des des déclarations à l'élément nouvellement créé, utilisez le mot "LAST" au lieu de l'identifiant d'élément Q number; la déclaration sera ajoutée au dernier élément créé.

Un exemple de création d'un nouvel élément, en lui ajoutant un lien inter-sites et un libellé:

CREATE

LAST TAB Sfrwiki TAB "Le croissant magnifique!"

LAST TAB Lfr TAB "Le croissant magnifique!"

Signifiant: créer un nouvel élément avec un lien vers Wikipedia en français w:fr:Le croissant magnifique! et un libellé français "Le croissant magnifique!"

Fusion d'élément

Vous pouvez fusionner deux éléments. Le premier élément (source) sera fusionné avec le deuxième et (si la fusion s'est bien passée) redirigé vers le deuxième élément (cible).

MERGE TAB Qsource TAB Qcible

Suppression de déclarations

Vous pouvez supprimer une déclaration en préfixant la ligne avec "-".

Exemple: -Q4115189 TAB P31 TAB Q1

Signifiant: supprimer de Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

Exécuter QuickStatements

Utiliser QuickStatements version 2

Voici comment utiliser QuickStatements (version 2) en mode basique:

1. Allez à https://tools.wmflabs.org/quickstatements/
2. Assurez-vous d'être loggé à OAuth et que votre nom soit affiché dans le coin en haut à droite. Sinon, loggez-vous.
3. Cliquez sur "Import commands" and choisissez "Version 1 format" parce que c'est la seule option disponible actuellement.
4. Copiez/collez vos commandes. Leur syntaxe est décrite dans la section ci-dessus.
5. Quand c'est fait, cliquez sur "Import".
6. L'outil va convertir vos commandes en forme lisible. Vérifiez-les puis cliquez "Run" pour les executer.
7. Au fur et à mesure du traitement de vos déclarations, vérifiez une nouvelle fois les résultats et cliquez sur "Stop" si vous vous apercevez d'un problème.
8. L'interface utilisateur vous informe de la fin du traitement de vos déclarations.

• 
  Préparez les déclarations sur une feuille de calcul
• 
  Copiez/collez les cellules dans la zone d'entrée de la fenêtre QS "Import"
• 
  QS converti vos commandes en langage clair et attend votre accord
• 
  QS exécute les commandes. Le bouton "Stop" vous permet d'interrompre le traitement.
• 
  QS a terminé.

Utiliser QuickStatements version 1

Copie d'écran de l'utilisation de QuickStatements version 1

QuickStatements version 1 est toujours disponible, mais plus maintenu. Il s'est arrêté de fonctionner pour quelques utilisateurs, tout en fonctionnant correctement pour les autres. Le fork NIOSH's de l'outil est aussi disponible.

1. Allez à https://tools.wmflabs.org/wikidata-todo/quick_statements.php
2. Copiez/collez vos commandes dans la fenêtre
3. Cliquez sur "Do it!"
4. L'interface utilisateur vous averti quand le traitement de toutes les commandes est terminé.

Utiliser QuickStatements version 2 en mode batch

This page is a work in progress, not an article or policy, and may be incomplete and/or unreliable. Please offer suggestions on the talk page. বাংলা | català | čeština | Deutsch | English | español | فارسی | suomi | français | हिन्दी | magyar | italiano | 日本語 | 한국어 | Lëtzebuergesch | latviešu | македонски | Bahasa Melayu | မြန်မာဘာသာ | norsk bokmål | Nederlands | ਪੰਜਾਬੀ | polski | پنجابی | português | português do Brasil | română | Scots | shqip | slovenščina | српски / srpski | svenska | Türkçe | русский | українська | 中文（简体） | +/−

QuickStatements version 2 a un bouton "Run in the background"

En préparant une exécution comme expliqué dans la section Utiliser QuickStatements version 2 ci-dessus à l'étape #6 si au lieu de pressez sur "run" vous pressez le bouton "Run in the background", alors l'outil va exécuter votre travail en mode batch.

• "Show" menu / "Last batches" vous montrera la liste des plus récentes exécutions batch
• "Show" menu / "Your last batches" vous montrera la liste des plus récentes exécutions batch que vous avez lancées.

Utiliser QuickStatements par URL

Un autre moyen d'exécuter QuickStatements est d'utiliser l'URL au lieu de copier/coller les commandes dans la fenêtre "Import". Par exemple, si nous importons la commande Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565 en utilisant la méthode "copier/coller" (image #1 ci-dessous), il va montrer la commande analysée et dans l'URL on pourra lire https: //tools.wmflabs.org/quickstatements/#v1=Q37887397%09P214%09"96480189"%09S143%09Q565 ou https://tools.wmflabs.org/quickstatements/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565 (image #2 ci-dessous)(la déclaration ajoute à Emile Justin Merlot (Q37887397)VIAF ID (P214)"96480189" sourcée par imported from Wikimedia project (P143)Wikimedia Commons (Q565)). Créer l'URL par d'autres moyens évite l'étape initiale d'analyse. Plusieurs modèles de Commons comme Creator or Authority control utilisent cette technique pour rassembler des informations qui peuvent être importées dans Wikidata par un URL cliquable.

• 
  Importer une commande par copier/coller
• 
  QS montre l'URL en attendant l'accord
• 
  Déclaration ajoutée

Conseils :

• Un URL ne peut pas contenir d'espaces. Remplacez TAB par "%09" ou "|", les double quotes par "%22", les espaces par "%20", and et les fins de ligne par "%0A" ou "||".
• [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://tools.wmflabs.org/quickstatements/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565]] va encoder l'URL dans une icône cliquable: (cliquez-la mais ne cliquez pas sur "run" ; ceci ne fonctionnerait pas parce que cet élément a déjà cette propriété).

Limitations

QuickStatements version 2 ne peut pas actuellement :

• fusionner des éléments (la version 1 le peut)
• donner des rangs aux déclarations
• spécifier un (type de ?) calendrier pour une déclaration de date
• specify precision or globe for a location statement

---

FAQ

QuickStatements peut-il ajouter des références avec plusieurs affirmations ?

Oui, QuickStatements actuel peut ajouter des références ayant par exemple à la fois imported from Wikimedia project (P143) et retrieved (P813) (voir ici) ou à la fois stated in (P248) et page(s) (P304).

Comment puis m'exercer à utiliser QuickStatements ?

Utilisez le Wikidata Sandbox (Q4115189).

Comment signaler des problèmes avec l'outil ?

Vérifiez avec d'autre utilisateurs sur la page de discussion ou sur Wikidata:Project chat. Les erreurs confirmées devront être signalées sur tool's Bitbucket page.

Où puis-je suggérer de nouvelles fonctionnalités ?

Vous pouvez demander sur tool's Bitbucket page ou sur User:Magnus Manske/quick statements2, mais soyez conscient que Magnus est très occupé !

Quel est le nombre maximum de commandes que je puisse faire traiter en une fois ?

Non documenté. Il a déjà été testé avec plus de 11,000 commandes. Mais prenez note que d'aussi gros batch vont prendre plusieurs heures avant de se terminer.

Bonnes Pratiques

• QuickStatements permet de traiter d'une seule déclaration à plusieurs milliers par batch . Les très gros batch ou ceux qui peuvent prêter à controverses doivent être soumis à la procédure d'approbation décrite dans Wikidata:Bots.
• Les utilisateurs doivent éviter de créer des éléments en double.
• Toutes les déclarations doivent avoir une référence (source) comme indiqué dans Help:Sources. Cela peut être moins important pour les identifiants, comme VIAF ID (P214) ou RKDartists ID (P650), etc.
• Les utilisateurs faisant des modifications sont responsables de la correction ou de l'annulation de leurs changements si des problèmes apparaissent. Voir à ce sujet Suppression de déclarations.

Voir Aussi

• CSV to quick_statements Outil pour convertir un fichier CSV bien formé en une série de commandes QuickStatements.
• Zotero export translator to QuickStatements format in zotkat: permet de collecter des références dans Zotero et de les exporter vers QuickStatements pour intégration dans Wikidata.