「テンプレート:Cite book/doc」の版間の差分

提供: Yourpedia
移動: 案内検索
(新しいページ: '<includeonly>{{テンプレート文書呼出}}</includeonly><noinclude>{{テンプレート文書直接表示}}</noinclude> <!-- 以下でテンプレートの解説を編集...')
 
(開発の意図)
 
(2人の利用者による、間の9版が非表示)
1行目: 1行目:
<includeonly>{{テンプレート文書呼出}}</includeonly><noinclude>{{テンプレート文書直接表示}}</noinclude>
+
'''Cite book'''は、書籍の出典情報の記載を支援するためのテンプレートです。著者姓-発行年方式のidを持つアンカーを生成して、同一記事内のidが一致する出典注(脚注)から内部リンクできるようにする機能があります。Wikipediaの同名のテンプレートとの互換性のために作成しましたが、Yourpediaでの使用は推奨しません。
<!-- 以下でテンプレートの解説を編集してください -->
+
このテンプレートは、[[WP:CITE|出典を明記する]]のに使います。書籍用です。
+
 
+
雑誌記事には[[Template:Cite journal]]を使ってください。
+
  
 
== 使い方 ==
 
== 使い方 ==
=== 簡単な使い方 ===
+
例えば、2015年にKADOKAWAから刊行された東野圭吾(著)『ラプラスの魔女』(角川文庫、<nowiki>ISBN 978-4041029893</nowiki>)の出典を記す場合、
<pre>
+
*<code><nowiki>{{Cite book|last= 東野 |year= 2015 |first= 圭吾 |title= ラプラスの魔女 |series= 角川文庫 |publisher= KADOKAWA |id= ISBN 978-4041029893 }}</nowiki></code>
{{Cite book
+
と入力すると、
|last=著者の姓
+
*{{Cite book|last= 東野 |year= 2015 |first= 圭吾 |title= ラプラスの魔女 |series= 角川文庫 |publisher= KADOKAWA |id= ISBN 978-4041029893 }}
|first=著者の名
+
と出力されます。
|author=著者(last, firstの替わりに使う。東アジア名の時はこちらの方が使いやすい)
+
|authorlink=著者への内部リンク
+
|coauthors=共著者
+
|year=
+
|title=タイトル
+
|publisher=出版社
+
|location=出版社の所在地
+
|id=デジタルオブジェクト識別子
+
}}
+
</pre>
+
  
==== 和書 ====
+
=== 特徴 ===
最初のパラメータに「和書」を入れると、[[WP:CITE#出典の書き方(和書)|和書の書式]]になります。
+
*冒頭に、アンカーに使用した著者姓-発行年等の情報を出力表示します。使用する引数については、[[#アンカー・冒頭の出力表示に含まれる引数]]をご参照ください。発行年等は常に( )で囲われ、発行年等の指定がない場合、空の( )が出力表示されます。
 +
*アンカーは、常に引数で指定した著者姓-発行年等の情報から生成します。引数「ref」は効きません。
 +
*アンカーの作成と冒頭の出力表示では「author」よりも「last」、「date」よりも「year」が優先され、( )の後の出力表示では「last」よりも「author」、「year」よりも「date」が優先されます。「last」と「author」、「year」と「date」を両方指定することにより、出力表示を分けることができます。
 +
*著者名から著者の記事への内部リンクを生成したい場合、引数「authorlink」は効きませんので、引数「author」に直接<nowiki>[[ ]]</nowiki>を付してください。その際、<nowiki>[[ ]]</nowiki>を付さずにアンカーを作成するためには、別途、引数「last」を<nowiki>[[ ]]</nowiki>を使わずに記してください。
 +
*書題(title)は、引数「url」を指定して外部リンクを設定しない限り、常に<nowiki>[ ]</nowiki>で囲われて出力表示されます。
 +
*上記のほかに、括弧や句読点、「第-巻」「-年-月-日」の記載などの、スタイルに関する自動補完機能は何もありません。句点を付したいときは引数「postscript」で指定できますが、ベタ書きするのと変わりありません。
 +
*書籍・雑誌等の識別子を入力するための引数には、「id」「ID」「id-before-at」「id-after-at」のほかに「asin」「isbn」「doi」「issn」「naid」がありますが、外部リンクを作成する機能はありません。外部リンクを作成したいときは、ISBNや{{Tl|asin}}、{{Tl|doi}}、{{Tl|issn}}、{{Tl|naid}}などのテンプレートを使用して入力指定してください。
  
'''例''':
+
== 開発の意図 ==
<pre>
+
条件文を使わないという制約下で、WikipediaのCite系テンプレートと互換性を持つように作成しました。
{{Cite book|和書
+
|author=佐藤史生
+
|year=1984
+
|title=阿呆船
+
|publisher=新書館
+
|id=ISBN 4-403-61051-6
+
}}
+
</pre>
+
こうなります:
+
{{Cite book|和書
+
|author=佐藤史生
+
|year=1984
+
|title=阿呆船
+
|publisher=新書館
+
|id=ISBN 4-403-61051-6
+
}}
+
  
==== 外国語文献 ====
+
WikipediaのCite系テンプレートには、著者姓-発行年方式のアンカー作成機能のほかに、テンプレートに入力された書誌情報を集計可能にする機能があります。しかしこの(Yourpediaの)テンプレートには集計機能はありません。集計機能を実装しない場合、アンカーの作成に必要な著者姓-発行年等の情報以外の書誌情報をテンプレートに入力する意味はあまりないと思います。だからこのテンプレートの使用は特に推奨しません。アンカーを作成したいときは、{{Tl|Aya}}を使用し、あとの書誌情報はお好きなスタイルで書くことをお勧めします。
最初のパラメータに「和書」を''入れない''と、[[WP:CITE#出典の書き方(外国語文献)|外国語文献の書式]]になります。
+
  
'''例''':
+
== 引数一覧 ==
<pre>
+
=== アンカー・冒頭の出力表示に含まれる引数 ===
{{Cite book
+
*入力省略時の既定値はありません。
|last=Lunde
+
{| class="wikitable" style="text-align:left"
|first=Ken
+
|-
|year=1999
+
! 引数 !! 意味 !! 入力の要否
|title=CJKV Information Processing
+
|-
|publisher=O'Reilly &amp; Associates
+
| last,last1 || 1人目の著者姓。アンカー・冒頭の出力表示では著者姓名(author, author1)に優先し、( )後の出力表示では劣後する。 || last,last1,author, author1のいずれかが必要
|location=Sebastopol, California
+
|-
|id=ISBN 1-56592-224-7
+
| last2 || 2人目 || 可略
}}
+
|-
</pre>
+
| last3 || 3人目 || 可略
こうなります:
+
|-
{{Cite book
+
| last4 || 4人目 || 可略
|last=Lunde
+
|-
|first=Ken
+
| author,<br />author1 || 1人目の著者姓名。( )後の出力表示では著者姓(last last1)に優先し、アンカー・冒頭の出力表示では劣後する。 || last,last1,author, author1のいずれかが必要
|year=1999
+
|-
|title=CJKV Information Processing
+
| author2 || 2人目 || 可略
|publisher=O'Reilly &amp; Associates
+
|-
|location=Sebastopol, California
+
| author3 || 3人目 || 可略
|id=ISBN 1-56592-224-7
+
|-
}}
+
| author4 || 4人目 || 可略
 +
|-
 +
| author-mask,<br />author-mask1 || 1人目の著者姓名(author, author1, last, last1, first, first1)を非表示にする。代わりに表示される「-」などの記号を入力。 || 可略
 +
|-
 +
| author-mask2 || 2人目 || 可略
 +
|-
 +
| author-mask3 || 3人目 || 可略
 +
|-
 +
| author-mask4 || 4人目 || 可略
 +
|-
 +
| year || 発行年。アンカー・冒頭の出力表示では発行年月日(date)に優先し、( )後の出力表示では劣後する。 || year, origyear, dateのいずれかが必要
 +
|-
 +
| origyear || 原著・初版の発行年。アンカー・冒頭の出力表示では発行年(year)に劣後し、発行年月日(date)に優先する。 || 同上
 +
|-
 +
| date || 発行年月日。( )後の出力表示では発行年(year)に優先し、アンカー・冒頭の出力表示では劣後する。 || 同上
 +
|}
 +
=== アンカー・冒頭の出力表示に含まれない引数 ===
 +
*入力省略時の既定値はありません。
 +
{| class="wikitable" style="text-align:left"
 +
|-
 +
! 引数 !! 意味 !! 入力の要否
 +
|-
 +
| author5 || 5人目の著者姓名。( )の後に、著者姓(last5)に優先して表示。 || 可略
 +
|-
 +
| author6 || 6人目 || 可略
 +
|-
 +
| author7 || 7人目 || 可略
 +
|-
 +
| author8 || 8人目 || 可略
 +
|-
 +
| author9 || 9人目 || 可略
 +
|-
 +
| author-mask5 || 5人目の著者姓名(author5, last5, first5)を非表示にする。代わりに表示される「-」などの記号を入力。 || 可略
 +
|-
 +
| author-mask6 || 6人目 || 可略
 +
|-
 +
| author-mask7 || 7人目 || 可略
 +
|-
 +
| author-mask8 || 8人目 || 可略
 +
|-
 +
| author-mask9 || 9人目 || 可略
 +
|-
 +
| last5 || 5人目の著者姓。著者姓名(author5)に劣後して、著者名(first5)と併せて表示。 || 可略
 +
|-
 +
| last6 || 6人目 || 可略
 +
|-
 +
| last7 || 7人目 || 可略
 +
|-
 +
| last8 || 8人目 || 可略
 +
|-
 +
| last9 || 9人目 || 可略
 +
|-
 +
| first1 || 1人目の著者名。著者姓名(author, author1)に劣後して、著者姓(last, last1)と併せて表示。 || 可略
 +
|-
 +
| first2 || 2人目 || 可略
 +
|-
 +
| first3 || 3人目 || 可略
 +
|-
 +
| first4 || 4人目 || 可略
 +
|-
 +
| first5 || 5人目 || 可略
 +
|-
 +
| first6 || 6人目 || 可略
 +
|-
 +
| first7 || 7人目 || 可略
 +
|-
 +
| first8 || 8人目 || 可略
 +
|-
 +
| first9 || 9人目 || 可略
 +
|-
 +
| coauthors,<br />coauthor || 共著者 || 可略
 +
|-
 +
| chapter,<br />contribution,<br />section || 章節。書名(title)の前に出力表示。 || 可略
 +
|-
 +
| editor || 編集者 || 可略
 +
|-
 +
| translator || 翻訳者 || 可略
 +
|-
 +
| others || その他の関係者(監修など) || 可略
 +
|-
 +
| title || 書名 || 必須
 +
|-
 +
| url || URL。書名(title)に外部リンクを設定する。 || 可略
 +
|-
 +
| format || 外部リンク先のファイル形式(pdfなど) || 可略
 +
|-
 +
| language || 言語 || 可略
 +
|-
 +
| transtitle,<br />trans_title || 訳書の書名 || 可略
 +
|-
 +
| work,<br />journal,<br />newspaper,<br />magazine,<br />periodical || 定期刊行物の題名 || 可略
 +
|-
 +
| edition || 版 || 可略
 +
|-
 +
| series, version || 叢書 || 可略
 +
|-
 +
| volume || 巻 || 可略
 +
|-
 +
| issue,number || 号 || 可略
 +
|-
 +
| publisher || 出版者 || 可略
 +
|-
 +
| location || 出版地 || 可略
 +
|-
 +
| month || 発行月。年(year)、日(day)とあわせて発行年月日を表示。 || 可略
 +
|-
 +
| day || 発行日。年(year)、月(month)とあわせて発行年月日を表示。 || 可略
 +
|-
 +
| origdate || 原著・初版の発行年月日 || 可略
 +
|-
 +
| origmonth || 原著・初版の発行月。年(origyear)、日(origday)とあわせて原著・初版の発行年月日を表示。 || 可略
 +
|-
 +
| origday || 原著・初版の発行日。年(origyear)、月(origmonth)とあわせて原著・初版の発行年月日を表示。 || 可略
 +
|-
 +
| id, ID, asin,<br />doi, isbn,<br />issn, naid || 識別子。頁範囲(page, pages, at)より前に表示。 || 可略
 +
|-
 +
| id-before-at || 識別子のうち、頁範囲(page, pages, at)より前に表示するもの。 || 可略
 +
|-
 +
| page,<br />pages,<br />at || 頁、頁範囲、参照範囲 || 可略
 +
|-
 +
| id-after-at || 識別子のうち、頁範囲(page, pages, at)より後に表示するもの。 || 可略
 +
|-
 +
| quote || 引用文 || 可略
 +
|-
 +
| postscript || 追記事項、句点 || 可略
 +
|}
  
=== その他のパラメータを含む使い方 ===
+
== 関連テンプレート ==
<pre>
+
*{{Tl|Cite journal}}、{{Tl|Cite web}}、{{Tl|Cite news}}、{{Tl|Citation}} - Wikipedia互換用テンプレート
{{Cite book
+
*{{Tl|Aya}} - 書誌情報に著者姓-発行年方式のアンカーを付すためのテンプレート
|last=著者の姓
+
*{{Tl|Harv}}、{{Tl|Sfn}}{{Tl|Harvtxt}}{{Tl|Harvtxt}} - 著者姓-発行年方式で出典注(脚注)を記すためのテンプレート
|first=著者の名
+
|author=著者(last, firstの替わりに使う。東アジア名の時はこちらの方が使いやすい)
+
|authorlink=著者への内部リンク
+
|coauthors=共著者
+
|translator=訳者 (othersを使うことを推奨)。和書のときだけ有効
+
|editor=編者
+
|others=その他の人名
+
|title=タイトル
+
|origdate=原出版物の日付、YYYY-MM-DDの形式で
+
|origyear=原出版物の年、origdateの替わりに
+
|origmonth=原出版物の月、origdateの替わりに
+
|url=ウェブ上で読める資料の場合、リンク先
+
|format=HTMLでない場合(PDFなど)
+
|accessdate=閲覧日、YYYY-MM-DDの形式で
+
|accessyear=閲覧年、accessdateの替わりに
+
|accessmonth=閲覧月、accessdateの替わりに
+
|edition=版(初版、第2版...)
+
|date=日付、YYYY-MM-DDの形式で
+
|year=年、dateの替わりに
+
|month=月、dateの替わりに
+
|publisher=出版社
+
|location=出版社所在地
+
|series=叢書名
+
|language=言語
+
|id=ISBN、LCC
+
|doi=デジタルオブジェクト識別子
+
|volume=巻 (1、下、第3巻、など)。和書のときだけ有効
+
|pages=ページ
+
|chapter=章
+
|chapterurl=章のURL
+
|quote=引用(適切な引用)
+
}}
+
</pre>
+
 
+
=== 注記 ===
+
外国語文献の書式にした場合、著者の名がピリオドでおわっていて出版日付がないと、以下のようにピリオドが余分についてしまいます。
+
<pre>
+
{{Cite book
+
|first=J.
+
|last=Doe
+
|title=A Book
+
}}
+
</pre>
+
が、次のようになります:
+
{{Cite book
+
|first=J.
+
|last=Doe
+
|title=A Book
+
}}
+
 
+
date には、出版が決まっているが日付が未定の場合「印刷中」「in press」などと、また、もともと日付のない書籍の場合「日付なし」「no date」などと記入するとよいでしょう。
+
 
+
== 関連項目 ==
+
* [[Wikipedia:出典を明記する]] - 出典の書きかた
+
* [[:Category:引用テンプレート]] - 関連するテンプレート
+
 
+
== リンク ==
+
*[[デジタルオブジェクト識別子]]
+
*[[ISBN]] - [[Help:ISBNのリンク]]
+
*[[:en:Template:LCC]]
+
  
 +
<noinclude>[[Category:テンプレート文書]]</noinclude>
 
<includeonly>
 
<includeonly>
<!-- カテゴリは以下に追加してください -->
+
[[Category:内部リンク用テンプレート]]
[[Category:リンク支援テンプレート|Cite book]]
+
[[Category:出典テンプレート]]
[[Category:引用テンプレート|Cite book]]
+
 
+
 
</includeonly>
 
</includeonly>

2018年5月10日 (木) 14:55時点における最新版

Cite bookは、書籍の出典情報の記載を支援するためのテンプレートです。著者姓-発行年方式のidを持つアンカーを生成して、同一記事内のidが一致する出典注(脚注)から内部リンクできるようにする機能があります。Wikipediaの同名のテンプレートとの互換性のために作成しましたが、Yourpediaでの使用は推奨しません。

使い方[編集]

例えば、2015年にKADOKAWAから刊行された東野圭吾(著)『ラプラスの魔女』(角川文庫、ISBN 978-4041029893)の出典を記す場合、

  • {{Cite book|last= 東野 |year= 2015 |first= 圭吾 |title= ラプラスの魔女 |series= 角川文庫 |publisher= KADOKAWA |id= ISBN 978-4041029893 }}

と入力すると、

  • 東野 (2015) 東野圭吾 [ ラプラスの魔女 ] 角川文庫 KADOKAWA 2015 ISBN 978-4041029893

と出力されます。

特徴[編集]

  • 冒頭に、アンカーに使用した著者姓-発行年等の情報を出力表示します。使用する引数については、#アンカー・冒頭の出力表示に含まれる引数をご参照ください。発行年等は常に( )で囲われ、発行年等の指定がない場合、空の( )が出力表示されます。
  • アンカーは、常に引数で指定した著者姓-発行年等の情報から生成します。引数「ref」は効きません。
  • アンカーの作成と冒頭の出力表示では「author」よりも「last」、「date」よりも「year」が優先され、( )の後の出力表示では「last」よりも「author」、「year」よりも「date」が優先されます。「last」と「author」、「year」と「date」を両方指定することにより、出力表示を分けることができます。
  • 著者名から著者の記事への内部リンクを生成したい場合、引数「authorlink」は効きませんので、引数「author」に直接[[ ]]を付してください。その際、[[ ]]を付さずにアンカーを作成するためには、別途、引数「last」を[[ ]]を使わずに記してください。
  • 書題(title)は、引数「url」を指定して外部リンクを設定しない限り、常に[ ]で囲われて出力表示されます。
  • 上記のほかに、括弧や句読点、「第-巻」「-年-月-日」の記載などの、スタイルに関する自動補完機能は何もありません。句点を付したいときは引数「postscript」で指定できますが、ベタ書きするのと変わりありません。
  • 書籍・雑誌等の識別子を入力するための引数には、「id」「ID」「id-before-at」「id-after-at」のほかに「asin」「isbn」「doi」「issn」「naid」がありますが、外部リンクを作成する機能はありません。外部リンクを作成したいときは、ISBNや{{asin}}、{{doi}}、{{issn}}、{{naid}}などのテンプレートを使用して入力指定してください。

開発の意図[編集]

条件文を使わないという制約下で、WikipediaのCite系テンプレートと互換性を持つように作成しました。

WikipediaのCite系テンプレートには、著者姓-発行年方式のアンカー作成機能のほかに、テンプレートに入力された書誌情報を集計可能にする機能があります。しかしこの(Yourpediaの)テンプレートには集計機能はありません。集計機能を実装しない場合、アンカーの作成に必要な著者姓-発行年等の情報以外の書誌情報をテンプレートに入力する意味はあまりないと思います。だからこのテンプレートの使用は特に推奨しません。アンカーを作成したいときは、{{Aya}}を使用し、あとの書誌情報はお好きなスタイルで書くことをお勧めします。

引数一覧[編集]

アンカー・冒頭の出力表示に含まれる引数[編集]

  • 入力省略時の既定値はありません。
引数 意味 入力の要否
last,last1 1人目の著者姓。アンカー・冒頭の出力表示では著者姓名(author, author1)に優先し、( )後の出力表示では劣後する。 last,last1,author, author1のいずれかが必要
last2 2人目 可略
last3 3人目 可略
last4 4人目 可略
author,
author1
1人目の著者姓名。( )後の出力表示では著者姓(last last1)に優先し、アンカー・冒頭の出力表示では劣後する。 last,last1,author, author1のいずれかが必要
author2 2人目 可略
author3 3人目 可略
author4 4人目 可略
author-mask,
author-mask1
1人目の著者姓名(author, author1, last, last1, first, first1)を非表示にする。代わりに表示される「-」などの記号を入力。 可略
author-mask2 2人目 可略
author-mask3 3人目 可略
author-mask4 4人目 可略
year 発行年。アンカー・冒頭の出力表示では発行年月日(date)に優先し、( )後の出力表示では劣後する。 year, origyear, dateのいずれかが必要
origyear 原著・初版の発行年。アンカー・冒頭の出力表示では発行年(year)に劣後し、発行年月日(date)に優先する。 同上
date 発行年月日。( )後の出力表示では発行年(year)に優先し、アンカー・冒頭の出力表示では劣後する。 同上

アンカー・冒頭の出力表示に含まれない引数[編集]

  • 入力省略時の既定値はありません。
引数 意味 入力の要否
author5 5人目の著者姓名。( )の後に、著者姓(last5)に優先して表示。 可略
author6 6人目 可略
author7 7人目 可略
author8 8人目 可略
author9 9人目 可略
author-mask5 5人目の著者姓名(author5, last5, first5)を非表示にする。代わりに表示される「-」などの記号を入力。 可略
author-mask6 6人目 可略
author-mask7 7人目 可略
author-mask8 8人目 可略
author-mask9 9人目 可略
last5 5人目の著者姓。著者姓名(author5)に劣後して、著者名(first5)と併せて表示。 可略
last6 6人目 可略
last7 7人目 可略
last8 8人目 可略
last9 9人目 可略
first1 1人目の著者名。著者姓名(author, author1)に劣後して、著者姓(last, last1)と併せて表示。 可略
first2 2人目 可略
first3 3人目 可略
first4 4人目 可略
first5 5人目 可略
first6 6人目 可略
first7 7人目 可略
first8 8人目 可略
first9 9人目 可略
coauthors,
coauthor
共著者 可略
chapter,
contribution,
section
章節。書名(title)の前に出力表示。 可略
editor 編集者 可略
translator 翻訳者 可略
others その他の関係者(監修など) 可略
title 書名 必須
url URL。書名(title)に外部リンクを設定する。 可略
format 外部リンク先のファイル形式(pdfなど) 可略
language 言語 可略
transtitle,
trans_title
訳書の書名 可略
work,
journal,
newspaper,
magazine,
periodical
定期刊行物の題名 可略
edition 可略
series, version 叢書 可略
volume 可略
issue,number 可略
publisher 出版者 可略
location 出版地 可略
month 発行月。年(year)、日(day)とあわせて発行年月日を表示。 可略
day 発行日。年(year)、月(month)とあわせて発行年月日を表示。 可略
origdate 原著・初版の発行年月日 可略
origmonth 原著・初版の発行月。年(origyear)、日(origday)とあわせて原著・初版の発行年月日を表示。 可略
origday 原著・初版の発行日。年(origyear)、月(origmonth)とあわせて原著・初版の発行年月日を表示。 可略
id, ID, asin,
doi, isbn,
issn, naid
識別子。頁範囲(page, pages, at)より前に表示。 可略
id-before-at 識別子のうち、頁範囲(page, pages, at)より前に表示するもの。 可略
page,
pages,
at
頁、頁範囲、参照範囲 可略
id-after-at 識別子のうち、頁範囲(page, pages, at)より後に表示するもの。 可略
quote 引用文 可略
postscript 追記事項、句点 可略

関連テンプレート[編集]

  • {{Cite journal}}、{{Cite web}}、{{Cite news}}、{{Citation}} - Wikipedia互換用テンプレート
  • {{Aya}} - 書誌情報に著者姓-発行年方式のアンカーを付すためのテンプレート
  • {{Harv}}、{{Sfn}}、{{Harvtxt}}、{{Harvtxt}} - 著者姓-発行年方式で出典注(脚注)を記すためのテンプレート