Vorlage:Marker

![]() |
Diese Vorlage wird auf vielen Seiten benutzt, und Änderungen werden projektweit sofort wahrgenommen. Bitte teste Änderungen vorher im /Sandkasten oder in deinem Benutzernamensraum. Die getestete Änderung sollte dann in einem einzigen Edit auf dieser Seite eingefügt werden. Bitte diskutiere Änderungen zuerst auf der Diskussionsseite bevor du sie implementierst. |
![]() |
Diese Vorlage benutzt Modul:Marker, Skripte geschrieben in der Programmiersprache Lua. Bitte informiere dich dort, wenn du mehr über die Sprache und ihren Einsatz erfahren willst. Diese Vorlagen sollte im Regelfall nicht ersetzt werden. |
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
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 keine HTML-Tags oder Anführungszeichen " enthalten. Typografische Anführungszeichen sind möglich. Wenn der Name dekliniert ist, kann mit demalt
-Parameter die Nennform angegeben werden. Die Anzeige auf der Karte erfolgt nur, wenn keinalt
-Parameter angegeben wurde.|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 besteht aus Kleinbuchstaben und einem bzw. mehreren Leerräumen. Der Typ sollte auch bei vorhandenerwikidata
-Angabe spezifiziert werden, um Rechenzeit zu sparen. Alle verfügbaren Typen sind in einer Tabelle aufgelistet. Der Type kann auch aus einer Komma-separierten Aufzählung mehrerer Typen bestehen. Farbbestimmend ist der erste Typ. Beispiele:type = observatory
type = restaurant, bar, cafe
|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.
- Optionale Parameter:
|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 Namensname
.|name-extra=
Namensergänzung, die nicht Bestandteil des Namens ist. Wird an den Namen angefügt.|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.- 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) und socialmedia (Linksymbole für soziale Medien). Wennshow
eingesetzt wird, wird die Markerformatierungformat
ignoriert.|format=
bewirkt eine unterschiedliche Formatierung.format
sollte nicht mehr eingesetzt, sondern an seiner Stelle der Parametershow
benutzt werden.|format=f2
stellt nur das Markersymbol dar.
|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 den Zeichen A–Z, a–z und 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.|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 mitsymbol = [1-9A-Z]
, um Duplikat zu unterdrücken.|styles=
Zusätzliche CSS-Stilanweisungen für den Namen. Es werden zusätzlich die Kurzbezeichner normal, italic (kursiv), kursiv und station (Text mit Rahmen) 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 mediumaquamarine #66CDAA orange #FFA500 plum #DDA0DD purple #800080 red #FF0000 silver #C0C0C0
- Rückwärtskompatibilität zur einstigen 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.17766 | long = 0.00115 }}
|
1 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 }}
|
2 Ägyptisches Museum ![]() |
{{marker | type = museum | name = Museum | lat = 51.27766 | long = 0.00115 | symbol = letter }}
|
A Museum |
{{marker | type = theme park | name = Themenpark | lat = 51.37766 | long = 0.00115 | image = Beispiel.jpg | zoom = 15 | url = http://www.beispiel.com/ }}
|
1 Themenpark |
{{marker | wikidata = Q82425 }}
|
3 Brandenburger Tor |
{{marker | wikidata = Q151356 | alt = Fernsehturm Berlin }}
|
4 Berliner Fernsehturm ![]() |
{{marker | wikidata = Q668382 | show = all }}
|
1 Flughafen Leipzig/Halle ![]() |
{{marker | wikidata = Q668382 | url = n | show = all }}
|
2 Flughafen Leipzig/Halle (IATA: LEJ, 51° 25′ 26″ N 12° 14′ 11″ O) |
{{marker | wikidata = Q20949716 | show = socialmedia }}
|
1 InterContinental Cairo Semiramis |
{{marker | type = lime | symbol = 8 | name = Sehenswürdigkeit | name-extra = 3* | lat = 15.47766 | long = 0.00115}}
|
8 Sehenswürdigkeit 3* |
{{marker | type = airport | symbol = airport | name = Flughafen Kairo | lat = 30.12194 | long = 31.40556 }}
|
![]() |
{{marker | name = Kölner Dom | wikidata = Q4176 | show = symbol }}
|
![]() |
{{marker | type = airport | styles = italic | name = Flughafen Luxor | lat = 25.670833 | long = 32.706389 }}
|
3 Flughafen Luxor |
{{marker | type = lime | symbol = museum | name = Kunstmuseum | lat = 51.47766 | long = 0.00115}}
|
M Kunstmuseum |
{{marker | type = subway | name = Liverpool Street | name-extra = [[Datei:Underground no-text.svg|14px|baseline]] | wikidata = Q801124 | styles = station }}
|
4 Liverpool Street ![]() |
{{marker | type = lime | symbol = unbekanntes-symbol | name = Kunstmuseum | lat = 51 | long = 0}}
|
![]() |
{{marker | type = | name = Unbekannte Einrichtung ohne Typ | lat = 52 | long = 0}}
|
1 Unbekannte Einrichtung ohne Typ |
Abhängigkeiten von show
Koordinaten
show | Ansicht |
---|---|
- poi |
5 Koptisches Museum |
all poi, coord |
6 Koptisches Museum (30° 0′ 21″ N 31° 13′ 49″ O) |
noname poi, noname |
7 |
all, noname poi, coord, noname |
8 30° 0′ 21″ N 31° 13′ 49″ O |
coord | (30° 0′ 21″ N 31° 13′ 49″ O) Koptisches Museum |
coord, noname | 30° 0′ 21″ N 31° 13′ 49″ O |
none none, noname |
Koptisches Museum |
Mit Einsatz von Wikidata
show | Ansicht |
---|---|
socialmedia | 5 Flughafen in Delhi (IATA: DEL) |
noairport | 6 Flughafen in Delhi |
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 Parameterparam
wird aus Wikidata übernommen, falls vorhanden.|param=
n, no, nein
. Der Parameterparam
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 mitshow = 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. Der Einheitlichkeit halber ist eine Unterdrückung des Codes über Vorlagenparameter nicht vorgesehen. Flughafencodes können mit CSS-Regeln in Mediawiki-Vorlagen unterdrückt werden. Beispiel: Vorlage:Marker ohne Flughafencodes.
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).
Stilvorlagen
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:VCard – für eine vollständige Beschreibung der Einrichtung.
- Vorlage:Mapframe – Fügt eine Karte in den Artikel ein.
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
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 | Eine vorgegebene Typbezeichnung eingeben. | Zeichenfolge | erforderlich |
URL | url | Webadresse der Einrichtung. Dies darf nicht die URL eines Social-Media-Dienstes sein. | 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 Marker | image | Bild zum Marker. | 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), f3 (Marker und Koordinate), f4 (Name und (Koordinate)), f5 (nur Koordinate) und f6 (nur Name). Alternativ kann der Parameter show verwendet werden. | Zeichenfolge | optional |
Anzeigemodus | show | Legt fest, ob POIs, Koordinaten und der Name angezeigt werden sollen. Mögliche Werte sind all (Standard), poi, coord, none, noname, 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. | Zeichenfolge | optional |
Marker-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 |
CSS-Stilanweisungen | styles | Zusätzliche CSS-Stilanweisungen für den Namen. Es werden zusätzlich die Kurzbezeichner normal, italic (kursiv), kursiv und station (Text mit Rahmen) unterstützt.
| Zeichenfolge | optional |
- 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.
- Zur Vorlage gibt es eine Experimentierseite.
- Liste der Unterseiten