Skip to content

Wikidata/SQID

Repository files navigation

SQID

(a.k.a. Wikidata Class Browser)

This repository contains the code for the SQID Wikidata Browser. You can use the application online without installing anything.

Submitting comments, bug reports, feature requests

Use the SQID Issues page on github to report issues and to find out if your issue is already known or even being worked on.

Installation

You do not normally need to install this yourself, since it is a Web application that you can use in your browser. Developers who want to change the code should have a local copy that runs though. This is farily easy:

  • Download the files. To install dependencies, run npm install. For local development, use npm run serve, which will start a local web server serving the application. For production builds, use npm run build and make the dist/ directory available using your local web server.
  • Get some data. You can copy the example json data files from src/data/exampleData to src/data/ to get started. You can update these files by running sqid-helper under helpers/rust from this directory, but this will not recreate all statistics. You can also download the most recently updated json files.
  • Optionally recreate all statistics. This is also done using sqid-helper, by specifing --only=process-dump and providing arguments as directed by the help message.

Deployment on Wikimedia Toolforge

An ansible playbook for deployment on Toolforge is available in helpers/ansible, run ansible-playbook -i production site.yml to build the java helper package and the app bundle, and deploy them to Toolforge. Use ansible-playbook -i production site.yml --tags all,clean to also force a clean rebuild.

License

The code in this repository is released under the Apache 2.0 license. External libraries used may have their own licensing terms.