Wikivoyage:VCard

Dieser Artikel enthält technische Hintergrundinformationen zum Modul Modul:vCard.

Benötigte ModuleBearbeiten

Skripten, die vCards verwendenBearbeiten

DiskussionBearbeiten

VerwendbarkeitBearbeiten

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.

AufrufBearbeiten

Der Aufruf erfolgt über die Vorlage {{vCard}}.

{{#invoke: vCard | vCard }}

InternationalisierungBearbeiten

KategorienBearbeiten

Neue TypenBearbeiten

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

Eingesetzte KlassenbezeichnerBearbeiten

vCard-Wrapper-TagBearbeiten

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

WartungBearbeiten

  • errorSchwerwiegende Fehler
  • listing-check-recommendedPrüfempfehlungen der Vorlagen {{vCard}} und {{Marker}}.
  • listing-outdated – Das lastedit-Datum liegt bereits drei Jahre zurück.
  • wikidata-contentDatum stammt aus Wikidata.
  • with-vCard – Absatztag (p, div, li, dd), das eine {{vCard}} umschließt.
  • with-vCard-innerspan-Wrapper für den Inhalt der mit with-vCard markierten Absätze.

Kennzeichnung der BestandteileBearbeiten

  • 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-emphasized – Hervorgehobene Angabe, üblicherweiser kursiv
  • 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-indent – Hängender Einzug der vCard
  • listing-landline – Festnetztelefonnummer(n) der Einrichtung
  • listing-lastedit – Datum der letzten Bearbeitung
  • 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-url – Offizielle Website der Einrichtung

KartographerBearbeiten

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

Eingesetzte DatenbezeichnerBearbeiten

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

Im Wrapper-TagBearbeiten

  • data-type – Typ der Einrichtung
  • data-group – Gruppe der Einrichtung, meist aus Typ bestimmt
  • data-group-translated – in die Wikisprache übersetzte Gruppenbezeichnung
  • 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-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-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-hotels-com – Hotel-ID auf Hotels.com
  • data-leading-hotels – Hotel-ID auf LHW.com
  • data-preferred-hotels – Hotel-ID auf PreferredHotels.com
  • data-recreation-gov – Recreation.gov facility ID
  • data-relais-chateaux – Hotel-ID auf RelaisChateaux.com
  • data-tripadvisor-com – TripAdvisor-ID
  • data-foursquare-id – Einrichtungs-ID auf Foursquare.com
  • data-google-maps-cid – Google Maps Customer ID

KartographerBearbeiten

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

Teure FunktionsaufrufeBearbeiten

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

AufbauBearbeiten

<span class="vCard vcard h-card" 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">
   <span class="listing-name-local wikidata-content"><span lang="ar" dir="rtl" title="Name in der Landessprache Arabisch"></span></span>,
   <!-- wenn name-local -->
   <span class="listing-name-latin listing-emphasized" title="Name in lateinischer Umschrift"></span>,[Leerraum]
    <!-- wenn name-latin -->
   <bdi></bdi> <!-- wenn alt -->
  </span>,[Leerraum]
  <bdi class="listing-comment listing-emphasized"></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]
  <span class="listing-address-local">
   <span lang="ar" title="Anschrift in der Landessprache Arabisch" dir="rtl">ميدان التحرير</span></span>
 </span>

 (
  <span class="listing-directions listing-emphasized"></span> <!-- wenn directions -->
  <!-- wenn directions-local -->
  <span class="listing-add-info">,[Leerraum]
   <span class="listing-directions-local"><span lang="ar" title="Lage in der Landessprache Arabisch" dir="rtl"></span></span>
  </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 -->

MetadatenBearbeiten

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>