Jump to content

Erweiterung:Kartographer

Issue-Tracker: #kartographer
From mediawiki.org
This page is a translated version of the page Extension:Kartographer and the translation is 75% complete.
Languages:
MediaWiki-Erweiterungen
Kartographer
Freigabestatus: stabil
Einbindung Tag
Beschreibung Erlaubt es, Karten als Frontend von Kartendiensten zu Seiten hinzuzufügen
Autor(en) Yuri Astrakhan (yurikDiskussion)
Kompatibilitätspolitik Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
MediaWiki 1.39+
Datenbankänderungen Nein
Lizenz MIT-Lizenz
Herunterladen
Erweiterung herunterladen
Git [?]:
Hilfe Help:Extension:Kartographer/de
Beispiel Siehe weiter unten auf dieser Seite
Parameter
  • $wgKartographerSimpleStyleMarkers
  • $wgKartographerSrcsetScales
  • $wgKartographerStaticFullWidth
  • $wgKartographerUsePageLanguage
  • $wgKartographerParsoidVersion
  • $wgKartographerStaticMapframe
  • $wgKartographerDfltStyle
  • $wgKartographerFallbackZoom
  • $wgKartographerParsoidSupport
  • $wgKartographerMapServer
  • $wgKartographerWikivoyageMode
  • $wgKartographerMediaWikiInternalUrl
  • $wgKartographerStyles
  • $wgKartographerUseMarkerStyle
  • $wgKartographerNearby
Tags
  • mapframe
  • maplink
Verwendete Hooks
Quarterly downloads 59 (Ranked 82nd)
Public wikis using 898 (Ranked 289th)
Übersetze die Kartographer-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme Offene Aufgaben · Einen Fehler melden

Mit dem Kartographer kannst du Karten (basierend auf OpenStreetMap) in Wikiseiten anzeigen. Sie wurde speziell für Wikimedia-Seiten wie Wikivoyage und Wikipedia entwickelt, kann aber in jedem Wiki verwendet werden.

Der Tileserver unter maps.wikimedia.org ist nicht für Dritte verfügbar. Bitte benutze deinen eigenen Tileserver. If you are a Wikimedia affiliate, see wikitech:Maps/External usage instead.

Verwendung

Kartographer definiert die Wikitext-Tags ‎<mapframe>...‎</mapframe> und ‎<maplink>, die eine Karte bzw. einen Link zu einer Karte auf der Seite anzeigen. Siehe Hilfe:Erweiterung:Kartographer zum Aufruf dieser Tags.

Beispiel

Map
Map of London


Installation

  • Installiere die JsonConfig -Erweiterung wie in der Dokumentation beschrieben.
  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens Kartographer im Ordner extensions/ ablegen.
    Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Kartographer
  • Wird von git aus installiert, ist Composer auszuführen, um PHP-Abhängigkeiten zu installieren, indem composer install --no-dev im Erweiterungsverzeichnis ausgeführt wird. (Siehe task T173141 für mögliche Komplikationen.)
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen: 
    wfLoadExtension( 'Kartographer' );
  • Konfiguriere nach Bedarf.
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

Konfiguration

Konfigurationseinstellungen
Parameter Voreinstellung Anmerkung
$wgKartographerMapServer 
null
Server providing the map tiles. This is the only setting that doesn't have a default. You must provide a value. Note that the Wikimedia tile server https://maps.wikimedia.org can't be used outside of the Wikimedia cluster. See openstreetmap:Tile servers for tile servers.
$wgKartographerStyles 
["osm-intl", "osm"]
Available map styles users can request from your $wgKartographerMapServer via mapstyle="…".
$wgKartographerDfltStyle 
"osm-intl"
Default map style to be used. Must be one of the values from $wgKartographerStyles.
$wgKartographerSrcsetScales 
[ 1.3, 1.5, 2, 2.6, 3 ]
Set of allowed high-DPI pixelratios supported by your $wgKartographerMapServer, to be used in <img srcset="…"> and $wgKartographerMapServer URLs. Must be in incremental order. Doesn't need to start with 1, this happens automatically. Note that most tile servers don't support this at all and thus require setting this to an empty array.
$wgKartographerUseMarkerStyle 
false
Ermöglicht es Kartographer, Marker-Styles aus dem GeoJSON zu extrahieren, um einen ‎<maplink> entsprechend zu gestalten. Currently only the marker-color is considered.
$wgKartographerWikivoyageMode 
false
Aktiviert die Gruppenfunktion, bei der verschiedene ‎<maplink>- und ‎<mapframe>-Tags über group="…"- und show="…"-Attribute jeweils auf die Daten der anderen zugreifen können. See Help:Extension:Kartographer#Groups. Disabled by default. Meant to be enabled on Wikivoyage.
$wgKartographerStaticMapframe 
false
Deaktiviert das Modul, das ‎<mapframe>-Tags in interaktive Minikarten verwandelt, die verschoben und gezoomt werden können, ohne die Seite zu verlassen. Static maps are recommended on high-traffic wikis where your KartographerMapServer couldn't keep up. Das Anklicken von ‎<maplink>- und ‎<mapframe>-Tags zum Öffnen einer interaktiven Karte im Vollbildmodus ist immer möglich. Requires a static map renderer like Kartotherian.
$wg KartographerStaticFullWidth 
1024
The actual width of static map images when a ‎<mapframe> uses the special value width="full". Relevant on wikis in static mode or when JavaScript is disabled. It's recommended to use one of the $wgImageLimits widths for consistency.
$wgKartographerUsePageLanguage 
true
Use the language of the page instead of that of the language of the territory mapped. This sets the lang parameter of the tiles requested.
$wgKartographerFallbackZoom 
13
Fallback zoom value when no zoom="…" is given. Must be an integer between 0 (map shows the entire earth) and 19 (as close as possible). Currently only works with dynamic maps.
$wgKartographerSimpleStyleMarkers 
true
Use an api to generate markers using the simplestyle-spec for features. Should be set to false for most applications outside WMF. Otherwise images of markers are assumed to be hosted on the map server.

API

Diese Erweiterung stellt zwei interne APIs bereit.

Implementierung

Kartographer nutzt eine Reihe von Open-Source- und Open-Data-Tools für die Darstellung von Karten:

  • Auf der Client-Seite (im Browser):
    • Leaflet, eine JavaScript-Kartenbibliothek
  • Serverseitig:
  • Generating the data in advance:
    • Tilerator - a tile pre-generation service also developed by the Wikimedia Foundation
    • OpenStreetMap - an open map data source, the source for the map data as well as for most of the points of interest (POIs).

For more information on these, see Wikimedia Maps. For more information on the production aspects of running these services, see the Wikitech Maps page.

Ziele

Allgemeine Ziele

  • A simple method to insert a map into an article without requiring common.js code changes
  • Ability to add extra information (marks, area, popups, text, links) to the map
  • Ability to gather map usage statistics (KPI) to better gauge how and what should be improved.
  • TBD: experimentation - if the user is aware of the privacy implications, the map should be able to show external data from non-production source, e.g. Static, server-side rendered images will not include the extra data added via this method until the extra data source is hosted in the secure production environment and can be shown without the user action.

Wikivoyage-Ziele

Wikivoyage tends to have a large number of points of interest (POIs), such as museums and restaurants, listed on a page (see example and scroll down to the "See" section). Each POI is usually added with a template, but all of them should appear on the same map. Also, each POI should be referable by showing an icon with a number, both in the text of the article, and on the map:

  • Ability to incrementally add features to the map. For example, each usage of the restaurant template adds a single POI, and the map shows all of them.
  • Added features need to be indexable. E.g. the first restaurant template would show [1] on the page, and map would show POI as a clickable [1] element. There could be multiple index counters at the same time, each for its own type of POIs.

Bekannte Probleme

See the corresponding project(s) in Phabricator for a complete list of bugs.

Siehe auch

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:Kartographer/de&oldid=6689088"