Vorlage:Marker/Doku

Hinweise

• Die Vorlage Marker soll ausschließlich für geografische Objekte benutzt werden, und auch nur dann, wenn die Koordinate bekannt ist. Sie dienen der Darstellung auf dynamischen Karten. In allen anderen Fällen kann die Vorlage {{Sitelinks}} eingesetzt werden.
• 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.

Alternative Vorlagen:

• {{Sitelinks}}
• {{vCard}}

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) für die Darstellung auf einer dynamischen Karte, wenn geografische Koordinaten (Latitude und Longitude) vorliegen. Der Einsatz erfolgt als Teil einer Textzeile (inline) im Gegensatz zur Vorlage {{vCard}}, die einen ganzen Absatz einnimmt (block).

• Verwendungsbeispiel: {{marker|type=|name=|lat=|long=|wikidata=}}

• Erforderliche Parameter:
  • |name= Name der Einrichtung, Anzeige im Text. Der Name darf nur druckbare Zeichen, aber keine Anführungszeichen ", Steuerzeichen, Vorlagen, HTML-Tags und nach Möglichkeit keine SGML-Entitäten und XML-Zeichenreferenzen enthalten. Typografische Anführungszeichen sind möglich. Wenn der Name dekliniert ist, kann mit dem name-map-Parameter die Nennform angegeben werden. Die Anzeige auf der Karte erfolgt nur, wenn kein name-map-Parameter angegeben wurde. Für den Namen ist nur die Verlinkung zu Artikeln in der Form [[name1|name2]] erlaubt, wobei die Verlinkung über den gesamten Namen reichen muss. Textteile davor und dahinter werden abgeschnitten. Der Name kann jedoch um den Wert in name-extra erweitert werden. Für die Gestaltung des Namens steht der Parameter styles zur Verfügung. Sternchen sind nicht erlaubt.
  • |type= Typ der Einrichtung (z. B. hotel, restaurant, nature reserve). In der Vorlage {{vCard}} werden dieselben Typen verwendet. Der Typ legt die Hintergrundfarbe des Markers fest. Die Typbezeichnung kann Leerräume enthalten. Groß-/Kleinschreibung wird nicht unterschieden. Der Typ sollte auch bei vorhandener wikidata-Angabe spezifiziert werden, um Rechenzeit zu sparen. Alle verfügbaren Typen sind in einer Tabelle aufgelistet. Für einige Typen können auch Alias-Begriffe verwendet werden: z. B. für bus auch bus stop. Der Typ kann auch aus einer Komma-separierten Aufzählung mehrerer Einzeltypen bestehen. Farben sind als Typen nicht möglich. Farbbestimmend ist der erste Typ. Beispiele:
    • type = observatory
    • type = restaurant, bar, cafe
  • |types= Alias für type.
  • |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.
    • |latitude= Alias für lat.
    • |coord= Alias für lat.
  • |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.
    • |lon= Alias für long.
    • |longitude= Alias für long.

Gemeldet in Phabricator (?)
Task T181604

• Optionale Parameter:
  • |name-map= Name der Einrichtung für die Anzeige auf der Karte. Der Name darf keine HTML-Tags, Sternchen 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.
  • |name-extra= Namensergänzung, die nicht Bestandteil des Namens ist und keine Sternchen enthalten darf. Sie wird an den Namen angefügt. Der Hauptanwendungszweck ist das Anfügen von Haltestellenschildern oder Verkehrsliniensymbolen, wobei die Formatierung des Namens auch für die Erweiterung verwendet wird.
  • |name-local= Name der Einrichtung in einer Landessprache. Mit name-local = y wird der Name aus Wikidata bezogen.
  • |name-latin= Name der Einrichtung in der Umschrift der Landessprache.
  • |alt= Alternative Bezeichnung(en). Sternchen sind nicht erlaubt. Der Parameter sollte nicht für die Angabe des Namens der Einrichtung in der Landessprache benutzt werden. Hierfür gibt es den Parameter name-local.
  • |url= URL der Einrichtung, deren Name entsprechend verlinkt wird. Dies darf nicht die URL eines Social-Media-Dienstes sein. 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. Groß-/Kleinschreibung wird nicht unterschieden.
    • 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.
  • |show= Legt den Anzeigemodus fest. Mögliche Werte sind: poi (nur Poi, Standard), all, coord (nur Koordinate), none (keine Koordinate), symbol (Symbol anstelle einer Nummer), noname (ohne Namen), nositelinks, socialmedia (Linksymbole für soziale Medien) und wikilink. Groß-/Kleinschreibung wird nicht unterschieden.
  • |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 Marker-Symbol. Standard ist eine leere Eingabe.
  • |map-group= Gruppenname einer Karte. Diese Gruppen-Namen dürfen nur aus Buchstaben und den Ziffern 0–9 bestehen. 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.
  • |zoom= Zoomlevel der Karte, die beim Anklicken des Textmarkers angezeigt wird. Standard: 17, gültiger Bereich: 1 bis 19 (1 = Erde, 19 = Teil einer Stadt: Gebäude).
  • |wikidata= Wenn ein gültiger Wikidata-Qualifikator vorliegt, wird versucht, fehlende Angaben für Name, Koordinaten, Bild und Typ aus Wikidata zu beziehen. Der Parameter muss zwingend gesetzt sein, wenn Daten aus Wikidata bezogen werden sollen.
  • |id= Anker-Id. Ist nur notwendig, wenn wikidata nicht gesetzt wurde und der Anker wirklich benötigt wird. Es sollte vorab ein Eintrag in Wikidata geprüft werden.
  • |commonscat= definiert eine Commons-Kategorie mit Medien zur Einrichtung. Der Parameter sollte nur verwendet werden, wenn es keinen Wikidata-Eintrag gibt.
  • |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, inherit (geerbt), italic (kursiv), kursiv und station (Text mit Rahmen) unterstützt.

• Optionale Parameter in der Testphase:
  • |copy-marker= Fügt eine Marker-Kopie anstelle des Markers ein. Der Wert kann eine Wikidata-Q-Id oder ein Name einer Einrichtung sein.
  • |country= Landesbezeichnung als ISO-3155-Code (z. B. de). Wird nur selten benötigt, wenn es keine andere Quelle für das Land der Einrichtung gibt. Kann z. B. in Themenartikeln oder in historischen Regionen geschehen, bei denen in Wikidata keine Landesangabe hinterlegt ist.
  • |status= Kommaseparierte Liste mit Statusangaben zum Artikel (stub, outline, ... guide, star, class-1 ...) oder zum Reiseziel (top-sight). Diese Angaben werden als Symbol vor dem Markersymbol positioniert. Groß-/Kleinschreibung wird nicht unterschieden.

show-Parameter

• copy: Der Parameter wikidata wird benutzt, um einen Marker als Markerkopie auszuweisen. D. h., wikidata muss gesetzt sein!
• noairport: Die Flughafencodes werden unterdrückt.
• noname: Die Namensbezeichnungen einschließlich der Interwiki- und Social-Media-Links werden unterdrückt. Es sind dann nur Marker und/oder Koordinate zu sehen.
• nositelinks: Es werden keine Interwiki-Sitelink-Symbole ausgegeben.
• socialmedia: Es werden zusätzlich Social-Media-Symbole ausgegeben.
• symbol: Anstelle einer Nummer wird ein Symbol auf dem Marker angegeben.
• wikilink: Der aus Wikidata stammende Weiterleitungs-Link zu einem Wikivoyage-Artikel wird unterdrückt. Dies ist sinnvoll für den Fall, dass eine Weiterleitung aus Wikidata bezogen wurde, die zu einer Artikel-Selbstreferenz führen würde. Siehe auch Kategorie:VCard: Artikellink ist Weiterleitung.

Eingesetzte Farben

Die Standardfarben für die einzelnen Abschnitte bzw. allgemeinen Gruppen sind:

	Name	Wert		Name	Wert		Name	Wert
	area Gebiet	#800000		eat Küche	#D2691E		populated Besiedelt	#0000FF
	buy Einkaufen	#008080		error Fehler	#FF00FF		see Sehenswert	#4682B4
	do Aktivitäten	#808080		go Anreise	#A52A2A		sleep Unterkunft	#000080
	drink Ausgehen	#000000		other Anderes	#FFD700		view Aussicht	#4169E1

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
	mediumaquamarine	#66CDAA		orange	#FFA500		plum	#DDA0DD
	purple	#800080		red	#FF0000		silver	#C0C0C0

Beispiele

Syntax	Ergebnis
{{marker | type = museum | name = Museum | lat = 51.17766 | long = 0.00115 }}	51.177660.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.27766 | long = 0.00115 | symbol = letter }}	51.277660.00115A Museum​
{{marker | type = theme park | name = Themenpark | lat = 51.37766 | long = 0.00115 | image = Beispiel.jpg | zoom = 15 | url = http://www.beispiel.com/ }}	51.377660.001151 Themenpark​
{{marker | wikidata = Q82425 }}	52.51627222222213.3777222222223 Brandenburger Tor​ ​
{{marker | wikidata = Q151356 | name-map = Fernsehturm Berlin }}	52.52083333333313.4094444444444 Berliner Fernsehturm​ ​
{{marker | wikidata = Q668382 | show = all }}	51.42399166666712.2363833333331 Flughafen Leipzig/Halle​ (IATA: LEJ) ​ (51° 25′ 26″ N 12° 14′ 11″ O)
{{marker | wikidata = Q668382 | url = n | show = all }}	51.42399166666712.236383333333 Flughafen Leipzig/Halle​ (IATA: LEJ) ​ (51° 25′ 26″ N 12° 14′ 11″ O)
{{marker | wikidata = Q668382 | show = noairport }}	51.42399166666712.236383333333 Flughafen Leipzig/Halle​ ​
{{marker | wikidata = Q20949716 | show = socialmedia }}	30.04288431.232211 InterContinental Cairo Semiramis​ ​
{{marker | type = museum | group = 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 | show = symbol | name = Flughafen Kairo | lat = 30.12194 | long = 31.40556 }}	30.1219431.40556 Flughafen Kairo​
{{marker | name = Kölner Dom | wikidata = Q4176 | show = symbol }}	50.9413888888896.9583333333333 Kölner Dom​ ​
{{marker | type = airport | styles = italic | name = Flughafen Luxor | lat = 25.670833 | long = 32.706389 }}	25.67083332.7063892 Flughafen Luxor​
{{marker | type = subway | name = Liverpool Street | name-extra = [[Datei:Underground no-text.svg|14px|baseline]] | wikidata = Q801124 | styles = station }}	51.5186-0.08133 Liverpool Street ​ ​
{{marker | type = museum | 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​

Abhängigkeiten von show

Koordinaten

show	Ansicht
- poi	30.005831.23035 Koptisches Museum​
all poi, coord	30.005831.23036 Koptisches Museum​ (30° 0′ 21″ N 31° 13′ 49″ O)
noname poi, noname	30.005831.2303Koptisches Museum7​
all, noname poi, coord, noname	30.005831.2303Koptisches Museum8​ 30° 0′ 21″ N 31° 13′ 49″ O
coord	30.005831.2303Koptisches Museum​ (30° 0′ 21″ N 31° 13′ 49″ O)
coord, noname	30.005831.2303Koptisches Museum30° 0′ 21″ N 31° 13′ 49″ O
none none, noname	30.005831.2303Koptisches Museum​

Mit Einsatz von Wikidata

show	Ansicht
socialmedia	28.557477.08334 Flughafen in Delhi​ (IATA: DEL) ​
noairport	28.557477.0833 Flughafen in Delhi​ ​

Hinweise

Anmerkugen

• Rückwärtskompatibilität zur einstigen Vorlage Poi
  • |show=noname bewirkt dieselbe Funktionsweise wie die Vorlage Poi. |url wird dann ignoriert.

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

Bezug von Daten aus Wikidata

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

• Erforderlicher Parameter:
  • |wikidata= Wikidata-Datenobjekt. Wenn nicht überschrieben, werden der Name, die Koordinate, der Typ, der Weblink, die Flughafencodes, das Bild, die Interwikilinks (Wikipedia, Commons, Wikidata) und die Links zu Social-Media-Diensten aus Wikidata übernommen.

• Optionale Parameter:
  • |param= j, ja, y, yes. Der Parameter param wird aus Wikidata übernommen, falls vorhanden.
  • |param= n, no, nein. Der Parameter param wird in keinem Fall aus Wikidata übernommen, auch wenn er vorhanden sein sollte.

• Standardwerte:
  • |image= yes
  • |url= yes

• Ausschließlicher Bezug über Wikidata:
  • iata, icao: werden immer automatisch aus Wikidata bezogen und dargestellt.
  • facebook, flickr, instagram, twitter, youtube: werden nur mit show = socialmedia aus Wikidata bezogen und dargestellt.

Besonderheiten Bezug von Werten

Die Flughafencodes IATA und ICAO sowie die Links zu Social-Media-Diensten werden ausschließlich aus Wikidata bezogen. Die Flughafencodes werden automatisch an den Namen angefügt. Die Links zu Social-Media-Diensten werden hinter den Schwesterprojekt-Symbolen angefügt, wenn show = socialmedia gesetzt wurde.

Unterdrückung von Flughafencodes

Im Fall von Flughäfen wird in Anlehnung zur Vorlage {{vCard}} der Flughafencode automatisch hinter den Namen des Flughafens und den Schwesterprojekt-Links angefügt. Mit show = noairport lässt sich die Ausgabe des Flughafencodes unterdrücken.

Verfügbare Maki-Symbole

Nachfolgend findet sich eine Liste von Maki-Symbolen in der Version Maki 7.2, wie sie für die Verwendung in Kartographer-Karten zur Verfügung gestellt wurden.

Stilvorlagen

• Vorlage:VCard/styles.css

Technische Dokumentation

• Wikivoyage:Marker – Die Seite enthält eine technische Dokumentation zum Marker. Dort sind unter anderem abhängige Module für die Konfiguration und die vom Marker verwendeten CSS-Klassen angegeben.

Siehe auch

Verwandte Vorlagen

• Vorlage:Marker Kopie - mehrfaches Setzen eines Markers in einem Artikel
• Vorlage:VCard – für eine vollständige Beschreibung der Einrichtung.
• Vorlage:Mapframe – Fügt eine Karte in den Artikel ein.
• Vorlage:Sitelinks – Angabe der Schwesterprojektlinks als Symbole.

Hilfeartikel

• Hilfe:Marker – Hilfeartikel zum Setzen von Markern.
• Hilfe:Erstellen einer VCard – Hilfeartikel zum Erzeugen von VCards.
• Hilfe:Symbole – Hilfe zu Symbolen in Artikeln.

TemplateData

Formatierung eines Karten-Markers

Vorlagenparameter[Vorlagendaten bearbeiten]

Diese Vorlage bevorzugt Inline-Formatierung von Parametern.

Parameter		Beschreibung	Typ	Status
Name	name	Bezeichnung der Einrichtung. Kann auch dekliniert sein. Die Bezeichnung darf nur druckbare Zeichen, aber keine Steuerzeichen, Vorlagen und HTML-Tags enthalten.	Mehrzeiliger Text	erforderlich
Namensergänzung	name-extra	Namensergänzung, die nicht Namensbestandteil ist. Dies können z. B. auch Symbolbilder sein.	Mehrzeiliger Text	optional
Name in Landessprache	name-local	Genaue Bezeichnung der Einrichtung in der Landessprache. Zusätzlich zum Namen.	Mehrzeiliger Text	optional
Name in Umschrift	name-latin	Genaue Bezeichnung der Einrichtung in der Umschrift der Landessprache.	Mehrzeiliger Text	optional
Alternativer Name für die Anzeige auf der Karte	name-map	Alternative Bezeichnung in der nicht deklinierten Nennform der Einrichtung für die Anzeige auf der Karte.	Mehrzeiliger Text	optional
Alternativer Name	alt	Alternative Bezeichnung der Einrichtung. Nicht für den namen in der Landessprache gedacht.	Mehrzeiliger Text	optional
Datenobjekt	wikidata	Nummer des Wikidata-Datenobjekts.	Mehrzeiliger Text	optional
Anker-Id	id	Ist nur notwendig, wenn wikidata nicht gesetzt wurde und der Anker wirklich benötigt wird	Mehrzeiliger Text	optional
Commons-Kategorie	commonscat	Die Commons-Kategorie mit Medien zur Einrichtung sollte nur angegeben werden, wenn es keinen Wikidata-Eintrag gibt.	Mehrzeiliger Text	optional
Typ	type types	Eine vorgegebene Typbezeichnung eingeben. Farben sind als Typen nicht möglich.	Mehrzeiliger Text	erforderlich
URL	url	Webadresse der Einrichtung. Dies darf nicht die URL eines Social-Media-Dienstes sein.	Mehrzeiliger Text	optional
Geografische Breite	lat latitude coord	Geografische Breite der Position der Einrichtung.	Mehrzeiliger Text	erforderlich
Geografische Länge	long lon longitude	Geografische Länge der Position der Einrichtung.	Mehrzeiliger Text	erforderlich
Bild zum Marker	image	Bild zum Marker.	Mehrzeiliger Text	optional
Zoom-Level	zoom	Zoom-Level der darzustellen Karte zwischen 0 und 19. Standard ist 17.	Zahlenwert	optional
Symbol	symbol	Symboltyp number, letter oder der Name eines Maki-Symbols. Standard ist number.	Mehrzeiliger Text	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.	Mehrzeiliger Text	optional
Anzeigemodus	show	Legt fest, ob POIs, Koordinaten und der Name angezeigt werden sollen. Mögliche Werte sind all (Standard), poi, coord, none, noname, nositelinks, nowikilink, symbol und socialmedia. Nur nötig, wenn der Anzeigemodus vom Standard (meist „nur Poi und Name“) abweicht. Wenn show eingesetzt wird, wird die Markerformatierung ignoriert.	Mehrzeiliger Text	optional
Marker-Gruppe	group	Wert überschreibt die automatische ermittelte Gruppenzugehörigkeit z. B. mit buy, do, drink, eat, go, see oder sleep	Mehrzeiliger Text	optional
Kartengruppe	map-group	Die Angabe wird nur gebraucht, wenn Marker auf unterschiedliche Karten verteilt werden sollen.	Mehrzeiliger Text	optional
GPX-Ausgabe	no-gpx	Der Wert j/y für ja verhindert die Ausgabe der Marker-Angaben in eine GPX-Datei.	Mehrzeiliger Text	optional
CSS-Stilanweisungen	styles	Zusätzliche CSS-Stilanweisungen für den Namen. Es werden zusätzlich die Kurzbezeichner normal, inherit (geerbt), italic (kursiv), kursiv und station (Text mit Rahmen) unterstützt. Beispiel color: #ff0000	Mehrzeiliger Text	optional