由亜辺出夫: /* 使い方 */

2018-05-05T03:33:41Z

‎使い方

由亜辺出夫: ページの作成:「'''Aya'''は、出典注の参照先となる書誌情報にアンカーを付し、著者姓-発行年方式で記された内部リンクの標的とするためのテ...」

2018-04-25T08:46:21Z

ページの作成:「'''Aya'''は、出典注の参照先となる書誌情報にアンカーを付し、著者姓-発行年方式で記された内部リンクの標的とするためのテ...」

新規ページ

'''Aya'''は、出典注の参照先となる書誌情報にアンカーを付し、著者姓-発行年方式で記された内部リンクの標的とするためのテンプレートです。Ayaは'''A'''uthor-'''y'''ear '''a'''nchorの意味です。

== 使い方 ==
例えば、佐藤某さんの2018年の著書にアンカーを付したい場合、書誌情報の前に
*<nowiki>{{Aya|佐藤|year=2018}} 佐藤某『書題××』出版社、2018年</nowiki>
のように記します。この入力は、テンプレート{{tl|CitationAnotherCore}}を呼び出し、内部で
*<nowiki><span class="citation id" id="CITEREF佐藤2018">佐藤 (2018)</span> 佐藤某『書題××』出版社、2018年</nowiki>

と解釈されます。これにより「<nowiki>CITEREF佐藤2018</nowiki>」というアンカーが生成され、内部参照の標的とすることができるようになります。

例えば、本文中で、

<nowiki>{{Harvtxt|佐藤|2018|pp=19-20}}はこれこれこうだと記している。</nowiki>

のように言及していたとすると、出力は、

{{Harvtxt|佐藤|2018|pp=19-20}}はこれこれこうだと記している。

となり、下記の参考文献（表示例）への内部リンクが生成されている（クリックするとジャンプする）ことが確認できると思います。

=== 参考文献（表示例） ===
{{Aya|佐藤|year=2018}} 佐藤某『書題××』出版社、2018年

== 引数一覧 ==
引数の記し方はHarv系のテンプレートに似せていますが、発行年（月日）について引数名「year」ないし「date」の記載を要する点にご留意ください。

{|class="wikitable"
! 引数（名省略時） !! 引数（名指定時） !! 意味 !! 既定値 !! 入力の要否
|-
| 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では、内部でアンカーを生成する{{tl|Citation}}やCite One型テンプレート（{{tl|Cite book}}、{{tl|Cite journal}}など）の使用が推奨されています。

Cite系のテンプレートには、出典注用のアンカーを付す機能のほかにも、括弧や句読点を補ったり、テンプレートに入力された書誌情報を取得し集計する機能があります。

しかし2018年4月現在のYourpediaでは、条件文が通らないため、Cite系のテンプレートで括弧や句読点などの表示を制御することは困難です。また集計機能は記事の執筆には特に必要ありません。

となると、アンカーに必要な最小限の情報だけ入力して、残りの書誌情報はテンプレートを使わずにベタ書きした方がいいと考え、それ用に作成しました。

== 入出力例 ==
{| class="wikitable"
|-
! 事例 !! 入力 !! 出力
|-
!著者1人
| <nowiki>{{Aya|佐藤|year=2018}}</nowiki> || 佐藤 (2018)
|-
!同2人
| <nowiki>{{Aya|佐藤|鈴木|year=2018}}</nowiki> || 佐藤鈴木 (2018)
|-
!同3人
| <nowiki>{{Aya|佐藤|鈴木|高橋|year=2018}}</nowiki> || 佐藤鈴木高橋 (2018)
|-
!同4人
| <nowiki>{{Aya|佐藤|鈴木|高橋|田中|year=2018}}</nowiki> || 佐藤鈴木高橋田中 (2018)
|-
!同5人（エラー:4人しか入力できない）
| <nowiki>{{Aya|佐藤|鈴木|高橋|田中|伊藤|year=2018}}</nowiki> || 佐藤鈴木高橋田中 (2018)
|-
!同0人（エラー）
| <nowiki>{{Aya|year=2018}}</nowiki> || (2018)
|-
!発行年引数記載なし（エラー）
| <nowiki>{{Aya|佐藤|2018}}</nowiki> || 佐藤 2018 ( )
|-
!発行年指定なし（エラー）
| <nowiki>{{Aya|佐藤}}</nowiki> || 佐藤 ( )
|}

== 関連項目 ==
*[[:Category:出典テンプレート|出典テンプレート]] - {{tl|Harv}}、{{tl|Harvnb}}、{{tl|Harvtxt}}、{{tl|Sfn}}
*[[:Category:内部リンク用テンプレート|内部リンク用テンプレート]] - {{tl|Anchor}}、{{tl|Anchors}}

<includeonly>
[[Category:内部リンク用テンプレート]]
[[Category:出典テンプレート]]
</includeonly>

@@ 5行目: / 5行目: @@
 *<nowiki>{{Aya|佐藤|year=2018}} 佐藤某『書題××』出版社、2018年</nowiki>
 のように記します。この入力は、テンプレート{{tl|CitationAnotherCore}}を呼び出し、内部で
-*<nowiki><span class="citation id" id="CITEREF佐藤2018">佐藤 (2018)</span> 佐藤某『書題××』出版社、2018年</nowiki>
+*<nowiki><span class="citation book" id="CITEREF佐藤2018">佐藤 (2018)</span> 佐藤某『書題××』出版社、2018年</nowiki>
 と解釈されます。これにより「<nowiki>CITEREF佐藤2018</nowiki>」というアンカーが生成され、内部参照の標的とすることができるようになります。

テンプレート:Aya/doc - 変更履歴

由亜辺出夫: /* 使い方 */

由亜辺出夫: ページの作成:「'''Aya'''は、出典注の参照先となる書誌情報にアンカーを付し、著者姓-発行年方式で記された内部リンクの標的とするためのテ...」