View it! Tool

From Meta, a Wikimedia project coordination wiki
Jump to navigation Jump to search

View it! is a tool in development that will show Wikipedia users (editors, and hopefully readers) relevant Wikimedia Commons media depicting—or otherwise related to—the article they are reading.

Image to accompany the View it! tool currently in development.

Localization[edit]

View it! has multilingual support! Add missing languages by expanding the localization instructions below. You can also make edits to existing languages here.


Expand for localization instructions

Steps[edit]

Please note that to prevent mistakes or abuse, changes are not automatic. Let us know if you've made an update that still needs to be deployed.

To help us make View it! multilingual:

  1. Visit View it! Tool/localization.json
  2. To make a change/correction to an existing language, simply edit the fields for that language's entry. You might want to discuss your change if someone else preferred a different wording.
  3. For a new language, copy the existing JSON notation for a language entry, for example:
    "en": {
    "label": "View",
    "description": "View images related to this article"
    },
  4. Follow these guidelines when adding/updating languages in the JSON:
    • Specify the language using its language code at the top of the entry (e.g. "en" for English, "es" for Spanish, etc.)
    • "label" and "description" can be changed to any value, per your local language community's preference. It does not need to be a translation of the English.
      • The "label" value controls what text goes in the tab. (Currently "View" in English.)
      • The "description" value controls the helpful tooltip that appears if a user hovers over the tab.
    • Languages should appear in Latin alphabetical order. Do not just place a new language at the top or bottom unless that is where it goes alphabetically.
    • If the new language you are adding is at the end, for valid JSON syntax, you must ensure the comma format is preserved. That is, add a final comma to the previous final language entry, and do not include a final comma (unlike the example code above) for the new language you are adding. (Ending list items in JSON arrays do not have commas.)
  5. Hit "Publish changes" and let us know to update the user script.

Example[edit]

View it! Tool localization.json page
Editing screen for View it! Tool localization.json
Translation (Swedish) added to View it! Tool localization.json
View it! Tool localization.json after saving new translation

Beta script installation[edit]

We have beta script ready for those who wish to try out View it!; please feel free to share feedback and any issues you may have on our Meta page, on the Talk page here, or to our personal talk pages.

All Wikimedia projects[edit]

View it! works across Wikipedia projects. To enable on all platforms:

1. Visit your global.js page on Meta: User:<YourUserName>/global.js

2. Copy in the code:

mw.loader.load( '//meta.wikimedia.org/w/index.php?title=User:SuperHamster/view-it.js&action=raw&ctype=text/javascript' ); // Backlink: [[User:SuperHamster/view-it.js]]

3. Click "Publish changes"

Go to your User global.js page on Meta
View it! script copied in global.js,
Meta global.js after saving View it! script

For English Wikipedia only[edit]

If you wish to only enable View it! on English Wikipedia:

1. Visit your common.js page: User:<YourUserName>/common.js


2. Copy in the code:

importScript( 'meta:User:SuperHamster/view-it.js' ); // Backlink: [[meta:User:SuperHamster/view-it.js]]

3. Click "Publish changes"

Screenshot of Common.js page - User:JamieF already has other scripts in use
View it! script copied to common.js
Screenshot of Common.js after saving View it! script

After installation[edit]

Once installed you will see a "View" button next to the "Article" and "Talk" buttons on a page that is connected to Wikidata/Structured data.

"View" button after installation of View it! on Mary Cassatt's entry.
Upon Clicking the "View" button users will be taken to the results via View it! on ToolForge. Example:Mary Cassatt View it! results

View it! will also work on other Wikipedia projects:

"View" button for View it! tool on Wikispecies - Mungo Park page
View it! results for Mungo Park
"View" button for View it! tool on WikiVoyage - Deventer, Netherlands page
View it! results for Deventer, Netherlands (WikiVoyage)

Rationale[edit]

The View it! tool will enrich Wikipedia content by offering an illustration of a given subject. This tool will increase the discovery of Wikimedia Commons uploads and encourage contributors to utilize Commons and structured data. While the number of images displayed in a Wikipedia article is finite and highly curated by editors, this tool will allow readers to access the full catalog of images available on Wikimedia Commons, and help editors easily add relevant items to a given article.

This page will serve as a space to document, receive feedback and ideas from the community, and list upcoming related meetings and training. As the tool is developed, changes will be noted and sections will be updated.

Possible features[edit]

Through View it! users will be able to see a gallery of related images derived from queries of structured data. While depicts (P180) is relevant to all subjects, other points may be used as well, such as collection (P195), creator (P170), location of creation (P1071) among others. The gallery may be displayed in different environments, such as:

  • A hosted Toolforge tool which users could link in their user interface (UI) when viewing an article; or
  • A button that loads the gallery within the Wikipedia article when clicked.

The tool will be useful to both editors and readers. For logged-in editors, there will be additional features that enable:

  • Removal of bad statements from Commons media, when unwanted results appear in the gallery (envision a one-click operation without leaving Wikipedia, with the tool utilizing a wbremoveclaims call on the backend).
  • Ability to add an image to an article being edited from the auto-generated gallery with a click. This may be a generated code for the user to copy into the source editor, or possibly insert an actual image into the editor.

Demo[edit]

Visit Toolforge to see a proof of concept and the type of results View it! will pull.

Testing sign up[edit]

Beta testing announcement archive

Please sign up if you're interested in being apart of the testing phase of View it! If you're interested in receiving updates about the project (listening sessions, testing updates, and launch) please sign up on the Discussion page.


Update sign up[edit]

Update archive

Please sign up if you're interested in receiving periodic updates about View it! tool - including the launch date and listening/comment sessions.


Status[edit]

August 2022[edit]

The team is investigating community wishes and best technical approaches.

View it! tool presentation at Wikimania 2022/Pittsburgh Meetup
Presentation recording from the August 31st meeting
  • Wednesday, August 31, 2022 16:00 UTC: A virtual presentation and discussion was held during the Wikimedians in Residence Exchange Network monthly meeting, with anyone is welcome to attend.
  • Saturday, August 13, 2022: In-person presentation/listening session, "Discoverability, Structured Data & the View it! tool" at Carnegie Library, East Liberty, Meeting Room 3. 130 S. Whitfield Street Pittsburgh, PA 15206 (second floor, handicap accessible).

September 2022[edit]

The development team is currently working to make the tool multilingual. Please help us with localization!

Usage[edit]

  • As of September 25th, 75 users have installed View it! across global, Commons, and various language specific projects.
  • View it! has also been modified and added to other projects and utilized in other search queries:

Timeline[edit]

The project was funded for development by the Wikimedia Foundation's Structured Data Across Wikimedia project, and has a 6 month timeline. View it! will be completed by January 2023.

Team[edit]

To share opinions, wishes, or ask questions please leave a message on the talk page. If you wish to reach a team member directly, please feel free to leave a message on our respective talk pages:

Beta testers[edit]

View it! tool Beta testing sign ups.

Update interest[edit]

List of those interested in View it! tool updates