https://github.com/cdrini/wikidata-timeline
web app for visualizing Wikidata items on a timeline
https://github.com/cdrini/wikidata-timeline
timeline visualization wikidata
Last synced: 5 days ago
JSON representation
web app for visualizing Wikidata items on a timeline
- Host: GitHub
- URL: https://github.com/cdrini/wikidata-timeline
- Owner: cdrini
- License: mit
- Created: 2015-09-26T03:29:39.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-06-12T06:38:08.000Z (almost 7 years ago)
- Last Synced: 2025-04-12T15:11:30.399Z (11 months ago)
- Topics: timeline, visualization, wikidata
- Language: JavaScript
- Homepage: https://wikidata-timeline.toolforge.org/
- Size: 1.92 MB
- Stars: 16
- Watchers: 3
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
View it live here: https://tools.wmflabs.org/wikidata-timeline/
Web app for visualizing Wikidata items in the form of a timeline.
Developed on/for Chrome 44+. Firefox/IE also tested to be stable, but might have some issues.
When using WDQ, these properties are used for determining time:
* startTime: 'P577', 'P580', 'P569', 'P571'
* endTime: 'P577', 'P582', 'P570', 'P576'
If endTime is missing, applies a default value (see the `defaultEndTime` url parameter).
If startTime = endTime, displayed as a point.
Performs rounding when endtime is 'someValue'.
# URL Params
Valid on the [timeline view](https://tools.wmflabs.org/wikidata-timeline/#/timeline) and the [new view](https://tools.wmflabs.org/wikidata-timeline/#/new).
Note: Boolean parameters are true for any value which is not "false".
Name | Type | Default | Description
-------------------- | ----------- | --------------- | -------------
title | String | Untitled | Timeline's title. Useful so that your browser's history doesn't display the same thing for different timelines.
sparql | String | | The SPARQL Query to use for the visualization. Expects the 1st variable to be items, 2nd to be labels, 3rd to be start time, and 4th to be end time (optional; see `defaultEndTime` parameter)). Try it/learn more at [Wikidata Query Service](https://query.wikidata.org).
wdq | String | | The Wikidata Query from which to get items. See [WDQ's Documentation](https://wdq.wmflabs.org/api_documentation.html) for help. Note this is translated to SPARQL using [WDQ2SPARQL](http://tools.wmflabs.org/wdq2sparql/w2s.php), so some features might not be available.
defaultEndTime | String | now | One of "now" or "start".
(also useful for resolving ``P571(inception)`` ambiguity).
embed | Boolean | false | If true, optimizes view for embedding in an iframe.
widthOfYear | Number | widthOfYear | How many pixels wide a year should be on the timeline
## WDQ URL Params
The url parameters work if the `wdq` is present.
Name | Type | Default | Description
-------------------- | ----------- | --------------- | -------------
languages | CSV | en,fr | The languages to use, ordered by preference. If no label in the given lang(s), stays blank
sitelink | String | wikidata | What an item links to when clicked. Language determined by ``languages``. Possible values: ``[ 'wikisource', 'commonswiki', 'wikibooks', 'wikiquote', 'wiki', 'wikinews', 'wikidata' ]``
sitelinkFallback | Boolean | true | If true, when the desired sitelink is not available, links to wikidata. If false, links to nothing.
## Deprecated URL Params
Please do not use these parameters.
- `query`: Now an alias for `wdq`
# Credits
## Services/APIs
* [WDQ2SPARQL](http://tools.wmflabs.org/wdq2sparql/w2s.php)
* [Wikidata API](https://www.wikidata.org/w/api.php)
* [Wikidata Query](https://wdq.wmflabs.org/api_documentation.html)
* [Wikidata Query Service SPARQL Endpoint](https://www.mediawiki.org/wiki/Wikidata_query_service/User_Manual#SPARQL_endpoint)
## Libraries
* [AngularJS](https://github.com/angular/angular.js)
* [Bootstrap](https://github.com/twbs/bootstrap)
* [Codemirror](https://github.com/codemirror/CodeMirror)
* [D3](https://github.com/mbostock/d3)
* [jQuery](https://github.com/jquery/jquery)