Skip to content

TransforMap/transformap-viewer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

5d738a3 · Feb 15, 2018
Oct 2, 2016
Nov 9, 2016
Feb 15, 2018
Feb 15, 2018
Dec 12, 2017
Jan 31, 2018
Nov 9, 2016
Jan 31, 2018
Aug 8, 2016
Jul 12, 2017
Aug 10, 2016
Oct 3, 2016
Dec 12, 2017
Oct 2, 2016
Oct 2, 2016
Nov 9, 2016
Mar 6, 2017
Sep 8, 2016
Feb 15, 2018
Sep 29, 2016
Nov 10, 2016
Jun 7, 2017
Jul 31, 2016

Repository files navigation

TransforMap-Viewer

This is a Web-Map plugin that aims at displaying data from the TransforMap API. It offers dynamic filters, which are built from a Wikibase graph hosted on base.transformap.co.

Features

  • Displays geoJSON Points
  • Clustering via PruneCluster
  • Popup with image display, special support for Mediawiki storage
  • Filtering system, builds filter menu out of RDF graph provided by Wikibase

Embedding

To embed the TransforMap-Viewer into your own website, the simplest way is via an iframe:

<iframe width="1200" height="500" src="http://viewer.transformap.co/#5/51.166/10.451"></iframe>

You can change the background layer via the param "background" (e.g. src="http://viewer.transformap.co/?background=mapnik#5/51.166/10.451"). Currently 4 layers are supported:

  • background=stamen_terrain_bg : Default, only terrain without any labels, roads or buildings.
  • background=stamen_terrain : terrain with (a few) labels, roads and buildings later
  • background=mapnik : Default OpenStreetMap 'Mapnik'/'OSM-Carto' style
  • background=hot : Humanitarian OSM style. Temperate colors, very detailed.

If you want to change anything else, e.g. color scheme or the displayed data, fork it and embed it from your fork's gh-pages.

Translations

Translation for the filter-menu are directly fetched from Wikibase. All other strings are are handled via weblate.transformap.co. You can help translating, just sign up! It stores its translations here: https://github.com/TransforMap/transformap-viewer-translations.

Note: The English translations are handled in the source repository directly.

To add new strings, you have to add them currently manually to scripts/map.js and in the translation repository, to each of the language files in json/*.json.

Development

Data flows

This service relies heavily on different linked data backends, see flowchart:

Flowchart showing the services involved

CSS

Is created via less.

Do not edit the CSS file in styles/css/style.css, edit styles/less/style.less and compile to css.

Install node less compiler to convert the stylesheet to less css:

  • Debian: aptitude install node-less
  • Windows: npm install less -g

Compile it via :

lessc styles/less/style.less styles/css/style.css

Dependencies

Install bower from npm:

[sudo] npm install -g bower

Debian: install npm:

[sudo] aptitude install npm nodejs-legacy

Fetch external dependencies:

bower install

Deployment

The site http://viewer.transformap.co/ is actually hosted at github.io. Just push the branch gh-pages to update the site.

Notes: for libraries used with bower, add a static copy of the files to the gh-pages branch to its location in bower_components/ (and add an exception to the .gitignore-file).

build concatenated and minified js/css

Run npm install once to install needed development dependencies.

Then, run npm run build each time js and/or css has been changed to update the content in the /dist folder.

Coding Style guide

We use spaces (2) instead of tabs, please also use this convention.

Forks

Currently, there are 3 "branches" of development: