Wikivoyage:VCard

この文書は草案です。まだ公式なものではありません。内容に関してノートページで議論を行っています。

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

使用方法

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

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

サブページ

見出し内の箇条書きの構成を転記します。

（インストール (英語)）^{[※3 1]}
（既存のマーカーおよびリストのモジュールおよびテンプレートの置き換え (英語)）^{[※3 2]}
（方法… (英語)）^{[※3 3]}
（開発）^{[※3 4]}
（使用されたウィキデータプロパティ）^{[※3 5]}

↑
見出し内の箇条書きの構成-1
- リンク付き見出し de:Wikivoyage:VCard/Installation 1609620 番、2024-03-30T19:19:34時点におけるRolandUnger による版。(→Modules needed: +Exchange rate)
小見出し
- 01 Importing modules（1 モジュールのインポート）
- 02 Modules needed（2 必要なモジュール）
- 03 Localization（3 ローカライズ）
- 04 Registration at Wikidata（4 Wikidata への登録）
- 05 Naming of templates（5 テンプレートの命名）
- 06 Styles needed（6 必要なスタイル）
- 07 Template calls（7 テンプレートの呼び出し）
- 08 Additional tools（8 追加ツール）
- 09 Maintenance（9 メンテナンス）
- 10 Notes（10 脚注）
- 11 Features（11 機能）
↑
見出し内の箇条書きの構成-2
- リンク付き見出しドイツ語版（英語版も参照）、de:Wikivoyage:VCard/Replacing_existing_Marker_and_Listing_modules_and_templates 1592073 番、2024-01-11T07:50:54時点における RolandUnger さんによる版。編集要約なし、段落の移動。
小見出し
- 01 Tracking categories（1 追跡カテゴリ）
- 02 LinkPhone and Exchange rate modules（2 LinkPhone および為替レートモジュール）
- 03 Type, group, and map-type（3 種類（type）、グループ、マップタイプ）
- 04 Do, see, ... templates（4 実行、参照、... テンプレート）
- 05 I18n（5 I18n）
- 06[-]Style sheets（[−]6 スタイルシート）
  - 6.1 JavaScript tools（6.1 JavaScript ツール）
- 07 parameters and values checks Maintenance: parameters and values checks（7 メンテナンス: パラメータと値のチェック）
↑
見出し内の箇条書きの構成-3
- リンク付き見出しドイツ語版（英語版も参照）、de:Wikivoyage:VCard/Replacing_existing_Marker_and_Listing_modules_and_templates 1592073 番、2024-01-11T07:50:54時点における RolandUnger さんによる版。編集要約なし、段落の移動。
小見出し
- 01 Tracking categories）（01 追跡カテゴリ）
- 02 LinkPhone and Exchange rate modules（02 LinkPhone および為替レートモジュール）
- 03 Type, group, and map-type（03 種類（type）、グループ、マップタイプ）
- 04 Do, see, ... templates（04 実行、参照、... テンプレート）
- 05 I18n（05 I18n）
- 06[−] Style sheets（06[−] スタイルシート）
  - 6.1 JavaScript tools（6.1 JavaScript ツール）
- 07 Maintenance: parameters and values checks（07 メンテナンス: パラメータと値のチェック）
↑
見出し内の箇条書きの構成-4
- リンク付き見出しドイツ語版（英語版も参照）、de:Wikivoyage:VCard/Entwicklung 1643063 番、2024-09-14T12:57:22時点における RolandUnger さんによる版 (→Erledigte Aufgaben: +1)
小見出し
- 01 Entwicklungsphasen der vCard（1 vCard の開発段階）
- 02 Vorschläge（2 提案）
- 03 Aufgaben zur Verbesserung der vCard（3 vCard を改善するためのつのタスク）
- 04 Kommentare（4 コメント）
- 05 Erledigte Aufgaben（5 タスクが完了）
- 06 Analyse Qualifikatoren bei Koordinaten（6 座標修飾子の分析）
↑
見出し内の箇条書きの構成-5
- リンク付き見出しドイツ語版（英語版も参照）、de:Wikivoyage:VCard/Verwendete_Wikidata-Eigenschaftenの 1536951 番、2023-04-26T11:56:01時点における DerFussi さんによる版 (-Link)
  - OSM Map Features（OSM マップの機能）
  - Wikidata: Property proposal（ウィキデータ:プロパティ（引数）の提案）
  - Wikidata: List of properties（ウィキデータ: プロパティの一覧）
  - Module:Adresse (w:fr)（モジュール:アドレス）（w:fr）

Index > Dokumentation > Lua- und Scribunto-Module > VCard > Verwendete Wikidata-Eigenschaften
索引 > 解説文書 > Lua および Scribunto モジュール

> VCard

> 使用される Wikidata プロパティ → 今ここ

ウィキデータの項目が見つかりません。
Die nachfolgende Tabelle listet die vom Modul vCard genutzten Wikidata-Eigenschaften:
（以下のチェック表は、「vCard モジュールで使用される Wikidata プロパティ」を示しています。）

小見出し

チェック表の列見出し

ウィキデータのプロパティ（引数）
vCard-ID	Trenner	Impl.
vCard-ID	区切り子	実施
Property-ID	Property-en	Property-de
P-ID	P引数（英語名）	P引数（ドイツ語名）
OSM-Key	Prüfung	Formatierung
OSM-Key	校正の状況	フォーマット
Kommentar
備考

必要なモジュール

モジュール:Coordinates、モジュール:Coordinates/i18n、モジュール:CountryData、モジュール:CountryData/Currencies、モジュール:CountryData/Geography、モジュール:Hours、モジュール:Hours/i18n、モジュール:Languages、モジュール:Link utilities、モジュール:Link utilities/i18n、モジュール:LinkMail、モジュール:LinkPhone、モジュール:Marker utilities、モジュール:Marker utilities/Groups、モジュール:Marker utilities/i18n、モジュール:Marker utilities/Maki icons、モジュール:Marker utilities/Types、モジュール:UrlCheck、モジュール:UrlCheck/i18n、モジュール:VCard、モジュール:VCard/Cards、モジュール:VCard/i18n、モジュール:VCard/Params、モジュール:VCard/Qualifiers、モジュール:VCard/Subtypes、モジュール:VCard/Unesco、モジュール:Wikidata utilities
MediaWiki:Gadget-MarkerUtilities.jsによりマーカーの複製、Skypeのリンク、マーカーモードなどが動作します。

依存関係

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

CountryData/Currencies

CountryData/Geography

Link utilities/Phone numbers

Wikidata utilities

スクリプト

MediaWiki:Gadget-MarkerUtilities.js‎‎
MediaWiki:InitListingTools.js
MediaWiki:Gadget-ListingEditor.js（解説） ― {{VCard}}のエディター。デフォルトで有効。
MediaWiki:Gadget-ListingInfo.js ― {{VCard}}の情報をポップアップで表示するガジェット。スマートフォンなどで便利であり、道を聞く際などを想定して現地語でも使用可能です。

スタイルシート

国際化

モジュール:Marker utilities/i18n ― 文字列
モジュール:VCard/i18n ― パラメータの名前、HTMLタグやデータ要素の識別子

メンテナンス

カテゴリ:VCardのメンテナンスカテゴリ ― VCardが追加するメンテナンスカテゴリの一切の親カテゴリ
カテゴリ:ウィキデータと実際のバージョンが異なるモジュール ― 最新のバージョンに更新されていないモジュールが追加されるカテゴリ

種類の更新

種類を更新する際は、ドイツ語版のモジュールを更新してください。なお、その際には以下のページを編集すること：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">

vcard: すべてのリストとマーカーに付加；microformat hCard 1.0 仕様書
h-card: すべてのリストとマーカーに付加；microformat hCard 2.0 仕様書

listing-indent – vCard のインデントがスタック。
listing-inline – vCard はインライン要素として表示。
listing-with-status – vCard のステータス・アイコンは状態を示す。
listing-edit – 編集スイッチを追加する必要がある。
listing-no-edit – 編集スイッチはいかなる状況でも 追加不要。

メンテナンス

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-*= ...>
 <!-- インラインモードかブロックモードかによって異なる（本文の行の途中に記載か、段落を別置するか）。データは以下を参照 -->

 <!-- 地理座標の一覧、座標が指定された場合のみ -->
 <span class="p-geo geo listing-coordinates" style="display: none">
  <span class="p-latitude latitude">…</span>
  <span class="p-longitude longitude">…</span>
 </span> <!-- 画像一覧、以下を参照 -->
 <span class="listing-image"><a …><img …></a></span>

 [before-Text&#160;]
 <span class="plainlinks printNoLink poi listing-map" … title="Nummer in der Karte …"><!-- 見どころ（POI）一覧、マップカードに記載される番号は…… --><!-- 地図マーカのラッパー -->
  <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>

 <!-- ID は、名前の前に付いた「vCard_」の項目順に付与。ここでは「Ägyptisches Museum Kairo」（カイロエジプト博物館） -->
 [空白]
 <bdi id="vCard_.Ägyptisches_Museum_Kairo" class="p-name p-org fn org listing-name">
  <a href="…"> <!-- URL が指定された場合のみ: 内部または外部を指定できる -->
   Ägyptisches Museum Kairo（カイロエジプト博物館）
  </a>
 </bdi>

 <a rel="nofollow" class="external autonumber" href="…">[1]</a> <!-- 2番目の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>,
   <!-- 現地名 -->
   <span class="listing-name-latin" title="Name in lateinischer Umschrift"<!-- 名前のラテン文字転写 --> lang="xx-Latn">…</span>,[空白]
    <!-- 名称の欧文表記 -->
   <bdi>…</bdi> <!-- 古い場合 -->
  </span>,[空白]
  <bdi class="listing-comment">…</bdi>,[空白] <!-- コメント -->
  <!-- IATA または（IATA が存在しない場合は）ICAO 航空コード -->
  <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> <!-- 住所 -->
 <!-- 住所の現地語表記 -->
 <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> <!-- 道順の一覧、指定がある場合 -->
  <!-- 地域の道順 -->
  <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>,[空白]

モバイル版:
 <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"><!-- Skypeの名称 -->
  <span class="listing-skype-link">nutzer.name</span> <!-- JavaScript によって生成されたリンク -->
 </span>.[空白]

 <!-- ウィキボヤージュやウィキペディア、コモンズへのリンク -->
 <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> <!-- ウィキデータへのリンク、個別に非表示にもできる -->

 <!-- SNS への 1 件以上のリンク、アイコン画像付き -->
 <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.<!-- 利用できるクレジットカードほか: Visa、Master、Amex、Maestro。 --></span>

 <span class="listing-subtype">Merkmale<!-- 特徴: [バー]、[プール]、[無線LAN] -->: [bar] [pool] [wlan].（[バー]、[プール]、[無線LAN]）</span>

 <img … /> <!-- ウィキデータに記載がある場合はユネスコのアイコン -->

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

使用方法

サブページ

必要なモジュール

依存関係

スクリプト

スタイルシート

国際化

メンテナンス

高価な関数呼び出し

使用するCSSクラス

vCardのラッパータグ

メンテナンス

内部要素

bodyタグのクラス

親リスト要素

Kartographer

構造

メタデータ

関連項目

`body`タグのクラス