Vorlage:Marker

Dokumentation für die Vorlage {{Marker}}[Ansicht] [Bearbeiten] [Versionsgeschichte] []

Hinweis

Wenn Daten aus Wikidata bezogen werden, ist es zwar nicht nötig, den Namen der Einrichtung anzugeben. Für eine bessere Lesbarkeit der Vorlage im Quelltext sollte der Name jedoch angegeben werden, da sich der Name nicht aus der Qualifikator-Id erschließt.

Funktionsbeschreibung

Wartung

Fehler bei der Nutzung der Vorlage Marker werden in der Wartungskategorie Wartung vCard angezeigt.

• Funktion: Diese Vorlage nummeriert automatisch Marker und Auflistungen (Points of Interest), wenn geografische Koordinaten (Latitude und Longitude) vorliegen. Der Einsatz erfolgt als Teil einer Textzeile (in-line).

• Verwendung: {{marker|type=|name=|lat=|long=}}

• Erforderliche Parameter:
  • |type= Typ der Einrichtung (u. a. see, do, buy, eat, drink, go, sleep, other, listing, around, city, vicinity). Dieselbe Liste wie bei der Vorlage {{vCard}}. Legt die Hintergrundfarbe des Markers fest. Die Typbezeichnung besteht aus Kleinbuchstaben und einem bzw. mehreren Leerräumen.
  • |name= Name der Einrichtung, Anzeige im Text. Der Name darf keine HTML-Tags oder Anführungszeichen " enthalten. Typografische Anführungszeichen sind möglich. Wenn der Name dekliniert ist, kann mit dem alt-Parameter die Nennform angegeben werden. Die Anzeige auf der Karte erfolgt nur, wenn kein alt-Parameter angegeben wurde.
  • |lat= Breitenangabe (Latitude) der Einrichtung, gültiger Bereich: -90.0 bis 90.0. Um Rechenzeit zu sparen, sollte die Koordinate in Dezimalform und nicht in der Form Grad-Minuten-Sekunden angegeben werden.
  • |long= Längenangabe (Longitude) der Einrichtung, gültiger Bereich: -180.0 bis 180.0. Um Rechenzeit zu sparen, sollte die Koordinate in Dezimalform und nicht in der Form Grad-Minuten-Sekunden angegeben werden.

Gemeldet in Phabricator (?)
Task T181604

• Optionale Parameter:
  • |name-extra= Namensergänzung, die nicht Bestandteil des Namens ist. Wird an den Namen angefügt.
  • |alt= Name der Einrichtung für die Anzeige auf der Karte. Der Name darf keine HTML-Tags oder Anführungszeichen " enthalten. Typografische Anführungszeichen sind möglich. Der Name wird nicht im Text angezeigt, sondern dient als Nennform für die möglicherweise deklinierte Form des Namens name.
  • |zoom= Zoomlevel der Karte, die beim Anklicken des Textmarkers angezeigt wird. Standard: 17, gültiger Bereich: 1 bis 18 (1 = Erde, 18 = Teil einer Stadt: Gebäude).
  • |url= URL der Einrichtung, deren Name entsprechend verlinkt wird. url = n unterdrückt die Ausgabe einer aus Wikidata bezogenen URL.
  • |image= Name einer Datei, die als verkleinertes Vorschaubild genutzt wird, wenn man den Kartenmarker anklickt. Ein vorangestellter "Datei:"-Präfix ist nicht nötig.
  • |text= Wiki-Text, der anstelle der automatisch generierten Zahl bzw. Buchstaben oder der Koordinate im Kartenlink angezeigt wird. Könnte auch ein Bild enthalten.
  • |symbol= Das Symbol kann unterschiedliche Bedeutung haben.
    • number, letter, Standard ist number. Bewirkt eine automatische Nummerierung.
    • Genau ein alphanumerisches Zeichen 0–9, A–Z. Marker und Karten-Pinnadel erhalten die Symbolbeschriftung. Es erfolgt jedoch keine Prüfung, ob das Symbol bereits bei einer automatischen Nummerierung vergeben wurde. Wird meist verwendet, um ein Marker-Duplikat anzulegen.
    • Symbol kann auch ein Maki Icon sein. Wenn Symbol fehlt, wird automatisch in Abhängigkeit von type nummeriert. symbol besteht nur aus Kleinbuchstaben und dem Bindestrich. Ziffern sind nicht zulässig. Ist der Symboltyp unbekannt, also auch kein gültiges Maki-Symbol, so wird ein Fehlermarker in der Farbe Fuchsia mit einem Kreuz ausgegeben. Mögliche Maki-Symbole können der Modul-Datei Maki icons entnommen werden. Ein Symbolbild kann im Parameter text eingetragen werden. Interimslösung: Wenn der Text leer ist, wird auf dem Marker der erste Buchstabe des symbol-Namens als Großbuchstabe mit einem blauen Pushpin-(Pinnnadel)-Symbol ausgegeben. Wenn auf Commons die Maki-Symbole verfügbar sein werden, so werden dann diese ausgegeben.
  • |format= bewirkt eine unterschiedliche Formatierung
    • |format=f0 stellt das Markersymbol und den Namen dar. Dies ist das Standard-Format und kann weggelassen werden.
    • |format=f1 stellt das Markersymbol, den Namen und die zugehörige Koordinate in Klammern dar.
    • |format=f2 stellt nur das Markersymbol dar.
    • |format=f3 stellt das Markersymbol und die zugehörige Koordinate dar.
  • |wikidata= Wenn ein gültiger Wikidata-Qualifikator vorliegt, wird versucht, fehlende Angaben für Name, Koordinaten, Bild und Typ aus Wikidata zu beziehen.
  • |commonscat= definiert eine Commons-Kategorie mit Medien zur Einrichtung. Der Parameter sollte nur verwendet werden, wenn es keinen Wikidata-Eintrag gibt.
  • |group= überschreibt die automatisch bestimmte Gruppenzugehörigkeit zu buy (Einkaufen), do (Aktivitäten), drink (Ausgehen), eat (Küche), go (Anreise), see (Sehenswürdigkeiten) und sleep (Unterkunft) für das POI-Symbol. Standard ist eine leere Eingabe.
  • |map-group= Gruppenname einer Karte. Diese Parameter wird im Allgemeinen nur genutzt, wenn mehrere Karten in einem Artikel verwendet werden, um die Zugehörigkeit von {{Marker}}n oder {{vCard}}s zu einer bestimmten Karte auszuweisen. Die Vorlage {{Marker}} unterstützt den Parameter map-group nur aus diesem Grund. Die Markerfarbe wird über den Parameter type vermittelt.
  • |no-gpx= j/y unterdrückt die Ausgabe in einer GPX-Datei. Üblicherweise zusammen mit symbol = [1-9A-Z], um Duplikat zu unterdrücken.
  • |styles= Zusätzliche CSS-Stilanweisungen für den Namen. Es werden zusätzlich die Kurzbezeichner normal und italic (kursiv) unterstützt.

Für den Parameter group können auch noch folgende Farbwerte genutzt werden:

	Name	Wert		Name	Wert		Name	Wert
	cosmos	#FFCFCF		gold	#FFD700		lime	#BFFF00
	magenta	#FF00FF		mediumaquamarine	#66CDAA		orange	#FFA500
	plum	#DDA0DD		purple	#800080		red	#FF0000
	silver	#C0C0C0

• Rückwärtskompatibilität zur Vorlage {{Poi}}
  • |format=f2 bewirkt dieselbe Funktionsweise wie die Vorlage Poi. |url wird dann ignoriert.

• Microformat:
  • Die Vorlage setzt das h-card microformat, microformats2, ein.

• Beispiele:

Syntax	Ergebnis
{{marker | type = museum | name = Museum | lat = 51.47766 | long = 0.00115 }}	51.477660.001151 Museum
{{marker | type = museum | name = [[Kairo/Ägyptisches Museum|Ägyptisches Museum]] | lat = 30.047778 | long = 31.233333 | url = http://www.sca-egypt.org/eng/MUS_Egyptian_Museum.htm }}	30.04777831.2333332 Ägyptisches Museum
{{marker | type = museum | name = Museum | lat = 51.47766 | long = 0.00115 | symbol = letter }}	51.477660.00115A Museum
{{marker | type = theme park | name = Themenpark | lat = 51.47766 | long = 0.00115 | image = Beispiel.jpg | zoom = 15 | url = http://www.beispiel.com/ }}	51.477660.001151 Themenpark
{{marker | type = museum | name = Koptisches Museum | lat = 30.0058 | long = 31.2303 | format = f1 }}	30.005831.23033 Koptisches Museum (30° 0′ 21″ N 31° 13′ 49″ O)
{{marker | type = museum | name = Koptisches Museum | lat = 30.0058 | long = 31.2303 | format = f2 }}	30.005831.23034Koptisches Museum
{{marker | type = museum | name = Koptisches Museum | lat = 30.0058 | long = 31.2303 | format = f3 }}	30.005831.23035 30° 0′ 21″ N 31° 13′ 49″ OKoptisches Museum
{{marker | wikidata = Q82425 }}	52.51627222222213.3777222222226 Brandenburger Tor
{{marker | wikidata = Q668382 | format = f1 }}	51.42388888888912.2363888888891 Flughafen Leipzig/Halle (51° 25′ 26″ N 12° 14′ 11″ O)
{{marker | type = lime | symbol = 8 | name = Sehenswürdigkeit | name-extra = 3* | lat = 15.47766 | long = 0.00115}}	15.477660.001158 Sehenswürdigkeit 3*
{{marker | type = airport | symbol = airport | name = Flughafen Kairo | lat = 30.12194 | long = 31.40556 }}	30.1219431.40556 Flughafen Kairo
{{marker | type = airport | styles = italic | name = Flughafen Kairo | lat = 30.12194 | long = 31.40556 }}	30.1219431.405562 Flughafen Kairo
{{marker | type = lime | symbol = museum | name = Kunstmuseum | lat = 51.47766 | long = 0.00115}}	51.477660.00115M Kunstmuseum
{{marker | type = lime | symbol = unbekanntes-symbol | name = Kunstmuseum | lat = 51 | long = 0}}	510 Kunstmuseum
{{marker | type = | name = Unbekannte Einrichtung ohne Typ | lat = 52 | long = 0}}	5201 Unbekannte Einrichtung ohne Typ

Bezug von Daten aus Wikidata

Die Vorlage Marker kann Daten auch aus Wikidata beziehen. Der Parameter wikidata muss dann zwingend gesetzt sein.

• Erforderlicher Parameter:
  • |wikidata= Wikidata-Datenobjekt. Wenn nicht überschrieben, werden die Koordinate, der Typ und die die Interwikilinks (Wikipedia, Commons, Wikidata) aus Wikidata übernommen.

• Optionale Parameter:
  • |auto= j, ja, y, yes. Alle weiteren in Wikidata verfügbaren Werte werden übernommen.
  • |param= j, ja, y, yes. Der Parameter param wird aus Wikidata übernommen, falls vorhanden. Wird benutzt, wenn auto = y nicht gesetzt wurde.
  • |param= n, no, nein. Der Parameter param wird in keinem Fall aus Wikidata übernommen, auch wenn er vorhanden sein sollte. Wird benutzt, wenn auto = y gesetzt wurde.

Verwandte Vorlagen und Module

• Vorlage:vCard – für eine vollständige Beschreibung der Einrichtung.
• Vorlage:Mapframe – Fügt Karte in den Artikel ein.
• Modul:Map erzeugt ein passendes <maplink>-Tag

Verfügbare Maki-Symbole

Nachfolgend findet sich eine Liste von Maki-Symbolen in der Version Maki 0.5.0, wie sie für die Verwendung in Kartographer-Karten zur Verfügung gestellt wurden. Nicht alle Symbole sind verfügbar (siehe auch Task T141304 und Task T156452). Die aktuelle Maki-Version ist 4.0.0 (Januar 2017).

TemplateData

Formatierung eines Karten-Markers

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Name	name	Bezeichnung der Einrichtung. Kann auch dekliniert sein.	Zeichenfolge	erforderlich
Namensergänzung	name-extra	Namensergänzung, die nicht Namensbestandteil ist. Dies können z. B. auch Symbolbilder sein.	Zeichenfolge	optional
Alternativer Name	alt	Alternative Bezeichnung in der nicht deklinierten Nennform der Einrichtung für die Anzeige auf der Karte.	Zeichenfolge	optional
Datenobjekt	wikidata	Nummer des Wikidata-Datenobjekts.	Zeichenfolge	optional
Commons-Kategorie	commonscat	Die Commons-Kategorie mit Medien zur Einrichtung sollte nur angegeben werden, wenn es keinen Wikidata-Eintrag gibt.	Zeichenfolge	optional
Typ	type counter	Eine vorgegebene Typbezeichnung eingeben.	Zeichenfolge	erforderlich
URL	url	Webadresse der Einrichtung.	Zeichenfolge	optional
Geografische Breite	lat	Geografische Breite der Position der Einrichtung.	Zeichenfolge	erforderlich
Geografische Länge	long	Geografische Länge der Position der Einrichtung.	Zeichenfolge	erforderlich
Bild zum POI	image	Bild zum POI.	Zeichenfolge	optional
Zoom-Level	zoom	Zoom-Level der darzustellen Karte zwischen 0 und 19. Standard ist 17.	Nummer	optional
Symbol	symbol	Symboltyp number, letter oder der Name eines Maki-Symbols. Standard ist number.	Zeichenfolge	optional
Text	text	Wiki-Text, der anstelle der automatisch generierten Zahl bzw. Buchstaben oder der Koordinate im Kartenlink angezeigt wird. Könnte auch ein Bild enthalten.	Zeichenfolge	optional
Markerformatierung	format	Legt die Darstellung von Markersymbol und Namen fest. Mögliche Werte sind f0 (Standard: Marker und Name), f1 (Marker, Name und (Koordinate)), f2 (nur Marker) und f3 (Marker und Koordinate).	Zeichenfolge	optional
POI-Gruppe	group	Wert überschreibt die automatische ermittelte Gruppenzugehörigkeit z. B. mit buy, do, drink, eat, go, see oder sleep	Zeichenfolge	optional
Kartengruppe	map-group	Die Angabe wird nur gebraucht, wenn Marker auf unterschiedliche Karten verteilt werden sollen.	Zeichenfolge	optional
GPX-Ausgabe	no-gpx	Der Wert j/y für ja verhindert die Ausgabe der Marker-Angaben in eine GPX-Datei.	Zeichenfolge	optional

Die vorstehenden Angaben wurden aus TemplateData-Informationen generiert.

Hinweise

• Die obige Dokumentation wurde aus der Seite Vorlage:Marker/Doku eingefügt. (bearbeiten | Versionsgeschichte) Die Kategorien für diese Vorlage sollten in der Dokumentation eingetragen werden. Die Interwiki-Links sollten auf Wikidata eingepflegt werden.
• Zur Vorlage gibt es eine XML-Beschreibung für die Vorlageneingabe mit Formularen.
• Liste der Unterseiten