Language screenshots

The purpose of the project is:

• drive a browser
• take a screenshot of a screen - in multiple languages
• crop the screenshot - so only relevant part is left
• upload the screenshot to Commons
  • testing: commons.wikimedia.beta.wmflabs.org
  • production: commons.wikimedia.org

At the moment it is used only in Help:VisualEditor/User guide, but the same concept can be applied to other tools as well.

Team

• Erica Litrenta - anything Help:VisualEditor/User guide related
• Ed Sanders - anything screenshots related
• Amir Aharoni - anything language related
• Željko Filipin - anything related to uploading files to Commons

For existing projects

How to see the existing screenshots?

• Images are stored in two places:
  • language-screenshots-VisualEditor Jenkins job
  • Commons (uploads by LanguageScreenshotBot: testing, production)

How to run the screenshot creating job?

• Log in (with Gerrit credentials) to Wikimedia Jenkins
• Request permission to run the job. (Ask the person that maintains Wikimedia Jenkins, at the moment it is Antoine Musso.)
• Go to language-screenshots-VisualEditor job.

• Click Build Now button.

How to add a language to the current job?

• Edit screenshotLangs.json

New projects

How to write a test that creates screenshots?

• Add another test to screenshots.js
• Uploading is done using the commons_upload Ruby gem.
• Environment variables that the gem needs:
  • MEDIAWIKI_API_UPLOAD_URL, API URL of the site where the images are to be uploaded
    • Testing: https://commons.wikimedia.beta.wmflabs.org/w/api.php
    • Production: https://commons.wikimedia.org/w/api.php
  • MEDIAWIKI_USER: usually LanguageScreenshotBot (exists on testing and production)
  • MEDIAWIKI_PASSWORD testing or production

How to create a whole new job for another extension?

• Add another project to jjb/language-screenshots.yaml (example: gerrit:300035)

See also

• Automatic cross-language screenshots
• User:LanguageScreenshotBot
• Help:VisualEditor/User guide