テンプレート:仮リンク/docのソースを表示

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<includeonly>{{使用箇所の多いテンプレート|189,000以上}}</includeonly>
{{Lua|モジュール:仮リンク}}
{{Bot use warning|bots=[[user:cewbot]]}}
{{COinS safe|n}}
{{tsh|Interlanguage link|Ill}}
{{記事の翻訳}}
[[ハイパーリンク|リンク]]先の[[Wikipedia:記事|記事]]が存在しない（いわゆる[[Wikipedia:REDLINK|赤リンク]]の）とき、他言語版（[[Wikipedia:ウィキペディアの一覧]]を参照）へのリンクを表示します。

他言語版へのリンクを表示することで読者、編集者への便宜とともに、赤リンク自体は残すことで、編集者には執筆をうながす効果が期待されます。

また、[[日本語版ウィキペディア]]記事が「存在」する場合でも、日本語版の記事の内容が不十分な場合などに、preserve引数を指定すると、参考リンクとして他言語版へのリンクが表示され、日本語版記事の発展をうながすことができます。

他言語での記事名を表示させておいたほうが読者にとって有用であると考えられる場合には{{tl|日本語版にない記事リンク}}の使用も検討してください。これには数学などの定理名や人名などが該当します。{{see|[[Template‐ノート:仮リンク#日本語版にない記事リンク|ノートの議論]]}}

== 使い方 ==
{{tlp|仮リンク|''[[日本語版ウィキペディア|日本語版]]項目名''|''[[Wikipedia:言語コード|言語プレフィックス]]など''|''他言語版項目名''|...}}
（全引数必須）<!-- ソフトウェア名などで「ページ」が同じ場合は省略できるようにテンプレートをつくれるけど、あえてやらない（理由？）-->

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

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

他言語版等の記事の存在確認はされず（あえてjaとして日本語版を指定されたものには行われます）、「''言語名''版」等は特に[[wikipedia:ユーザーCSS|ユーザーCSS]]等で設定していない場合、青リンクとなります。

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

[[ハングル文字]]の[[韓国語版ウィキペディア]](ko)を指定した場合は、「[[韓国語]]」ではなく「[[朝鮮語]]」と表示されます。（参考：[[朝鮮語の呼称問題]]）[[言語コード]]と[[ISO 3166-1 alpha-2]]の[[韓国]]の[[国コード]]を使ってko-krというような指定も[[大文字小文字]]いずれもできません（[https://ko-kr.wikipedia.org ko-kr.wikipedia.org]は存在しない）

== 使用例 ==
=== 日本語版の指定された記事名が未作成の場合 ===
* 入力：<code><nowiki>{{仮リンク|ジョン・マッキャニー|en|John McCanny}}</nowiki></code>
* 出力：{{仮リンク|ジョン・マッキャニー|en|John McCanny}}
複数の言語版を指定する場合
* 入力：<code><nowiki>{{仮リンク|ウェールズ独立運動|en|Welsh independence|simple|Welsh independence}}</nowiki></code>
* 出力：{{仮リンク|ウェールズ独立運動|en|Welsh independence|simple|Welsh independence}}
他言語版ではなく[[ウィキデータ]]を指定する場合
* 入力：<code><nowiki>{{仮リンク|ジョン・マッキャニー|wikidata|Q6247442}}</nowiki></code>
* 出力：{{仮リンク|ジョン・マッキャニー|wikidata|Q6247442}}
言語指定部には言語コード、wikidata以外の語句には対応しません。例えば、それ以外の[[ウィキメディア財団#ウィキメディア財団のプロジェクト|他プロジェクト]]を指定しようとしてもエラーとなります。
* 入力：<code><nowiki>{{仮リンク|ジョン・マッキャニー|wikt|example}}</nowiki></code>
* 出力：{{仮リンク|ジョン・マッキャニー|wikt|example}}
記事名と違う名前で表記する場合は、"label"を指定できます。
* 入力：<code><nowiki>{{仮リンク|ウェールズ独立運動|en|Welsh independence|label=ウェールズの独立}}</nowiki></code>
* 出力：{{仮リンク|ウェールズ独立運動|en|Welsh independence|label=ウェールズの独立}}
{{tl|日本語版にない記事リンク}}は同様のテンプレートですが、他言語版のページ名も表示します
* 入力：<code><nowiki>{{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny}}</nowiki></code>
* 出力：{{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny}}
基本的には、{{tl|仮リンク}}を使って下さい。[[Template‐ノート:仮リンク#日本語版にない記事リンク|ノート#日本語版にない記事リンク]]参照。

=== 同じ言語版で、指定された記事名が作成済みの場合 ===
[[Wikipedia:リダイレクト|リダイレクト]]かどうか、ループリンクかどうかのチェックはしません。
* 入力：<code><nowiki>{{仮リンク|ディエゴ・マラドーナ|en|Diego Maradona}}</nowiki></code>
* 出力：{{仮リンク|ディエゴ・マラドーナ|en|Diego Maradona}}
"preserve"を指定した場合。
* 入力：<code><nowiki>{{仮リンク|ディエゴ・マラドーナ|en|Diego Maradona|preserve=1}}</nowiki></code>
* 出力：{{仮リンク|ディエゴ・マラドーナ|en|Diego Maradona|preserve=1}}
===redirect引数===
リダイレクトの記事化が望まれる場合。preserveと同様に他言語版へのリンクが残ります。
* 入力：<code><nowiki>{{仮リンク|Wikipedia:記事名|en|Wikipedia:Article titles|redirect=1}}</nowiki></code>
* 出力：{{仮リンク|Wikipedia:記事名|en|Wikipedia:Article titles|redirect=1}}

== 引数 ==
{| class="wikitable"
|+引数の一覧
!指定内容!!既定値!!説明
|-
!項目名
|必須||日本語版で記事を作るときに望ましいと考える項目名。（[[Wikipedia:記事名の付け方]]も参照）
|-
!言語
|<nowiki>-</nowiki>||[[Wikipedia:多言語プロジェクトとしてのウィキペディア|他言語版]]にすでに記事がある場合、その[[Wikipedia:言語コード|言語コード]]。[[ウィキデータ]]を指定する場合はwikidata。
|-
!ページ
|<nowiki>-</nowiki>||同上、その言語版でのページ名。
|-
!label=表示
|項目名||リンクに表示したいテキストを、''項目名''に指定した項目名と異なる場合に指定。<br>通常の内部リンクでパイプ (&#x7C;) のあとに書くものと同じ。
|-
!preserve
|<nowiki>-</nowiki>||日本語版記事が存在する場合でも他言語版リンクを表示するかどうか。任意の値の指定で強制表示。
|-
!redirect
|<nowiki>-</nowiki>||日本語版記事がリダイレクトの場合で、リダイレクトページの記事化が望まれる場合に指定。任意の値の指定で他言語版リンクを強制表示。ループリンクかどうかの判定はしていません。
|-
!FIXME
|<nowiki>-</nowiki>||何らかの理由でテンプレートに修正が必要な場合に指定。任意の値の指定で「[[:Category:修正が必要な仮リンクを含む記事]]」に追加。現在仮リンクの整備は[[利用者:cewbot|bot]]で行われているので、ご意見・要望がございましたら、[[利用者‐会話:Kanashimi|運用者にお問い合わせ]]ください。
|-
!br
|<nowiki>-</nowiki>||表の中などで言語版表示の前に改行を入れる場合に任意の値を指定。
|}
''言語''と''ページ''は4組まで指定できます。

== TemplateData ==
<templatedata>
{
	"description": "リンク先の記事が存在しないの時、他言語版へのリンクを表示します。",
	"params": {
		"1": {
			"label": "項目名",
			"description": "日本語版で記事を作るときに望ましいと考える項目名。",
			"type": "line",
			"required": true
		},
		"2": {
			"label": "言語 (1)",
			"description": "他言語版の言語コード",
			"type": "line",
			"required": true
		},
		"3": {
			"label": "ページ (1)",
			"description": "「言語 (1)」で「項目名」に相当するページ名。",
			"inherits": "1",
			"required": true,
			"type": "line"
		},
		"label": {
			"label": "ラベル",
			"description": "項目名へのリンクに付けるラベル",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"preserve": {
			"label": "他言語版リンクを強制表示",
			"description": "日本語版記事が存在する場合でも他言語版リンクを表示する",
			"type": "boolean",
			"required": false,
			"example": "1",
			"autovalue": "1"
		},
		"redirect": {
			"label": "リダイレクトのとき他言語版リンクを強制表示",
			"description": "日本語版記事がリダイレクトとして存在する場合でも他言語版リンクを表示する（記事として存在する場合には表示しない）",
			"type": "boolean",
			"required": false,
			"example": "1",
			"autovalue": "1"
		},
		"FIXME": {
			"label": "要修正",
			"description": "何らかの理由でテンプレートに修正が必要な場合に指定。",
			"example": "1",
			"autovalue": "1",
			"type": "content"
		},
		"br": {
			"label": "改行",
			"description": "表の中などで言語版表示の前に改行を入れる場合に指定。",
			"example": "1",
			"autovalue": "1",
			"type": "boolean"
		},
		"4": {
			"label": "言語 (2)",
			"description": "他言語版の言語コード",
			"inherits": "2",
			"required": false
		},
		"5": {
			"label": "ページ (2)",
			"description": "「言語 (2)」で「項目名」に相当するページ名。",
			"inherits": "3",
			"required": false,
			"type": "line"
		},
		"6": {
			"label": "言語 (3)",
			"description": "他言語版の言語コード",
			"inherits": "4"
		},
		"7": {
			"label": "ページ (3)",
			"description": "「言語 (3)」で「項目名」に相当するページ名。",
			"inherits": "5",
			"type": "line"
		},
		"8": {
			"label": "言語 (4)",
			"description": "他言語版の言語コード",
			"inherits": "4"
		},
		"9": {
			"label": "ページ (4)",
			"description": "「言語 (4)」で「項目名」に相当するページ名。",
			"inherits": "5",
			"type": "line"
		}
	}
}
</templatedata>

== カテゴリ ==
{| class="wikitable"
|+適用カテゴリ表
!日本語版記事作成状況!!preserve引数指定!!FIXME引数指定!!適用カテゴリ!!備考
|-
|未作成||-||なし||なし||
|-
|未作成||-||あり||[[:Category:修正が必要な仮リンクを含む記事]]||
|-
|リダイレクト||-||なし||[[:Category:日本語版記事がリダイレクトの仮リンクを含む記事]]||
|-
|リダイレクト||-||あり||[[:Category:日本語版記事がリダイレクトの仮リンクを含む記事]]<br/>[[:Category:修正が必要な仮リンクを含む記事]]||
|-
|作成済み||なし||なし||[[:Category:解消済み仮リンクを含む記事]]||仮リンクの存在するページが標準名前空間以外の場合、[[:Category:解消済み仮リンクを含むページ]]に分類
|-
|作成済み||なし||あり||[[:Category:修正が必要な仮リンクを含む記事]]||{{tl|仮リンク2}}では[[:Category:解消済み仮リンクを含む記事]]にも分類
|-
|作成済み||あり||なし||なし||
|-
|作成済み||あり||あり||[[:Category:修正が必要な仮リンクを含む記事]]||

|}

== 別名 ==
* <nowiki>{{ill2}}</nowiki> - [[英語版ウィキペディア]]でも同じ ([[:en:Template:ill2]]) 名称。1文字目は「アイ」(i) で2、3文字目は小文字の「エル」(l) です。
* <nowiki>{{Link-interwiki}}</nowiki>（非推奨） - 英語版[[:en:Template:Link-interwiki]]とは利用法が異なるため。英語版Link-interwikiの言語間リンクには{{tl|日本語版にない記事リンク}}が採用されています。

== 関連項目 ==
* {{tl|仮リンク2}} - 仮リンク2は原則使用しないでください。仮リンクでは記事の存在のチェックを行っていますが、[[Wikipedia:Lua|Luaモジュール]]では、その高負荷な処理の制限（1ページ500回まで）が厳密になります。1ページで500回以上本テンプレートを使用したい場合は、本テンプレートの代わりに仮リンク2を使用することで回避可能です。仮リンク2を使用する前にサーバ負荷やページの読み込み時間等のデメリットについて理解した上で、本当に仮リンクの使用が適切であるか検討してください。
* {{tl|日本語版にない記事リンク}} - 同様のテンプレートですが、「（''言語名''版）」の代わりに、「（''言語名'': ''記事名''）」と表示されます。
* {{tl|enlink}} - 仮リンクの「（''言語名''）」部分と同様な外国語版の記事名の表示を行う。英語版以外へのリンクもできる。
* {{tl|autolink}} - リンク先が存在しない場合は、赤リンクの代わりに普通の文字を表示します。記事の中で使うテンプレートではありません。
* {{tl|赤リンク別表示}} - {{tlc|autolink}}と類似のテンプレートですが、赤リンクの時には別の文字を表示します。
* [[Wikipedia:翻訳のガイドライン]]
* [[:Category:解消済み仮リンクを含む記事]]
* [[:Category:日本語版記事がリダイレクトの仮リンクを含む記事]]
* [[Help:言語間リンク]]
* [[モジュール:仮リンク]]

<includeonly>
<!-- カテゴリは以下に追加してください -->
{{デフォルトソート:かりりんく}}
[[Category:内部リンク用テンプレート]]
[[Category:翻訳テンプレート]]
[[Category:インターウィキリンク用テンプレート]]
</includeonly>