Wikivoyage:VCard

Links hinzufügen
Aus Wikivoyage

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]

VCard

Marker utilities
Coordinates
Coordinates/i18n
Marker utilities/Groups
Marker utilities/i18n
Marker utilities/Maki icons
Marker utilities/Types
UrlCheck
UrlCheck/i18n
Wikidata utilities
Marker utilities/i18n
VCard/Cards
VCard/i18n
VCard/Params
Marker utilities/i18n
VCard/Qualifiers
VCard/Subtypes
VCard/Unesco
CountryData
CountryData/Currencies
CountryData/Geography
Wikidata utilities
Exchange rate
Hours
Hours/i18n
Wikidata utilities
Hours/i18n
Languages
LinkMail
Link utilities
Link utilities/i18n
LinkPhone
Link utilities
Link utilities/i18n
Link utilities/Phone numbers
LinkSkype
Link utilities
Link utilities/i18n
Wikidata utilities

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]

Skype-URI-Links[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.

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
Abgerufen von „https://de.wikivoyage.org/w/index.php?title=Wikivoyage:VCard&oldid=1609764“