「テンプレート:Refn/doc」を編集中

<includeonly>{{pp-template}}</includeonly>{{Template shortcut|refn}}
[[Help:脚注|脚注]] {{tag|ref}} を入れ子にするためのテンプレートです。[[Help:マジックワード|マジックワード]] <code><nowiki>{{#tag:ref| }}</nowiki></code> を利用しています。

__TOC__
== 使い方 ==
通常の {{tag|ref|open}} タグを用いた文章を、さらにこのテンプレートで囲ってください

※2015年9月13日現在、'''脚注文章の中に"="(ASCII文字のイコール）が含まれているとエラーになります'''。回避策として<code>&amp;#61;</code>または{{tl|1==}}を使用してください。もしくは暗黙の引数部分を {{Para|1|脚注文章}} と明示的に示す形でも構いません。

{| class="wikitable"
|-
| style="width:50%;vertical-align/top" | <syntaxhighlight lang="xml">ここに本文を書きます{{Refnest|group="注"|ここに脚注の文章を書きます<ref name="a">ここに出典などを書きます。</ref><ref>出典2。</ref><ref name="a" />。}}。

=== 注釈 ===
{{Reflist|group="注"}}

=== 出典 ===
{{Reflist}}
</syntaxhighlight>
|| 
ここに本文を書きます{{Refnest|group="注"|ここに脚注の文章を書きます<ref name="a">ここに出典などを書きます。</ref><ref>出典2。</ref><ref name="a" />。}}。

'''注釈'''
{{Reflist|group="注"}}

'''出典'''
{{Reflist|close}}
|}

'''引数 name を使う場合'''
{| class="wikitable"
|-
| style="width:50%;vertical-align/top" | <syntaxhighlight lang="xml">ここに本文を書きます{{Refnest|group="注"|name="b"|ここに脚注の文章を書きます<ref name="b">ここに出典などを書きます。</ref><ref>出典2。</ref><ref name="b" />。}}。続いて本文を書きます<ref group="注" name="b" />。

=== 注釈 ===
{{Reflist|group="注"}}

=== 出典 ===
{{Reflist}}
</syntaxhighlight>
|| 
ここに本文を書きます{{Refnest|group="注"|name="b"|ここに脚注の文章を書きます<ref name="b">ここに出典などを書きます。</ref><ref>出典2。</ref><ref name="b" />。}}。続いて本文を書きます<ref group="注" name="b" />。

'''注釈'''
{{Reflist|group="注"}}

'''出典'''
{{Reflist|close}}
|}

=== リスト定義時のエラー ===
ソースコード上で脚注を記述するとき、本文内のリンク記号位置でなく脚注表示位置に記述することができます。たとえば <code><nowiki><ref name="○○">...</ref></nowiki></code> のように記述された脚注を、<code><nowiki><references>...</references></nowiki></code> 内に置く、または <code><nowiki>{{</nowiki>[[Template:Reflist|Reflist]]|refs=...<nowiki>}}</nowiki></code> 内に置くなどの方法があります（「リスト定義」。詳細は[[H:LDR]]を参照）。

しかし、現在のところ、ここで{{tl|Refnest}}を用いても正常に動作しません。たとえば次のコードはエラーとされます。

{| class="wikitable"
!記述例!!表示結果
|-
| style="width:50%"| <syntaxhighlight lang="xml">
記事本文です<ref group="注" name="noteA" /><ref group="注" name="noteB" />。

== 脚注 ==
=== 注釈 ===
{{Reflist|group="注"|refs=
<ref group="注" name="noteA">この脚注は正常に生成されません。</ref>
{{Refnest|group="注"|name="noteB"|このように入れ子脚注をリスト定義したとき、それより先に記述されたリスト定義脚注が正常に生成されず、その個数分、後の脚注が表示されなくなります<ref>この脚注は表示されます。</ref><ref>この脚注は表示されません。</ref>。また、以下のようなエラーメッセージが表示されます。}}
}}

=== 出典 ===
{{Reflist}}
</syntaxhighlight>
| <!-- 以上、記述例。以下、表示結果 -->
記事本文です<ref group="注" name="noteA" /><ref group="注" name="noteB" />。

<span style="font-size: 115%">'''脚注'''</span>
----
'''注釈'''
{{Reflist|group="注"|refs=
<ref group="注" name="noteA">この脚注は正常に生成されません。</ref>
{{Refnest|group="注"|name="noteB"|このように入れ子脚注をリスト定義したとき、それより先に記述されたリスト定義脚注が正常に生成されず、その個数分、後の脚注が表示されなくなります<ref>この脚注は表示されます。</ref><ref>この脚注は表示されません。</ref>。また、以下のようなエラーメッセージが表示されます。}}
}}

'''出典'''
{{Reflist}}
|}

この問題の詳細については[[:phab:T22707]]を参照してください。

== 引数 ==
{| class="wikitable" border="1"
|+ 引数の一覧
! 引数 !! 指定内容 !! 既定値 !! 説明
|-
! 1
| 脚注の本文 ||  || 
|-
! group
| グループ名 ||  || <nowiki><ref group="">{{{1}}}</ref></nowiki> に相当します。
|-
! name
| 識別名 ||  || <nowiki><ref name="">{{{1}}}</ref></nowiki> に相当します。
|}

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "内側に refタグを入れ子にするために使います。",
	"params": {
		"1": {
			"aliases": [
				"refn"
			],
			"label": "本文",
			"description": "表示する内容",
			"type": "string",
			"required": true
		},
		"name": {
			"label": "refタグの名前",
			"description": "その注釈を複数回使う場合は、2回目以降のname指定用の文字を入力。最初の一文字目が半角数字であってはならない。",
			"type": "line"
		},
		"group": {
			"label": "refタグのグループ",
			"description": "refタグをグループ分けする場合は、グループ名を入力。",
			"example": "注",
			"type": "line"
		}
	},
	"format": "inline"
}
</templatedata>

== 関連するテンプレート ==
* {{tl|Efn}} - 脚注を入れ子にする別のテンプレート（主に注釈用）

== 関連項目 ==
* [[Help:脚注#脚注を入れ子にしたいとき]]
* [[Help:マジックワード]]
<includeonly>
[[Category:脚注テンプレート]]
</includeonly>