テンプレート:Reflist/doc
これはテンプレート:Reflistの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
脚注に参照文献リストを載せるためのテンプレートです。<references />
の代用として{{Reflist}}
を使用することができます。
本文と脚注のスタイルを変えて、全体を読みやすくするために用いられます。
目次
使用法
複数の列
テンプレート:CSS3 multiple column layout
{{Reflist|2}}
とすると脚注が2列のリストに、{{Reflist|3}}
とすると3列のリストになります。
{{Reflist|30em}}
などのように、pxなどの絶対単位やemなどの相対単位で幅を指定すると、その列幅以上になるように、脚注の列幅を指定できます。この際、数字と単位の間にはスペースを入れないでください。{{Reflist|colwidth=30em}}
のように、列幅の前に「colwidth=」と入れても同じ表示を得ることができます。
一般にはem単位指定および列数指定が用いられています。
注意:2011年時点で、対応するブラウザは表のとおり。
発生し得る問題
- 脚注の分裂
複数の列を使用することで、列の一番下に表示された脚注が次の列の頭に分かれて表示されてしまうことがあります。MediaWiki:Common.cssには表示が2列にわたって表示されないようにするCSSルールが含まれています。しかし、少なくない環境下において、1つの脚注であるにもかかわらず複数列表示の設定がされている場合や、スマートフォンで表示した場合などの特定の条件下では、1つの脚注が2列以上に分裂して表示されてしまうこともあります。
マークアップ | 描画 |
---|---|
2列以上に組まれると<ref>このように脚注が表示されます。このように脚注が表示されます。</ref>、場合によっては1つの脚注が2列以上に分かれてしまいます。 この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。 ==脚注== {{Reflist|10em}} |
2列以上に組まれると[1]、場合によっては1つの脚注が2列以上に分かれてしまいます。
この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。
|
このテンプレートで複数列設定を行った場合に、あなたのブラウザではそれぞれの脚注が1列に表示されていても、他の環境(ブラウザやウィンドウ幅など)によっては別の挙動を示すことがあります。
- 列幅が極端に狭くなる
脚注の列数を極端に大きく設定すると、列の幅が非常に短くなり、見にくくなる恐れがあります。そのため、列数指定に対しては、列幅がある一定の値(20em)未満にならないようになっています。
また、列幅が狭すぎると脚注自体が表示されなくなります。
マークアップ | 描画 |
---|---|
このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります<ref>このような表示になります。</ref><ref>このような表示になります。</ref><ref>このような表示になります。</ref>。 ==脚注== {{Reflist|6}} |
このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります[1][2][3]。 |
使用法
使用する列数指定や列幅の指定は編集者にゆだねられていますが、以下に一般的な指定を挙げます。
- 1列指定(既定): 脚注が少ないときに用いられます。
- 2列以上指定もしくは30em: 多数の脚注を、直接書いている場合に用いられます。
- 20em: {{sfn}} が使用されている場合によく用いられます。
例
マークアップ | 描画 |
---|---|
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.[1]
Lorem ipsum dolor sit amet.[2] Lorem ipsum dolor sit amet.[3] Lorem ipsum dolor sit amet.[4] Lorem ipsum dolor sit amet.[5] |
group引数
同一記事内に複数の脚注を設置する場合(<ref group=>, <references group=>を使用する場合)は、group引数を用いる事で対応できます。
表示例
- 脚注1では
{{Reflist}}
と書き、脚注は<ref>〜</ref>
で括っています。[1][2][3] - 脚注2では
{{Reflist|group=※}}
と書き、脚注は<ref group="※">〜</ref>
で括っています。[※ 1][※ 2][※ 3]
脚注1
脚注2
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>}} |
---|---|
実 際 の 表 示 |
これは本文です[† 1]。ここでは説明ページの都合でgroup引数と併用していますが、もちろんgroup引数なしでも使えます[† 2]。 |
通常――この機能を使わない場合は、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利用者でも同等の効果を得ることができます。
関連項目
- {{脚注ヘルプ}}
- {{Reflist-talk}} - ノートページ用。
- Help:脚注部分をスクロール化する