e4e64914ccc3666ecb22f08d797008874c930924 - mediawiki/extensions/Kartographer

commit	e4e64914ccc3666ecb22f08d797008874c930924	[log] [tgz]
author	Translation updater bot <[email protected]>	Mon Sep 02 09:20:57 2024 +0200
committer	Translation updater bot <[email protected]>	Mon Sep 02 09:20:57 2024 +0200
tree	615f7738bd98f02a792066ee39abba9db31eb13d
parent	8c589c358f1b2931dd56ec0193abd5d3f493159b [diff]

tree: 615f7738bd98f02a792066ee39abba9db31eb13d

README.md

Kartographer is a MediaWiki extension that adds map capability See https://www.mediawiki.org/wiki/Extension:Kartographer

You will need to run your own map tile server, or use one that is available to you. See https://wiki.openstreetmap.org/wiki/Tile_servers

Terminology

DM – data model
Dynamic as in "dynamic map frame" – scrollable, zoomable mini map in a wiki article, realized with Leaflet
GeoData – MediaWiki extension that provides the information for the nearby feature
GeoJSON – standard format to describe features on a map, e.g. points and shapes
Kartographer – MediaWiki extension for displaying prerendered and dynamic maps
Kartotherian – tile server as well as backend rendering service required for Kartographer
Leaflet – JavaScript library for interactive maps
Maki – icon set used for the markers on a map
Marker – a location on a map marked with a pin and/or an icon
MapBox – collection of JavaScript libraries on top of Leaflet, as well as the name of the company that created them
MW – MediaWiki
Nearby – in this context a feature that provides links to other articles on the same wiki that have coordinates close to a given location
OSM – OpenStreetMap, data source for the base layer of all maps
Simplestyle – extension to the GeoJSON standard
Static as in "static map frame" – the static .png rendering of a <mapframe> tag; note this is always present, but overlayed with a dynamic map frame, depending on the configuration
Tile – see en:Tiled web map
TopoJSON – extension to the GeoJSON standard that encodes topology
VE – VisualEditor
Wikivoyage – primary user of dynamic maps and the nearby feature on the Wikimedia cluster
WV – Wikivoyage

Developer info

Many parts of the JavaScript that builds the dynamic maps and provides the GeoJSON might be used by tools and Gadgets outside of the Wikimedia extension realm so dependencies and requirements on this interface may be hard to discover. Be extra careful changing these without notice if they're not explicitly marked private and especially if they are marked public.