Resources

Communication & community

General communication

Wikidocumentaries blog The blog features articles about activities created around Wikidocumentaries. Articles can be published in Finnish and English.
Wikidocumentaries Facebook group. The group is primarily for informing about future events and promoting related events. Events can be multilingual, currently in Finland primarily.
Wikidocumentaries Slack channel The network of project partners preparing events and funding applications collaboratively.

Wikidocumentaries for developers

Cheat sheet for important actions

Wikimedia and project accounts

Get a Wikimedia account (the same account for all Wikipedias, Wikimedia Commons, Wikidata etc.) e.g. https://www.wikidata.org/wiki/Special:UserLogin
Get the Wikimedia developer account > Registration instructions under "VPS and General Users". The same key and password let you access The Wikimedia Cloud Services at https://wikitech.wikimedia.org and the git repositories located at https://gerrit.wikimedia.org/. You are also creating a separate Shell account. Read also:
- https://wikitech.wikimedia.org/wiki/Main_Page
- https://wikitech.wikimedia.org/wiki/Help:Access
Create an account in Wikimedia Phabricator
Ask to join the codebase in GitHub
Ask for an account to edit this wiki

Updating wikidocumentaries-demo.wmflabs.org code from GitHub

Login with SSH to the hupu server:
ssh hupu.eqiad.wmflabs
Run:
sudo -s
Run:
sudo -s -u wikidocumentaries-web
Run:
script /dev/null
To see detached screens (there should be two, one for wikidocumentaries-ui and one for the wikidocumentaries-topic-search-api), run:
screen -ls
Restore a screen (replace the last parameter with the actual screen id), e.g. run:
screen -r 24566.pts-4.hupu
Stop the running node ui/api app, press:
ctrl+c
Pull changes from the GitHub (and if needed resolve conflicts), run:
git pull origin master
Start the node ui/api app again, run:
npm run dev
Exit from the screen, press:
ctrl+a+d
Restore the other screen and update the app following again from the step 6 to the step 11
Exit the script and then from the wikidocumentaries-web shell and root shell, press:
ctrl+d and again ctrl+d and again ctrl+d
You have succesfully updated the wikidocumentaries-ui/wikidocumentaries-topic-search-api and may now logout from the hupu server

Adding users to the Wikidocumentaries project on Hupu

Sign in on page https://horizon.wikimedia.org
In the dropdown next to the left top logo choose Wikidocumentaries
In the left dropdown choose Project -> Access -> Project Members
Press button + Add members on the right
Fill in either User name or Shell name (one is enough) and choose Project Admin to grant all privileges

Wikimedia developer resources

MediaWiki

MediaWiki homepage https://www.mediawiki.org/wiki/MediaWiki
MediaWiki Vagrant portable MediaWiki development environment https://www.mediawiki.org/wiki/MediaWiki-Vagrant

Wikibase

https://github.com/wmde/wikibase-docker
The Wikibase setup including MediaWiki, Wikibase and the SPARQL endpoint are included in a Docker compose at https://github.com/wmde/wikibase-docker/blob/master/README-compose.md

LAMP stack

Front end

Vue.js

Current (17.10.2018) Wikidocumentaries UI is built with Vue.js

Component-specific

Parsing Wiki content

Cheerio

https://github.com/cheeriojs/cheerio

Surveyor geotagging tool

React

Current (17.10.2018) Surveyor UI is built with React

Official React Getting Started guide

Vue.js and React together

https://x-team.com/blog/react-vue-component-integration/
vuera - Vue in React, React in Vue

Leaflet

Official Leaflet Tutorials

Map component

OpenLayers

API documentations

Wikimedia

Media services

Finna.fi

Includes

Images from Finnish museums
Publications from Finnish libraries

Documentation

Finna API documentation
Old but still somewhat useful Finna API documentation
CC licensing data available, prepared for RightsStatements

Flickr

Flick API Docs - Includes useful API Explorer

Topothek

Includes

Images from Topotheks submitted by local people

Ajapaik

Ajapaik.ee

K-Samsök

Internet Archive

Data

Nimiarkisto.fi

Linked Data Finland

BiographySampo
SotaSampo

FIN-CLARIN

Map services

Map Warper

Map Warper API documentation

Design files

https://www.figma.com/files/project/891845/Wikidocumentaries

Misc.

Images

For the federated API query to be able to search
- Name of the topic, time, location as coordinates or address, existing authority IDs (Eg YSO), alternative names, language variants...