Wikivoyage

Wikivoyage:VCard

Index > Dokumentation > Lua- und Scribunto-Module > VCard
Wikivoyage Projektseiten

Dieser Artikel enthält technische Hintergrundinformationen zum Modul Modul:vCard. Dieses Modul und seine Untermodule sind Teil des Marker Package‎.

Unterseiten

Bearbeiten

Diskussion

Bearbeiten

Verwendbarkeit

Bearbeiten
Unterstützte Skins
Vector, Minerva u.a.
Eignung für andere Wikis
nur Wikivoyage, teilweise Eignung, Anpassung und Übersetzung nötig
Eignung für mobile Geräte
ja.

Aufruf

Bearbeiten

Der Aufruf erfolgt über die Vorlage {{vCard}}. Nachfolgende Beispiele sind ohne Template-Styles notiert:

{{#invoke: vCard | vCard }}

oder

{{#invoke: vCard | vCard | type = see }}

Benötigte Module

Bearbeiten

Module dependencies

Bearbeiten

Skripten, die vCards verwenden

Bearbeiten

Internationalisierung

Bearbeiten

Hilfe

Bearbeiten

Kategorien

Bearbeiten

Neue Typen

Bearbeiten

Neue Typen für Einrichtungen müssen in folgenden Artikeln eingetragen werden:

Stilvorlagen

Bearbeiten

Semantische Mikroformate

Bearbeiten
Bearbeiten

Eingesetzte Klassenbezeichner

Bearbeiten

vCard-Wrapper-Tag

Bearbeiten
  • vCard: <span/div class="vCard vcard h-card">
  • Marker: <span/div class="Marker vcard h-card">
  • listing-indent – Hängender Einzug der vCard.
  • listing-inline – vCard soll als Inline-Element dargestellt werden.
  • listing-with-status – vCard besitzt Status-Ikonen.
  • listing-edit – Bearbeiten-Schalter soll angefügt werden.
  • listing-no-edit – Bearbeiten-Schalter soll keinesfalls angefügt werden.
  • error – Schwerwiegende Fehler
  • listing-check-recommended – Prüfempfehlungen der Vorlagen {{vCard}} und {{Marker}}.
  • listing-outdated – Das lastedit-Datum liegt bereits drei Jahre zurück.
  • listing-with-siblings – vCard befindet sich in einem Absatztag (p, div, li, dd), das weitere Kindelemente umfasst. Im zukünftig geplanten Blockmodus führt dies zu fehlerhaften Darstellungen. Die Klasse wird im Skript Gadget-ListingEditor.js gesetzt.
  • voy-wikidata-content – Angabe stammt aus Wikidata.

Kennzeichnung der Bestandteile

Bearbeiten
  • listing-add-contact – zusätzliche Kontaktangaben wie Telefonnummern oder Email-Adressen, die im Text ausgeblendet werden, weil sie eine Maximalanzahl überschritten haben. Im vCard-Info-Dialog werden sie angezeigt.
  • listing-add-info – Zusätzliche Angaben der Einrichtung in der Landessprache wie Anschrift und Lage
  • listing-address – Anschrift der Einrichtung
  • listing-address-local – Anschrift der Einrichtung in der Landessprache
  • listing-airport – Flughafencodes
  • listing-alt – Alternative Bezeichnung der Einrichtung
  • listing-checkin – Checkin-Zeit der Einrichtung
  • listing-checkout – Checkout-Zeit der Einrichtung
  • listing-comment – Kommentar zur Bezeichnung der Einrichtung
  • listing-content – Beschreibung der Einrichtung
  • listing-coordinates – Koordinate der Einrichtung
  • listing-credit – Akzeptierte Kreditkarten
  • listing-directions – Lage der Einrichtung
  • listing-directions-local – Lage der Einrichtung in der Landessprache
  • listing-dms-coordinates – Koordinate der Einrichtung im Grad-Minute-Sekunde-Format
  • listing-email – Email(s) der Einrichtung
  • listing-fax – Faxnummer(n) der Einrichtung
  • listing-hours – Öffnungszeiten der Einrichtung
  • listing-iata – Verlinkter IATA-Flughafencode
  • listing-iata-code – IATA-Flughafencode
  • listing-icao – Verlinkter ICAO-Flughafencode
  • listing-icao-code – ICAO-Flughafencode
  • listing-image – Bild der Einrichtung
  • listing-inline – vCard wird behandelt, als würde sie innerhalb eines Absatzes verwendet
  • listing-landline – Festnetztelefonnummer(n) der Einrichtung
  • listing-lastedit – Datum der letzten Bearbeitung
  • listing-link-from-wd – Der Artikellink wurde aus Wikidata bezogen
  • listing-link-is-redirect – Der Artikellink wurde aus Wikidata bezogen und stellt eine Weiterleitung dar (immer zusammen mit der Klasse mw-redirect)
  • listing-map – Wrapper für den Kartographer-Marker
  • listing-map-inverse – Inverse Textfarbe für den Kartographer-Marker
  • listing-map-is-symbol – Symboldarstellung auf dem Kartographer-Marker
  • listing-map-is-error – Fehlerhafter Markertyp oder Markergruppe
  • listing-metadata – Metadaten, Kompatibilität zur Vorlage Listing in WV/en
  • listing-metadata-items – Metadateneinträge wie Änderungsdatum, Bearbeiten- und Info-Schalter
  • listing-mobile – Mobiltelefonnummer(n) der Einrichtung
  • listing-name – Bezeichnung der Einrichtung
  • listing-name-latin – Bezeichnung der Einrichtung in der Landessprache in lateinischer Umschrift
  • listing-name-local – Bezeichnung der Einrichtung in der Landespsrache
  • listing-phone – Wrapper für alle Telefonnummern (Festnetz, Mobil, kostenfrei, Fax)
  • listing-phone-number – Einzelne Telefonnummer der Einrichtung
  • listing-price – Preisangaben zur Einrichtung
  • listing-sister-icon – Bildsymbole der Links zu den Wikimedia-Schwesterprojekten
  • listing-sister-commons – Bildsymbol des Links zu Wikimedia Commons
  • listing-sister-wikidata – Bildsymbol des Links zu Wikidata
  • listing-sister-wikipedia – Bildsymbol des Links zur Wikidata
  • listing-sister-wikivoyage – Bildsymbol des Links zu einem anderssprachigen Wikivoyage
  • listing-skype – Skype-Name(n) der Einrichtung
  • listing-skype-link – Einzelner Skype-Name der Einrichtung
  • listing-social-media – Bildsymbole der Links zu sozialen Diensten
  • listing-social-media-facebook – Bildsymbol zim Facebook-Link
  • listing-social-media-flickr – Bildsymbol zum Flickr-Link
  • listing-social-media-instagram – Bildsymbol zum Instagram-Link
  • listing-social-media-twitter – Bildsymbol zum Twitter-Link
  • listing-social-media-youtube – Bildsymbol zum Youtube-Link
  • listing-subtype – Wrapper für Untertypen der Einrichtung
  • listing-tollfree – Kostenfreie Telefonnummer(n) der Einrichtung
  • listing-unesco – Bildlink zum zugehörigen Unesco-Artikel
  • listing-unused-redirect – Der von Wikidata bezogene Wikivoyage-Sitelink ist eine Weiterleitung und wird deshalb nicht benutzt.
  • listing-url – Offizielle Website der Einrichtung
  • voy-lang – Bestandteil in einer Fremdsprache
  • voy-lang-xx – Bestandteil in der Fremdsprache mit dem ISO-639-1-Code xx

Übergeordnetes Listenelement

Bearbeiten
  • listing-status-item – Klasse blendet das Listensymbol aus und formatiert die vCard mit hängendem Einzug.

Kartographer

Bearbeiten
  • mw-kartographer-maplink – umschließt das Markersymbol

Eingesetzte Datenbezeichner

Bearbeiten

Die nachfolgenden Angaben können von anderen Anwendungen genutzt werden und stammen zum Teil aus Wikidata.

Im Wrapper-Tag

Bearbeiten
  • data-type – Typ der Einrichtung
  • data-group – Gruppe der Einrichtung, meist aus Typ bestimmt
  • data-group-translated – Gruppe der Einrichtung in der Sprache des Wikis, wie sie in Kartendartsellungen benutzt wird
  • data-map-group – Kartengruppe der Einrichtung, für Aufteilung auf verschiedene Karten vorgesehen
  • data-color – Farbwert zur Gruppe
  • data-name – Bezeichnung der Einrichtung
  • data-name-local – Bezeichnung der Einrichtung in der Amtssprache im Land data-country
  • data-address-lang – Sprache der Anschrift in der Landessprache
  • data-address-local – Anschrift in der Landessprache
  • data-directions-local – Wegbeschreibung in der Landessprache
  • data-subtype – Merkmale der Einrichtung. Merkmale werden durch Semikolons getrennt. Jedes Merkmal besteht aus dem Typ, der Typgruppe und der Anzahl (Falls größer als 1). Der HTML-Parameter wird auch dann angegeben, wenn die Ausgabe im Text fehlt.
  • data-country – Landesangabe nach ISO 3166
  • data-country-name – Landesangabe in der Sprache des Wikis aus Modul:CountryData/Geography
  • data-location – Ortsangabe, enthält den Namen des Artikels oder Unterartikels
  • data-country-calling-code – Telefon-Landesvorwahl im Land data-country
  • data-lang – Amtssprache im Land data-country
  • data-lang-name – Amtssprache im Land data-country in der Sprache des Wikis
  • data-wikilang – Sprache des Wikis
  • data-dir="rtl" – Schreibrichtung der Amtssprache im Land data-country
  • data-wiki-dir="ltr" – Schreibrichtung der Sprache des Wikis
  • data-currency – Währungen im Land data-country
  • data-section-from – Artikel, aus dem die vCard als <section> importiert wurde
  • data-image – Bild der Einrichtung
  • data-wikidata – Wikidata-Q-Identifikator der Einrichtung
  • data-commonscat – Commons-Kategorie der Einrichtung
  • data-url – Offizielle Website der Einrichtung
  • data-rss – RSS-Web-Feed der Einrichtung
  • data-alpenverein-at – ÖAV-Schutzhütten-ID
  • data-alpenverein-de – DAV-Schutzhütten-ID
  • data-agora-com – Hotel-ID auf Agora.com
  • data-booking-com – Hotel-ID auf booking.com
  • data-expedia-com – Hotel-ID auf expedia.com
  • data-historic-hotels-america – Hotel-ID auf HistoricHotels.org
  • data-historic-hotels-europe – Hotel-ID auf HistoricHotelsOfEurope.com
  • data-historic-hotels-worldwide – Hotel-ID auf HistoricHotelsWorldwide.com
  • data-hostelworld-com – Hostel-ID auf Hostelworld.com
  • data-hotels-com – Hotel-ID auf Hotels.com
  • data-kayak-com – Hotel-ID auf Kayak.com
  • data-leading-hotels – Hotel-ID auf LHW.com
  • data-preferred-hotels – Hotel-ID auf PreferredHotels.com
  • data-pzs-si – PZS-Schutzhütten-ID
  • data-recreation-gov – Recreation.gov facility ID
  • data-relais-chateaux – Hotel-ID auf RelaisChateaux.com
  • data-sac-cas-ch – Schutzhütten-ID des Schweizer Alpen-Clubs
  • data-skyscanner-com – Hotel-ID auf Skyscanner.com
  • data-trip-com – Hotel-ID auf Trip.com
  • data-tripadvisor-com – TripAdvisor-ID
  • data-foursquare-id – Einrichtungs-ID auf Foursquare.com
  • data-google-maps-cid – Google Maps Customer ID

Kartographer

Bearbeiten
  • data-lat – Geografische Breite in Dezimalform
  • data-lon – Geografische Länge in Dezimalform

Teure Funktionsaufrufe

Bearbeiten
  • mw.wikibase.getEntity( id ) – Aufruf des Wikidata-Datensatzes
  • mw.title.new('Media:' .. image).exists – Prüfung, ob Bild (image) vorhanden
  • frame:callParserFunction( name = '#coordinates', ... ) – Eintrag der Koordinaten in Mediawiki-Datenbank
  • frame:extensionTag( ... ) – Aufruf von <maplink ...>

Wenn Daten aus Wikidata bezogen werden, dann sollte auch das Bild aus Wikidata stammen. Damit erspart man sich die teure Bildprüfung.

Aufbau

Bearbeiten 
<span class="vCard vcard h-card listing-edit/listing-no-edit" data-*= ... > / <div class="vCard vcard h-card" data-*= ...>
 <!-- davon abhängig, ob Inline- oder Blockmodus; Daten siehe unten -->

 <!-- Nur, wenn Koordinate angegeben -->
 <span class="p-geo geo listing-coordinates" style="display: none">
  <span class="p-latitude latitude">…</span>
  <span class="p-longitude longitude">…</span>
 </span> <!-- siehe unten -->
 <span class="listing-image"><a …><img …></a></span>

 [before-Text&#160;]
 <span class="plainlinks printNoLink poi listing-map" … title="Nummer in der Karte …"> <!-- Wrapper für Kartenmarker -->
  <a class="mw-kartographer-maplink mw-kartographer-autostyled" … data-zoom="17" data-lat="30.047778" data-lon="31.233333" style="background: #4682B4;" …> [Nr] </a>
 </span>

 <!-- Die id wird aus dem Namen mit vorangestelltem 'vCard_' gebildet -->
 [Leerraum]
 <bdi id="vCard_.Ägyptisches_Museum_Kairo" class="p-name p-org fn org listing-name">
  <a href="…"> <!-- Nur, wenn URL angegeben ist: kann intern oder extern sein -->
   Ägyptisches Museum Kairo
  </a>
 </bdi>

 <a rel="nofollow" class="external autonumber" href="…">[1]</a> <!-- wenn zweite URL -->

 [Leerraum](
  <span class="p-nickname nickname listing-alt">
   <bdi class="listing-name-local wikidata-content voy-lang voy-lang-xx" lang="xx" dir="rtl" title="Name in der Landessprache …">…</bdi>,
   <!-- wenn name-local -->
   <span class="listing-name-latin" title="Name in lateinischer Umschrift" lang="xx-Latn">…</span>,[Leerraum]
    <!-- wenn name-latin -->
   <bdi>…</bdi> <!-- wenn alt -->
  </span>,[Leerraum]
  <bdi class="listing-comment">…</bdi>,[Leerraum] <!-- wenn comment -->
  <!-- IATA- oder ICAO-Code (wenn IATA nicht vorhanden) -->
  <span class="listing-airport listing-iata">
   <a href="/wiki/International_Air_Transport_Association" title="International Air Transport Association">IATA</a>: <span class="listing-iata-code wikidata-content">…</span>
  </span>
 ),[Leerraum]

 <bdi class="p-adr adr listing-address">
  <span class="p-street-address street-address">…</span>
 </bdi> <!-- wenn address -->
 <!-- wenn address-local -->
 <span class="listing-add-info">,[Leerraum]
  <bdi class="listing-address-local voy-lang voy-lang-xx" lang="xx" title="Anschrift in der Landessprache …" dir="rtl">ميدان التحرير</bdi>‎
 </span>

 (
  <span class="listing-directions">…</span> <!-- wenn directions -->
  <!-- wenn directions-local -->
  <span class="listing-add-info">,[Leerraum]
   <bdi class="listing-directions-local voy-lang voy-lang-xx" lang="xx" title="Lage in der Landessprache …" dir="rtl">…</bdi>
  </span>
 ).[Leerraum]

 <abbr title="Telefon">Tel.</abbr>:
 <span class="p-tel tel listing-phone listing-landline">
  <span class="plainlinks nourlexpansion listing-phone-number"><a rel="nofollow" class="external text" href="tel:+493023451234">+49 (0)30 2345 1234</a></span>
 </span>,[Leerraum]

 <abbr title="Telefon">Tel.</abbr> gebührenfrei:
 <span class="p-tel tel listing-phone listing-tollfree">
  <span class="plainlinks nourlexpansion listing-phone-number"><a rel="nofollow" class="external text" href="tel:+4980023451234">+49 (0)800 2345 1234</a></span>
 </span>,[Leerraum]

 Mobil:
 <span class="p-tel tel listing-phone listing-mobile">
  <span class="plainlinks nourlexpansion listing-phone-number"><a rel="nofollow" class="external text" href="tel:+4917623451234">+49 (0)176 2345 1234</a></span>
 </span>,[Leerraum]

 Fax:
 <span class="p-tel-fax fax listing-fax">
  <span class="listing-phone-number">+49 (0)30 2345 9876</span>,
  <span class="listing-phone-number">(0)176 345 1234</span>
 </span>,[Leerraum]

 E-Mail:
 <span class="u-email email listing-email">
  <span class="plainlinks nourlexpansion"><a rel="nofollow" class="external text" href="mailto:info@hotel.de">info@hotel.de</a></span>
 </span>,[Leerraum]

 Skype:
 <span class="listing-skype">
  <span class="listing-skype-link">nutzer.name</span> <!-- Der Link wird per JavaScript erzeugt -->
 </span>.[Leerraum]

 <!-- Links zu Wikivoyage, Wikipedia, Commons -->
 <span class="listing-sister-icon listing-sister-wikipedia"><a …><img …></a></span>
 <span class="listing-sister-icon listing-sister-commons">…</span>
 <span class="listing-sister-icon listing-sister-wikidata">…</span> <!-- Link zu Wikidata, einzeln ausblendbar -->

 <!-- ein oder mehrere Links zu Social-Media-Diensten -->
 <span class="listing-social-media listing-social-media-*" …><a …><img …></a></span>
 …
 <span class="listing-social-media listing-social-media-*" …><a …><img …></a></span>
 <span class="listing-social-media listing-full-stop">.</span>[Leerraum]

 <span class="p-note note listing-content">Beschreibung</span>

 <span class="p-note note listing-hours">Geöffnet: 7/24.</span>[Leerraum]
 <span class="listing-checkin">Check-in: ab 14 Uhr.</span>[Leerraum]
 <span class="listing-checkout">Check-out: bis 12 Uhr.</span>[Leerraum]

 <span class="p-note note listing-price">Preis: 100 €.</span>
 <span class="p-note note listing-credit">Akzeptierte Zahlungsarten: Visa, Master, AmEx, Maestro.</span>

 <span class="listing-subtype">Merkmale: [bar] [pool] [wlan].</span>

 <img … /> <!-- Unesco-Symbol, wenn Eintrag in Wikidata -->

 <span class="listing-dms-coordinates printNoLink plainlinks wikidata-content">(
  <a class="external text" href="…">
   <span class="coordStyle" title="Breitengrad">51° 25′ 26″ N</span> <span class="coordStyle" title="Längengrad">12° 14′ 11″ O</span>
  </a>
 )</span>

 <span class="listing-metadata listing-metadata-items">
  <!-- ohne Änderungsdatum -->
  <span class="listing-metadata-item listing-lastedit" style="display:none"><span>letzte Änderung: keine Angabe</span></span>
  <!-- mit Änderungsdatum -->
  <span class="listing-metadata-item listing-lastedit"><span>letzte Änderung: Jun. 2020</span></span>
 </span>

</div> / <span> <!-- davon abhängig, ob Inline- oder Blockmodus -->

Metadaten

Bearbeiten

Der vCard sind nicht sichtbare Metadaten vorangestellt, die von Skripten ausgewertet werden können, ohne dabei auf Wikidata zugreifen zu müssen.

<span / div ...
 data-region="EG"
 data-countrycode="+20"
 data-lang="ar"
 data-wikilang="de"
 data-currency="EGP, LE, pt."
 data-type="museum"
 data-group="see"
 data-color="#4682B4"
 data-wikidata="Q201219"
 data-commonscat="Egyptian_Museum_(Cairo)"
 data-url="http://www.sca-egypt.org/eng/MUS_Egyptian_Museum.htm"
>
<span class="listing-image" style="display: none"><a ...><img ...></a></span>

Die letzte Zeile ist im Minerva-Skin wie folgt aufgebaut:

<span class="listing-image" style="display: none"><a ...><noscript><img ...></noscript><span class="lazy-image-placeholder" ... data-src= ...> </span></a></span>

Es folgt die Koordinate:

<span class="p-geo geo listing-coordinates" style="display: none">
 <abbr class="p-latitude latitude">30.047778</abbr>
 <abbr class="p-longitude longitude">31.233333</abbr>
</span>

Zusätzliche Klassen und Attribute im body-Tag

Bearbeiten
  • voy-user-login – zeigt an, dass der Leser ein angemeldeter Benutzer ist.

Die folgenden Attribute werden für den vCard-Editor/Listing-Editor benötigt und beim Initialisieren des Editors eingefügt:

  • data-currency – Landeswährungen
  • data-country-calling-code – Landes-Telefonvorwahl
  • data-dir – Schreibrichtung der Amtssprache
  • data-lang – Sprachcode der Amtssprache
  • data-lang-name – Name der Amtssprache
  • data-local-calling-code – Orts-Telefonvorwahl
  • data-trunk-prefix - Verkehrsausscheidungsziffer
Abgerufen von „https://de.wikivoyage.org/w/index.php?title=Wikivoyage:VCard&oldid=1644222“