Help‐ノート:脚注/改訂案201907
このヘルプページのノートページはただいま大幅な改稿を行っています。 申し訳ございませんが編集の競合を避けるため、しばらくの間編集を控えてくださるとありがたく存じます。ご迷惑をおかけしますが、ご協力お願いいたします。 設定期限もしくは貼付後72時間経っても工事が完了していない場合は、このテンプレートを除去しても構いません。 |
Xが未定。※は補足。打ち消し線が抹消、『』が追加。この二つがセットの場合は置換です。 |
{{HJ:h|Editor toc ja|『Xきのう』|H:FN}}
『ウィキペディアでは、記事本文の内容に関する参考文献や注釈といった短い補足コメントを、記事の末尾など本文とは別の場所にまとめて表示する機能があります。』本文中に置いた専用のリンクをクリックすることで、対応する補足コメントを参照します。
具体的にはこの文末にあるものです[解説 1]。
ここでは『編集・執筆者向けの』『補足コメント』の作成方法の技術的な説明をします。読者向けの『補足コメント』の使用法についてはHelp:『X機能』/読者向けをご覧ください。
Wikipedia:出典を明記するでは、編集・執筆者向けに、なぜ出典を明記しなければならないかや、出典にどのような内容を記述するべきかについて説明されています。『Wikipedia:スタイルマニュアル (レイアウト)に記載がありますが、本文の解説では「注釈」「出典」を節の名称として使用していますが、これは一例に過ぎません。本文書を根拠に変更しないでください。』
『補足コメント』の作成方法
半角文字の <ref>
と</ref>
で通常の文を囲みます。すると、囲まれた文は文章中のその場所には表示されない補足コメントとなり、代わりに通し番号が割り振られたリンク記号がその場所に表示されます。<ref>
の代わりに<ref name="○○">
と書くこともできます。○○の部分には簡潔に『補足コメント』を区別して表す文字列を入れます。このことによって、同じ『補足コメント』を異なる場所から参照できるようになります(方法は後述)。一定の条件のもとでは引用符を省略することができます。文字列についての条件は下の#name、group属性に用いる文字列の詳しい仕様節をご覧ください。
記述例 | 表示結果 |
---|---|
このように本文中に補足コメントを記述すると、実際には通し番号のリンク記号が表示されます<ref>ここは補足コメントです。本文と別の場所にリンク表示されます。</ref>。
『X』機能を利用すると、記事の出典や参考文献をスマートに参照することができます<ref name="example">ウィキ田ペディ夫『俺は百科事典』明美書房刊、2007年O月X日発行(46-49ページ)</ref>。
|
このように本文中に補足コメントを記述すると、実際には通し番号のリンク記号が表示されます[1]。 『X』機能を利用すると、記事の出典や参考文献をスマートに参照することができます[2]。 |
こうして作成された補足コメントは、半角文字で<references />
または{{Reflist}}
と記述した場所に一覧表示され、対応する本文中のリンクをクリックして参照することができるようになります。ここには、作成した場所より上に作成されたすべての補足コメントが一括表示されるので、基本的に<references />
または{{Reflist}}
は1つのページにいずれか1つのみ作成します。{{Reflist}}も参照。
記述例 | 表示結果 |
---|---|
{{Reflist}}
|
以上が、補足コメント』リンクの作成方法です。実際の記事執筆に取りかかる前に、下記の#スタイルと用法節にあるアドバイスも併せてお読みください。
複数箇所に同じ『補足コメント』を付ける
記事中の他の場所から同じ『補足コメント』を参照させたい場合は、『補足コメント』リンクの識別名を同じにします。このとき2つ目以降の補足コメントは無視されるため、省略が可能です。その場合、<ref name="○○" />
とだけ記述してもかまいません。
記述例 | 表示結果 |
---|---|
通常はそれぞれの『補足コメント』リンクに個別の番号が順に割り振られますが<ref>各補足コメント横の^マークをクリックすると対応する番号の位置に戻ります。複数の箇所から参照される場合はアルファベット記号が表示されます。</ref>、同じ識別名の『補足コメント』リンクには同じ番号が表示されます<ref name="example">同じ識別名の『補足コメント』リンクのうち、2つ目以降のここの補足コメントは表示されないため省略可能です。</ref>。
後者の場合、上で紹介した略記法が使用できます<ref name="example" />。
== 『注釈』 ==
{{Reflist}}
|
通常はそれぞれの『補足コメント』リンクに個別の番号が順に割り振られますが[1]、同じ識別名の『補足コメント』リンクには同じ番号が表示されます[2]。 後者の場合、上で紹介した略記法が使用できます[2]。 |
基礎情報テンプレートなど、テンプレートの仕様変更により引数が出力されなくなることもあります。その際、補足コメントをテンプレートの引数に記述していると、エラーが表示されてしまいます。出来る限り本文中に補足コメント本体を記述した方が良いでしょう。
『補足コメント』をグループ化する
- 使用法
<ref>
タグと<references/>
タグ
の中で
<ref group="グループ名">
<references group="グループ名" />
と指定してください("グループ名"には"注釈"などを使います)。なお、</ref>
タグの使用法は変わりません。
さらなる使用説明については、以下「注釈と出典の分離」など応用編を参照『して』ください。
注釈リストと出典リストを分離したいとき
記事の中には、出典(参照した情報源)の書誌情報と、注釈(補足説明)が、『補足コメント』のなかに混在しているものもあります。しかし、それでは記事の文中に[1][2][3]がついていても、その箇所がきちんと出典が付加された箇所か、それとも補足説明のみで要出典な箇所か、一見では判別しにくくなります。
分離したほうが好ましいと考える場合は、文中で同じように[1][2][3]と表示するのではなく、注釈を示す『補足コメント』を[注釈1][注釈2][注釈3]と表示させ、出典を示す『補足コメント』と区別することができます。この作業を行なう場合、同時に、記事末のの節も2つの節に分離し「注釈」の節には注釈が、「出典」の節には出典が、それぞれ別々に記載されるようにします。
作業手順:
- 注釈用の『補足コメント』タグはすべて次のように置き換える。『補足コメント』の再利用の箇所も同様に置き換えるのを忘れずに。
<ref>ほにゃらである</ref>
→<ref group="注釈">ほにゃらである</ref>
<ref name="honyara-setsumei"/>
→<ref group="注釈" name="honyara-setsumei"/>
- 記事末の『補足コメント』節を、次の要領で置き換える。
== 注釈 ==
『"補注"等と言い換えてもよい』<references group="注釈"/>
== 出典 ==
『"参照元"等と言い換えてもよい』<references/>
- あるいは{{Reflist}}を使用している場合は
== 注釈 ==
{{Reflist|group="注釈"}}
== 出典 ==
{{Reflist}}
記述例 | 表示結果 |
---|---|
例示のための文章です<ref group="注釈">これは注釈の例です。</ref>、さらなる例示文章です<ref group="注釈" name="ex02">説明用の『補足コメント』を参照元や引用元とは別に表示できます。混合された「注釈と参照元」や「注釈と引用元」というような項目が作成できます。 これはそのような注釈の例です。 refタグのgroup拡張を使用して作成されます。</ref>。
ポイントは参照を手助けします<ref>著者、A.(2007)。"どのように参照するか、東京:なんとか出版</ref>。2度目の注釈です<ref group="注釈" name="ex02" />。注釈は参照を手助けします{{Refnest|group="注釈"|注釈は記事本文と同じく[[WP:V|検証可能性]の対象となり、自分自身の参照が必要な場合があります。これらの参照は説明文内や、『補足コメント』を加えて提供できます<ref>著者、B.(1986)。"どのように『補足コメント』で参照するか"、大阪:何々書籍</ref>。refタグは、そのままでは入れ子にできません。[[#『補足コメント』を入れ子にしたいとき|『補足コメント』を入れ子にしたいとき]]を見て下さい。}}。
== 注釈 ==
<references group="注釈" />
== 出典 ==
<references />
|
グループ名の基準
<ref>タグの本来『の』目的は、出典(参照文章と参照箇所)の記述のためであり、その数も多くなりがちなので、出典用には、特にgroup="グループ名"は指定しませんが、させている記事もあります(用例:国名の漢字表記一覧では文献上の出典とそれ以外の出典を分けるためにgroup="出典"を設け、[出典1][出典2]と表示させています)。
注釈(補足説明)用に使う場合は、<ref group="注釈">、『<ref group="注">等』を使います。見た目をすっきりしたいなどの理由で、
- <ref group="†">
- <ref group="※">
『等の記号を用いることもあります。』
また、英語版ウィキペディアには、group="lower-alpha"
を使ってa b c、group="lower-roman"
を使ってi ii iiiと表示されるPredefined groupsが実装されていますが、日本語版では実装されていないので、翻訳するときなどは、group="注釈"
など適当に置き換えてください。
『補足コメント』文記述箇所を本文から分離したいとき
ソースコード上で補足コメントを、本文内のリンク記号位置でなく『補足コメント』表示位置に記述したい場合があります。例えば
- 文章が長く、本文内に直接挿入するとソースコードの見通しが悪くなるとき
- 同一の『補足コメント』を本文内の多くの箇所から参照しており、その『補足コメント』の内容がソースコード内のどこに記述されているか判りづらくなっているとき
などが考えられます。そのためには、<ref>
タグのname=
拡張を使用した上で、『補足コメント』の内容を記述した<ref name="○○">...</ref>
を<references>
と</references>
タグで挟み、『補足コメント』表示部に置いてください。本文の参照箇所では(単にname=
拡張を使用したときと同様に)<ref name="○○"/>
と記述してください。
記述例 | 表示結果 |
---|---|
記事本文です<ref name="hogehoge" />。オプションを使用しない場合と混在させることができます<ref group="†">この『補足コメント』文はソースコード上では本文に続けて記述されています。</ref>。group拡張と併用させることもできます<ref group="†" name="memo01" />。
== 注釈 ==
<references group="†">
<ref group="†" name="memo01">group拡張と併用した例です。</ref>
</references>
== 出典 ==
<references>
<ref name="hogehoge">いろは太郎『ほげほげ物語』、XYZ出版、2000年</ref>
</references>
|
記事本文です[1]。オプションを使用しない場合と混在させることができます[† 1]。group拡張と併用させることもできます[† 2]。
|
{{Reflist}}テンプレートを使用する場合は、|refs=
引数を使用してください。
記述例 | 表示結果 |
---|---|
記事本文です<ref name="ex01" />。
== 『注釈』 ==
{{Reflist|refs=
<ref name="ex01">『補足コメント』表示位置に記述した『補足コメント』文です。</ref>
}}
|
記事本文です[1]。
|
『補足コメント』を入れ子にしたいとき
システムの都合により<ref>...</ref>
タグは入れ子にすることが出来ません。代わりに、{{Refnest}}テンプレートを用いることができます。
技術的には、単純な<ref>...</ref>
の入れ子は、エラーになりますが、<ref>...</ref>
の中でも、"#tag" マジックワードは使えますので、Refnestはこれを利用します。#tagはそのままではソースが読みにくいので、Refnestテンプレートを使って下さい。
記述例 | 表示結果 |
---|---|
記事本文です{{Refnest|group="注"|注釈文です。ここの記述の出典を示したいときに、このようにして出典を参照することができます<ref>注釈文の出典。</ref>。}}{{Refnest|group="注"|name="note-example"|このようにname引数を指定することもできます<ref>注釈文2の出典。</ref>。}}。続く記事本文です<ref group="注" name="note-example" />。
== 注釈 ==
{{Reflist|group="注"}}
== 出典 ==
{{Reflist}}
|
ただし現在のところ、入れ子にした『補足コメント』を、『補足コメント』表示位置に記述する(#『補足コメント』文記述箇所を本文から分離したいとき)ことはできません。この問題の詳細についてはbug 20707 を参照してください。
スタイルと用法
『{{main|Wikipedia:スタイルマニュアル (レイアウト)}}』 ウィキペディアでは記事の信頼性向上のために出典を明記することが推奨されていますが、逐一これらを本文中に記載しようとすると文章が煩雑になりがちです。そのような場合に『補足コメント』機能を使うと本文が読みやすくなります。記事全体の構成や編集方針を十分検討した上で効果的に活用してください。
- 『補足コメント』欄は記事の末尾付近に作成します。『内容・用法に応じて』冒頭に「注」、「注釈」『、「出典」』などの表題を付けるのが一般的です。『この文書では通常使用されない「解説」としています。』
- ウィキペディアでは、二重の半角大括弧(
[[
と]]
)で任意の文字列を囲むと同名の記事へのリンクを作成することができます。また、二重の半角中括弧({{
と}}
)で囲まれたタグを記事に挿入するとテンプレートと呼ばれる特定の機能表示がページ上に呼び出されます。『補足コメント』部でも、これらの機能は本文と同様の要領で使用できます[解説 2]。 - 『補足コメント』は多くの場合、一つの文を説明対象にします。この場合は、句点(。)の後でなく前に『補足コメント』リンクを置きます[解説 3]。
- 見出しに『補足コメント』を使わないでください。『補足コメント』の番号が見出しの一部として扱われ、番号が変化するたびに見出しの名前が変化してしまいます。他のページから正しくリンク出来なくなります。
- 一方で、一文に複数の『補足コメント』リンクを置く場合など、その説明対象の範囲が文というより節・句・単語などになることもあります。節対象の『補足コメント』リンクは読点(、)の前に[解説 4]、句・単語などを対象とする『補足コメント』リンクは各説明対象のすぐ後[解説 5]に置きます。
- 段落全体など、比較的広い範囲の文章に対してひとつの『補足コメント』が対応することもあります。そのような場合でも本文と注釈の対応関係が読者や後の編集者にも平易に分かるよう、一文ごとに『補足コメント』リンクを挿入したり、本文や注釈文に注釈範囲を明示したりするなど配慮してください。段落全体に対する『補足コメント』の注番号が、段落の最後(段落を構成する最後の文の句点の後)に置かれていることもあります[解説 6]。加筆や修正、書式の統一の際には注意してください。
- 文献の記述スタイルに関する詳細については「Wikipedia:出典を明記する」も参照してください。『補足コメント』の記載位置などについては、文中に括弧書きを挿入する場合の表記ルールなどが参考になります(参考:Wikipedia:表記ガイド)。
- 参考文献の記載は記事本文と同様、読者にとって重要な資料となるものです。正確を期すよう心がけてください。また、本文と足コメントが正しく対応していることを確認してください。特に、文献などの本文を引用して記載する場合には著作者、著作物名など出典情報を明示する義務が法律で定められています。記載漏れや間違いの無いよう厳重に注意してください[解説 7]。
- 参考文献の詳細を『補足コメント』に表示するための便利なテンプレートが用意されています
<ref>
タグと</ref>
タグの間に以下のテンプレートを使って参考文献の詳細を記述するとそれらが一定のスタイルで表示されます。 記事執筆の一助として適宜利用してください。
主に使うのは{{Cite web}} / {{Cite book}} / {{Cite journal}} / {{Cite news}}など。詳しくはWikipedia:出典テンプレートを参照してください。 - 読者向け説明ページへのリンクを記事中に置くためのテンプレートが用意されています。記事執筆の一助として適宜利用してください。
{{脚注ヘルプ}} - 『補足コメント』リンクを使用している他の記事のスタイルも参考にしてください。
例:日本語 / チンドン屋 / GARNET CROWなど
システム上の制限
<ref>...</ref>
内では、テンプレートのsubst展開はできません。{{subst:テンプレートx}}と書くと、それがそのまま残ります。<ref>
タグは入れ子にできません。上記#『補足コメント』を入れ子にしたいとき参照。
name、group属性に用いる文字列の詳しい仕様
- 名前は大文字と小文字は区別されます。
- 名前は数字だけではいけません。
- 異なるグループや注釈に同じ名前をつけることはできません。
- 引用符は使われている文字が半角アルファベット A–Z, a–z, 半角数字 0–9, ならびに特定の記号
!$%&()*,-.:;<@[]^_`{|}~
のみからなる場合は省略可能です。 - 上記以外の文字(スペースやJIS X0208の文字を含む)を名前に含める場合は、名前は半角の2重引用符 (
"
)で囲む必要があります。 - 引用符は通常の半角の2重引用符 (
"
)です。他の引用記号類は名前の一部として扱われます。 - 引用符に囲まれた名前は小なり記号 (
<
) や2重引用符 ("
)を含むことはできません。 - 名前は簡潔にし標準的な半角英数字とJIS X0208の文字のみを使うようにしてください。
- 名前は必要がない場合でも付与することを選択できます。
『
テンプレートの利用
{{Sfn}}タグを使えば、同一の『補足コメント』を自動で集約します。記述を簡易化でき、同一文書を何度も参照するのに便利です。詳細は「Wikipedia:出典テンプレート#ハーバード参照方式」を参照してください。
注釈用テンプレート
ここまでの作業で<ref group="注釈">と<references group="注釈" />を使用する代わりに、
のテンプレートを使用することも可能です。詳細はそれぞれのテンプレートを参照してください。 』
『
脚注機能
ウィキペディアには節を編集する場合、プレビュー画面ではその節に含まれている<ref></ref>の記載を末尾に脚注として自動生成する機能があります。この機能は記事全体にも適用され、執筆・編集時に<ref></ref>を記載したのに<references />や{{Reflist}}が無い場合、末尾に表示されてしまいます。このような記事を見つけたら、<references />や{{Reflist}}の節を補ってください、 』
このページの解説
- ^ 左の記号をクリックすると本文に戻ります。または、ブラウザの戻る機能でも戻れます(参考:Help:『X機能』/読者向け)。
- ^ 参考:Help:リンク / Help:テンプレート
- ^ 英文などの場合は、『補足コメント』リンクをピリオド(.)の直後に置きます(参考:英語版Wikipedia:脚注)。
- ^ 句点の場合と同様に考えます。
- ^ ひとつの文に多くの『補足コメント』を挿入しすぎると読みにくくなります。可能であれば一文ごとに『補足コメント』をまとめることも検討してみてください。
- ^ 句点の後ろに置くだけで、それが段落全体の注であると示せるわけではありません。
- ^ 参考:Wikipedia:引用のガイドライン
関連項目
- Wikipedia:スタイルマニュアル
- Wikipedia:出典を明記する
- Help:ISBNのリンク
- 脚注
- 注釈
- 分注
- Help:脚注部分をスクロール化する - 脚注部分の表示を変えるガジェット
- Help:『X機能』/過去の方法
cs:Wikipedie:Reference es:Wikipedia:Referencias#Notas al pie