コンテンツにスキップ

Wikivoyage:VCard

リンクを編集
提供：ウィキボヤージュ
 この文書は草案です。まだ公式なものではありません。

このページにはテンプレート:VCardに関する技術的な情報が掲載されています。

使用方法

[編集]
詳細は「ヘルプ:VCardの書き方」を参照

{{VCard}}を使用します。モジュールを直接呼び出した場合、CSSが読み込まれません。

必要なモジュール

[編集]

依存関係

[編集]

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
Hours
Hours/i18n
Wikidata utilities
Hours/i18n
Languages
LinkMail
Link utilities
Link utilities/i18n
LinkPhone
Link utilities
Link utilities/i18n
Link utilities/Phone numbers
Wikidata utilities

スクリプト

[編集]

スタイルシート

[編集]

国際化

[編集]

メンテナンス

[編集]
種類の更新

種類を更新する際は、ドイツ語版のモジュールを更新してください。なお、その際には以下のページを編集すること：Module:Marker utilities/Types、Template:VCard/XML、Template:Marker/XML

高価な関数呼び出し

[編集]
  • mw.wikibase.getEntity( id ) – ウィキデータの情報を取得する
  • mw.title.new('Media:' .. image).exists – 画像（image）が利用可能か確認する
  • frame:callParserFunction( name = '#coordinates', ... ) – MediaWikiのデータベースに座標を書き込み
  • frame:extensionTag( ... ) – <maplink ...>を呼び出す

データがウィキデータから呼ばれている場合、画像もウィキデータのものを使用します。こうすることで高価な画像関数の呼び出しを避けることができます。

使用するCSSクラス

[編集]

vCardのラッパータグ

[編集]
  • 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.

内部要素

[編集]
  • 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 – 外国語で書かれている要素
  • voy-lang-xx – ISO 639-1 コード xx の言語で書かれている要素

bodyタグのクラス

[編集]
  • voy-user-login – 閲覧している人がログイン利用者であることを表す

Listing Editorは初期化時に以下の属性を挿入します：

  • data-currency – 地元の通過
  • data-country-calling-code – 国別電話番号
  • data-dir – 現地語の表記方法
  • data-lang – 現地語の言語コード
  • data-lang-name – 現地語名
  • data-local-calling-code – 市外局番
  • data-trunk-prefix - Verkehrsausscheidungsziffer

親リスト要素

[編集]
  • listing-status-item – アイコンを非表示にし、vCard をインデントしてフォーマットします

Kartographer

[編集]
  • mw-kartographer-maplink – マーカーのアイコンを内包

構造

[編集]
<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 -->
 [空白]
 <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 -->

 [空白](
  <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>,[空白]
    <!-- wenn name-latin -->
   <bdi>…</bdi> <!-- wenn alt -->
  </span>,[空白]
  <bdi class="listing-comment">…</bdi>,[空白] <!-- 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>
 ),[空白]

 <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">,[空白]
  <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">,[空白]
   <bdi class="listing-directions-local voy-lang voy-lang-xx" lang="xx" title="Lage in der Landessprache …" dir="rtl">…</bdi>
  </span>
 ).[空白]

 <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>,[空白]

 <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>,[空白]

 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>,[空白]

 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>,[空白]

 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>,[空白]

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

 <!-- 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>[空白]

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

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

 <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">
  <!-- 最終更新日なし -->
  <span class="listing-metadata-item listing-lastedit" style="display:none"><span>letzte Änderung: keine Angabe</span></span>
  <!-- 最終更新日あり -->
  <span class="listing-metadata-item listing-lastedit"><span>最終更新：2020年6月</span></span>
 </span>

</div> / <span> <!-- インラインかブロックかによる -->

メタデータ

[編集]

vCardには表示されないメタデータが保存されており、ウィキデータにアクセスせずともプログラムを使用してデータを参照できます。 

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

Minervaスキンの場合最後の行がこのようになります： 

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

座標は以下の通り： 

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

関連項目

[編集]
「https://ja.wikivoyage.org/w/index.php?title=Wikivoyage:VCard&oldid=49837」から取得