“Nokaor:Reflist” のwerson間の差分

提供：Aynuwiki
(-「言語間リンク」のコメント)
 
細 (1版 をインポートしました)
 
(相違点なし)

2024 pam 3 2024-03-05T01:00:08+00:00up 5 312024 (Ape.) 01:00時点における最新werson

テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

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

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

使用法

複数の列

ブラウザのCSS3マルチカラムレイアウト対応
プロパティ IE Edge Firefox Safari Chrome Opera
column-width
column-count 		≥ 10
(2012)		 ≥ 12
(2015)		 ≥ 1.5
(2005)		 ≥ 3
(2007)		 ≥ 1
(2008)		 ≥ 11.1
(2011)
columns ≥ 10
(2012)		 ≥ 12
(2015)		 ≥ 9
(2011)		 ≥ 3
(2007)		 ≥ 1
(2008)		 ≥ 11.1
(2011)
break-before
break-after
break-inside 		≥ 10
(2012)		 ≥ 12
(2015)		 ≥ 65
(2019)		 ≥ 10
(2016)		 ≥ 50
(2016)		 ≥ 11.1
(2011)

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

{{Reflist|2}}とすると脚注が2列のリストに、{{Reflist|3}}とすると3列のリストになります。

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

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

発生し得る問題

脚注の分裂
脚注が途中で改列されてしまった例（和田アキ子）。なお、この画像では列幅も小さくなっているが、現在は解消されている。

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

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

== 脚注 ==
{{Reflist|10em}}
2列以上に組まれると[1]、場合によっては1つの脚注が2列以上に分かれてしまいます。

この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。

脚注
  1. ↑ このように脚注が表示されます。このように脚注が表示されます。

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

列幅が極端に狭くなる

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

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

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

== 脚注 ==
{{Reflist|6}}
このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります[1][2][3]。
脚注
  1. ↑ このような表示になります。
  2. ↑ このような表示になります。
  3. ↑ このような表示になります。

使用法

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

  • 指定なしもしくは1列指定（既定）: 脚注が少ないときに用いられます。
  • 30emもしくは2列以上指定: 多数の脚注を直接書いている場合に用いられます。
  • 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.[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]

脚注
  1. ↑ 出典名、アクセス日時など
  2. ↑ 出典名、アクセス日時など
  3. ↑ 出典名、アクセス日時など
  4. ↑ 出典名、アクセス日時など
  5. ↑ 出典名、アクセス日時など

group引数

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

表示例

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

脚注1

  1. ↑ 1111111111
  2. ↑ 2222222222
  3. ↑ 3333333333

脚注2

  1. ↑ aaaaaaaaaa
  2. ↑ bbbbbbbbbb
  3. ↑ cccccccccc

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]。
  1. ↑ これは脚注の内容です。
  2. ↑ これは本文中の脚注タグ内ではなく、refs引数の中に書いてあります。

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

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

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

liststyle引数

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

CSSのlist-style-type引数
CSS 2.1のlist-style-type[1]
none
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
disc
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
circle
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
square
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
decimal
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
decimal-leading-zero
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
lower-roman
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
upper-roman
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
lower-alpha
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
upper-alpha
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
lower-greek
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
armenian
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
georgian
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
CSS 2.1で非推奨となったCSS2のlist-style-type[2]

一部ブラウザではサポートされています。

hebrew
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No No No No Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No
cjk-ideographic
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No No No No Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No
hiragana
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No No No No Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No
katakana
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No No No No Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No
hiragana-iroha
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No No No No Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No
katakana-iroha
  1. 1つめ
  2. 2つめ
  3. 3つめ
  4. 4つめ
Internet Explorer Firefox Safari Chrome Opera
6 7 8 9 10 3 4 5 4 5 9 10 11 12 10 11 12
No No No No No Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No

scroll引数（廃止）

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

追跡カテゴリ

テンプレートデータ

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

Reflist

このテンプレートは、記事の最後に脚注の一覧を表示し、追加の書式設定および整理のオプションを提供します。"Apply changes"（変更の適用）をクリックしてビジュアル編集（VE）表示モードに戻った後は、参照リストは表示されません。"Save page"（ページの保存）を押して通常の表示モードに戻すと、変更を適用した参考文献一覧が再び表示されます。Phabricator:T53146 を参照してください。

テンプレートパラメーター

パラメーター説明型状態
Columns / Column width1 colwidth

モード2件をサポートしています。第1モード：参考文献一覧は整数の固定列にレンダリング。2番目のモード：印刷用の 'em' などの測定単位で、参考文献一覧の列幅を指定（例：'33em'）。 「33&nbsp;em」のように空白を挟むと認識しません

既定
1
文字列省略可能
Liststyleliststyle

参考文献一覧を列挙するときに使用する書式を設定。有効な CSS 値を list-style-type に定義できます

既定
decimal
文字列省略可能
Groupgroup

group とは、表示する脚注を制限するパラメータ（識別子）です。このテンプレートに group パラメータを指定しないと、このパラメータのない脚注のみ表示します。指定すると group パラメータと一致する脚注に絞り込んで処理します。それ以外は処理されません。

文字列省略可能
List of referencesrefs

記事内でどんな名前付き脚注を使うか、定義する場所を提供します。脚注をこの場所で定義すると、記事のどこかで1回も使用しないものは、一覧に表示されません。

文字列省略可能

関連項目

  1. ↑ “Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification”. W3C (2010年12月7日). 2016年12月2日閲覧。
  2. ↑ “Cascading Style Sheets, level 2 CSS2 Specification”. W3C (2008年4月11日). 2016年12月2日閲覧。
この解説は、Nokaor:Reflist/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (作成 | 複製)とテストケース (作成)で試すことができます。（解説）
/docのサブページにカテゴリを追加してください。 このテンプレートのサブページ一覧。
“https://wiki.aynu.org:443/index.php?title=Nokaor:Reflist&oldid=5466” から取得