テンプレート:Sfn/doc - 変更履歴

由亜辺出夫: 説明文の修正

2018-05-29T03:26:32Z

説明文の修正

由亜辺出夫: カテゴリリンク修正

2018-04-25T08:48:41Z

カテゴリリンク修正

2018年4月19日 (木) 07:42に由亜辺出夫による

2018-04-19T07:42:55Z

2018年4月19日 (木) 07:42に由亜辺出夫による

2018-04-19T07:42:17Z

由亜辺出夫: カテゴリリンク追加

2018-04-19T07:39:47Z

カテゴリリンク追加

由亜辺出夫: 新規作成

2018-04-12T15:46:26Z

新規作成

新規ページ

'''Sfn'''は、著者姓-発行年方式で略記された出典注（脚注）の記載を支援するためのテンプレートです。脚注（refタグ）を生成して名寄せのための名前（name）を付し、脚注に記した著者姓-発行年から同一記事内にあるidが一致する最初のCite系テンプレートへの内部リンクを生成します。「Sfn」は'''S'''hortened '''f'''oot'''n'''ote（略記された脚注）を意味します。

== 使い方 ==
例えば、佐藤某さんの2018年の著書の19-20頁が出典の場合、脚注を付したい箇所に
<nowiki>これこれこうである{{Sfn|佐藤|2018|pp=19-20}}。</nowiki>
のように記します。この入力は、内部で、
<nowiki>これこれこうである<ref name=FOOTNOTE佐藤201819-20>[[#CITEREF佐藤2018|佐藤 2018 ]] 19-20 </ref>。</nowiki>
と解釈されます。ここで、
#refタグが付されること
#refタグに「FOOTNOTE佐藤201819-20」という名前が付されること、従って同じ名前の付されたrefタグが別にあれば、自動的に名寄せされること
#同じ記事の中にある「CITEREF佐藤2018」というidへの内部リンクが生成されること、従って別途「CITEREF佐藤2018」というアンカーを作成すれば内部参照ができること
にご留意ください。出力は、
これこれこうである{{Sfn|佐藤|2018|pp=19-20}}。
となります。通常のRefタグと同じように、脚注節に<nowiki>{{Reflist}}</nowiki>か<nowiki><references /></nowiki>を書いておくと、そこに脚注が表示されます。

=== 脚注（表示例） ===
{{Reflist}}

この例の場合、脚注から参考文献への内部参照を完成させるには、同じ記事の中に、別途Cite系のテンプレートを用いて参考文献を記し、その際、著者姓（last）に「佐藤」、発行年（year）に「2018」を指定すると、「CITEREF佐藤2018」というアンカーが生成されます。

== 開発の意図 ==
条件文を使わないという制約下で、WikipediaのSfnテンプレートと互換性を持つように作成しました。

条件文を使用しない（場合分けが難しい）という前提があるため、
#句読点、カンマ、ピリオド、＆、括弧は表示しません。ただし、句点ないしピリオドは、引数「ps」（追記事項）に記すことによって表示できます。
#著者姓が4人まで指定できる点はWikipediaのテンプレートと同様ですが、4人のときに出力表示が省略されることはありません。
#頁などの参照範囲を指定する引数「p=」「pp=」「loc=」の指定内容はいずれも出力表示されますが、数字の前の「p.」「pp.」は表示しません。「佐藤 2018 pp.19-20」「佐藤 2018 19-20頁」のように表示したい場合は、入力するときに「pp=pp.19-20」「pp=19-20頁」のように指定してください。

== 引数一覧 ==
{| class="wikitable" style="text-align:left"
|-
! 引数 !! 意味 !! 既定値 !! 入力の要否
|-
! (1)
| 著者姓1 || NULL || 必要
|-
! (2)
| 発行年または著者姓2 || NULL || 必要
|-
! (3)
| NULLまたは発行年または著者姓3 || NULL || 可略
|-
! (4)
| NULLまたは発行年または著者姓4 || NULL || 可略
|-
! (5)
| NULLまたは発行年 || NULL || 可略
|-
! p
| 単一頁番号 || NULL || 可略
|-
! pp
| 複数頁番号 || NULL || 可略
|-
! loc（locationの略）
| 参照範囲（章、節など） || NULL || 可略
|-
! ps（postscriptの略）
| 追記事項 || NULL || 可略
|}

== 入出力例 ==
{| class="wikitable" style="text-align:left"
|-
! 事例 !! 入力 !! 理想の出力（内部リンクは省略） !! 現状の出力（同）
|-
!著者1人、複数頁指定
| <nowiki>{{Sfn|佐藤|2018|pp=19-20}}</nowiki> || 佐藤 2018, pp.19-20. || 佐藤 2018 19-20
|-
!同2人、同
| <nowiki>{{Sfn|佐藤|鈴木|2018|pp=19-20}}</nowiki> || 佐藤 & 鈴木 2018, pp.19-20. || 佐藤鈴木 2018 19-20
|-
!同3人、同
| <nowiki>{{Sfn|佐藤|鈴木|高橋|2018|pp=19-20}}</nowiki> || 佐藤, 鈴木 & 高橋 2018, pp.19-20. || 佐藤鈴木高橋 2018 19-20
|-
!同4人、同
| <nowiki>{{Sfn|佐藤|鈴木|高橋|田中|2018|pp=19-20}}</nowiki> || 佐藤 et al. 2018, pp.19-20. || 佐藤鈴木高橋田中 2018 19-20
|-
!同5人、同（エラー）
| <nowiki>{{Sfn|佐藤|鈴木|高橋|田中|伊藤|2018|pp=19-20}}</nowiki> || （エラー表示） || 佐藤鈴木高橋田中伊藤 19-20
|-
!同0人、同（エラー）
| <nowiki>{{Sfn|2018|pp=19-20}}</nowiki> || （エラー表示） || [[#CITEREF2018{{{2}}}|2018 {{{2}}} ]] 19-20
|-
!発行年指定なし（エラー）
| <nowiki>{{Sfn|佐藤|pp=19-20}}</nowiki> || （エラー表示） || [[#CITEREF佐藤{{{2}}}|佐藤 {{{2}}} ]] 19-20
|-
!著者1人、単一頁指定
| <nowiki>{{Sfn|佐藤|2018|p=19}}</nowiki> || 佐藤 2018, p.19. || 佐藤 2018 19
|-
!同、参照範囲指定
| <nowiki>{{Sfn|佐藤|2018|loc=第1章}}</nowiki> || 佐藤 2018, 第1章 || 佐藤 2018 第1章
|-
!頁範囲指定なし
| <nowiki>{{Sfn|佐藤|2018}}</nowiki> || 佐藤 2018 || 佐藤 2018
|-
!同、複数頁指定、句点あり
| <nowiki>{{Sfn|佐藤|2018|pp=19-20|ps=.}}</nowiki> || 佐藤 2018, pp.19-20. || 佐藤 2018 19-20.
|}

== 他のHarv系テンプレートとの関係 ==
=== Harv ===
{{tl|Harv}}は、本文中の各文の終わりに括弧書きで著者姓・発行年方式により典拠を略記する場合に用います。
*入力例：<nowiki>これこれこうである{{Harv|佐藤|2018|pp=19-20}}。</nowiki>
*出力例：これこれこうである{{Harv|佐藤|2018|pp=19-20}}。
=== Harvnb ===
{{tl|Harvnb}}は、Harvの括弧なし版、SfnのRefタグが付かない版です。括弧内に複数の出典を記したい場合などに用います。
*入力例：<nowiki>これこれこうである（{{Harvnb|佐藤|2018|pp=19-20}}、{{Harvnb|鈴木|2017|pp=38-46}}）。</nowiki>
*出力例：これこれこうである（{{Harvnb|佐藤|2018|pp=19-20}}、{{Harvnb|鈴木|2017|pp=38-46}}）。
=== Harvtxt ===
{{tl|Harvtxt}}は、本文中で著者姓・発行年方式により典拠を略記する場合に用います。現状、複数の著者姓を指定しても1人しか表示しないという技術的な問題があります。
*入力例：<nowiki>{{Harvtxt|佐藤|2018|pp=19-20}}によると、これこれこうである。</nowiki>
*出力例：{{Harvtxt|佐藤|2018|pp=19-20}}によると、これこれこうである。
=== Refの入れ子の回避 ===
脚注の中に本文を補足する文章を記し、その文章に出典注を付したいことはよくあると思いますが、脚注の中でSfnテンプレートを使おうとすると、SfnテンプレートはRefタグを生成するため、Refの入れ子（ネスト、nest）をして、脚注節の側で更にグルーピングを要することになり、記事の構造が複雑になってしまいます。

Refの入れ子の問題を回避するために、脚注の文章に出典注を付す場合には、Refタグを生成しないHarvテンプレート、HarvnbテンプレートおよびHarvtxtテンプレートを使いましょう。
*入力例：<nowiki><ref>本文を補足すると、これこれこうである{{Harv|佐藤|2018|pp=19-20}}。</ref></nowiki>
*出力例：<ref>本文を補足すると、これこれこうである{{Harv|佐藤|2018|pp=19-20}}。</ref>
==== 脚注 ====
{{Reflist}}

[[Category:テンプレート文書]]

@@ 124行目: / 124行目: @@
 <includeonly>
 [[Category:内部リンク用テンプレート]]
-[[Category:出典注記用テンプレート]]
+[[Category:出典テンプレート]]
 </includeonly>

@@ 121行目: / 121行目: @@
 {{Reflist}}
-<onlyinclude>[[Category:テンプレート文書]]</onlyinclude>
+<noinclude>[[Category:テンプレート文書]]</noinclude>
 <includeonly>
 [[Category:内部リンク用テンプレート]]
 [[Category:出典注記用テンプレート]]
 </includeonly>

@@ 121行目: / 121行目: @@
 {{Reflist}}
-[[Category:テンプレート文書]]
+<onlyinclude>[[Category:テンプレート文書]]</onlyinclude>
 <includeonly>
 [[Category:内部リンク用テンプレート]]
 [[Category:出典注記用テンプレート]]
 </includeonly>

←前の版		2018年4月19日 (木) 07:39時点における版
122行目:		122行目:

	[[Category:テンプレート文書]]		[[Category:テンプレート文書]]
		+	<includeonly>
		+	[[Category:内部リンク用テンプレート]]
		+	[[Category:出典注記用テンプレート]]
		+	</includeonly>

@@ 2行目: / 2行目: @@
 == 使い方 ==
-例えば、佐藤某さんの2018年の著書の19-20頁が出典の場合、脚注を付したい箇所に
+例えば、「佐藤某」さんの「2018年」の著書の「19-20頁」が出典の場合、脚注を付したい箇所に
-  <nowiki>これこれこうである{{Sfn|佐藤|2018|pp=19-20}}。</nowiki>
+  これこれこうである<nowiki>{{Sfn|</nowiki>''佐藤''<nowiki>|</nowiki>''2018''<nowiki>|pp=</nowiki>''19-20''<nowiki>}}</nowiki>。
 のように記します。この入力は、内部で、
-  <nowiki>これこれこうである<ref name=FOOTNOTE佐藤201819-20>[[#CITEREF佐藤2018|佐藤 2018 ]] 19-20 </ref>。</nowiki>
+  これこれこうである<nowiki><ref name=FOOTNOTE</nowiki>''佐藤201819-20''<nowiki>>[[#CITEREF</nowiki>''佐藤2018''<nowiki>|</nowiki>''佐藤 2018''<nowiki> ]] </nowiki>''19-20''<nowiki> </ref></nowiki>。
 と解釈されます。ここで、
 #refタグが付されること
 #refタグに「FOOTNOTE佐藤201819-20」という名前が付されること、従って同じ名前の付されたrefタグが別にあれば、自動的に名寄せされること
-#同じ記事の中にある「CITEREF佐藤2018」というidへの内部リンクが生成されること、従って別途「CITEREF佐藤2018」というアンカーを作成すれば内部参照ができること
+#同じ記事の中にある「CITEREF佐藤2018」というidを持つアンカーへの内部リンクが生成されること、従って別途「CITEREF佐藤2018」というidを持つアンカーを作成すれば内部参照ができること
 にご留意ください。出力は、
   これこれこうである{{Sfn|佐藤|2018|pp=19-20}}。
-となります。通常のRefタグと同じように、脚注節に<nowiki>{{Reflist}}</nowiki>か<nowiki><references /></nowiki>を書いておくと、そこに脚注が表示されます。
+となります。通常のrefタグと同じように、{{Tl|Reflist}}テンプレートなどを使用して脚注の一覧の欄を設けておくと、そこに脚注が表示されます。
 === 脚注（表示例） ===
 {{Reflist}}
-この例の場合、脚注から参考文献への内部参照を完成させるには、同じ記事の中に、別途Cite系のテンプレートを用いて参考文献を記し、その際、著者姓（last）に「佐藤」、発行年（year）に「2018」を指定すると、「CITEREF佐藤2018」というアンカーが生成されます。
+脚注から参考文献への内部リンクを完成させるには、同じ記事の中に、同じidを持つアンカーを作成します。アンカーの作成には、{{Tl|Cite book}}などのCite系テンプレートや{{Tl|Aya}}を用いることができます。この説明文の最後には、{{Tl|Aya}}を用いて、
 == 開発の意図 ==
@@ 118行目: / 122行目: @@
 *入力例：<nowiki><ref>本文を補足すると、これこれこうである{{Harv|佐藤|2018|pp=19-20}}。</ref></nowiki>
 *出力例：<ref>本文を補足すると、これこれこうである{{Harv|佐藤|2018|pp=19-20}}。</ref>
-==== 脚注 ====
+==== 脚注（例） ====
 {{Reflist}}
 <noinclude>[[Category:テンプレート文書]]</noinclude>