Hilfe:Kartographer

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen

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.

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.

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
<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

Wikisyntax: <tag>

<mapframe>

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
Karte

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.

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

[Bearbeiten | Quelltext bearbeiten]

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.

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

[Bearbeiten | Quelltext bearbeiten]
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)

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).