「テンプレート:Aya」の版間の差分
細 (由亜辺出夫 がページ「テンプレート:Cite id」を「テンプレート:Aya」に移動しました: 短い名称に変更) |
細 (動作不良のため修正。) |
||
1行目: | 1行目: | ||
<includeonly>{{CitationAnotherCore | <includeonly>{{CitationAnotherCore | ||
− | |Citation class= | + | |Citation class=book |
|Ancname1={{{1}}} | |Ancname1={{{1}}} |
2018年5月5日 (土) 12:30時点における版
Ayaは、出典注の参照先となる書誌情報にアンカーを付し、著者姓-発行年方式で記された内部リンクの標的とするためのテンプレートです。AyaはAuthor-year anchorの意味です。
使い方
例えば、佐藤某さんの2018年の著書にアンカーを付したい場合、書誌情報の前に
- {{Aya|佐藤|year=2018}} 佐藤某『書題××』出版社、2018年
のように記します。この入力は、テンプレート{{CitationAnotherCore}}を呼び出し、内部で
- <span class="citation book" id="CITEREF佐藤2018">佐藤 (2018)</span> 佐藤某『書題××』出版社、2018年
と解釈されます。これにより「CITEREF佐藤2018」というアンカーが生成され、内部参照の標的とすることができるようになります。
例えば、本文中で、
{{Harvtxt|佐藤|2018|pp=19-20}}はこれこれこうだと記している。
のように言及していたとすると、出力は、
佐藤 (2018 19-20)はこれこれこうだと記している。
となり、下記の参考文献(表示例)への内部リンクが生成されている(クリックするとジャンプする)ことが確認できると思います。
参考文献(表示例)
佐藤 (2018) 佐藤某『書題××』出版社、2018年
引数一覧
引数の記し方はHarv系のテンプレートに似せていますが、発行年(月日)について引数名「year」ないし「date」の記載を要する点にご留意ください。
引数(名省略時) | 引数(名指定時) | 意味 | 既定値 | 入力の要否 |
---|---|---|---|---|
1 | (なし) | 著者姓1 | (なし) | 必須 |
2 | (なし) | 著者姓2 | (なし) | 可略 |
3 | (なし) | 著者姓3 | (なし) | 可略 |
4 | (なし) | 著者姓4 | (なし) | 可略 |
(なし) | year | 発行年 | (なし) | yearまたはdateの入力が必須。優先度はyearの方が高い。 |
(なし) | date | 発行年月日 | (なし) | 同上。 |
(なし) | mask,mask1 | 著者姓1を(アンカーには含めるが)表示しない。入力値は、著者姓1の代わりに表示される(「-」など)。 | (なし) | 可略 |
(なし) | mask2 | 著者姓2について、上と同じ。 | (なし) | 可略 |
(なし) | mask3 | 著者姓3について、上と同じ。 | (なし) | 可略 |
(なし) | mask4 | 著者姓4について、上と同じ。 | (なし) | 可略 |
開発の意図
Harv系のテンプレートを使用する場合、標的となる書誌情報の側にアンカーを付す必要があり、Wikipediaでは、内部でアンカーを生成する{{Citation}}やCite One型テンプレート({{Cite book}}、{{Cite journal}}など)の使用が推奨されています。
Cite系のテンプレートには、出典注用のアンカーを付す機能のほかにも、括弧や句読点を補ったり、テンプレートに入力された書誌情報を取得し集計する機能があります。
しかし2018年4月現在のYourpediaでは、条件文が通らないため、Cite系のテンプレートで括弧や句読点などの表示を制御することは困難です。また集計機能は記事の執筆には特に必要ありません。
となると、アンカーに必要な最小限の情報だけ入力して、残りの書誌情報はテンプレートを使わずにベタ書きした方がいいと考え、それ用に作成しました。
入出力例
事例 | 入力 | 出力 |
---|---|---|
著者1人 | {{Aya|佐藤|year=2018}} | 佐藤 (2018) |
同2人 | {{Aya|佐藤|鈴木|year=2018}} | 佐藤 鈴木 (2018) |
同3人 | {{Aya|佐藤|鈴木|高橋|year=2018}} | 佐藤 鈴木 高橋 (2018) |
同4人 | {{Aya|佐藤|鈴木|高橋|田中|year=2018}} | 佐藤 鈴木 高橋 田中 (2018) |
同5人(エラー:4人しか入力できない) | {{Aya|佐藤|鈴木|高橋|田中|伊藤|year=2018}} | 佐藤 鈴木 高橋 田中 (2018) |
同0人(エラー) | {{Aya|year=2018}} | (2018) |
発行年引数記載なし(エラー) | {{Aya|佐藤|2018}} | 佐藤 2018 ( ) |
発行年指定なし(エラー) | {{Aya|佐藤}} | 佐藤 ( ) |