Commons:Pattypan/Simple manual

How to upload files using Pattypan

File extensions accepted by Pattypan

Pattypan can upload files with the extensions "png", "gif", "jpg", "jpeg", "tiff", "tif", "xcf", "svg", "wav", and "ogg".

Install Pattypan

• Before installing, make sure that the latest version of Java is installed on your computer. Download Java here: https://www.java.com/download/
• If you are using Ubuntu 18.04 or more recent, you will also need to install openjfx (open a terminal and type sudo apt install openjfx). Fedora 29 may require java-1.8.0-openjdk-openjfx.
• Download Pattypan from: https://github.com/yarl/pattypan/releases and save the .jar file.
• Depending on your system, you may need to make the .jar file executable.
• Depending on your system, you may need to change the java-version with sudo update-alternatives --config java see github/pattypan/#84

Prepare a folder containing the files you wish to upload to Wikimedia Commons on your computer.

• If you have different types of content that will require different templates (for example photos of 2D objects like paintings and 3D objects like sculptures), place them in different folders to import them in different batches.
• It is not mandatory, but giving readable filenames (instead of names like "IMG001578350.jpg") can avoid many back-and-forth between the spreadsheet and the file folder later in the process.

Pattypan uploader's main window

Create a spreadsheet to be filled in with object descriptions

• Run the pattypan.jar file, (e.g. java -Duser.language=en -jar pattypan.jar)
• Click Generate spreadsheet and navigate to a folder on your computer containing the files you would like to upload.
• Choose a metadata template from the list at the left, for instance {{Artwork}}, {{Book}}, {{Musical work}}, {{Information}} or {{Photograph}}. You can also use any other template via the "Advanced / Write wikicode" button (there is a select button that allows you to view what the default templates look like so you can fill yours.)
• Choose columns for the spreadsheet: select the fields (Field names) of the chosen metadata template, which you would like to include in the file descriptions (e.g. date, dimensions, institution, source, etc.) In the screenshot below the fields Artist, Author, Title ... are shown for template Artwork. The selected values will be converted into column headings — you will then be able to fill the columns with appropriate information. At this stage, you can pre-fill selected fields with repetitive information by selecting the radio button "Const" and writing the information into the provided boxes. (In the example: {{Creator:Jerzy Litwin}}.. The author field is not selected, so there will be no column Author in the spreadsheet Pattypan prepares and this field will not appear on Wikimedia Commons in the file metadata there after upload.)

Pattypan - selection of description fields with template Artwork

• After selecting your chosen fields, click Create File. The spreadsheet will be created in the same folder, in which your image files (to be uploaded) are placed and will have a filename with a time stamp, for example pattypan 2017-08-02 15_39_46.xls (Microsoft Excel 97-2003 Worksheet).
• Click Open to open the generated spreadsheet.

Fill in the spreadsheet with file descriptions

• Fill in the fields (Author, title, and all your chosen fields) with appropriate information. This can also be done in a separate next session after File --> Save if needed, leaving Pattypan and editing the spreadsheet outside of Pattypan. You see from the screenshot below that Pattypan has created a list of source files on disk (Column A, field: path) and suggests a target destination filename on Wikimedia Commons (Column B, field: name) which can be changed. A column for the target categories on Wikimedia Commons has also been added. To enter multiple target categories in the spreadsheet, separate them by a semicolon (;). Example: Raphus cucullatus;Crocodilia.
  Note: All fields can (but do not have to) be filled in using wikicode; the License field must be filled in using wikicode. Find the right license here: Copyright tags.
  For instance, in the description field you can enter {{en|1=..(Your English description)..}}{{pl|1=(..(Your Polish description)..}} and in the licence field say {{CC-BY-SA-4.0}}.
  
  

Example of a resulting spreadsheet for template Photograph, showing the first columns A:path, B:name, C:photographer, D:title, E:description, F:depicted_people, G:depicted_place.

• Click File --> Save. Close the spreadsheet and optionally leave Pattypan.
• You might now work on the spreadsheet outside of Pattypan massaging your metadata for entry in the column fields.

Check for errors and preview

• Run Pattypan again (or go back to start screen) and click Validate and upload.
• Navigate to the folder on the computer containing the spreadsheet (and images) and select the prepared spreadsheet. Check for error notifications (empty fields, other errors). You can also click through to test views of file descriptions to preview them before uploading. Each file description can be previewed in a graphic form such as it will present itself on Wikimedia Commons (this will open in a browser window). If you are not satisfied, you can edit the spreadsheet and then reload it to try the validation again etc. When you are satified, click Next.

Pattypan - verifying upload for another batch of files

Pattypan: warnings

Upload files

• Login with your Wikimedia Commons username and password. Click Upload to upload all items and descriptions to Wikimedia Commons.