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
Télécharger manuellement Java pour Mac peut être assez complexe. Il est potentiellement plus simple d'installer java via le système de gestion de paquets Homebrew (https://brew.sh), qui fonctionne avec les Mac Intel et M1. Vous trouverez plus d'informations sur l'installation de Java sur un Mac avec Homebrew ici.
Les nouveaux 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.
Windows notes
Download the EXE file from downloads linked below.
Launch the EXE file.
You may see a popup saying "Windows protected your PC" and a text about the file not being recognised. Select "More info" (image) and then "Run anyway".
You will see a popup from User Account Control asking if you want to run. Select "Yes".
After closing Pattypan the first time you may see a popup saying "This program might not have installed correctly". Select "This program installed correctly" to not see it again.
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
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
Fenêtre principale de l'outil de téléversement Pattypan
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).
Pattypan - sélection des champs des descriptions des fichiers, avec le modèle "Artwork"
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.
Pattypan - vérification du téléversement pour un autre lot de fichiersPattypan : messages d'erreur
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.
Upload with a proxy
If you live in an area where Wikimedia projects are blocked, you will need to start pattypan using the following command.
