Editing Template:Cite journal/doc

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
{{使用箇所の多いテンプレート|110,000以上}}
{{See also|Wikipedia:出典テンプレート}}

'''Cite journal''' は、[[WP:CITE|出典を明記する]]のに使います。学術雑誌の記事用です。日本語の学術雑誌には[[Template:Cite journal ja-jp]]を使うこともできます。また、英語版記事を翻訳した時に'''Template:Cite journal'''を使用した出典が英語版と同じ表示にならない場合は[[Template:Cite journal2]]に差し替えることを試みてください。

'''Template:Cite paper'''、'''Template:Cite magazine''' から転送されており、論文や一般の雑誌にも使用できると考えられます。

書籍には[[Template:Cite book]]または[[Template:Citation]]または[[Template:Cite book ja-jp]]を使ってください。

== 基本フォーマット ==
=== 和書 ===
最初のパラメータに「和書」と入れるか、言語を日本語に指定する（{{para|language|ja}}）と、[[Wikipedia:出典を明記する#書誌情報の書き方（和書）|和書の書式]]になります。

<code><nowiki>{{Cite journal |和書 |author= |authorlink= |title= |journal= |volume= |issue= |publisher= |date= |pages= |naid= |ref=}}</nowiki></code>

<pre>{{Cite journal |和書
| author = 江崎玲於奈
| authorlink = 江崎玲於奈
| title = Zaner電流と薄いp-n接合
| journal = 日本物理學會誌
| volume = 13
| issue = 4
| publisher = 社団法人日本物理学会
| date = 1958年04月
| pages = 252-256
| crid = 1390001205406006784
| ref = harv
}}
</pre>
: {{Cite journal |和書
| author = 江崎玲於奈
| authorlink = 江崎玲於奈
| title = Zaner電流と薄いp-n接合
| journal = 日本物理學會誌
| volume = 13
| issue = 4
| publisher = 社団法人日本物理学会
| date = 1958-04
| pages = 252-256
| crid = 1390001205406006784
| ref = harv
}}

上に示した例の様に<code>ref = harv</code>が指定されている場合に、{{tl|Harv}}を用いて書誌情報を参照できるようにID属性が設定される。

=== 外国語文献 ===
最初のパラメータに「和書」を''入れない''と、[[Wikipedia:出典を明記する#書誌情報の書き方（外国語文献）|外国語文献の書式]]になります。

<code><nowiki>{{Cite journal |last= |first= |last2= |first2= |date= |title= |url= |journal= |publisher= |volume= |issue= |pages= |language= |doi= |accessdate=}}</nowiki></code>

<pre>{{Cite journal 
| last = Smith
| first = Joseph III
| date = October 1879
| title = Last Testimony of Sister Emma
| journal = The Saints' Herald
| volume = 26
| page = 289
| language = en
}}</pre>
: {{Cite journal 
| last = Smith
| first = Joseph III
| date = October 1879
| title = Last Testimony of Sister Emma
| journal = The Saints' Herald
| volume = 26
| page = 289
| language = en
}}

== パラメータ一覧 ==
<code><nowiki>{{Cite journal |和書 |last= |first= |author= |authorlink= |date= |year= |month= |title= |journal= |volume= |issue= |page= |pages= |publisher= |location= |language= |issn= |crid= |doi= |hdl= |pmid= |id= |isbn= |url= |format= |accessdate= |quote= |ref=}}</nowiki></code>

 <nowiki>{{Cite journal |和書（「|和書」は和書用表示の場合だけ必要）
| last = 著者の姓（「, first」より前に表示される）
| first = 著者の名（「last, 」の後に表示される）
| author = 著者（last未入力時のみ表示され「名姓」や「姓名」としたい場合に使う）
| authorlink = 著者への内部リンク（</nowiki>[[Help:ページ名|Wikipediaのページ名]]<nowiki>を指定する）
| date = YYYY-MM-DD または YYYY年M月D日 または YYYY年M月 または YYYY
| year = 年 （ref=harv を指定する場合に表示と参照が異なる場合に指定、参照は year、表示は date）
| month = 月 （date=を指定する代わりに yearと共に指定、dateに月を含めて指定すれば指定不要）
| title = 記事のタイトル
| journal = 雑誌名
| volume = 巻（和書用の場合、数字のみ入れると自動的に「第X巻」となる）
| issue = 号（和書用の場合、数字のみ入れると自動的に「第Y号」となる）
| page = ページ番号（単一ページ）。"page = 5"でp. 5と表示される。
| pages = ページ範囲（複数ページ）。"pages = 5–7"でpp. 5–7と表示される。pageがある場合、journalが未記載の場合は無効。注：総ページ数ではない。
| publisher = 出版社
| location = 出版社の所在地
| language = 出典の言語（言語コードまたは言語名）。"ja"で日本語、"en"で英語と表示される。日本語を指定した場合は自動的に和書用表示になり、「日本語」は表示されない。
| issn = </nowiki>[[ISSN]]<nowiki>
| crid = </nowiki>[[CRID (識別子)|CiNii Research ID]]<nowiki>
| doi = </nowiki>[[デジタルオブジェクト識別子]]<nowiki>
| hdl = </nowiki>[[ハンドルシステム|ハンドルシステム識別子]]<nowiki>
| pmid = </nowiki>[[PMID|Pubmed ID]]<nowiki>
| id = </nowiki>[[:Category:文献リンク用テンプレート|文献リンク用テンプレート]]（例：{{tlx|JOI|JST.JSTAGE/johokanri/42.126}}など）<nowiki>
| isbn = </nowiki>[[ISBN]]<nowiki>
| url = ウェブ上で閲覧できるリンク先（title表示部に外部リンクを作成する）
| format = url に指定したリンク先がHTMLでない場合（PDF等）
| accessdate = 閲覧日（YYYY-MM-DDのように書く）
| quote = 適切な引用
| ref = id 属性（harvなど）
}}</nowiki>

=== 複数著者の場合 ===
'''author2='''および'''authorlink2='''、'''author3='''および'''authorlink3='''、といった形で指定できます。

* <code><nowiki>{{Cite journal |和書 |author=伊藤一夫 |author2=植村泰忠 |authorlink2=植村泰忠 |author3=江崎玲於奈 |authorlink3=江崎玲於奈 |author4=金井英三 |author5=木下是雄 |authorlink5=木下是雄 |author6=小谷正雄 |authorlink6=小谷正雄 |author7=坂井光夫 |author8=柴田長吉郎 |author9=高橋秀俊 |authorlink9=高橋秀俊 |title=基礎と応用をつなぐもの |journal=日本物理學會誌 |volume=12 |issue=9 |date=1957-09-05 |crid=1390007050485574912}}</nowiki></code>
** {{Cite journal |和書 |author=伊藤一夫 |author2=植村泰忠 |authorlink2=植村泰忠 (物理学者) |author3=江崎玲於奈 |authorlink3=江崎玲於奈 |author4=金井英三 |author5=木下是雄 |authorlink5=木下是雄 |author6=小谷正雄 |authorlink6=小谷正雄 |author7=坂井光夫 |author8=柴田長吉郎 |author9=高橋秀俊 |authorlink9=高橋秀俊 |title=基礎と応用をつなぐもの |journal=日本物理學會誌 |volume=12 |issue=9 |date=1957-09-05 |crid=1390007050485574912}}

'''coauthors='''で列挙することもできます。

*<code><nowiki>{{Cite journal |和書 |author=伊藤一夫 |coauthors=[[植村泰忠 (物理学者)|]]、[[江崎玲於奈]]、金井英三、[[木下是雄]]、[[小谷正雄]]、坂井光夫、柴田長吉郎、[[高橋秀俊]] |title=基礎と応用をつなぐもの |journal=日本物理學會誌 |volume=12 |issue=9 |date=1957-09-05 |crid=1390007050485574912}}</nowiki></code>
**{{Cite journal |和書 |author=伊藤一夫 |coauthors=[[植村泰忠 (物理学者)|植村泰忠]]、[[江崎玲於奈]]、金井英三、[[木下是雄]]、[[小谷正雄]]、坂井光夫、柴田長吉郎、[[高橋秀俊]] |title=基礎と応用をつなぐもの |journal=日本物理學會誌 |volume=12 |issue=9 |date=1957-09-05 |crid=1390007050485574912}}

;注意
:'''authorlink'''を入力すると強制的に[[Help:リンク|内部リンク]]が作成されるので、'''author''' の入力値に内部リンクが含まれている場合は'''authorlink'''を指定しないでください（'''last'''と'''first'''の表示部全体をひとつの内部リンクにするには'''authorlink'''が必要になります）。
:* 誤例 <code><nowiki>{{Cite journal |author=[[著者太郎]] |authorlink=著者太郎}}</nowiki></code> → {{Cite journal |author=[[著者太郎]] |authorlink=著者太郎}}

=== 書誌IDの指定 ===
<code><nowiki>{{Cite journal |author= |year= |title= |journal= |volume= |issue= |pages= |publisher= |language= |doi= |pmid= |pmc= |crid= |oclc= |issn= |isbn=}}</nowiki></code>

[[デジタルオブジェクト識別子|DOI]]、[[ハンドルシステム|HDLs]]、[[ISSN]]、[[ISBN]]、[[OCLC]]、[[PMID]]/PMCなどが利用できます。

*<code><nowiki>{{Cite journal |author=Bannen RM, Suresh V, Phillips GN Jr, Wright SJ, Mitchell JC |title=Optimal design of thermally stable proteins |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |year=2008 |language=en |pmid=18723523 |pmc=2562006 |doi=10.1093/bioinformatics/btn450}}</nowiki></code>
** {{Cite journal |author=Bannen RM, Suresh V, Phillips GN Jr, Wright SJ, Mitchell JC |title=Optimal design of thermally stable proteins |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |year=2008 |language=en |pmid=18723523 |pmc=2562006 |doi=10.1093/bioinformatics/btn450}}
*<code><nowiki>{{Cite journal |first=W. Hugh |last=Woodin |title=The Continuum Hypothesis, Part I |journal=Notices of the AMS |volume=48 |issue=6 |year=2001 |pages=567–576 |location=Providence, RI |publisher=American Mathematical Society |language=en |issn=1088-9477 |oclc=34550461}}</nowiki></code>
**{{Cite journal |first=W. Hugh |last=Woodin |title=The Continuum Hypothesis, Part I |journal=Notices of the AMS |volume=48 |issue=6 |year=2001 |pages=567–576 |location=Providence, RI |publisher=American Mathematical Society |language=en |issn=1088-9477 |oclc=34550461}}

{{See also|[[:Category:外部リンク用テンプレート]]}}

== COinS ==
{{UF-COinS}}

== 関連項目 ==
* [[デジタルオブジェクト識別子]] (DOI)
* [[ISSN]]
* [[PubMed#PMID|PMID]] - 論文の識別番号
* [[Wikipedia:出典テンプレート#関連ツール]]には、DOIやPMIDを指定すると{{tl|Cite journal}}を生成するツールがあります。
* {{tl|Full}} - 文献の完全な書誌情報が不明で、他の利用者に助力を求めたい場合に使用できます。

== テンプレートデータ ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "和書",
			"description": "和書の場合には「和書」を指定する（ビジュアルエディターによるテンプレートの挿入時には自動的に入力されます）",
			"type": "string",
			"autovalue": "和書"
		},
		"last": {
			"aliases": [
				"last1"
			],
			"label": "姓",
			"description": "著者の姓",
			"type": "line"
		},
		"author": {
			"aliases": [
				"author1",
				"authors"
			],
			"label": "著者",
			"description": "著者の姓名",
			"type": "content",
			"suggested": true
		},
		"first": {
			"aliases": [
				"first1"
			],
			"label": "名",
			"description": "著者の名",
			"type": "line"
		},
		"author-link": {
			"aliases": [
				"authorlink",
				"author1-link",
				"authorlink1"
			],
			"label": "著者への内部リンク",
			"description": "著者名と記事名が異なるときなどに使用",
			"type": "wiki-page-name"
		},
		"editor-last": {
			"aliases": [
				"editor-surname",
				"editor1-last",
				"editor1-surname"
			],
			"label": "姓（編集者）",
			"description": "編集者の姓",
			"type": "line"
		},
		"editor": {
			"aliases": [
				"editor1",
				"editors"
			],
			"label": "編集者",
			"description": "編集者の姓名",
			"type": "content"
		},
		"editor-first": {
			"aliases": [
				"editor-given",
				"editor1-first",
				"editor1-given"
			],
			"label": "名（編集者）",
			"description": "編集者の名",
			"type": "line"
		},
		"editor-link": {
			"aliases": [
				"editor1-link"
			],
			"label": "編集者への内部リンク",
			"description": "編集者名と記事名が異なる場合などに使用",
			"type": "wiki-page-name"
		},
		"month": {
			"label": "月",
			"description": "発行月",
			"type": "number"
		},
		"year": {
			"label": "年",
			"description": "発行年",
			"suggested": true,
			"example": "2015",
			"type": "number"
		},
		"date": {
			"label": "発行年月日",
			"description": "発行年月日",
			"type": "date",
			"suggested": true,
			"example": "2015-01-31"
		},
		"title": {
			"label": "タイトル",
			"description": "タイトル",
			"type": "line",
			"suggested": true
		},
		"url": {
			"label": "URL",
			"description": "URL",
			"type": "line",
			"suggested": true
		},
		"pmc": {
			"aliases": [
				"PMC"
			],
			"label": "PMC論文番号",
			"description": "PubMed Centerの論文番号",
			"type": "number"
		},
		"journal": {
			"label": "雑誌名",
			"description": "雑誌名",
			"type": "content",
			"required": true
		},
		"volume": {
			"label": "巻",
			"description": "巻数。一般雑誌の見出し（～シリーズ別巻など）には向きません。奥付の「第○巻第△号（通巻□号）」の○を記載すると良いでしょう。",
			"suggested": true,
			"type": "number"
		},
		"issue": {
			"aliases": [
				"number"
			],
			"label": "号",
			"description": "号数。一般雑誌の見出し（春の特大号など）には向きません。奥付の「第○巻第△号（通巻□号）」の△を記載すると良いでしょう。",
			"suggested": true,
			"type": "number"
		},
		"page": {
			"label": "ページ番号（単一）",
			"description": "出典のページ番号",
			"suggested": true,
			"type": "number",
			"autovalue": "",
			"example": "10"
		},
		"pages": {
			"label": "ページ番号（複数）",
			"description": "複数のページを出典とする場合に、ページ番号を範囲で指定するか、半角コロンで区切る",
			"suggested": true,
			"type": "line",
			"example": "3-5,9"
		},
		"chapter": {
			"label": "章",
			"description": "章",
			"type": "line"
		},
		"edition": {
			"label": "版",
			"description": "版",
			"type": "line"
		},
		"publisher": {
			"label": "発行所",
			"description": "発行所",
			"suggested": true,
			"type": "content"
		},
		"language": {
			"label": "言語",
			"description": "言語",
			"type": "content"
		},
		"format": {
			"label": "フォーマット",
			"description": "url に指定したリンク先がHTMLでない場合（PDF等）",
			"type": "content"
		},
		"arxiv": {
			"label": "arXiv ",
			"description": "arXivの識別子",
			"type": "line"
		},
		"ASIN": {
			"aliases": [
				"asin"
			],
			"label": "ASIN",
			"description": "Amazon識別コード",
			"type": "line"
		},
		"bibcode": {
			"label": "Bibcode",
			"description": "Bibcode識別子",
			"type": "line"
		},
		"doi": {
			"aliases": [
				"DOI"
			],
			"label": "DOI",
			"description": "記事にDOI(デジタルオブジェクト識別子)が割り当てられている場合に指定する。自動的にリンクされる。",
			"type": "line"
		},
		"NAID": {
			"aliases": [
				"naid"
			],
			"label": "NAID",
			"description": "NII論文ID",
			"type": "line"
		},
		"JFM": {
			"type": "line"
		},
		"JSTOR": {
			"aliases": [
				"jstor"
			],
			"label": "JSTOR",
			"description": "JSTOR識別子",
			"type": "line"
		},
		"LCCN": {
			"label": "LCCN",
			"description": "アメリカ議会図書館管理番号",
			"type": "line"
		},
		"MR": {
			"label": "MR",
			"description": "Mathematical Reviews識別子",
			"type": "line"
		},
		"oclc": {
			"aliases": [
				"OCLC"
			],
			"label": "OCLC",
			"description": "記事にOCLC(Online Computer Library Center)管理番号が割り当てられている場合に指定する。自動的にリンクされる。",
			"type": "number"
		},
		"OL": {
			"aliases": [
				"ol"
			],
			"label": "OL",
			"description": "Open Library識別子",
			"type": "line"
		},
		"OSTI": {
			"aliases": [
				"osti"
			],
			"label": "OSTI",
			"description": "アメリカエネルギー省科学技術情報局識別子",
			"type": "line"
		},
		"pmid": {
			"aliases": [
				"PMID"
			],
			"label": "PMID",
			"description": "記事にPMID(PubMed Unique Identifier)が割り当てられている場合に指定する。",
			"type": "line"
		},
		"SSRN": {
			"label": "SSRN",
			"description": "Social Science Research Network",
			"type": "line"
		},
		"accessdate": {
			"label": "アクセス日時",
			"description": "アクセス日時",
			"type": "date"
		},
		"ref": {
			"label": "ref",
			"description": "id属性。harv を入力する場合には「作品年数」も使用すること。",
			"type": "line"
		},
		"location": {
			"required": false,
			"type": "string",
			"label": "出版元本社の都市名",
			"description": "出版元が本社を置いている都市名。"
		},
		"isbn": {
			"required": false,
			"type": "string",
			"label": "ISBN（国際標準図書番号）",
			"description": "記事にISBN(国際標準図書番号)が割り当てられている場合に指定する。自動的にリンクされる。"
		},
		"issn": {
			"required": false,
			"type": "string",
			"label": "ISSN（国際標準逐次刊行物番号）",
			"description": "記事にISSN(国際標準逐次刊行物番号)が割り当てられている場合に指定する。自動的にリンクされる。"
		},
		"last2": {
			"aliases": [
				"surname2"
			]
		},
		"first2": {
			"aliases": [
				"given2"
			]
		},
		"last3": {
			"aliases": [
				"surname3"
			]
		},
		"first3": {
			"aliases": [
				"given3"
			]
		},
		"last4": {
			"aliases": [
				"surname4"
			]
		},
		"first4": {
			"aliases": [
				"given4"
			]
		},
		"last5": {
			"aliases": [
				"surname5"
			]
		},
		"first5": {
			"aliases": [
				"given5"
			]
		},
		"last6": {
			"aliases": [
				"surname6"
			]
		},
		"first6": {
			"aliases": [
				"given6"
			]
		},
		"last7": {
			"aliases": [
				"surname7"
			]
		},
		"first7": {
			"aliases": [
				"given7"
			]
		},
		"last8": {
			"aliases": [
				"surname8"
			]
		},
		"first8": {
			"aliases": [
				"given8"
			]
		},
		"last9": {
			"aliases": [
				"surname9"
			]
		},
		"first9": {
			"aliases": [
				"given9"
			]
		},
		"author2": {},
		"author3": {},
		"author4": {},
		"author5": {},
		"author6": {},
		"author7": {},
		"author8": {},
		"author9": {},
		"author2-link": {
			"aliases": [
				"authorlink2"
			]
		},
		"author3-link": {
			"aliases": [
				"authorlink3"
			]
		},
		"author4-link": {
			"aliases": [
				"authorlink4"
			]
		},
		"author5-link": {
			"aliases": [
				"authorlink5"
			]
		},
		"author6-link": {
			"aliases": [
				"authorlink6"
			]
		},
		"author7-link": {
			"aliases": [
				"authorlink7"
			]
		},
		"author8-link": {
			"aliases": [
				"authorlink8"
			]
		},
		"author9-link": {
			"aliases": [
				"authorlink9"
			]
		},
		"editor2-last": {
			"aliases": [
				"editor2-surname"
			]
		},
		"editor2-first": {
			"aliases": [
				"editor2-given"
			]
		},
		"editor3-last": {
			"aliases": [
				"editor3-surname"
			]
		},
		"editor3-first": {
			"aliases": [
				"editor3-given"
			]
		},
		"editor4-last": {
			"aliases": [
				"editor4-surname"
			]
		},
		"editor4-first": {
			"aliases": [
				"editor4-given"
			]
		},
		"editor2": {},
		"editor3": {},
		"editor4": {},
		"editor2-link": {},
		"editor3-link": {},
		"editor4-link": {},
		"asin-tld": {
			"label": "ASIN-TLD"
		},
		"crid": {
			"aliases": [
				"CRID"
			],
			"label": "CRID",
			"description": "CiNii Researchの識別子"
		},
		"hdl": {
			"aliases": [
				"HDL"
			],
			"label": "HDLs",
			"description": "ハンドルシステム識別子"
		},
		"zbl": {
			"label": "Zbl",
			"description": "zbMATH識別子"
		},
		"id": {
			"aliases": [
				"ID"
			],
			"label": "その他の識別子",
			"description": "上記にない識別子を表示する場合に指定する",
			"type": "unbalanced-wikitext"
		},
		"quote": {
			"label": "引用",
			"description": "適切な引用",
			"type": "string"
		}
	},
	"description": "このテンプレートは、出典を明記するのに使います。雑誌記事用です。日本語雑誌にはTemplate:Cite journal ja-jpを使うこともできます。",
	"maps": {
		"citoid": {
			"title": "title",
			"url": "url",
			"publisher": "publisher",
			"publicationTitle": "journal",
			"proceedingsTitle": "journal",
			"encyclopediaTitle": "journal",
			"dictionaryTitle": "journal",
			"date": "date",
			"place": "location",
			"ISSN": [
				"issn"
			],
			"ISBN": [
				"isbn"
			],
			"PMCID": "pmc",
			"PMID": "pmid",
			"pages": "pages",
			"volume": "volume",
			"seriesNumber": "volume",
			"issue": "issue",
			"DOI": "doi",
			"oclc": "oclc",
			"language": "language",
			"author": [
				[
					"first",
					"last"
				],
				[
					"first2",
					"last2"
				],
				[
					"first3",
					"last3"
				],
				[
					"first4",
					"last4"
				],
				[
					"first5",
					"last5"
				],
				[
					"first6",
					"last6"
				],
				[
					"first7",
					"last7"
				],
				[
					"first8",
					"last8"
				],
				[
					"first9",
					"last9"
				]
			],
			"editor": [
				[
					"editor-first",
					"editor-last"
				],
				[
					"editor2-first",
					"editor2-last"
				],
				[
					"editor3-first",
					"editor3-last"
				],
				[
					"editor4-first",
					"editor4-last"
				]
			]
		}
	},
	"format": "inline",
	"paramOrder": [
		"1",
		"last",
		"first",
		"author",
		"author-link",
		"last2",
		"first2",
		"author2",
		"author2-link",
		"last3",
		"first3",
		"author3",
		"author3-link",
		"last4",
		"first4",
		"author4",
		"author4-link",
		"last5",
		"first5",
		"author5",
		"author5-link",
		"last6",
		"first6",
		"author6",
		"author6-link",
		"last7",
		"first7",
		"author7",
		"author7-link",
		"last8",
		"first8",
		"author8",
		"author8-link",
		"last9",
		"first9",
		"author9",
		"author9-link",
		"editor-last",
		"editor-first",
		"editor",
		"editor-link",
		"editor2-last",
		"editor2-first",
		"editor2",
		"editor2-link",
		"editor3-last",
		"editor3-first",
		"editor3",
		"editor3-link",
		"editor4-last",
		"editor4-first",
		"editor4",
		"editor4-link",
		"month",
		"year",
		"date",
		"title",
		"url",
		"journal",
		"volume",
		"issue",
		"page",
		"pages",
		"chapter",
		"edition",
		"publisher",
		"location",
		"language",
		"accessdate",
		"format",
		"ref",
		"arxiv",
		"ASIN",
		"asin-tld",
		"bibcode",
		"crid",
		"doi",
		"hdl",
		"isbn",
		"issn",
		"JFM",
		"JSTOR",
		"LCCN",
		"MR",
		"NAID",
		"oclc",
		"OL",
		"OSTI",
		"pmc",
		"pmid",
		"SSRN",
		"zbl",
		"id",
		"quote"
	]
}
</templatedata>
<includeonly>{{sandbox other||
{{DEFAULTSORT:{{TEMPLATENAME}}}}
<!-- カテゴリは以下に追加してください -->
[[Category:出典テンプレート|journal]]
[[Category:学術雑誌のテンプレート]]
}}</includeonly>