Wikivoyage:VCard/How to…/sandbox

Index > Dokumentation > Lua- und Scribunto-Module > VCard > How to…

---

この記事はさまざまな問題に解決策を提供しようと設けました。よくある質問も置いてあります。

依存の関係

モジュール Module:Marker のインストール設定は、モジュール Module:vCard に依存する設定ではありません。後者 Module:vCard は前者 Module:Marker を採用しておらず、つまり、これら2つに直接の依存関係はありません。ライブラリは共通の Module:Marker utilities です。

引数の名称

引数（パラメータ）の名称は大文字・小文字の区別を認識します。

エイリアスの利用

テンプレートの {{Marker}} および {{vCard}} はどちらもモジュールの Module:Marker/Params と Module:VCard/i18n を使って、引数名にエイリアス（通称）の定義ができます。さらに加えて、エイリアスを設定できるモジュールには groups（グループ）、types（タイプ）、subtypes（サブタイプ）があります。

vCard/i18n と vCard/Params の差異

モジュール類の機能と役割の詳細は、それぞれ読み比べてください。

• Module:vCard/Params
• Module:vCard/i18n

名称にリンクを使いたい

固有の名称にメディアウィキのリンク構文を用いると、固有の記事ページもしくは記事内の見出しへリンクを張れます。リンク構文の外側の文字列は除去の対象です。

• name = [[固有の記事へのリンク|名称]] — 記事ページにリンク。
• name = [[固有の記事へのリンク#その記事内のアンカー名|名称]] — 固有の記事の中に置いた、アンカー/見出しにリンク。
• name = [[#固有のアンカー|名称]] — 表示中の記事の中に置いた、アンカー/見出しにリンク。

引数 引数 |wikidata= を用いて固有の記事へページへのリンクを指定してある場合、ウィキデータに探しに行き、語彙素というページ名で登録がある場合はそちらから情報を読み込みます。ただしメディアウィキのリンク構文は、ウィキデータへのサイト間リンクを防ぎます。

記事リンク（article links）のほか、通常のURLリンクも使えます。

• url = https://...

名前に記事リンクを使わない場合、施設あるいは場所のリンクにURLリンクを使います。もしも療養にリンクさせた場合、（1）名称は記事リンク、（2）URLリンクの後に地球儀アイコンが自動で付きます。

（設計計画）ウィキデータに定義のあるサイトリンクはリダイレクトが発生しますが、そのようなものは通常、組織や場所の名称のリンクに使いません。しかしながら記事ページ内にその種のリンクを検知した場合、リダイレクトされる未使用のサイトリンクカテゴリにまとめています。この種のサイトのリダイレクトを使うには、Marker の引数を show = wikilink と指定します。この「show」オプションを採用した記事は別途、記事のリンクがリダイレクトというカテゴリに分類されます。

アンカーID

アンカーに付ける識別子は、引数「id」に次の指定をします。

• id = vCard_…
  • ラッパータグ（Wrapper-Tag）内のウィキデータ識別子 Wikidata-Id
  • listing-name-bdi-Tag 内の名前識別子 Name-Id

予約サービス

商用の予約サービス（Booking services）には Agoda.com、Booking.com、じゃらんなどがあり、{{vCard}} では対応はしていても画面に表示しません。vCard テンプレートにはそれらを手動で記入する引数（パラメータ）はありません。これらの値はウィキデータから読み込まれ、属性は data-… にしてラッパータグ内に収容するだけです。ガジェットあるいはユーザスクリプト内なら使用可能です。

SNSリンクは載せない

{{Marker}} の場合、SNS へのリンクは既定では非表示です。また、固有の引数 |facebook= のようなものも存在しません。リンクの値はウィキデータに記録があるなら読み込むし、そのためにはテンプレート内の引数 show = socialmedia の設定が必須です。モジュール側の設定により、SNS リンクをすべて防止するにはモジュール Module:Marker/Params のコメント引数 socialmedia = 1 を設定します。

{{vCard}}, テンプレートの場合は、SNS リンクを規定で表示します。また非表示にするにはテンプレート内の引数 show = nosocialmedia を使います。特定のウィキ全体で SNS リンクを非表示にするには、モジュール Module:Marker_utilities/i18n の設定を変えて引数 options.defaultShow = 'poi, nosocialmedia' とします。後者の場合、モジュール Module:VCard/i18n の中に非表示にする SNS 引数を全て列記しておき、SNS リンクを記入した時点でエラーメッセージを表示させる方法も合理的でしょう。

廃止された引数

{{vCard}} では引数の |wikipedia= を廃止しました。そのリンクはすべて、ウィキデータから読み込むからです。そこで、ウィキデータの項目（語彙素）の識別子（Q 番号）を引数 |wikidata= で指定します。ただし |wikipedia= への対応は可能で、 Module:VCard/i18n の廃止コメントを除去願います。

コモンズのカテゴリを示す引数 |commonscat= は使ってはいけません。このカテゴリは大半の場合、対応するウィキデータのデータセット内に記録してあるからです。もしもウィキデータを読み高設定にしたのに、コモンズのカテゴリが表示されない場合は、ウィキデータに行って修正できないか、試してください。

処理に使う時間

使うのはウィキデータか、地図リンク maplink なのか……。

データの件数が1でも100でも、処理時間に違いは感じないはずで、メディアウィキ構文（syntax）の処理中、データセット全体をキャッシュに取り込んで使うからです。

{{IsIn|VCard}}