「テンプレート:Harvnb」の版間の差分
(新しいページ: '<includeonly>{{#ifeq:{{{Ref|}}}|none |{{#if:{{{5|}}} |{{{1|}}} et al. {{{5|}}} |{{#if:{{{4|}}} |{{{1|}}}, {{{2|}}} & {{{3|}}} {{{4|}}} |...') |
(動作するように書替え。テンプレート:Sfn 2018年4月4日 (水) 08:47 の 由亜辺出夫 による版を修正して移入。) |
||
1行目: | 1行目: | ||
− | <includeonly> | + | <includeonly>[[#CITEREF{{{1}}}{{{2}}}{{{3|}}}{{{4|}}}{{{5|}}}|{{{1}}} {{{2}}} {{{3|}}} {{{4|}}} {{{5|}}}]] {{{p|}}}{{{pp|}}}{{{loc|}}}{{{postscript|{{{ps|}}}}}}</includeonly><noinclude> |
− | + | {{Documentation}} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | }}</includeonly><noinclude> | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
</noinclude> | </noinclude> |
2018年4月4日 (水) 18:26時点における版
Harvnbは、著者姓-発行年方式で略記された出典注の記載を支援するためのテンプレートです。括弧なしで出典注を記し、著者姓-発行年から同一記事内にあるidが一致する最初のcite系テンプレートへの内部リンクを生成します。「Harvnb」はHarvard citation no brackets(ハーバード方式の出典注、括弧なし)を意味します。
目次
使い方
例えば、「佐藤某」さんの「2018年」の著書の「19-20頁」が出典の場合、出典注を付したい箇所に
これこれこうである({{Harvnb|佐藤|2018|pp=19-20}})。
のように記します。出力は、
これこれこうである(佐藤 2018 19-20)。
となります。この入力は、内部で、
これこれこうである([[#CITEREF佐藤2018|佐藤 2018 ]] 19-20)。
と解釈されます。ここで、同じ記事の中にある「CITEREF佐藤2018」というidを持つアンカーへの内部リンクが生成されます。
内部リンクを完成させるには、同じ記事の中に、同じidを持つアンカーを作成します。アンカーの作成には、{{Cite book}}などのCite系テンプレートや{{Aya}}を用いることができます。この説明文の最後には、{{Aya}}を用いて、
*{{Aya|佐藤|year=2018}} 佐藤某『書題××』出版社、2018年
と記し、アンカーが作成してあるため、上でHarvnbテンプレートを使いて作成した内部リンクをクリックすると、このアンカーへジャンプします。Cite系のテンプレートを用いる場合には、著者姓(last)に「佐藤」、発行年(year)に「2018」と指定すると、同じように「CITEREF佐藤2018」というアンカーを生成することができます。
Harvnbの出力は、Harvの括弧がない場合、SfnのRefタグを付さない場合と同じ出力になるため、括弧内や脚注に複数の出典を記したい場合に、HarvやSfnの代わりに用いられます。ただし、脚注の中で用いる場合、脚注の名寄せに必要な名前(name)は、別に手動で定義することになります。
開発の意図
条件文を使わないという制約下で、WikipediaのHarvnbテンプレートと互換性をもつように作成しました。
条件文を使用しない(場合分けが難しい)という前提があるため、
- 句読点、カンマ、ピリオド、&、括弧は表示しません。ただし、句点ないしピリオドは、引数「ps」(追記事項)に記すことによって表示できます。
- 著者姓が4人まで指定できる点はWikipediaのテンプレートと同様ですが、4人のときに出力表示が省略されることはありません。
- 頁などの参照範囲を指定する引数「p=」「pp=」「loc=」の指定内容はいずれも出力表示されますが、数字の前の「p.」「pp.」は表示しません。「佐藤 2018 pp.19-20」「佐藤 2018 19-20頁」のように表示したい場合は、入力するときに「pp=pp.19-20」「pp=19-20頁」のように指定してください。
引数一覧
引数 | 意味 | 既定値 | 入力の要否 |
---|---|---|---|
(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 | 可略 |
入出力例
事例 | 入力 | 理想の出力(内部リンクは省略) | 現状の出力(同) |
---|---|---|---|
著者1人、複数頁指定 | {{Harvnb|佐藤|2018|pp=19-20}} | 佐藤 2018, pp.19-20 | 佐藤 2018 19-20 |
同2人、同 | {{Harvnb|佐藤|鈴木|2018|pp=19-20}} | 佐藤 & 鈴木 2018, pp.19-20 | 佐藤 鈴木 2018 19-20 |
同3人、同 | {{Harvnb|佐藤|鈴木|高橋|2018|pp=19-20}} | 佐藤, 鈴木 & 高橋 2018, pp.19-20 | 佐藤 鈴木 高橋 2018 19-20 |
同4人、同 | {{Harvnb|佐藤|鈴木|高橋|田中|2018|pp=19-20}} | 佐藤 et al. 2018, pp.19-20 | 佐藤 鈴木 高橋 田中 2018 19-20 |
同5人、同(エラー) | {{Harvnb|佐藤|鈴木|高橋|田中|伊藤|2018|pp=19-20}} | (エラー表示) | 佐藤 鈴木 高橋 田中 伊藤 19-20 |
同0人、同(エラー) | {{Harvnb|2018|pp=19-20}} | (エラー表示) | [[#CITEREF2018{{{2}}}|2018 {{{2}}} ]] 19-20 |
発行年指定なし(エラー) | {{Harvnb|佐藤|pp=19-20}} | (エラー表示) | [[#CITEREF佐藤{{{2}}}|佐藤 {{{2}}} ]] 19-20 |
著者1人、単一頁指定 | {{Harvnb|佐藤|2018|p=19}} | 佐藤 2018, p.19 | 佐藤 2018 19 |
同、参照範囲指定 | {{Harvnb|佐藤|2018|loc=第1章}} | 佐藤 2018, 第1章 | 佐藤 2018 第1章 |
頁範囲指定なし | {{Harvnb|佐藤|2018}} | 佐藤 2018 | 佐藤 2018 |
同、複数頁指定、句点あり | {{Harvnb|佐藤|2018|pp=19-20|ps=.}} | 佐藤 2018, pp.19-20 | 佐藤 2018 19-20. |
他のHarv系テンプレートとの関係
Harv
{{Harv}}は、本文中の各文の終わりに括弧書きで著者姓・発行年方式により典拠を略記する場合に用います。
- 入力例:これこれこうである{{Harv|佐藤|2018|pp=19-20}}。
- 出力例:これこれこうである(佐藤 2018 19-20)。
Sfn
{{Sfn}}は、脚注に著者姓・発行年方式により典拠を略記する場合に用います。
- 入力例:これこれこうである{{Sfn|佐藤|2018|pp=19-20}}。
- 出力例:これこれこうである[1]。
Harvtxt
{{Harvtxt}}は、本文中で著者姓・発行年方式により典拠を略記する場合に用います。現状、複数の著者姓を指定しても1人しか表示しないという技術的な問題があります。
- 入力例:{{Harvtxt|佐藤|2018|pp=19-20}}によると、これこれこうである。
- 出力例:佐藤 (2018 19-20)によると、これこれこうである。
Refの入れ子の回避
脚注の中に本文を補足する文章を記し、その文章に出典注を付したいことはよくあると思いますが、脚注の中でSfnテンプレートを使おうとすると、SfnテンプレートはRefタグを生成するため、Refの入れ子(ネスト、nest)をして、脚注節の側で更にグルーピングを要することになり、記事の構造が複雑になってしまいます。
Refの入れ子の問題を回避するために、脚注の文章に出典注を付す場合には、Refタグを生成しないHarvテンプレート、HarvnbテンプレートおよびHarvtxtテンプレートを使いましょう。
- 入力例:<ref>本文を補足すると、これこれこうである{{Harv|佐藤|2018|pp=19-20}}。</ref>
- 出力例:[2]
脚注(例)
参考文献(例)
- 佐藤 (2018) 佐藤某『書題××』出版社、2018年