Hilfe:Kartographer

Die MediaWiki-Erweiterung Kartographer unterstützt das Arbeiten mit Landkarten als Grafik.

Das Element <maplink> ermöglicht einen Verweis auf eine ganzseitige Landkarte. Es wurde 2016 auf allen Projekten freigeschaltet.

Das Element <mapframe> ermöglicht die Einbindung eines statischen Kartenausschnittes in eine Wiki-Seite. Es wurde in diesem Wiki am 7. Juni 2022 freigeschaltet.

maplink

Die Wirkung ist die Generierung einer Verlinkung auf eine Karte im Vollbildmodus, ggf. mit eingezeichneten Positionen. Die Karte wird über eine Spezialseite erzeugt.

Bei Benutzern mit aktiviertem JavaScript* wird die generierte Karte der bisher betrachteten Wiki-Seite überlagert. Ohne JavaScript wird eine Verlinkung auf die Spezialseite erzeugt, der Artikel wird also bei Klick auf diesen Link verlassen.

* Bei dir ist JavaScript momentan nicht aktiviert.

Syntax

Wikisyntax: <tag>

<maplink>

• Typ: unary / binary
• Attribute:
  • alt=""
  • class=""
  • group=""
  • lang=""
  • latitude=""
  • longitude=""
  • mapstyle=""
  • show=""
  • text=""
  • zoom=""

Hinweis: Die Erzeugung der Syntax kann mit Hilfe der Vorlage:maplink deutlich vereinfacht werden, es müssten nur ausgewählte Parameter angegeben werden. Insbesondere kann mittels Wikidata sehr einfach auf bereits existierende Daten und Koordinaten zurückgegriffen werden. Im Folgenden wird die Nutzung des Katographers ohne die genannte Vorlage erläutert.

Das Element <maplink> kann mit Attributen verwendet werden:

alt

Alternativtext

class

Universalparameter

group

Nur auf Wikivoyage freigeschaltet.

lang

Sprachcode, in dessen Sprache die Zielkarte beschriftet ist.

latitude

Geografische Breite des Kartenmittelpunkts

Dezimalzahl mit Punkt

Angabe empfehlenswert; Vorgabe: 0

longitude

Geografische Länge des Kartenmittelpunkts

Dezimalzahl mit Punkt

Angabe empfehlenswert; Vorgabe: 0

mapstyle

Vorgabe: osm-intl

show

Detail zu group=

text

Linkbeschriftung

Optional; Vorgabe: Koordinatenwerte

zoom

Zoomfaktor

Anhaltswerte:

• 6, 7 – Staat
• 12 – Stadt
• 16 – Stadtplan

Inhalt des Elements ist eine JSON-Struktur (basierend auf GeoJSON) mit beispielsweise folgenden Komponenten:

type

"Feature" – Anzeigeelement, im Raum begrenzt

"FeatureCollection" – Anzeigeelemente

• muss ein Array features:[] enthalten

"Geometry" – Reine Geometrie

geometry

Objekt mit den Komponenten:

coordinates

Array [2] mit den Koordinaten [Länge, Breite] als numerische Werte

type

Art des Anzeigeelements

"Point" – Punkt

"LineString" – Linie

"MultiPolygon" – etwa Grenzen

properties

Objekt (Struktur außerhalb von GeoJSON) mit den Komponenten:

description

Erläuterung zum Anzeigeelement, kann Wiki-Syntax enthalten

marker-color

Hexadezimalcode für den Farbwert

marker-size

Größe des Anzeigeelements (small/medium/large)

Vorgabe: medium

marker-symbol

Gestaltung des Anzeigeelements

• Text/Symbol im Kopf des Markers – erlaubt sind Ziffern „0“ … „9“, Kleinbuchstaben „a“ … „z“ (werden auf Großbuchstaben konvertiert) und Iconnamen aus http://mapbox.com/maki/ Hier die von unserer Implementierung unterstützten Icons: Maki Icons
• -number – Automatische Nummerierung 1, 2, 3, …
• -letter – Automatisch (auto-counter) mit Buchstaben A, B, C, …
• -number-Code bzw. -letter-Code
  • Verwendung eines unabhängig laufenden auto-counter für Code.

title

Beschriftung des Anzeigeelements

Beispiele

<maplink zoom="16" longitude="6.910340" latitude="50.955561" text="Wikipedia:Lokal K">
{
  "type":       "Feature",
  "geometry":   { "type":        "Point", 
                  "coordinates": [6.910340, 50.955561] },
  "properties": {
    "title":        "WP:Lokal K",
    "marker-color": "228B22" }
}
</maplink>

Wikipedia:Lokal K

mapframe

Wikisyntax: <tag>

<mapframe>

• Typ: unary / binary
• Attribute:
  • alt=""
  • class=""
  • group=""
  • height=""
  • lang=""
  • latitude=""
  • longitude=""
  • mapstyle=""
  • show=""
  • width=""
  • zoom=""

Das Element <mapframe> ist seit Anfang Juni 2022 freigeschaltet.

Es ermöglicht die Einbindung eines statischen Kartenausschnittes mit Markierungen in eine Wiki-Seite.

Die Syntax ist analog zu maplink; mit Ausnahme der hier fehlenden Linkbeschriftung text=. Zusätzliche Parameter sind:

height

Höhe des Ausschnitts in Pixeln

width

Breite des Ausschnitts in Pixeln

Beispiel

Der zugehörige Quellcode lautet:

<mapframe latitude="48.856667" longitude="2.351667" lang="fr" zoom="5" width="400" height="300">
{
  "type": "FeatureCollection",
  "features": [
    { "type": "Feature",
      "properties": {},
      "geometry": {
        "type": "Point",
        "coordinates": [
          2.351667,
          48.856667    ]
                  }
    }
              ]
}
</mapframe>

Das Element kann auch ohne JSON-Inhalt (also „unary“) verwendet werden. In diesem Fall ist nur eine einzige direkt angegebene Position möglich, und als Karte wird die Standard-Karte Spezial:Map mit den spezifizierten Koordinaten und dem Zoom-Faktor verwendet.

Spezial:Map

Die Erweiterung stellt auch die Spezialseite Spezial:Map bereit. Diese kennt folgende Parameter:

/zoom

/latitude

/longitude

Hier ist nur der Kartenmittelpunkt und der Ausschnitt anhand des Zoomfaktors bekannt; alle Einzelheiten gehen verloren.

Hilfsmittel und Hilfen

Vereinfachte Handhabung per Vorlage

Die Erzeugung der Syntax kann mit Hilfe der Vorlage:maplink deutlich vereinfacht werden, es müssten nur ausgewählte Parameter angegeben werden. Insbesondere kann mittels Wikidata sehr einfach auf bereits existierende Daten und Koordinaten zurückgegriffen werden. Die Vorlage kombiniert dabei die Funktionalitäten von <maplink> und <mapframe>, sodass Karten mitsamt Untertitel erzeugt werden können.

Debugger / Validierer

Die syntaktische Gültigkeit des Codes kann vor dem Speichern überprüft werden.

Speziell für JSON-Code eignet sich:

• jsonlint.com – der Code kann auf diese Seite kopiert werden und zeigt die fehlerhaften Zeilen.

Jeder andere JavaScript-Validierer kann ebenso zur ersten Fehlersuche verwendet werden.

• jshint.com – Gleiches Prinzip; Analyse mittels JSHint.

Wartung

Es gibt die Kategorie:Wikipedia:Seite mit Karte, in die vom System alle Seiten mit Karten eingeordnet werden.

Die Verwendung von Kartographer in dieser Wikipedia wird außerdem unter Special:PagesWithProp/kartographer protokolliert.

Weitere Informationen

• Hilfe:Kartographer/VisualEditor – Beschreibung der Bearbeitung mit dem VisualEditor.
• Wikipedia:Kartensaison/Kartographer – Ausführliche Beschreibung mit Beispielen

MediaWiki: Help:Extension:Kartographer/Getting started/de – Erste Schritte mit dem Kartographer

MediaWiki: Help:Extension:Kartographer/de – Ausführliche technische Informationen

Phabricator – Workboard: #Kartographer (englisch)

• Phabricator – Quellcode: EKAR/*

Extern (englisch):

• geojson.org
• H. Butler, M. Daly, A. Doyle, S. Gillies, S. Hagen, T. Schaub: RFC 7946 – The GeoJSON Format [Errata: RFC 7946]. August 2016 – Standard: [Internet Standards Track] (28 Seiten, englisch).