Wikivoyage:VCard

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

Unterseiten Bearbeiten

Installation (in Englisch)
Replacing existing Marker and Listing modules and templates (in Englisch)
How to… (in Englisch)
Entwicklung
Verwendete Wikidata-Eigenschaften

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

Coordinates (Doku), Coordinates/i18n (Doku), CountryData (Doku), CountryData/Currencies (Doku), CountryData/Geography (Doku), Hours (Doku), Hours/i18n (Doku), Languages (Doku), Link utilities (Doku), Link utilities/i18n (Doku), LinkMail (Doku), LinkPhone (Doku), LinkSkype (Doku), Marker utilities (Doku), Marker utilities/Groups (Doku), Marker utilities/i18n (Doku, es), Marker utilities/Maki icons (Doku), Marker utilities/Types (Doku), UrlCheck (Doku), UrlCheck/i18n (Doku, en, es), VCard (Doku), VCard/Cards (Doku), VCard/i18n (Doku), VCard/Params (Doku), VCard/Qualifiers (Doku, es), VCard/Subtypes (Doku), VCard/Unesco (Doku) und Wikidata utilities (Doku).
Zusätzlich wird MediaWiki:Gadget-MarkerUtilities.js eingesetzt, um Skype-Namen zu verlinken.

Module dependencies Bearbeiten

Skripten, die vCards verwenden Bearbeiten

MediaWiki:Gadget-MarkerUtilities.js‎‎
MediaWiki:Gadget-InitListingTools.js
MediaWiki:Gadget-ListingEditor.js, Editor für die Vorlage {{vCard}}. Dokumentation.
MediaWiki:Gadget-ListingInfo.js, Anzeige ausgewählter Daten aus der Vorlage {{vCard}}, insbesondere für den Einsatz auf Smartphones, um bei Taxifahrern und Passanten bei der Wegfindung um Unterstüzung auch in der Landessprache zu bitten. Dokumentation.
MediaWiki:Gadget-MarkerTooltip.js, Tooltip-Informationen der mit {{vCard}} und {{Marker}} generierten Marker-Symbole. Dokumentation.

Internationalisierung Bearbeiten

Modul:Marker utilities/i18n – Zeichenkettendefinition
Modul:VCard/i18n – Namen der Vorlagenparameter, HTML-Tag-data-Bezeichner

Hilfe Bearbeiten

Kategorien Bearbeiten

Wartungskategorie: Kategorie:Wartung vCard

Neue Typen Bearbeiten

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

Modul:Marker utilities/Types, Vorlage:VCard/XML, Vorlage:Marker/XML

Stilvorlagen Bearbeiten

Vorlage:VCard/styles.css

Semantische Mikroformate Bearbeiten

Die semantischen Mikroformate Microformats 2, hCard 1.0, h-card (2.0) werden in {{vCard}} und {{Marker}} unterstützt.

Skype-URI-Links Bearbeiten

Das Skype-Protokoll wird in der Mediawiki-Link-Syntax (noch) nicht unterstützt. Die Links werden mit der JavaSript-Bibliothek MediaWiki:Gadget-MarkerUtilities.js angelegt.

Eingesetzte Klassenbezeichner Bearbeiten

vCard-Wrapper-Tag Bearbeiten

vCard: <span/div class="vCard vcard h-card">
Marker: <span/div class="Marker vcard h-card">

vcard: for all listings and markers, microformat hCard 1.0 specification
h-card: for all listings and markers, microformat hCard 2.0 specification

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.

Wartung Bearbeiten

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-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

Wikivoyage:VCard

Unterseiten Bearbeiten

Diskussion Bearbeiten

Verwendbarkeit Bearbeiten

Aufruf Bearbeiten

Benötigte Module Bearbeiten

Module dependencies Bearbeiten

Skripten, die vCards verwenden Bearbeiten

Internationalisierung Bearbeiten

Hilfe Bearbeiten

Kategorien Bearbeiten

Neue Typen Bearbeiten

Stilvorlagen Bearbeiten

Semantische Mikroformate Bearbeiten

Skype-URI-Links Bearbeiten

Eingesetzte Klassenbezeichner Bearbeiten

vCard-Wrapper-Tag Bearbeiten

Wartung Bearbeiten

Kennzeichnung der Bestandteile Bearbeiten

Übergeordnetes Listenelement Bearbeiten

Kartographer Bearbeiten

Eingesetzte Datenbezeichner Bearbeiten

Im Wrapper-Tag Bearbeiten

Kartographer Bearbeiten

Teure Funktionsaufrufe Bearbeiten

Aufbau Bearbeiten

Metadaten Bearbeiten

Zusätzliche Klassen und Attribute im body-Tag Bearbeiten

Zusätzliche Klassen und Attribute im `body`-Tag Bearbeiten