Plantilla:VCard/doc

De Wikiviajes, la guía libre de viajes


Uso[editar]

This template describes facilities, accomodations, instituitions etc, but not things like dishes. It should be used as listing elements in articles. If you need it anywhere in the continuous text (to set a marker for an airport or something like that) please use the {{Marker}}

There is a minimum of two parameters, the name and type. If you use Wikidata, the name may not be necessary but you can not identify your listing in the plain wiki text. So please always provide the name. The template has got a huge amount of parameters. The most of them are not needed when Wikidata is used, preferably but setting auto=yes. Misusage of the template or one of its parameters categorizes the article into one or more of the maintenance categories.

Verwendung[editar]

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


In den meisten Ländern wird die VCard im Blockmodus dargestellt, d. h., sie bildet einen vollständigen Absatz. Ausnahmen sind gegenwärtig nur Deutschland, Österreich, die Schweiz und Italien, in denen die vCard aus historischen Gründen noch im Inline-Modus (Zeilenmodus) angezeigt wird. Diese Ausnahmen werden zukünftig aufgehoben.

Die Vorlage VCard sollte deshalb nicht innerhalb einer Zeile verwendet werden. Möglich sind die Nutzung als allein stehender Absatz oder die Nutzung als ein Listenelement. Ausnahmen können mit dem Parameter show vereinbart werden. Alternativ kann auch die Vorlage {{Marker}} verwendet werden, die für die Verwendung innerhalb einer Zeile geeignet ist.

  • Funktion: Die Vorlage dient zur Ausgabe von Angaben, wie sie auf einer Visitenkarte stehen könnten.
  • Verwendung: {{VCard | type=a_type | subtype=a_subtype | subtype=a_name | alt=alt_name | comment=a_comment | address=an_adress | directions=directions | wikidata=an_object | url=an_url | facebook=an_username | instagram=an_username | twitter=an_username | lat=a_latidude | long=a_longitude | image=map_image | phone=a_phone | mobile=a_mobile | fax=a_fax | email=an_email | skype=a_contact | hours=hours | checkin=checkin_time | checkout=checkout_time | price=prices | payment=accepted payment | description=a_description }}
  • Erforderlicher Parameter:
    • |name= Name der Einrichtung. Der Name darf keine HTML-Tags oder Anführungszeichen " enthalten. Typografische Anführungszeichen sind möglich.
    • |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 vorhandener wikidata-Angabe spezifiziert werden, um Rechenzeit zu sparen. Alle verfügbaren Typen sind in einer Tabelle aufgelistet. Der Typ kann auch aus einer Komma-separierten Aufzählung mehrerer Typen bestehen. Farbbestimmend ist der erste Typ. Beispiele:
      • type = observatory
      • type = restaurant, bar, cafe
  • Optionale Parameter:
    • |subtype= Weitere Spezifikation der Einrichtung. Es werden nur diejenigen Werte angezeigt, die in der Tabelle Modul:vCard/Subtypes spezifiziert sind.
    • |name-extra= Namensergänzung, die nicht Bestandteil des Namens ist. Wird an den Namen angefügt.
    • |name-local= Name der Einrichtung in einer Landessprache.
    • |name-latin= Name der Einrichtung in der Umschrift der Landessprache.
    • |alt= Alternative Bezeichnung(en).
    • |comment= Anmerkung zur Bezeichnung.
    • |address= Anschrift der Einrichtung.
    • |address-local= Anschrift der Einrichtung in einer Landessprache.
    • |directions= Anfahrt zur Einrichtung.
    • |directions-local= Anfahrt zur Einrichtung in einer Landessprache.
    • |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.
    • |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= Wikidata-Datenobjekt.
    • |auto= j, ja, n, nein, no, y, yes. Alle weiteren in Wikidata verfügbaren Werte werden übernommen/nicht übernommen.
    • |commonscat= definiert eine Commons-Kategorie mit Medien zur Einrichtung. Der Parameter sollte nur verwendet werden, wenn es keinen Wikidata-Eintrag gibt.
    • |url= Internetadresse (URL) der Einrichtung. Dies darf nicht die URL eines Social-Media-Dienstes sein.
    • |facebook= Facebook-Benutzername oder -Webadresse der Einrichtung.
    • |flickr= Name der flickr-Gruppe.
    • |instagram= instagram-Benutzername der Einrichtung.
    • |twitter= Twitter-Benutzername der Einrichtung.
    • |youtube= Kennung oder Name des YouTube-Kanals.
    • |show= Legt den Anzeigemodus fest. Mögliche Werte sind: poi (nur Poi, Standard), all, coord (nur Koordinate), none (nichts), inline, outdent und symbol (Symbol anstelle einer Nummer). Standardmäßig wird die vCard im Block-Modus ausgegeben (bisherige Ausnahmen Deutschland, Italien, Österreich und die Schweiz). Wenn sie innerhalb einer Zeile verwendet werden soll, so muss die Option inline gesetzt werden.
    • |group= überschreibt die automatisch bestimmte Gruppenzugehörigkeit zu buy (Einkaufen), do (Aktivitäten), drink (Ausgehen), eat (Küche), go (Anreise), see (Sehenswürdigkeiten), sleep (Unterkunft) und other (Anderes) für das Marker-Symbol. Weiterhin stehen mehrere Farbangaben wie blue, gold, lime, maroon, mediumaquamarine, red, silver zur Verfügung. 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 {{vCard}} unterstützt den Parameter map-group nur aus diesem Grund. Die Markerfarbe wird über den Parameter type oder group vermittelt. Die Parameter group und map-group haben unterschiedliche Bedeutung.
    • |image= Bild, das beim Anklicken der Nummer auf der Karte eingeblendet werden soll.
    • |phone= kommaseparierte Telefonnummern der Einrichtung. Zur Behandlung von Ausnahmen wie Notrufen, die nur im Inland gültig sind, siehe auch die Hinweise in der Vorlage {{LinkPhone}}.
    • |tollfree= kommaseparierte gebührenfreie Telefonnummern der Einrichtung.
    • |mobile= kommaseparierte Mobil-Telefonnummern der Einrichtung.
    • |fax= kommaseparierte Faxnummern der Einrichtung.
    • |email= E-Mail-Adresse der Einrichtung.
    • |skype= Skype-Benutzername der Einrichtung.
    • |hours= Öffnungszeiten der Einrichtung.
    • |checkin= Check-in-Zeit.
    • |checkout= Check-out-Zeit.
    • |payment= Akzeptierte Zahlungsarten.
    • |price= Kosten der Nutzung der Einrichtung.
    • |description= Beschreibung
      • |content= Alias für description.
    • |before= Vorangestellte Textteile oder Symbole. Für nachgestellte Angaben lässt sich description benutzen.
    • |lastedit= Datum der letzten Bearbeitung in der Form jjjj-mm-tt. Wenn das angegebene Datum bereits drei Jahre oder länger zurückliegt, wird neben dem Datum der Hinweis ausgegeben, dass die Angaben möglicherweise veraltet sind, und der Artikel wird in der Kategorie VCard: Angaben veraltet vermerkt. Diese Angabe ist keine Pflichtangabe und sollte nur verwendet werden, wenn zeitlich variable Angaben wie Uhrzeiten oder Preise spezifiziert wurden.
  • Beispiele:
    • Geschrieben: {{VCard | type= museum | name= Ägyptisches Museum | address= Mīdān at-Taḥrīr | directions= Nordseite des Platzes | url= http://www.emuseum.gov.eg/ | lat= 30.047778 | long= 31°14' 0" E | phone= +20 (0)2 2579 6974 | fax= +20 (0)2 2579 4596 | email= egymu1@idsc.net.eg | hours= Geöffnet täglich 09:00 bis 17:00 Uhr | price= Eintritt LE 50 für Erwachsene, LE 25 für Kinder, Mumiensaal: LE 80 | show= coord }}
    • Leer: {{VCard| type= | name= | address= | directions= | url= | image= | lat= | long= | phone= | fax= | email= | hours= | checkin= | checkout= | price= | payment= | description= }}
    • Realisiert:
      Ägyptisches Museum, Mīdān at-Taḥrīr (Nordseite des Platzes). +20 (0)2 2579 6974, fax: +20 (0)2 2579 4596, : 🕓 täglich 09:00 bis 17:00 Uhr. Precio: Eintritt LE 50 für Erwachsene, LE 25 für Kinder, Mumiensaal: LE 80. (30° 2′ 52″ N 31° 14′ 0″ O)
  • Sprungziel:
    • jede VCard erhält automatisch das Sprungziel „vCard_Vcardname“, zum Aufruf also Artikelname#vCard_Vcardname einsetzen, es ist Groß- und Kleinschreibung zu beachten
  • Hinweis zu den Reisethemen:
    • Alle für den Reisenden relevanten Objekte (im Normalfall über die VCard in Artikel eingebunden) stehen im Regelfall immer im Ortsartikel. Beziehe dich bei der Arbeit an den Themenartikel nach Möglichkeit immer auf die Ortsartikel. In besonderen Fällen kannst du auch Objekte im Themenartikel platzieren, im Ausnahmefall in beiden. Detailliertere Hinweise findest du im Artikel Wohin damit.
  • Bitte Beachten: Innerhalb der vCard keine Zeilenumbrüche (Return) einfügen. Das kann zu Fehlfunktionen führen.

type, group und map-group[editar]

Plantilla:Bildergalerie

Der Parameter type beschreibt möglichst genau die Art einer Einrichtung. Hier soll es nicht nur darum gehen, formal z. B. eine Unterkunft als Unterkunft auszuweisen, sondern konkret z. B. sie als Hotel, Herberge oder Campingplatz zu benennen. Zum einen ist es zukünftig beabsichtigt, die Angaben aus vCards sukzessive nach Wikidata zu transferieren. Dafür wird eine möglichst genaue Instanz („ist ein“) benötigt. Ein zukünftiges Projekt soll zudem ein Reiseplaner sein. Auch hierfür benötigt man eine möglichst genaue Klassifizierung.

Die Typen sind in geeignete Gruppen eingeteilt. Damit besitzen Einrichtungen mit ähnlicher Funktion, aber unterschiedlichen Typen, eine farblich einheitliche Darstellung auf den Karten. Es kann Fälle geben, in denen eine andere Gruppe geeigneter wäre. Mit dem Parameter group ist es möglich, die Standardzuordnung zu überschreiben, ohne den Typ selbst zu ändern. Z. B. werden Stadien üblicherweise für die Durchführung von Sportveranstaltungen verwendet, d. h., sie werden in die Gruppe Aktivitäten (do) einsortiert. Es könnte aber sein, dass architektonische Besonderheiten eine Rolle spielen oder es sich um eine archäologische Stätte handelt. Dann kann man die Einrichtung in eine andere Gruppe, nämlich Sehenswert (see), eingliedern. D. h., auf der Karte wird sie in die Gruppe „Sehenswert“ einsortiert und erhält die Farbe dieser Gruppe.

Auch der Parameter map-group überschreibt type oder group. Zweck ist es, diese Einrichtung auf einer weiteren Karte anzuzeigen, die diese Gruppe map-group anzeigen kann. Hierzu kann der Parameter show der Vorlage {{Mapframe}} angepasst werden. map-group ändert aber nicht die Farbe des Markers. Diese wird aus dem Typ bzw. seiner Gruppe bezogen.

Bezug von Daten aus Wikidata[editar]

Die Vorlage vCard 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, die Interwikilinks (Wikipedia, Commons, Wikidata) und der Hinweis auf ein Weltkulturerbe automatisch ü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.

Die Vorlage bezieht noch weitere Angaben wie die Kennungen von Buchungsportalen, Flughafencodes, sozialen Netzwerken und Websitelinks aus Wikidata, die hauptsächlich in der vCard-Info zur Anzeige gelangen.

Abhängigkeiten von show[editar]

show Ansicht
1 Ägyptisches Museum, Mīdān at-Taḥrīr.
none
Ägyptisches Museum, Mīdān at-Taḥrīr.
poi
2 Ägyptisches Museum, Mīdān at-Taḥrīr.
coord
Ägyptisches Museum, Mīdān at-Taḥrīr. (30° 2′ 52″ N 31° 14′ 0″ O)
all
3 Ägyptisches Museum, Mīdān at-Taḥrīr. (30° 2′ 52″ N 31° 14′ 0″ O)

none ist stärker als poi, coord und all. all ist stärker als poi und coord. Standard ist poi.

Markermodus[editar]

Wenn in der vCard keine Anschriften, Kontaktdaten und keine Beschreibung enthalten sind – auch nicht aus Wikidata bezogen –, wird das Ergebnis im Markermodus ausgegeben: Es ist dann ein Inline-Element und enthält keine Interpunktionszeichen. Die Ausgabe ähnelt der der Vorlage {{Marker}}. Das Anfügen von Text hinter der Vorlage sollte dann vermieden werden, wenn weitere Angaben später ergänzt werden.

Beispiel: aus {{vCard | name = Ägyptisches Museum Kairo | wikidata = Q201219 | name-local = j | facebook = j | twitter = j }} wird:

Template styles[editar]

Technische Dokumentation[editar]

  • (German Wikivoyage) – Die Seite enthält eine technische Dokumentation zur VCard. Dort sind unter anderem abhängige Module für die Konfiguration und die von der VCard verwendeten CSS-Klassen angegeben.

TemplateData[editar]

Parámetros de la plantilla

ParámetroDescripciónTipoEstado
tipotipo

tipo de local (hotel, acantilado, puente, oficina, etc.)

Cadenasugerido
grupo de tipogrupo

tipo de listado (ver, hacer, comprar, comer, beber y salir, dormir, etc.)

Cadenaobligatorio
característicasestrellas

características del local (si disponen de baños, acceso a silla de ruedas, etc.); calificación de estrellas

Cadenasugerido
opciones de pantallashow

Cadenaen desuso
wikidatawikidata

elemento de Wikidata

Cadenaopcional
nombrenombre

nombre del listado

Cadenaobligatorio
nombre alternativoalt

nombre alternativo del listado

Cadenaopcional
sitio weburl

sitio web oficial del listado (evítese sitios webs de terceros)

Cadenaopcional
dirección del listadodirección

dirección del listado

Cadenaopcional
indicacionesindicaciones

indicaciones sobre la ubicación del listado

Cadenaopcional
latitudlat

Cadenaopcional
longitudlong

Cadenaopcional
teléfonotlf

Cadenaopcional
teléfono gratuitotlf_gratuito

Cadenaopcional
teléfono móvilmobile

Cadenaopcional
faxfax

Cadenaopcional
correo electrónicoemail

Cadenaopcional
horariohorario

Cadenaopcional
horario de entradahora_entrada

Cadenaopcional
horario de salidahora_salida

Cadenaopcional
precioprecio

Cadenaopcional
método de pagopayment

Cadenaopcional
imagenimagen

Cadenaopcional
categoría de imagencommonscat

categoría del listado en Wikimedia Commons (evítese lo más posible, use Wikidata)

Cadenaopcional
nivel de zoomzoom

Cadenaopcional
preposiciónbefore

Añade información o una imagen antes del listado (incluir alguna aclaración o añadir un icono a la línea de metro del listado, etc) Se debe usar moderadamente.

Cadenaen desuso

See also[editar]

related templates[editar]
  • {{Marker}} – für Angabe von Objekten und Kartenlinks im Fließtext.
  • {{Mapframe}} – Fügt eine Karte in den Artikel ein.