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 journals|Template:Cite journal}}
{{Auto italic title}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

{{Parameter names example
 |title
 |image
 |image_size
 |alt
 |caption
 |former_name
 |abbreviation
 |bluebook
 |mathscinet
 |nlm
 |discipline
 |peer-reviewed
 |language
 |editor
 |publisher
 |country
 |history
 |frequency
 |openaccess
 |license
 |impact
 |impact-year
 |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-side infobox. It can be stacked with other infoboxes.

== Usage ==
<pre style="overflow:auto;">
{{Infobox journal
| title         = 
| image         =  <!-- or |cover= -->
| image_size    = 
| alt           = 
| caption       = 
| former_name   = <!-- or |former_names= -->
| abbreviation  = <!-- ISO 4 abbreviation -->
| 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-->
| discipline    = <!-- or |subject= -->
| peer-reviewed = 
| language      = 
| editor        = <!-- or |editors= -->
| publisher     = 
| country       = 
| history       = 
| frequency     = 
| openaccess    = 
| license       = 
| impact        = 
| impact-year   = 
| ISSNlabel     = 
| ISSN          = 
| eISSN         = 
| CODEN         = 
| JSTOR         = 
| LCCN          = 
| OCLC          = 
| website       = 
| link1         = 
| link1-name    = 
| link2         = <!-- up to |link5= -->
| link2-name    = <!-- up to |link5-name= -->
| boxwidth      = 
}}
</pre>
{{clear}}

=== Parameters ===
{{Infobox journal}}<!--(to show the result when no parameters supplied)-->

All parameters are optional. If none are supplied, the result is as shown opposite.
{{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
 | {{para|title         }} | Name of journal (defaults to {{tlx|PAGENAMEBASE}}).
 | {{para|italic title  }} | Put "no" to override the italic format of the page article title.
 | {{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 [[Wikipedia:Extended image syntax|frameless]] (usually 220px, but logged in users can change that in [[Special:Preferences|Preferences]]).
 | {{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|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|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|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|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 ===
* ''language'' - default is "English" but it is possible to put more than one:&nbsp; language=English, French (etc.).
* ''website'' - Just put the full URL; e.g., http://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, show "Online access":
<pre>
   | website = http://www.nature.com
   | link1 = http://www.nature.com/nature/current_issue.html
   | link1-name = Online access
</pre>
* ''title'' - The infobox displays the journal title at the top, wrapping to keep the infobox narrow. To custom-wrap a long title, insert "&lt;br/>". Otherwise, the title will auto-wrap after all words that fit:
<pre>
   | title = Canadian Journal of<br/>Earth Sciences
</pre>
* ''country'' - such as "Canada".

&nbsp;In general, any parameter can be custom-wrapped by inserting a "&lt;br/>" wherever needed.

==Sub templates==
;Main infobox
{|class=wikitable
|-
|{{tl|Infobox journal/Bluebook check}} || Checks if a [[Bluebook]] redirects exists. If not, prompts editors to create it.
|-
|{{tl|Infobox journal/Bluebook preload}} || The suggested content of the Bluebook redirect page.
|-
|{{tl|Infobox journal/ISO 4 check}} || Checks if an [[ISO 4]] redirects exists. If not, prompts editors to create it.
|-
|{{tl|Infobox journal/ISO 4 preload}} || The suggested content of the ISO4 redirect page.
|-
|{{tl|Infobox journal/MathSciNet check}} || Checks if an [[MathSciNet ]] redirects exists. If not, prompts editors to create it.
|-
|{{tl|Infobox journal/MathSciNet  preload}} || The suggested content of the ISO4 redirect page.
|-
|{{tl|Infobox journal/NLM check}} || Checks if a [[United States National Library of Medicine|NLM]] redirects exists. If not, prompts editors to create it.
|-
|{{tl|Infobox journal/NLM preload}} || The suggested content of the NLM redirect page.
|-
|{{tl|Infobox journal/ISSN-eISSN}} || Used to format the ISSN information
|-
|}

;Search links
Put <code>.infobox-journal-search { display: inline !important;}</code> in your CSS file (like [https://en.wikipedia.org/w/index.php?title=User:Headbomb/monobook.css&diff=841588503&oldid=840747595 this]) to enable search links.
{|class=wikitable
|-
|{{tl|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 needs {{para|ISSN/eISSN}} to work.
|-
|{{tl|Infobox journal/Indexing search}} || Provides a MIAR database search link to verify Abstracting/Indexing information. Needs {{para|ISSN/eISSN}} to work.
|-
|}

;Other
*{{tl|Infobox journal/sandbox}}
*{{tl|Infobox journal/testcases}}
*{{tl|Infobox journal/wikidata}}

== 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": "string",
      "default": "{{PAGENAMEBASE}}",
      "required": false
    },
    "italic title": {
      "label": "no italic title",
      "description": "Use _no_ to override default italicization of journal title, otherwise leave blank.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "image": {
      "label": "Image",
      "aliases": [
        "cover"
      ],
      "description": "Image of journal cover",
      "type": "string/wiki-page-name",
      "default": "",
      "required": false
    },
    "image_size": {
      "label": "Image size",
      "description": "Size to display image. Defaults to frameless (usually 220px, but logged in users can change that in Preferences).",
      "type": "string",
      "default": "",
      "required": false
    },
    "alt": {
      "label": "Alt",
      "description": "Alternative text for image.",
      "type": "string",
      "default": "",
      "required": false
    },
    "caption": {
      "label": "Caption",
      "description": "Caption for image, if needed.",
      "type": "string",
      "default": "",
      "required": false
    },
    "editor": {
      "label": "Edited by",
      "aliases": [
        "editors"
      ],
      "description": "Name of editor-in-chief.",
      "type": "string/wiki-page-name",
      "default": "",
      "required": false
    },
    "discipline": {
      "label": "Discipline or subject",
      "aliases": [
        "subject"
      ],
      "description": "Topic of the journal.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "peer-reviewed": {
      "label": "Not peer-reviewed",
      "description": "Put _no_ if journal is not peer-reviewed, otherwise leave blank.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "language": {
      "label": "Language",
      "description": "Language in which the journal is published.",
      "type": "string/line",
      "default": "English",
      "required": false
    },
    "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",
      "default": "",
      "required": false
    },
    "abbreviation": {
      "label": "Abbreviated title (formal)",
      "description": "Abbreviation for journal.  This is not simply the first letters of the title words, but the ISO or NLM abbreviation; will be italicized by default.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "publisher": {
      "label": "Publisher",
      "description": "Name of the journal's publisher.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "country": {
      "label": "Country",
      "description": "Country of publication, if appropriate.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "frequency": {
      "label": "Frequency",
      "description": "Frequency of publication",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "history": {
      "label": "Publication history",
      "description": "Publication history, as: 1869–present.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "openaccess": {
      "label": "Open access",
      "description": "Availability of open access content, with links if appropriate.",
      "type": "string",
      "default": "",
      "required": false
    },
    "license": {
      "label": "License",
      "description": "License of the journal's content if open access.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "impact": {
      "label": "impact factor",
      "description": "The impact factor of the journal.",
      "type": "string",
      "default": "",
      "required": false
    },
    "impact-year": {
      "label": "impact factor year",
      "description": "The year the impact factor was measured.",
      "type": "string",
      "default": "",
      "required": false
    },
    "website": {
      "label": "Journal homepage",
      "description": "URL for journal homepage.",
      "type": "string",
      "default": "",
      "required": false
    },
    "link1": {
      "label": "Journal link",
      "description": "First additional journal link, generally a link to the contents of the current issue.",
      "type": "string",
      "default": "",
      "required": false
    },
    "link1-name": {
      "label": "Journal link label",
      "description": "Name for first additional journal link.",
      "type": "string/line",
      "default": "",
      "required": false
    },
    "link2": {
      "label": "Journal link",
      "description": "Second additional journal link, generally a link to the online archive of published issues.",
      "type": "string",
      "default": "",
      "required": false
    },
    "link2-name": {
      "label": "Journal link label",
      "description": "Name for second additional journal link.",
      "type": "string",
      "default": "",
      "required": false
    }
  }
}</templatedata>
{{collapse bottom}}

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

===Related categories===
* {{clc|Redirects from ISO 4 abbreviations}}
* {{clc|Redirects from Bluebook abbreviations}}
* {{clc|Redirects from MathSciNet abbreviations}}
* {{clc|Redirects from NLM abbreviations}}

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

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

{{Organization infoboxes}}

<includeonly>
{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!------- ADD CATEGORIES BELOW THIS LINE -------->
[[Category:Organization infobox templates|Journal]]
[[Category:Publishing infobox templates|Journal]]
[[Category:Templates that add a tracking category]]
[[Category:Infobox templates using small or smaller]]
}}</includeonly>