Commons:Pattypan/Manuel de base

This page is a translated version of a page Commons:Pattypan/Simple manual and the translation is 100% complete. Changes to the translation template, respectively the source language can be submitted through Commons:Pattypan/Simple manual and have to be approved by a translation administrator.

Comment téléverser des fichiers avec Pattypan

Remarque : si vous souhaitez télécharger des images sur votre ordinateur à partir d'une liste dans une feuille de calcul (les partenaires fournissent souvent les métadonnées ainsi), il existe plusieurs outils disponibles, parmi lesquels : un programme libre de gestion de téléchargements (Windows, Mac, Android, Linux), la construction d'un butineur d'images à l'aide de l'extension TabSave de Chrome.

Extensions de fichier acceptées par Pattypan

Pattypan peut importer les fichiers avec les extensions suivantes : "png", "gif", "jpg", "jpeg", "tiff", "tif", "xcf", "svg", "wav", and "ogg".

Installer Pattypan

Prérequis. Pattypan utilise le Java Runtime Environment (JRE), lequel nécessite des droits d'administrateur sur votre système. Pour installer la dernière version de Java sur votre ordinateur, utilisez un des paquets Java suivants :
- Java SE Development Kit from Oracle - easiest to install and run for Windows/Mac/Linux
  - https://www.oracle.com/java/technologies/downloads/
- Compilations de Java Development Kit - compilations open source, sélection la plus haute version "prête à l'emploi"
  - https://jdk.java.net/
- Remarques pour les Mac
  - Télécharger manuellement Java pour Mac peut être assez complexe, mais il y a quelques options. Certaines puces Mac ont du mal à utiliser Java, en particulier les puces Mac plutôt que les puces Intel.
  - Java peut être téléchargé à partir d'Oracle.com. L'option d'installation installera Java https://www.oracle.com/java/technologies/downloads/#jdk19-mac
  - L'installation de Java peut être plus facile à l'aide du système de paquets Homebrew (https://brew.sh), et fonctionne avec Intel et Mac M1. Vous trouverez plus d'informations sur l'installation de Java sur Mac à l'aide d'Homebrew ici.
  - Bien que les nouveaux Mac Intel fonctionnent bien avec Pattypan 22.02 bien, les Mac M1 peuvent rencontrer des problèmes pour trouver la bibliothèque OpenJFX, auquel cas il faudra l'installer manuellement. Voir https://github.com/yarl/pattypan/issues/158.
- Notes Windows
  - Télécharger le fichier EXE à partir des téléchargements liés ci-dessous.
  - Lancez le fichier .exe.
    - Il se peut qu'une fenêtre contextuelle s'affiche, indiquant que "Windows a protégé votre PC" et que le fichier ne soit pas reconnu. Sélectionnez "Plus d'informations" (image) puis "Exécuter quand même".
  - Vous verrez une fenêtre contextuelle de contrôle de compte d'utilisateur vous demandant si vous voulez exécuter. Sélectionnez "Oui".
  - Après avoir fermé Pattypan la première fois, vous verrez peut-être une fenêtre contextuelle disant "Ce programme n'a peut-être pas été correctement installé". Sélectionnez "Ce programme est correctement installé" pour ne pas le revoir.
Téléchargez Pattypan depuis :
- https://github.com/yarl/pattypan/releases et enregistrez le fichier .jar.
- Suivant votre système, vous pouvez avoir besoin de rendre le fichier .jar exécutable.
- En fonction de votre système, vous pourriez avoir besoin de modifier la version de java avec la commande sudo update-alternatives --config java, voir github/pattypan/#84
- Pour Windows EXE, téléchargez à partir de https://github.com/Wikimedia-Sverige/pattypan/releases.

Préparer sur votre ordinateur un dossier contenant les fichiers que vous voulez téléverser sur Wikimedia Commons

Si vous avez différents types de contenus qui nécessitent différents modèles, tels que des photographies d'objets 2D (peintures) et 3D (sculptures), placez-les dans différents dossiers afin qu'ils soient téléversés via des lots distincts.
Il est conseillé de donner aux fichiers des noms lisibles (pas comme "IMG001578350.jpg") afin de limiter les aller/retour entre la feuille de calcul et le dossier dans la suite du processus

Créer une feuille de calcul à remplir avec les descriptions des objets

Exécutez le fichier pattypan.jar (par exemple java -Duser.language=en -jar pattypan.jar),
Cliquez sur Generate spreadsheet et naviguez jusqu'au dossier de votre ordinateur qui contient les fichiers que vous désirez téléverser.
Choisissez un modèle de mise en forme des métadonnées dans la liste située à gauche, par exemple : {{Artwork}}, {{Book}}, {{Musical work}}, {{Information}} ou {{Photograph}}. Vous pouvez aussi utiliser n'importe quel autre modèle via le bouton "Advanced / Write wikicode" (il y a un bouton pour visualiser à quoi ressemblent les modèles par défaut, pour vous permettre de renseigner le vôtre).
Choisissez les colonnes qui figureront sur la feuille de calcul : sélectionnez les champs ("Field names") des métadonnées que vous voulez faire apparaître dans la description du fichier (par exemple : date, dimensions, institution, source, etc.). Dans la capture d'écran ci-dessous, on voit les champs "Artist", "Author", "Title"... destinés au modèle "Artwork". Les valeurs sélectionnées seront converties en titres de colonnes — vous pourrez alors remplir les colonnes avec les informations appropriées. À cette étape, vous pouvez préremplir les champs sélectionnés avec des informations répétées en cochant le bouton radio "Const" et en saisissant l'information dans les zones connexes (dans l'exemple : {{Creator:Jerzy Litwin}}. Le champ "Author" n'est pas sélectionné, donc il n'y aura pas de colonne du même nom dans la feuille de calcul que Pattypan va préparer, et ce champ n'apparaîtra pas dans les métadonnées du fichier sur Wikimedia Commons après le téléversement).

Une fois les champs désirés sélectionnés, cliquez sur Create File. La feuille de calcul va être créée dans le même dossier que celui où les fichiers des images devant être téléversées se trouvent. Le nom de la feuille de calcul comprendra un horodatage, par exemple : pattypan 2017-08-02 15_39_46.xls (feuille de calcul Microsoft Excel 97-2003).
Cliquez sur Open pour ouvrir la feuille de calcul générée.

Remplir la feuille de calcul avec les descriptions des fichiers

Remplissez les champs (auteur, titre, et tous ceux que vous avez choisis) avec les informations nécessaires. Ceci peut aussi être fait à part, après avoir enregistré votre travail avec File --> Save si besoin, en quittant Pattypan puis en modifiant la feuille de calcul hors de Pattypan. La capture d'écran ci-dessous illustre comment Pattypan a créé une liste des fichiers source présents sur le disque (colonne A, champ : "path") et comment il suggère les noms des fichiers à l'arrivée sur Wikimedia Commons (colonne B, champ : "name"), ces derniers pouvant être modifiés. Une colonne pour les catégories cibles sur Wikimedia Commons a aussi été ajoutée. Pour saisir plusieurs catégories cibles dans la feuille de calcul, séparez-les avec un point-virgule (;). Par exemple : Raphus cucullatus;Crocodilia.
Remarque : tous les champs peuvent (mais ce n'est pas obligatoire) être remplis avec du wikitexte ; le champ License en revanche doit être renseigné avec du wikitexte. Vous pouvez trouver la "bonne" licence ici : bandeaux de licence.
Par exemple, dans le champ "description", vous pouvez saisir {{en|1=..(Your English description)..}}{{pl|1=(..(Your Polish description)..}} et dans le champ "license", {{CC-BY-SA-4.0}}.

Exemple d'une feuille de calcul finalisée en se basant sur le modèle "Photograph", avec comme premières colonnes : A:path, B:name, C:photographer, D:title, E:description, F:depicted_people, G:depicted_place.

cliquez sur File --> Save pour enregistrer. Fermez la feuille de calcul et quittez éventuellement Pattypan.
Vous pouvez maintenant travailler sur la feuille de calcul hors de Pattypan, pour finaliser les valeurs des métadonnées saisies dans les champs des colonnes.

Vérifier l'absence d'erreurs et prévisualiser

Relancez Pattypan (ou revenez à son écran de démarrage) et cliquez sur Validate and upload pour lancer la validation.
Rendez-vous dans le dossier de l'ordinateur contenant la feuille de calcul (et les images) et sélectionnez la feuille de calcul que vous avez préparée. Vérifiez s'il n'y a pas de message d'erreur (champ vide ou autre erreur). Vous pouvez aussi prévisualiser les descriptions des fichiers avant d'effectuer le téléversement, en cliquant dessus. Chaque description de fichier peut être prévisualisée graphiquement telle qu'elle se présentera sur Wikimedia Commons (ceci va ouvrir une nouvelle fenêtre du navigateur). Si vous n'êtes pas satisfait du résultat, vous pouvez modifier la feuille de calcul et la recharger pour relancer une nouvelle validation, et ainsi de suite. Lorsque tout est bon, cliquez sur Next pour continuer.

Attention, les noms de fichiers contenant des caractères particuliers (blanc souligné, espace, retour chariot accidentel) peuvent s'avérer problématiques. Le nettoyage des noms de fichiers permettra d'éviter une erreur de téléversement.

Téléverser les fichiers

Connectez-vous avec votre identifiant et votre mot de passe Wikimedia Commons. Cliquez sur Upload pour téléverser tous les éléments et leur description sur Wikimedia Commons.

Télécharger avec un proxy

Si vous vivez dans une région où les projets Wikimedia sont bloqués, vous devrez démarrer Pattypan en utilisant la commande suivante :

java -Dhttp.proxyHost=*.*.*.* -Dhttp.proxyPort=* -Dhttps.proxyHost=*.*.*.* -Dhttps.proxyPort=* -jar pattypan.jar

Par exemple :

java -Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=12345 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=12345 -jar pattypan.jar