「テンプレート:日本語版にない記事リンク/doc」を編集中

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<includeonly>{{Lua|モジュール:仮リンク}}</includeonly>
リンク先の記事が存在しない（いわゆる[[赤リンク]]の）とき、[[他言語版]]へのリンクを表示します。

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

__TOC__

== 使い方 ==
 <nowiki>{{</nowiki>日本語版にない記事リンク|''日本語版記事名''|''言語コード''|''他言語版記事名''}}

''日本語版記事名''へのリンクを張ります。[[赤リンク]]である間は、''言語コード''（正確には[[Wikipedia:エディションコード]]）と''他言語版記事名''で指定する他言語プロジェクトの記事へのリンクが張られます。記事ができると、他言語版へのリンクは表示されなくなります。リンクラベルには他言語版記事名が用いられます。

よって、本テンプレートは[[日本語版ウィキペディア|日本語版]]での記事が作成されるまで'''一時的'''に他言語での記事名も表示させておいたほうが読者にとって有用な場合に使用されることを想定されています。作成後も'''恒久的'''に他言語での記事名も表示させておいたほうが読者にとって有用な場合には、{{tl|Lang}}テンプレートを用いてください。

また、他言語での記事名がそもそも不要な場合、{{tl|仮リンク}}を用いてください。現在の実装は同一の[[Wikipedia:モジュール|モジュール]]（[[モジュール:仮リンク]]）によって行われているため、各テンプレート固有の引数以外は同一の動作がサポートされています。

[[半角]]の[[空白文字]]( )と[[アンダースコア]](_)の間などで違っていても正しくリンクされますが（[[Help:ページ名]]）、表示は指定されたとおりとなります。

== 表示例 ==
記事が未作成の場合
* 入力: <code><nowiki>{{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny}}

空白を[[アンダースコア]]としたり、<!-- [[ウィクショナリー]]以外では -->1文字目の[[大文字小文字]]が違っても、リンクは有効ですが（[[Help:ページ名]]）、記事名は指定したまま表示されます。
* 入力: <code><nowiki>{{日本語版にない記事リンク|ジョン・マッキャニー|en|John_McCanny}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|ジョン・マッキャニー|en|John_McCanny}}

外国語版にも存在しない/記事名を間違えた場合でも、外国語版へのリンクは赤くなりません。
* 入力: <code><nowiki>{{日本語版にない記事リンク|存在しない記事名|en|arimahen}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|存在しない記事名|en|arimahen}}

{{tl|仮リンク}}は類似のテンプレートですが、言語名のみ表示され記事名は表示されません。
* 入力: <code>{{tlp|仮リンク|ジョン・マッキャニー|en|John McCanny}}</code>
* 出力: {{仮リンク|ジョン・マッキャニー|en|John McCanny}}

記事が作成済みの場合、他言語版へのリンクは表示されません。
* 入力: <code><nowiki>{{日本語版にない記事リンク|ディエゴ・マラドーナ|en|Diego Maradona}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|ディエゴ・マラドーナ|en|Diego Maradona}}

記事中で表示する文字と異なった日本語版ウィキペディアへの赤リンク先を生成したい場合、例えば[[曖昧さ回避]]のカッコを伴った記事へのリンクを作成する場合は<code>label</code>パラメータを設定することで実現できます。
* 入力: <code><nowiki>{{日本語版にない記事リンク|怒りの日 (映画)|label=怒りの日|en|Day of Wrath}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|怒りの日 (映画)|label=怒りの日|en|Day of Wrath}}

他言語版記事名の方も同様に、記事中で表示する文字と異なったリンク先としたい場合、例えば曖昧さ回避のカッコを伴った記事へのリンクを作成する場合は<code>interwikilabel</code>パラメータを設定することで実現できます。
* 入力: <code><nowiki>{{日本語版にない記事リンク|ジョン・ポラード (数学者)|label=ジョン・ポラード|en|John Pollard (mathematician)|interwikilabel=John Pollard}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|ジョン・ポラード (数学者)|label=ジョン・ポラード|en|John Pollard (mathematician)|interwikilabel=John Pollard}}

すでに一度以上{{tl|lang-en}}などを使っていて、「[[英語]]」などへのリンクが不要な場合は<code>links</code>パラメータに<code>no</code>の引数を渡してください。
* 入力: <code><nowiki>{{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny|links=no}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny|links=no}}

また、言語名を略称（英語に対する「英」）で表示したい場合は、<code>short</code>パラメータに<code>on</code>の引数を渡してください。
* 入力: <code><nowiki>{{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny|short=on}}</nowiki></code>
* 出力: {{日本語版にない記事リンク|ジョン・マッキャニー|en|John McCanny|short=on}}

<code>short</code>パラメータと<code>links</code>パラメータは併用可能です。

日本語版で記事が作成された後も他言語版での記事名を表記しておきたい場合は、{{tl|Lang}}と{{tl|仮リンク}}の併用で実現できます。
* 入力: <code>{{tlp|仮リンク|存在しないページ|en|English Page}}（{{tlp|Lang-en|English Page}}）</code>
* 出力: {{仮リンク|存在しないページ|en|English Page}}（{{Lang-en|English Page}}）

空白をアンダースコアで入力してしまった場合
* 入力: <code>{{tlp|仮リンク|存在しないページ|en|Wikimedia_Foundation}}（{{tlp|Lang-en|Wikimedia_Foundation}}）</code>
* 出力: {{仮リンク|存在しないページ|en|Wikimedia_Foundation}}（{{Lang-en|Wikimedia_Foundation}}）

== 引数 ==
{| class="wikitable" border="1"
|+ 引数の一覧
! 引数名 !! 指定内容 !! 既定値 !! 説明
|-
! 1
! ''日本語記事名''
| 必須 || 日本語版で記事を作るときに望ましいと考える項目名。
|-
! 2
! ''言語コード''
| 必須 || 他言語版にすでに記事がある場合、その言語コード。
|-
! 3
! ''他言語版記事名''
| 必須 || 同上、ページ名。
|-
! label
! ''リンクラベル名''
| <nowiki>-</nowiki> || リンク文字列に変更が必要な場合（例えば曖昧さ回避括弧がある場合）などに使用する。
|-
! interwikilabel
! ''他言語版リンクラベル名''
| <nowiki>-</nowiki> || リンク文字列に変更が必要な場合（例えば曖昧さ回避括弧がある場合）などに使用する。
|-
! short
! ''言語名の省略の有無''
| off || 言語名を省略して表示する際に追加する。
|-
! links
! ''言語名へのリンクの有無''
| yes || 言語名へのリンクを行わないで表示する際に追加する。
|-
!preserve
! ''他言語版リンクを強制表示''
|<nowiki>-</nowiki>||日本語版記事が存在する場合でも他言語版リンクを表示するかどうか。任意の値の指定で強制表示。
|-
!redirect
! ''日本語版記事がリダイレクト''
|<nowiki>-</nowiki>||日本語版記事がリダイレクトの場合で、リダイレクトページの記事化が望まれる場合に指定。任意の値の指定で他言語版リンクを強制表示。
|-
!FIXME
! ''要修正''
|<nowiki>-</nowiki>||何らかの理由でテンプレートに修正が必要な場合に指定。任意の値の指定で「[[:Category:修正が必要な仮リンクを含む記事]]」に追加。現在仮リンクの整備は[[利用者:cewbot|bot]]で行われているので、ご意見・要望がございましたら、[[利用者‐会話:Kanashimi|運用者にお問い合わせ]]ください。
|-
!br
! ''改行''
|<nowiki>-</nowiki>||表の中などで言語版表示の前に改行を入れる場合に任意の値を指定。
|}

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

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "リンク先の記事が存在しない(いわゆる「赤リンク」)の時、他言語版へのリンクを表示します。{{仮リンク}}は類似のテンプレートですが、{{仮リンク}}の方が圧倒的に多く使われているため、よく整備されています。 {{仮リンク}}の使用を、優先的に考えて下さい。[[Template‐ノート:仮リンク#日本語版にない記事リンク]]参照。",
	"params": {
		"1": {
			"label": "日本語記事名",
			"description": "日本語版で記事を作るときに望ましいと考える項目名。",
			"type": "string",
			"required": false
		},
		"2": {
			"label": "言語コード",
			"description": "他言語版にすでに記事がある場合、その言語コード。",
			"type": "string",
			"required": false
		},
		"3": {
			"label": "他言語版記事名",
			"description": "他言語版にすでに記事がある場合、そのページ名。",
			"type": "string",
			"required": false
		},
		"label": {
			"label": "リンクラベル名",
			"description": "リンク文字列に変更が必要な場合（例えば曖昧さ回避括弧がある場合）などに使用する。",
			"type": "string",
			"required": false
		},
		"interwikilabel": {
			"label": "他言語版リンクラベル名",
			"description": "リンク文字列に変更が必要な場合（例えば曖昧さ回避括弧がある場合）などに使用する。",
			"type": "string",
			"required": false
		},
		"short": {
			"label": "言語名の省略の有無",
			"description": "言語名を省略して表示する際に追加する。",
			"example": "on（省略するときのみ）",
			"type": "string",
			"required": false
		},
		"links": {
			"label": "言語名へのリンクの有無",
			"description": "言語名へのリンクを行わないで表示する際に追加する。",
			"example": "no（リンクを行わない時のみ）",
			"type": "string",
			"required": false
		},
		"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": "boolean"
		},
		"br": {
			"label": "改行",
			"description": "表の中などで言語版表示の前に改行を入れる場合に指定。",
			"example": "1",
			"autovalue": "1",
			"type": "boolean"
		}
	}
}
</templatedata>

== 関連項目 ==
* {{Tl|Interlang}} - リンクだけを生成する。
* {{Tl|仮リンク}} - 他言語版での記事名を表示させたくない場合。

<includeonly>{{Sandbox other||
<!-- カテゴリと言語間リンクは以下に追加してください -->
{{DEFAULTSORT:にほんこはんにないきしりんく}}
[[Category:内部リンク用テンプレート]]
[[Category:翻訳テンプレート]]
[[Category:インターウィキリンク用テンプレート]]


}}
</includeonly>