テンプレート:Citation
提供: Yourpedia
Citationは、出典情報の記載を支援するためのテンプレートです。著者姓-発行年方式のidを持つアンカーを生成して、同一記事内のidが一致する出典注（脚注）から内部リンクできるようにする機能があります。Wikipediaの同名のテンプレートとの互換性のために作成しましたが、Yourpediaでの使用は推奨しません。
使い方[編集]
例えば、2008年12月の山口大学医学会の雑誌『山口医学』（第57巻第6号）に掲載された、東ほか7人が著者にクレジットされている論文『両側乳癌手術症例の臨床および病理組織学的検討』（NAID 110007056050、197-202頁）の出典を記す場合、
{{Citation|last1= 東 |first1= 美和 |last2= 倉田 |first2= 悟 |last3= 宮本 |first3= 俊吾 |last4= 金田 |first4= 好和 |last5= 須藤 |first5= 隆一郎 |last6= 善甫 |first6= 宣哉 |last7= 中安 |first7= 清 |year= 2008 |month= 12 |title= 両側乳癌手術症例の臨床および病理組織学的検討 |journal= 山口医学 |volume= 57 |issue= 6 |publisher= 山口大学医学会 |id= {{naid|110007056050}} |pages=197-202 }}
と入力すると、
- 東 倉田 宮本 金田 (2008) 東美和 倉田悟 宮本俊吾 金田好和 須藤隆一郎 善甫宣哉 中安清 [ 両側乳癌手術症例の臨床および病理組織学的検討 ] 山口医学 57 6 山口大学医学会 2008 12 197-202 NAID 110007056050
と出力されます。
特徴[編集]
- 冒頭に、アンカーに使用した著者姓-発行年等の情報を出力表示します。使用する引数については、#アンカー・冒頭の出力表示に含まれる引数をご参照ください。発行年等は常に( )で囲われ、発行年等の指定がない場合、空の( )が出力表示されます。
- アンカーは、常に引数で指定した著者姓-発行年等の情報から生成します。引数「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 | 叢書 | 可略 |
| agency | 通信社 | 可略 |
| volume | 巻 | 可略 |
| issue,number | 号 | 可略 |
| publisher | 出版者 | 可略 |
| location | 出版地 | 可略 |
| month | 発行月。年（year）、日（day）とあわせて発行年月日を表示。 | 可略 |
| day | 発行日。年（year）、月（month）とあわせて発行年月日を表示。 | 可略 |
| origdate | 原著・初版の発行年月日 | 可略 |
| origmonth | 原著・初版の発行月。年（origyear）、日（origday）とあわせて原著・初版の発行年月日を表示。 | 可略 |
| origday | 原著・初版の発行日。年（origyear）、月（origmonth）とあわせて原著・初版の発行年月日を表示。 | 可略 |
| asin, isbn, issn |
識別番号。頁範囲（page, pages, at）より前に表示。 | 可略 |
| id-before-at | 識別番号のうち、頁範囲（page, pages, at）より前に表示するもの。 | 可略 |
| page, pages, at |
頁、頁範囲、参照範囲 | 可略 |
| id, ID, doi, naid |
識別番号。頁範囲（page, pages, at）より後に表示。 | 可略 |
| id-after-at | 識別番号のうち、頁範囲（page, pages, at）より後に表示するもの。 | 可略 |
| quote | 引用文 | 可略 |
| archive | アーカイブ名 | 可略 |
| archiveurl | アーカイブのURL | 可略 |
| archivedate | アーカイブの日付 | 可略 |
| accessdate | 閲覧日付 | 可略 |
| deadurl | リンク切れしているURL | 可略 |
| postscript | 追記事項、句点 | 可略 |
