テンプレート:Reflist/doc

脚注に参照文献リストを載せるためのテンプレートです。<references />の代用として{{Reflist}}を使用することができます。

本文と脚注のスタイルを変えて、全体を読みやすくするために用いられます。

使用法

複数の列

テンプレート:CSS3 multiple column layout {{Reflist|2}}とすると脚注が2列のリストに、{{Reflist|3}}とすると3列のリストになります。

{{Reflist|30em}}などのように、pxなどの絶対単位やemなどの相対単位で幅を指定すると、その列幅以上になるように、脚注の列幅を指定できます。この際、数字と単位の間にはスペースを入れないでください。{{Reflist|colwidth=30em}}のように、列幅の前に「colwidth=」と入れても同じ表示を得ることができます。

一般にはem単位指定および列数指定が用いられています。

注意：2011年時点で、対応するブラウザは表のとおり。

発生し得る問題

脚注の分裂

ファイル:Exofrefwith4cols2.png

脚注が途中で改列されてしまった例（テンプレート:Oldid）。なお、この画像では列幅も小さくなっているが、現在は解消されている。

複数の列を使用することで、列の一番下に表示された脚注が次の列の頭に分かれて表示されてしまうことがあります。MediaWiki:Common.cssには表示が2列にわたって表示されないようにするCSSルールが含まれています。しかし、少なくない環境下において、1つの脚注であるにもかかわらず複数列表示の設定がされている場合や、スマートフォンで表示した場合などの特定の条件下では、1つの脚注が2列以上に分裂して表示されてしまうこともあります。

マークアップ	描画
2列以上に組まれると<ref>このように脚注が表示されます。このように脚注が表示されます。</ref>、場合によっては1つの脚注が2列以上に分かれてしまいます。 この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。 ==脚注== {{Reflist|10em}}	2列以上に組まれると、場合によっては1つの脚注が2列以上に分かれてしまいます。 この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。 脚注

このテンプレートで複数列設定を行った場合に、あなたのブラウザではそれぞれの脚注が1列に表示されていても、他の環境（ブラウザやウィンドウ幅など）によっては別の挙動を示すことがあります。

列幅が極端に狭くなる

脚注の列数を極端に大きく設定すると、列の幅が非常に短くなり、見にくくなる恐れがあります。そのため、列数指定に対しては、列幅がある一定の値（20em）未満にならないようになっています。

また、列幅が狭すぎると脚注自体が表示されなくなります。

マークアップ	描画
このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります<ref>このような表示になります。</ref><ref>このような表示になります。</ref><ref>このような表示になります。</ref>。 ==脚注== {{Reflist|6}}	このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります。 脚注

使用法

使用する列数指定や列幅の指定は編集者にゆだねられていますが、以下に一般的な指定を挙げます。

• 1列指定（既定）: 脚注が少ないときに用いられます。
• 2列以上指定もしくは30em: 多数の脚注を、直接書いている場合に用いられます。
• 20em: {{sfn}} が使用されている場合によく用いられます。

例

15em幅指定の場合

マークアップ	描画
Lorem ipsum.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> ==脚注== {{Reflist|15em}}	Lorem ipsum. Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet. 脚注

group引数

同一記事内に複数の脚注を設置する場合（<ref group=>, <references group=>を使用する場合）は、group引数を用いる事で対応できます。

表示例

• 脚注1では{{Reflist}}と書き、脚注は<ref>〜</ref>で括っています。
• 脚注2では{{Reflist|group=※}}と書き、脚注は<ref group="※">〜</ref>で括っています。

refs引数

<ref name="hoge">ほげほげ</ref> のような、内容とname属性をもつ脚注タグをrefs引数として列挙しておくと、ページ中でそのname属性を使うことができます。

使 用 例	これは本文です<ref group="†" name="hoge" />。ここでは説明ページの都合でgroup引数と併用していますが、もちろんgroup引数なしでも使えます<ref group="†" name="piyo" />。 {{Reflist|group="†"|refs=<ref group="†" name="hoge">これは脚注の内容です。</ref><ref group="†" name="piyo">これは本文中の脚注タグ内ではなく、refs引数の中に書いてあります。</ref>}}
実 際 の 表 示	これは本文です。ここでは説明ページの都合でgroup引数と併用していますが、もちろんgroup引数なしでも使えます。

通常――この機能を使わない場合は、name属性はページ中のどこかの脚注で定義しておく必要がありますが、それが消されると、name属性だけで記述している脚注でエラーとなってしまいます（実際、そのような編集はしばしば見られます）。このrefs引数で脚注のname属性を定義しておけば、このような事故を防ぐことができますし、ソースの可読性も向上します。

ただし欠点もあり、ここで定義された脚注が本文中で一度も使われなかった場合には、エラーが発生します。後で置換されたり除去されることが予想される脚注ではこの機能を使わず、普通に本文中の脚注タグで記述したほうが、後の編集者には親切かもしれません。

また、現在のところ、ここで入れ子脚注（H:REFNEST参照）を正常に利用することはできません。詳細はTemplate:Refnest#リスト定義時のエラーを参照してください。

liststyle引数

既定では、脚注は番号付けされて表示されます。liststyle引数を用いることで、脚注を番号付けさせないようにしたり、他の記号やローマ数字などで番号付けできるようになります。list-style-typeとして定義されたCSS文字列ならば使用することができます。 使用可能なスタイルは以下の表を参照してください。 テンプレート:CSS list-style-type values

scroll引数（廃止）

注意：2009年5月のHelp‐ノート:脚注における合意により、脚注をスクロール表示にしたい場合は各自Scrolled Reflistというガジェットを利用し、Template:Reflistのscrollパラメータは使用しないことになりました。なお、{{Reflist}}を使っている項目の脚注部分にはclass名として「reflist」が指定されていますので、ウェブブラウザのユーザスタイルシートにMediaWiki:Gadget-ScrolledReflist.cssの内容を転記すればIP利用者でも同等の効果を得ることができます。

テンプレートデータ

これは新しいビジュアルエディターにより使用されるテンプレートのためのTemplateData文書です。

Reflist

<templatedata> { "description": "This template displays the list of footnotes at the end of an article and provides additional formatting and organizing options. After hitting \"Apply changes\" and turning back to VE read mode, you will not see the references list. After hitting \"Save page\" and turning back to normal read mode the reference list will reappear with the changes applied, see T53146.", "params": { "1": { "label": "Columns / Column width", "type": "string", "required": false, "description": "Two modes supported. First mode: integer number of fixed columns into which the reference list is to be rendered. Second mode: typographic unit of measurement such as 'em', specifying the width for the reference list columns, e.g. '33em'; spaced '33 em' will not be recognized", "default": "1", "aliases": [ "colwidth" ] }, "liststyle": { "label": "Liststyle", "type": "string", "required": false, "description": "Specifies the style used when the reference list is enumerated; accepts any valid CSS value defined for list-style-type", "default": "decimal" }, "group": { "label": "Group", "type": "string", "required": false, "description": "Group is an identifier which restricts the references that are shown. Without this parameter, this template only shows references with no group identifier. With a group identifier specified, only references with a matching group identifier are handled. The rest are left alone." }, "refs": { "label": "List of references", "type": "string", "required": false, "description": "Provides a space to define named references for use in the article. References defined in this space are not shown unless used somewhere in the article." } } } </templatedata>

関連項目

• {{脚注ヘルプ}}
• {{Reflist-talk}} - ノートページ用。
• Help:脚注部分をスクロール化する