テンプレート:要出典/docのソースを表示

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<includeonly>{{pp-template}}{{使用箇所の多いテンプレート|36,000以上}}</includeonly>
このテンプレートは記事の内容について出典を求めるとき、記事中のどの部分について出典を求めているのかを特定するために用います。[[Wikipedia:検証可能性]]の編集方針により、記事を作成する上では引用または出典を必ず示さなければなりません。記事を編集する際には[[Wikipedia:出典を明記する]]を参照して文献情報などを添えた上で加筆してください。

本テンプレートは単独で使っても構いませんが、記事の内容に問題があり、以下のテンプレートを使う際に問題の箇所を特定するためにも使えます。
: {{tl|出典の明記}}、{{tl|未検証}}、{{tl|観点}}、{{tl|正確性}}、{{tl|精度}}、{{tl|告知}}、{{tl|独自研究}}

このテンプレートは[[Wikipedia:ウィキペディアへの自己言及|自己参照]]であり、百科事典の内容ではなくウィキペディア・プロジェクトに属しています。

== 使用法 ==
;使用例
 この文は例です<nowiki>{{要出典|date=</nowiki>{{#time:Y年n月|+9 hours}}<nowiki>}}</nowiki>。
;表示例
:この文は例です{{要出典|date={{#time:Y年n月|+9 hours}}}}。

テンプレートの表示位置にマウスカーソルを合わせると、情報源を求めるメッセージと日付（年・月）が[[ツールチップ]]で表示されます。「要出典」の文字のリンク先は[[Wikipedia:「要出典」をクリックされた方へ]]となっています。

さらに、出典を求める箇所を絞り込んで示したい場合には、以下のように書くとその次のように表示されます。

 この文は<nowiki>{{要出典|範囲=出典を求める範囲を示す使い方の|date=</nowiki>{{#time:Y年n月|+9 hours}}<nowiki>}}</nowiki>例です。

:この文は{{要出典|範囲=出典を求める範囲を示す使い方の|date={{#time:Y年n月|+9 hours}}}}例です。

これは従来の使用方法との互換性から、引数名の "範囲=" を省略してテキストだけを入力しても動作しますが、入力するテキスト中に半角イコールを含んでいる場合に表示されなくなるため、省略せず "範囲=〜〜〜" と記入することを推奨します。なお、[[Template:要出典範囲]]を用いても同様の表示ができます。

マウスカーソルを合わせたときに表示する[[ツールチップ]]のコメントを任意に指定したい場合は、以下のように書くとその次のように表示されます。

 この文は例です<nowiki>{{要出典|date=</nowiki>{{#time:Y年n月|+9 hours}}<nowiki>|title=出典を求める理由や求める出典内容}}</nowiki>。

:この文は例です{{要出典|date={{#time:Y年n月|+9 hours}}|title=出典を求める理由や求める出典内容}}。

（マウスカーソルを合わせるとtitleで指定した文字列が表示されます）。

1ページ内に貼り付ける数が多い場合など、[[ツールチップ]]の既定文字列を表示させたくない場合は、空の無名パラメータをひとつ追加してください。具体的には「|」（縦棒）をひとつ追加します。この場合の dateパラメータに指定できる形式は「yyyy年m月」形式のみとなり、他の形式での指定はできません<!-- 理由: このテンプレートは見かけは小さいが内部テンプレートまで含めての展開サイズは大きいので 1ページに大量のタグが貼られた場合のサーバー負荷を低減するため。あまり大量に貼るとシステムがそのページを「Category:高負荷な構文解析関数の呼び出しが多過ぎるページ」に分類する。かつての実例記事:「日本の郷土料理一覧」 -->。以下のように書くとその次のように表示されます。

 この文は例です<nowiki>{{要出典|date=</nowiki>{{#time:Y年n月|+9 hours}}<nowiki>|}}</nowiki>。

:この文は例です{{要出典|date={{#time:Y年n月|+9 hours}}|}}。

（マウスカーソルを合わせると日付だけが表示されます）。

== 引数 ==
{| class="wikitable" border="1"
|+ 引数の一覧
! 引数 !! 指定内容 !! 説明
|-
! date
| 貼付年月 || テンプレートを付記した年月を「{{#time:Y年n月|+9 hours}}」というような形式で記載してください。指定された年月をもとに、原則[[:Category:出典を必要とする記述のある記事/{{#time:Y年n月|+9 hours}}]]のようなカテゴリに分類されます（※日付に対応する先述のようなカテゴリが存在しない場合、[[:Category:出典を必要とする記事/{{#time:Y年n月|+9 hours}}]]のようなカテゴリに分類されます）。
|-
! 範囲
| 要出典範囲 || 出典を求める箇所。標準的なブラウザの閲覧環境では、テキストに下線が引かれて表示されます。
|-
! title
| [[ツールチップ]] || 出典を求める理由、および求める出典内容。「要出典」の文字にマウスカーソルを合わせたときに表示されます。
|-
|}

=== TemplateData ===
{{TemplateDataHeader}}
<templatedata>
{
	"description": "このテンプレートは記事の内容について出典を求めるとき、記事中のどの部分について出典を求めているのかを特定するために用います。",
	"format": "inline",
	"params": {
		"title": {
			"label": "ツールチップ",
			"description": "出典を求める理由、および求める出典内容。「要出典」の文字にマウスカーソルを合わせたときに表示されます。",
			"type": "line",
			"default": "この記述には信頼できる情報源の提示が求められています。",
			"required": false
		},
		"date": {
			"label": "貼付年月",
			"description": "テンプレートを付記した年月を「2013年8月」という形式で記載して下さい。この例では「Category:出典を必要とする記述のある記事/2013年8月」に分類されます。",
			"type": "date",
			"required": true,
			"autovalue": "{{subst:#time:Y年F}}",
			"example": "2013年8月"
		},
		"範囲": {
			"label": "要出典範囲",
			"description": "出典を求める箇所。標準的なブラウザの閲覧環境では、テキストに下線が引かれて表示されます。",
			"type": "content",
			"aliases": [
				"fix-span"
			],
			"required": false
		}
	},
	"paramOrder": [
		"date",
		"範囲",
		"title"
	]
}
</templatedata>

== 要出典テンプレートと要出典範囲テンプレートの違い ==

英語の[[:en:Template:Citation needed|Citation needed]]と[[:en:Template:Citation needed span|Citation needed span]]の違いは、Citation neededが範囲を示しませんがCitation needed spanが範囲を示すことです。日本のテンプレートは歴史的な事情が異なり要出典テンプレートと要出典範囲テンプレートはどちらも範囲を示せます。要出典範囲テンプレートはいらないのではないかというと一つだけ違いがありました。

要出典テンプレートは範囲のパラメーターを渡さなくてもエラーを出しませんが、要出典範囲テンプレートは範囲のパラメーターを渡さないとエラーを出します。

{{tlc|要出典|2=date=2021年1月}}
:{{要出典|date=2021年1月}}

{{tlc|要出典範囲|2=date=2021年1月}}
:{{要出典|date=2021年1月}}{{Fix/error|B|要出典範囲|要出典|onlyarticles=no}}

標準の名前空間のみエラーを出しノートや利用者などの名前空間でエラーを出さないことが要出典テンプレートと要出典範囲テンプレートの違いをわかりにくくしています。

== カテゴリ ==
このテンプレートは、貼り付けられたページに次のカテゴリを適用します:
{| class="wikitable"
! カテゴリ !! ソートキー !! 説明
|-
! style="text-align:left;" | [[:Category:出典を必要とする記述のある記事]]
|  |DEFAULTSORT  || 当該月のサブカテゴリが存在する場合
|-
! style="text-align:left;" | [[:Category:出典を必要とする記事]]
|  |DEFAULTSORT  || 「Category:出典を必要とする記述のある記事」に当該月のサブカテゴリが存在しない場合
|}

== リダイレクト ==
他言語版で相当タグが挿入されている記事を翻訳する上での便宜のために設けられています。日本語版で新たに挿入する場合にはリダイレクトの使用は無用です。
* {{tl|Citation needed}}
* {{tl|Cn}}
* {{tl|Fact}}

== 関連テンプレート ==
;出典を求める
:; {{tl|要出典範囲}} : 出典明記の文章を範囲指定する。
:; {{tl|出典の明記}} : 記事全体（または記事内の節の全体）について出典を求める。
;医学・科学
:; {{tl|要出典医学}}
:; {{tl|要出典科学}}
;ほか
:; {{tl|誰}}・{{tl|誰2}} : 誰が言っているのか明示を求める。
:; {{tl|いつ}} : 時期や年月日の明示を求める。
:; {{tl|どこ}} : 場所の明示を求める。
:; {{tl|要検証}} : 検証可能性に問題がある文章に。記事や節には{{tl|未検証}}。
:; {{tl|疑問点}} : 記事の内容の不正確性を示す。記事用の{{tl|正確性}}の文章用。
:; {{tl|Full}} : 文献特定のための詳細情報を求める。
:; {{tl|信頼性要検証}} : 出典が信頼性に乏しい。個別の文章にて使う。

== 関連項目 ==
* [[Wikipedia:検証可能性]]
* [[Wikipedia:出典を明記する]]
* [[Wikipedia:信頼できる情報源]]

<includeonly>
<!-- カテゴリは以下に追加してください -->
{{DEFAULTSORT:ようしゆつてん}}
[[Category:検証可能性関連のテンプレート]]
[[Category:インラインテンプレート]]
</includeonly>