Hilfe:Kartographer

aus Wikipedia, der freien Enzyklopädie
Wechseln zu: Navigation, Suche

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 am 7. September 2016 auf allen Projekten freigeschaltet.

Ein weiteres Element <mapframe> würde die Einbindung eines Kartenausschnittes in eine Wiki-Seite ermöglichen.

maplink[Bearbeiten | Quelltext bearbeiten]

Die Wirkung ist die Generierung einer Verlinkung auf eine Karte im Vollbildmodus, ggf. mit eingezeichneten Positionen.

Bei Benutzern mit aktiviertem JavaScript (bei dir ist JavaScript momentan nicht aktiviert) wird die generierte Karte der bisher betrachteten Wiki-Seite überlagert; die URL bleibt unverändert (abgesehen von einem angehängten Fragment).

Ohne JavaScript wird eine Verlinkung mit der Spezialseite erzeugt; genauer: diese wird immer vom Server ausgeliefert, jedoch mittels JavaScript durch die überlagerte Karte ersetzt.

Syntax[Bearbeiten | Quelltext bearbeiten]

Das Element <maplink> kann mit Parametern verwendet werden:

alt
Alternativtext
class
Universalparameter
group
Nur auf Wikivoyage freigeschaltet.
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[Bearbeiten | Quelltext bearbeiten]

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

Das Element <mapframe> ist nicht freigeschaltet.

Es würde die Einbindung eines Kartenausschnittes in die Wiki-Seite ermöglichen.

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

Spezial:Map[Bearbeiten | Quelltext bearbeiten]

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]

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.

Wartung[Bearbeiten | Quelltext bearbeiten]

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 – Technische Informationen (englisch)
Phabricator – Workboard: #Kartographer (englisch)

Extern (englisch):