User:FinnaUploadBot/Finna upload Howto

This is basic documentation for uploading images from Finna

Get upload script

THIS NEEDS TO BE UPDATED. CURRENT SCRIPT IS
https://github.com/Wikimedia-Suomi/Finna-uploader 
git clone https://github.com/Wikimedia-Suomi/pywikibot-fiwiki-scripts.git
cd pywikibot-fiwiki-scripts
python3 -m venv venv
source venv/bin/activate
echo "usernames['commons']['commons'] = 'USERNAME'"> user-config.py 
pip install pillow pywikibot imagehash
Running

Script finds next image which has not been uploaded and uploads it after confirmation from user. All filter etc parameters are hardcoded directly to code.

python scripts/upload_kuvasiskot.py

Finna API

Finna record API
Finna search API
  • Example python code: finna_search_api.py
  • Example search: Studio Kuvasiskojen kokoelma + Free images + professorit"+"miesten+puvut
  • Params
    • filter[]: ~format_ext_str_mv:"0/Image/ (format = image)
    • filter[]: free_online_boolean:"1" (only free images)
    • filter[]: ~usage_rights_str_mv:"usage_B" (commercial use and editing allowed)
    • filter[]: ~hierarchy_parent_title:"Studio Kuvasiskojen kokoelma" (collection)
    • lookfor: "professorit"+"miesten+puvut" (search key)
    • type: Subjects (where lookfor search key matches, alternative value AllFields)
    • field[] = values to be returned

Uploaded example image

File:Matemaatikko, professori Frithoif Nevanlinna (HK7155-914-64-1).tif

Example wikitext infobox


== {{int:filedesc}} ==
{{Photograph
|photographer = {{Creator:Kuvasiskot}}
|title = {{fi|matemaatikko, professori Frithoif Nevanlinna}}
|description = 
|depicted people = Nevanlinna, Frithoif
|depicted place = Suomi, Helsinki
|date = valmistusaika 1964
|medium = 
|dimensions = 12,0 x 9,0 cm
|institution = {{institution:Museovirasto}}
|department = Historian kuvakokoelma; Studio Kuvasiskojen kokoelma
|references = 
|object history = 
|exhibition history = 
|credit line = 
|inscriptions = 
|notes = 
|accession number = HK7155:914-64-1
|source = https://finna.fi/Record/museovirasto.D5CB6FCA17D5447E75B348831905033A
|permission = CC BY 4.0
Tiedostoa voi käyttää vapaasti myös kaupallisesti. Tiedoston yhteydessä on mainittava tekijä ja/tai kuvaaja sekä kokoelman ja organisaation nimi. 

Käyttöohjeet:
Käyttäjä vastaa tekijänoikeuksien ja yksityisyyden suojan kunnioittamisesta sekä siitä, että tiedot ovat oikein. Henkilökuvien käyttö markkinoinnissa ja mainonnassa on kielletty ilman kuvassa olevan henkilön suostumusta. Käyttäjä vastaa lupien hankkimisesta tiedostoissa esiintyvien henkilöiden, teosten ja tavaramerkkien osalta. Käyttäjä vastaa käyttötarkoituksen mukaisesta tiedostonkäsittelystä. Pyydämme toimittamaan Museoviraston kirjastoon vapaakappaleen painetusta julkaisusta, jossa tiedostoa on käytetty. Jos ladattavan tiedoston ominaisuudet eivät ole riittävät, ota yhteyttä Museoviraston Kuvakokoelmiin (kuvakokoelmat@museovirasto.fi). 

3D: FINNA-palvelussa on julkaistu 3D mallista verkkoesittämiseen soveltuva kevennetty versio.
|other_versions = 
|wikidata = 
|camera coord = }}
Params
  • photographer = Finna nonPresenterAuthors described using creator template
  • title = Finna full title
  • depicted people = Finna subjectActors
  • depicted place = Finna subjectPlaces
  • date = record['events']['valmistus'][
  • medium =
  • dimensions = record['measurements']
  • institution = Finna institutions in Wikimedia Commons institution template format (example: institution:Museovirasto)
  • department = Finna collections
  • accession number = Finna identifierString (HK7155:914-64-1)
  • source = Finna record page: https://finna.fi/Record/museovirasto.D5CB6FCA17D5447E75B348831905033A
  • permission = Finna copyright text
== {{int:license-header}} ==
{{CC-BY-4.0}}
{{FinnaReview}}
Explanations
  • {{CC-BY-4.0}} - Creative Commons BY 4.0
  • {{FinnaReview}} - request for independent confirmation for copyright licence

Rule for copyright is

  • If licence is something else than CC-BY-4.0 then SKIP.
  • If it is more than 70 years from death of photographer then SKIP (sort these later)
  • If there is artwork in the photograph based on subjects information then SKIP

Categories


[[Category:Kuvasiskot]]
[[Category:Files uploaded by FinnaUploadBot]]
[[Category:1964 in Finland]]
[[Category:Portrait photographs]]
[[Category:Men wearing suits in Finland]]
[[Category:Professors from Finland]]
Category definitions
  • Important ones (to be added for all uploaded photos if possible)
    • Photographs by Kuvasiskot = collection category
    • Files uploaded by FinnaUploadBot = Default category for all files uploaded by FinnaUploadBot
    • 1964 in Finland = year category based on Finna year
  • Subjects based
    • Portrait photographs = Category added based on "subjects"
    • Men wearing suits in Finland = Category added based on "subjects"
    • Professors from Finland = Category added based on "subjects"

Creator and institution templates

Creator example 1
Creator example 2
Instituition example
Collection example

Structured data on Commons

Properties