View source for Template:Infobox journal/doc

{{Documentation subpage}}
<!--Categories where indicated at the bottom of this page, please; interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
{{For|citing articles in journals|Template:Cite journal}}
{{High-use|8969}}
{{Auto italic title}}
{{Auto short description}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

{{Parameter names example|italic title=no
|title
|image
|image_size
|alt
|caption
|former_name
|abbreviation
|discipline
|peer-reviewed
|language
|editor
|publisher
|country
|history
|frequency
|openaccess
|license
|impact
|impact-year
|bluebook
|mathscinet
|nlm
|ISSN
|ISSNlabel
|eISSN
|CODEN
|JSTOR
|LCCN
|OCLC
|website
|link1
|link1-name
|link2
|link2-name
}}

{{tl|Infobox journal}} can be used to display details about [[academic journal]]s, as a right-aligned infobox. It can be stacked with other infoboxes. The [[User:Tokenzero/infoboxJournal|infoboxJournal.js]] script can be used to easily add the infobox to articles, as well as standardize existing infoboxes. The script is in development, so make sure to review the suggested presentation before saving.

== Usage ==
;Syntax<!-- full syntax for ease of use to new editors -->
Simply copy-paste this code in an article and fill it according to the [[#Parameters|documentation]] below. Remove hidden notes (both the <code><nowiki><!--</nowiki></code> and <code><nowiki>--></nowiki></code> characters) that surround certain entries, in order for the data you enter to appear in the published article. Unused parameters may also be removed.

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox journal
| title         = 
| image         = <!-- or |cover= -->
| image_size    = <!-- default is 200px -->
| alt           =
| caption       = 
| former_name   = <!-- or |former_names= -->
| abbreviation  = <!-- use ISO 4 standard -->
| discipline    = <!-- or |subject= -->
| peer-reviewed =
| language      = 
| editor        = <!-- or |editors= -->
| publisher     = 
| country       = 
| history       = 
| frequency     = 
| openaccess    = 
| license       = 
| impact        = 
| impact-year   = 
| bluebook      =
| mathscinet    =
| nlm           =
| ISSN          = <!-- up to |ISSN10= -->
| ISSNlabel     = <!-- up to |ISSNlabel10= -->
| eISSN         = <!-- up to |eISSN10= -->
| CODEN         = <!-- up to |CODEN10= -->
| JSTOR         = <!-- up to |JSTOR10= -->
| LCCN          = <!-- up to |LCCN10= -->
| OCLC          = <!-- up to |OCLC10= -->
| website       = 
| link1         = <!-- up to |link10= -->
| link1-name    = <!-- up to |link10-name= -->
}}
</syntaxhighlight>
{{clear}}

;Non-ISO 4 abbreviations (pick those that apply)
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| bluebook      = <!-- For law journals only -->
| mathscinet    = <!-- For the MathSciNet abbreviation, IF different from ISO 4 abbreviation -->
| nlm           = <!-- For the NLM abbreviation, IF different from ISO 4 abbreviation -->
</syntaxhighlight>

;Identifiers for multiple journals at once
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| ISSNlabel     = 
| ISSN          = 
| eISSN         = 
| CODEN         = 
| JSTOR         = 
| LCCN          = 
| OCLC          = 

| ISSNlabel2    = 
| ISSN2         = 
| eISSN2        = 
| CODEN2        = 
| JSTOR2        = 
| LCCN2         = 
| OCLC2         = 

...
</syntaxhighlight>
Goes up to {{para|ISSNlabel10}}

=== Parameters ===
All parameters are optional.
{{clear}}
{{code|{{((}}Infobox journal}} 
:{{Aligned table  <!--style="vertical-align:top;border-width:0;border-collapse:collapse;padding:2px;font-size:95%;line-height:1.42em;overflow:auto;"-->
 |style=font-size:95%;line-height:1.425em;overflow:auto;
 |cols=2 |col1width=8.0em |col2width=81.5em | col1style=white-space:nowrap;
 | {{para|title         }} | Name of journal (defaults to {{tlx|PAGENAMEBASE}}).
 | {{para|italic title  }} | Put "no" to override the italic format of the page article title.  Setting to "no" also disables the automatic generation of a [[Wikipedia:Short description|short description]].
 | {{para|image         }} | Image of journal's cover (e.g. abc.jpg, xpz.png, 123.gif). Does not need <code><nowiki>[[File:...]]</nowiki></code> or <code><nowiki>[[File:...]]</nowiki></code>.
 | {{para|image_size    }} | Size to display image. Defaults to 200px.
 | {{para|alt           }} | [[Wikipedia:Alternative text for images|Alternative text for image]].
 | {{para|caption       }} | Caption for image, if needed.
 | {{para|former_name   }} | Any former name or names of the journal (italicized by default).
 | {{para|abbreviation  }} | The [[ISO 4]] abbreviation for journal. Include dots (e.g. <code>J. Phys.</code>, not <code>J Phys</code>). If unset, links to find out what the ISO 4 abbreviation is will be displayed. Use {{para|abbreviation|no}} to hide the field.
 | {{para|discipline    }} | Topic of the journal.
 | {{para|peer-reviewed }} | Put <code>no</code> if journal is not [[Peer review|peer-reviewed]] (in which case {{tl|Infobox magazine}} is probably more appropriate). If the situation is complicated, put "See text" and describe it in the text. If the field is blank, omitted, or set to <code>yes</code>, no field is shown, and peer-review status is implied.
 | {{para|language      }} | Language of publication if not English. Do not wikilink (per [[WP:MOS]]).
 | {{para|editor        }} | Name of journal's editor.
 | {{para|publisher     }} | Name of publisher. This should be the name of the entity (company, university, society) that performs the actual publishing (marketing, printing, distribution, etc), possibly followed by "on behalf of ...." if there is clear evidence that the journal is owned by another organization (usually a [[learned society]]); furthermore, in case there is clear evidence that the journal is co-owned by another organization (including the publisher itself), this information can be followed with "and ..."
 | {{para|country       }} | Country of publication, if there is a clear national affiliation. Leave blank for international journals. Do not wikilink (per [[WP:MOS]]).
 | {{para|history       }} | Publication history, e.g. 1869–present.
 | {{para|frequency     }} | Frequency of publication.
 | {{para|openaccess    }} | Availability of [[Open access journal|open-access content]], with wikilinks if appropriate (put <code>Yes</code> if journal is completely open-access, or {{elc|Delayed open access journal|Delayed}} or {{elc|Hybrid open access journal|Hybrid}} if more appropriate)
 | {{para|license       }} | License for the journal's content if the previous parameter is <code>Yes</code>.
 | {{para|impact        }} | Journal's [[impact factor]].
 | {{para|impact-year   }} | Year impact factor above was measured, '''not''' the year it was published. E.g. the 2016 impact factor was published in 2017, so 2016 goes in the infobox.
 | {{para|bluebook      }} | The [[Bluebook]] abbreviation for law journal.
 | {{para|mathscinet    }} | The [[MathSciNet]] abbreviation IF different from ISO 4 abbreviation.
 | {{para|nlm           }} | The [[United States National Library of Medicine|NLM]] abbreviation IF different from ISO 4 abbreviation.
 | {{para|bypass-rcheck }} | Set to <code>yes</code> to bypass the built-in ISO 4 / bluebook redirect check until {{phab|T14019}} is resolved. This should '''only''' be used after the ISO 4 / bluebook redirects were created, '''not''' to get rid of the template messages. See [[:Category:Infobox journals with bypassed redirect checking]] for more information.
 | {{para|ISSNlabel     }} | To distinguish between ISSNs when more than one is given (use in conjunction with ISSN2label, ISSN3label, ... ISSN10label).
 | {{para|ISSN          }} | [[International Standard Serial Number|ISSN]] (print edition) or eISSN if electronic-only journal. If there is more than one journal, such as in ''[[European Physical Journal]]'', use additional ISSN2, ISSN3,&nbsp;... ISSN10 parameters.
 | {{para|eISSN         }} | Same as ISSN, but for online version of paper journals. eISSN2, eISSN3,&nbsp;... eISSN10 supported.
 | {{para|CODEN         }} | [[CODEN]].
 | {{para|coden-link''n''}} | Since the CODEN database linked to does not contain all CODENs ever used the link can be suppressed using {{para|coden-link''n''|no}} for the corresponding {{para|CODEN''n''}}.
 | {{para|JSTOR         }} | Journal's [[JSTOR]] number (usually its ISSN without the dash; link will be generated automatically).
 | {{para|LCCN          }} | [[Library of Congress Control Number|LCCN]] (link will be generated automatically).
 | {{para|OCLC          }} | [[Online Computer Library Center|OCLC]] number (link will be generated automatically).
 | {{para|website       }} | [[Uniform Resource Locator|URL]] for journal homepage (see usage below).
 | {{para|link1         }} | First additional link's URL (see below).
 | {{para|link1-name    }} | Name for first additional link (see below).
 | {{para|link2         }} | Second additional link's URL (see below).
 | {{para|link2-name    }} | Name for second additional link (see below).
 | {{para|boxwidth      }} | To set the infobox's width in exceptional circumstances. Use [[Em (typography)|em]] (i.e. font-proportional) units, e.g. boxwidth&nbsp{{=}} 20.0em. Default is 22.0em.
}}
{{code|{{))}}}}

=== Usage notes ===
* {{para|title}} The infobox displays the journal title at the top, wrapping to keep the infobox narrow. To custom-wrap a long title, insert "{{tag|br|s}}". Otherwise, the title will auto-wrap after all words that fit:
   | title = Canadian Journal of{{tag|br|s}}Earth Sciences
* {{para|language}} default is "English" but it is possible to put more than one:&nbsp; language=English, French (etc.)
* {{para|website}} Just put the full URL; e.g., https://www.nature.com . This field automatically displays the name "Journal homepage."  If you wish to display a different name, or to include additional links, use parameters "link1" & "link1-name" ("link2" etc.).  For example, to show "Online access":
<div class="plainlinks">
   | website = https://www.nature.com
   | link1 = https://www.nature.com/nature/current_issue.html
   | link1-name = Online access
</div>
In general, any parameter can be custom-wrapped by inserting a "{{tag|br|s}}" wherever needed.

==Sub templates==
===Main infobox===
; {{tlx|Infobox journal/frequency}} : To populate [[:Category:Academic journals by publication frequency (infobox)]].
; {{tlx|Infobox journal/openaccess}} : To populate [[:Category:Academic journals by access policy (infobox)]].
; {{tlx|Infobox journal/Bluebook check}} : Checks if a [[Bluebook]] redirect exists. If not, prompts editors to create it.
; {{tlx|Infobox journal/Bluebook preload}} : The suggested content of the Bluebook redirect page.
; {{tlx|Infobox journal/ISO 4 check}} : Checks if an [[ISO 4]] redirect exists. If not, prompts editors to create it.
; {{tlx|Infobox journal/ISO 4 preload}} : The suggested content of the ISO 4 redirect page.
; {{tlx|Infobox journal/ISSN-eISSN}} : Used to format the ISSN information.
; {{tlx|Infobox journal/MathSciNet check}} : Checks if a [[MathSciNet]] redirect exists. If not, prompts editors to create it.
; {{tlx|Infobox journal/MathSciNet  preload}} : The suggested content of the MathSciNet redirect page.
; {{tlx|Infobox journal/NLM check}} : Checks if an [[United States National Library of Medicine|NLM]] redirect exists. If not, prompts editors to create it.
; {{tlx|Infobox journal/NLM preload}} : The suggested content of the NLM redirect page.

===Search links===
Put {{code|2=css|.infobox-journal-search { display: inline !important;} }} in your CSS file ({{Diff||841588503|840747595|like this}}) to enable search links.

; {{tlx|Infobox journal/Abbreviation search}}  :  Provides search links for relevant standard abbreviations ([[ISO 4]], [[Bluebook]], [[MathSciNet]], and [[United States National Library of Medicine|NLM]]). It also gives a link to their corresponding databases when possible. Some links need {{para|ISSN/eISSN}} to work.
; {{tlx|Infobox journal/Former check}} : Checks if a former name redirect exists. If not, prompts editors to create it and to verify that standard abbreviation redirects are also created. This is currently experimental, and will only display if you've enabled the search links.
; {{tlx|Infobox journal/Indexing search}} : Provides a MIAR database search link to verify Abstracting/Indexing information. Needs {{para|ISSN/eISSN}} to work.

===Other===
*{{tlx|Infobox journal/sandbox}}
*{{tlx|Infobox journal/testcases}}

== Template characteristics ==
===Microformat===
{{UF-hprod}}

===COinS===
&nbsp;{{UF-COinS}}

===TemplateData===
{{collapse top|[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>{
	"description": "{{Infobox journal}} can be used to display details about academic journals and similar publications as a right-side infobox.",
	"format": "block",
	"params": {
		"title": {
			"label": "Title",
			"description": "Name of journal",
			"type": "line",
			"default": "{{PAGENAMEBASE}}",
			"required": false,
			"suggested": true
		},
		"italic title": {
			"label": "no italic title",
			"description": "Put \"no\" to override the italic format of the page article title.  Setting to \"no\" also disables the automatic generation of a short description.",
			"type": "string/line",
			"required": false
		},
		"image": {
			"label": "Image",
			"aliases": [
				"cover"
			],
			"description": "Image of journal cover",
			"type": "wiki-file-name",
			"required": false,
			"example": "Natprotcover.gif",
			"suggested": true
		},
		"image_size": {
			"label": "Image size",
			"description": "Size to display image",
			"type": "line",
			"required": false,
			"default": "200px"
		},
		"alt": {
			"label": "Alt",
			"description": "Alternative text for image.",
			"type": "line",
			"required": false
		},
		"caption": {
			"label": "Caption",
			"description": "Caption for image, if needed.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"editor": {
			"label": "Edited by",
			"aliases": [
				"editors"
			],
			"description": "Name of editor-in-chief.",
			"type": "wiki-page-name",
			"required": false,
			"suggested": true
		},
		"discipline": {
			"label": "Discipline or subject",
			"aliases": [
				"subject"
			],
			"description": "Topic of the journal.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"peer-reviewed": {
			"label": "Not peer-reviewed",
			"description": "Put \"no\" if journal is not peer-reviewed (in which case {{Infobox magazine}} is probably more appropriate). If the situation is complicated, put \"See text\" and describe it in the text. If empty, peer-review status is implied.",
			"type": "string/line",
			"required": false
		},
		"language": {
			"label": "Language",
			"description": "Language in which the journal is published. Do not wikilink.",
			"type": "line",
			"default": "English",
			"required": false,
			"suggested": true
		},
		"former_name": {
			"label": "Former name(s)",
			"aliases": [
				"former_names",
				"formername",
				"formernames"
			],
			"description": "Any former names for the journal, separate by commas or semicolons; will be italicized by default.",
			"type": "string",
			"required": false,
			"suggested": true
		},
		"abbreviation": {
			"label": "Abbreviated title (formal)",
			"description": "The ISO-4 abbreviation for journal. Include dots (e.g. J. Phys., not J Phys). Put \"no\" to hide the field.",
			"type": "line",
			"required": false,
			"suggested": true,
			"example": "J. Political Theory B"
		},
		"publisher": {
			"label": "Publisher",
			"description": "Name of the journal's publisher.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"country": {
			"label": "Country",
			"description": "Country of publication, if there is a clear national affiliation. Leave blank for international journals. Do not wikilink.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"frequency": {
			"label": "Frequency",
			"description": "Frequency of publication",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"history": {
			"label": "Publication history",
			"description": "Publication history, as: 1869–present.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"openaccess": {
			"label": "Open access",
			"description": "Availability of open access content, with links if appropriate. (Put 'Yes' if the journal is completely open-access, or '[[Delayed open access journal|Delayed]], ## years/months' or '[[Hybrid open access journal|Hybrid]]' if more appropriate).",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"license": {
			"label": "License",
			"description": "License of the journal's content if open access.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"impact": {
			"label": "impact factor",
			"description": "The impact factor of the journal.",
			"type": "line",
			"required": false,
			"suggested": true
		},
		"impact-year": {
			"label": "impact factor year",
			"description": "Year impact factor above was measured, not the year it was published. E.g. the 2016 impact factor was published in 2017, so 2016 goes in the infobox.",
			"type": "number",
			"required": false,
			"suggested": true
		},
		"website": {
			"label": "Journal homepage",
			"description": "URL for journal homepage.",
			"type": "url",
			"required": false,
			"example": "https://www.nature.com",
			"suggested": true
		},
		"link1": {
			"label": "Journal link (1st)",
			"description": "First additional journal link, generally a link to the contents of the current issue.",
			"type": "url",
			"required": false,
			"suggested": true,
			"example": "https://www.nature.com/nature/current_issue.html"
		},
		"link1-name": {
			"label": "Journal link label (1st)",
			"description": "Name for first additional journal link.",
			"type": "line",
			"required": false,
			"suggested": true,
			"example": "Online Access"
		},
		"link2": {
			"label": "Journal link (2nd)",
			"description": "Second additional journal link, generally a link to the online archive of published issues.",
			"type": "url",
			"required": false
		},
		"link2-name": {
			"label": "Journal link label (2nd)",
			"description": "Name for second additional journal link.",
			"type": "line",
			"required": false
		},
		"bluebook": {
			"label": "Bluebook abbreviation",
			"description": "The Bluebook abbreviation for law journals.",
			"type": "line"
		},
		"mathscinet": {
			"label": "MathSciNet abbreviation",
			"description": "The MathSciNet abbreviation IF different from ISO 4 abbreviation.",
			"type": "line"
		},
		"nlm": {
			"label": "NLM abbreviation",
			"description": "The NLM/PubMed abbreviation IF different from ISO 4 abbreviation.",
			"type": "line"
		},
		"bypass-rcheck": {
			"label": "bypass redirect check",
			"description": "Put \"yes\" to bypass the built-in ISO 4 / bluebook redirect check. See [[Category:Infobox journals with bypassed redirect checking]] for more information.",
			"type": "unknown"
		},
		"boxwidth": {
			"label": "boxwidth",
			"description": "To set the infobox's width in exceptional circumstances. Use em (i.e. font-proportional) units, e.g. boxwidth&nbsp= 20.0em. Default is 22.0em.",
			"type": "line"
		},
		"ISSNlabel": {
			"label": "ISSN label",
			"description": "To distinguish between ISSNs when more than one is given (use in conjunction with ISSN2label, ...).",
			"type": "line"
		},
		"ISSN": {
			"label": "ISSN",
			"description": "ISSN (print edition) or eISSN if electronic-only journal. If there is more than one journal, such as in European Physical Journal, use additional ISSN2, ISSN3, ... parameters.",
			"example": "1754-2189",
			"type": "line",
			"suggested": true
		},
		"eISSN": {
			"label": "eISSN",
			"description": "Same as ISSN, but for online version of paper journals.",
			"example": "1750-2799",
			"type": "line",
			"suggested": true
		},
		"CODEN": {
			"label": "CODEN",
			"description": "CODEN bibliographic code.",
			"example": "NCAOBW",
			"type": "line",
			"suggested": true
		},
		"JSTOR": {
			"label": "JSTOR",
			"description": "Journal's JSTOR number (usually its ISSN without the dash; link will be generated automatically).",
			"example": "00121169",
			"suggested": true
		},
		"LCCN": {
			"label": "LCCN",
			"description": "Library of Congress Control Number (link will be generated automatically).",
			"example": "sn85009990",
			"type": "line",
			"suggested": true
		},
		"OCLC": {
			"label": "OCLC number",
			"description": "OCLC Control Number (a.k.a. OCN, WorldCat)",
			"example": "1076455010",
			"type": "number",
			"suggested": true
		}
	},
	"paramOrder": [
		"title",
		"italic title",
		"image",
		"image_size",
		"alt",
		"caption",
		"former_name",
		"abbreviation",
		"discipline",
		"peer-reviewed",
		"language",
		"editor",
		"publisher",
		"country",
		"history",
		"frequency",
		"openaccess",
		"license",
		"impact",
		"impact-year",
		"bluebook",
		"mathscinet",
		"nlm",
		"bypass-rcheck",
		"ISSNlabel",
		"ISSN",
		"eISSN",
		"CODEN",
		"JSTOR",
		"LCCN",
		"OCLC",
		"website",
		"link1",
		"link1-name",
		"link2",
		"link2-name",
		"boxwidth"
	]
}</templatedata>
{{collapse bottom}}

===Tracking categories===
* {{clc|Articles with outdated impact factors}}
* {{clc|Infobox journals with bypassed ISO 4 abbreviations}}
* {{clc|Infobox journals with bypassed redirect checking}}
* {{clc|Infobox journals with missing Bluebook abbreviations}}
* {{clc|Infobox journals with missing ISO 4 abbreviations}}
* {{clc|Infobox journals with missing NLM abbreviations}}
* {{clc|Infobox journals with missing MathSciNet abbreviations}}
* {{clc|ISSN needed}}
* {{clc|Pages using infobox journal with unknown parameters}}
* {{clc|TEMP Infobox journal with para 'peer-reviewed'}}

* {{clc|Category:Articles with missing Bluebook abbreviation redirects}}
* {{clc|Category:Articles with missing ISO 4 abbreviation redirects}}
* {{clc|Category:Articles with missing NLM abbreviation redirects}}
* {{clc|Category:Articles with missing MathSciNet abbreviation redirects}}

===Related tracking categories===
* {{clc|Journal articles needing infoboxes}}
* {{clc|Redirects from Bluebook abbreviations}}
* {{clc|Redirects from ISO 4 abbreviations}}
* {{clc|Redirects from MathSciNet abbreviations}}
* {{clc|Redirects from NLM abbreviations}}

===Related redirect templates===
* {{tl|R from Bluebook abbreviation}}
* {{tl|R from ISO 4 abbreviation}}
* {{tl|R from MathSciNet abbreviation}}
* {{tl|R from NLM abbreviation}}

== See also ==
* {{tl|Infobox bibliographic database}}
* {{tl|Infobox magazine}}
* {{TL|Infobox document}}

{{Organization infoboxes}}

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Organization infobox templates|Journal]]
[[Category:Publishing infobox templates|Journal]]
[[Category:Templates that add a tracking category]]
}}</includeonly>