Resources

Cheat sheet for important actions

Updating wikidocumentaries-demo.wmflabs.org code from GitHub

1. Login with SSH to the hupu server:

   ssh hupu.eqiad.wmflabs

2. Run:

   sudo -s

3. Run:

   sudo -s -u wikidocumentaries-web

4. Run:

   script /dev/null

5. To see detached screens (there should be two, one for wikidocumentaries-ui and one for the wikidocumentaries-topic-search-api), run:

   screen -ls

6. Restore a screen (replace the last parameter with the actual screen id), e.g. run:

   screen -r 24566.pts-4.hupu

7. Stop the running node ui/api app, press:

   ctrl+c

8. Pull changes from the GitHub (and if needed resolve conflicts), run:

   git pull origin master

9. Start the node ui/api app again, run:

   npm run dev

10. Exit from the screen, press:

    ctrl+a+d

11. Restore the other screen and update the app following again from the step 6 to the step 11
12. Exit the script and then from the wikidocumentaries-web shell and root shell, press:

    ctrl+d and again ctrl+d and again ctrl+d

13. 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

1. Sign in on page https://horizon.wikimedia.org
2. In the dropdown next to the left top logo choose Wikidocumentaries
3. In the left dropdown choose Project -> Access -> Project Members
4. Press button + Add members on the right
5. 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

Front end

Vue.js

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

• Vue.js official guides
• Vue.js tutorial with the Webpack
• Vue.js Webpack starter pack

Component-specific

Parsing Wiki content

Cheerio

• https://github.com/cheeriojs/cheerio

Surveyor geotagging tool

• Surveyor at New York Public Library
• Surveyor GitHub repository
• Leaflet.GeoTagPhoto plugin
• brick-by-brick JSON API

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

• Official OpenLayers Quick Start
• Official OpenLayers Examples
• Official OpenLayers API Docs

Navigation

About	Technology	Design	Content modules	Tool pages	Projects
Status Wikidocumentaries blog Wikidocumentaries demo Phabricator project Facebook group GitHub repository Translation in TranslateWiki Wikidocumentaries Slack	Setting up dev environment Resources Translations Languages Using Wikibase Federation with Wikidata APIs Linking Media metadata Properties to content User registration Licensing	Page types Landing page Search page Topic page User page Organisation page Project page Tool page Tasks Components Main toolbar and footer Search Faceting Topic page header Content module Dropdown Modal Icons	Active modules Article Family tree Gallery Historical map Images Image viewer Infobox Map Module ideas Audio/Video Bibliography Correspondence Discussion Graph Name Newspaper articles Testimonials Timeline Visualizations Wikidocumentary 3D	Visual editor Query tool QuickStatements Open Refine Creating topics Uploading images Geolocating tool Metadata editor Rectifying maps Transcription Annotation tool	Central Park Archives Convent Quarter Wikisource