Template:仮リンク2/doc

これはTemplate:仮リンク2の解説サブページです。
使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。

本テンプレートは{{仮リンク}}の過去（Lua化前）のバージョンです。特に理由がない場合はこのテンプレートを使用するのではなく、代わりに仮リンクテンプレートを使用してください。

このテンプレートなど、（関連項目に記載のあるような）仮リンク系のテンプレートはページの存在チェックのため、高負荷な構文解析関数を使用しています。この高負荷な構文解析関数は、サーバへの負荷が高いため、1ページ500回までの制限があります。実はこの制限は通常の（Luaモジュールを使用しない）テンプレートであればその制限を超えても一定数は使用可能です。しかし、Luaモジュール対応した仮リンクテンプレートではこの制限が厳密になっているため、500回以上の使用が発生している大規模なページへの使用ができません。このテンプレートはその事象の回避のために残されていますが、そのような大量の仮リンク使用がそもそも適切か、このテンプレートの使用前によく検討してください。

このテンプレートは仮リンクテンプレートに対して機能（Lua化しないと実現が難しい機能）が不足しており、今後機能追加等も予定されていません。可能な限り仮リンクテンプレートを使用してください。

使い方

{{仮リンク|日本語版項目名|言語プレフィックス|他言語版項目名|...}} （全引数必須）

日本語版項目名へのリンクを張ります。リンク先ページがまだ作成されていない（いわゆる「赤リンク」）間は、「（言語名版）」と表示される、他言語版の記事へのリンクが作成されます。記事ができると、普通のリンクだけになります。リンク先は、言語プレフィックスと他言語版項目名で指定します。

他言語版のページは、4つまで指定できます。

他言語版の記事の存在確認はされず、「言語名版」は特に設定していない場合、青リンクとなります。

注意

他言語版へのリンクは、ページを印刷した場合には表示されません。印刷時には、あまり意味がないからです。

使用例

日本語版の指定された記事名が未作成の場合

入力：{{仮リンク|ジョン・マッキャニー|en|John McCanny}}
出力：ジョン・マッキャニー（英語版）

他言語版ではなくwikidataを指定する場合

入力：{{仮リンク|ジョン・マッキャニー|wikidata|Q6247442}}
出力：ジョン・マッキャニー（wikidata）

{{日本語版にない記事リンク}}は同様のテンプレートですが、他言語版のページ名も表示します

入力：{{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny}}
出力：ジョン・マッキャニー（英語: John McCanny）

基本的には、{{仮リンク}}を使って下さい。ノート#日本語版にない記事リンク参照。

同じ言語版で、指定された記事名が作成済みの場合

入力：{{仮リンク|ディエゴ・マラドーナ|en|Diego Maradona}}
出力：ディエゴ・マラドーナ

"preserve"を指定した場合

入力：{{仮リンク|ディエゴ・マラドーナ|en|Diego Maradona|preserve=1}}
出力：ディエゴ・マラドーナ（英語版）

曖昧さ回避などで括弧付きのページ名の場合、"label"を指定できます。

入力：{{仮リンク|怒りの日 (映画)|label=怒りの日|en|Day of Wrath}}
出力：怒りの日

引数

引数の一覧
指定内容	既定値	説明
項目名	必須	日本語版で記事を作るときに望ましいと考える項目名。（Wikipedia:記事名の付け方も参照）
言語	-	他言語版にすでに記事がある場合、その言語コード。
ページ	-	同上、その言語版でのページ名。
label=表示	項目名	リンクに表示したいテキストを、項目名に指定した項目名と異なる場合に指定。通常の内部リンクでパイプ (\|) のあとに書くものと同じ。
preserve	-	日本語版記事が存在する場合でも他言語版リンクを表示するかどうか。任意の値の指定で強制表示。
redirect	-	日本語版記事がリダイレクトの場合で、リダイレクトページの記事化が望まれる場合に指定。任意の値の指定で他言語版リンクを強制表示。
FIXME	-	何らかの理由でテンプレートに修正が必要な場合に指定。任意の値の指定で「Category:修正が必要な仮リンクを含む記事」に追加。現在仮リンクの整備はbotで行われているので、ご意見・要望がございましたら、運用者にお問い合わせください。
br	-	表の中などで言語版表示の前に改行を入れる場合に任意の値を指定。

言語とページは4組まで指定できます。

TemplateData

リンク先の記事が存在しないの時、他言語版へのリンクを表示します。{{仮リンク}}テンプレートの使用を推奨します。

テンプレートパラメーター
このテンプレートは、パラメーターを1行で記述することが推奨されています。
パラメーター		説明	型	状態
項目名	`1`	日本語版で記事を作るときに望ましいと考える項目名。	ページ名	必須
言語 (1)	`2`	他言語版の言語コード	文字列	必須
ページ (1)	`3`	「言語 (1)」で「項目名」に相当するページ名。	ページ名	必須
言語 (2)	`4`	他言語版の言語コード	文字列	省略可能
ページ (2)	`5`	「言語 (2)」で「項目名」に相当するページ名。	ページ名	省略可能
言語 (3)	`6`	他言語版の言語コード	文字列	省略可能
ページ (3)	`7`	「言語 (3)」で「項目名」に相当するページ名。	ページ名	省略可能
言語 (4)	`8`	他言語版の言語コード	文字列	省略可能
ページ (4)	`9`	「言語 (4)」で「項目名」に相当するページ名。	ページ名	省略可能
ラベル	`label`	項目名へのリンクに付けるラベル	文字列	省略可能
他言語版リンクを強制表示	`preserve`	日本語版記事が存在する場合でも他言語版リンクを表示するかどうか例 1 自動入力値 `1`	ブール値	省略可能
日本語版記事がリダイレクト	`redirect`	日本語版記事がリダイレクトであり、リダイレクトページの記事化が望まれる場合に指定例 1 自動入力値 `1`	ブール値	省略可能
要修正	`FIXME`	何らかの理由でテンプレートに修正が必要な場合に指定。例 1 自動入力値 `1`	ブール値	省略可能
改行	`br`	表の中などで言語版表示の前に改行を入れる場合に指定。例 1 自動入力値 `1`	ブール値	省略可能

カテゴリ

日本語版での記事が作成された場合には、本テンプレートを含むページは隠しカテゴリCategory:解消済み仮リンクを含む記事に分類されます。この機能は2012年9月に追加されました。日本語版の記事がリダイレクトの場合には、隠しカテゴリCategory:日本語版記事がリダイレクトの仮リンクを含む記事に分類されます。この機能は2017年12月に追加されました。