View source for Template:ISSN/doc

{{Documentation subpage}}
{{Lua|Module:Check isxn}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

== Usage ==
This template generates a link for finding data about a (print or on-line) publication via its [[International Standard Serial Number]] (ISSN). The ISSN refers to the particular publication, not to a specific issue (or date) of that publication. The ISSN is used to help establish the publication as a Wikipedia [[WP:reliable source|reliable source]].

For a publication with the ISSN 1234-5678, use '''{{tl2|ISSN|1234-5678}}'''. The template supports up to 9 ISSNs.

==Examples==
{{tlc|ISSN|0028-0836}}

results in:

{{ISSN|0028-0836}}

If more than one ISSN is given, the template will separate them using a comma:

{{tlc|ISSN|0028-0836|0028-0836|0028-0836}}

results in:

{{ISSN|0028-0836|0028-0836|0028-0836}}

Alternatively the conjugation between the last two list items can be defined using the {{para|leadout}} parameter:

{{tlc|ISSN|0028-0836|0028-0836|0028-0836|5=leadout=and}}

results in:

{{ISSN|0028-0836|0028-0836|0028-0836|leadout=and}}

If the leading "ISSN" should not be a link (for example if already linked to in the article), it can be suppressed using the {{para|link|no}} parameter:

{{tlc|ISSN|0028-0836|0028-0836|0028-0836|5=link=no}}

results in:

{{ISSN|0028-0836|0028-0836|0028-0836|link=no}}

It the leading "ISSN" link should not occur (for example in longer lists), it can be suppressed using the {{para|plainlink|yes}} parameter:

{{tlc|ISSN|0028-0836|0028-0836|0028-0836|5=plainlink=yes}}

results in:

{{ISSN|0028-0836|0028-0836|0028-0836|plainlink=yes}}

The {{para|plainlink}} and {{para|leadout}} parameter can be used at the same time:

{{tlc|ISSN|0028-0836|0028-0836|0028-0836|5=plainlink=yes|6=leadout=as well as}}

results in:

{{ISSN|0028-0836|0028-0836|0028-0836|plainlink=yes|leadout=as well as}}

==Find ISSN of publication==
*Find the ISSN by [http://grlinker.coalliance.org/grbin/ilu_rmt.cgi searching with the publication's name] on the [[Colorado Alliance of Research Libraries]] web site.

'''Note''':

An ISSN is always eight digits long. Scroll down the Worldcat page to find the ISSN. Do not rely on the digits shown in the Worldcat URL for the particular publication, since the URL sometimes shows only seven digits, which is invalid to use as the ISSN.

==Error checking==
This template uses [[Module:Check isxn]] to validate the ISSN. If the ISSN is not valid, this subtemplate will still generate the link, and it will add the article to [[:Category:Pages with ISSN errors]]. To be valid, the ISSN must contain a hyphen separating the two groups of four digits.

* {{mono|<nowiki>{{ISSN|09516816}}</nowiki>}} (valid ISSN, but no hyphen) &nbsp; produces {{ISSN|09516816}}
* {{mono|<nowiki>{{ISSN|0951-6816}}</nowiki>}} (valid ISSN, with hyphen) &nbsp; produces {{ISSN|0951-6816}}

Since invalid ISSNs are sometimes used in publications, it is possible to disable the validity check for individual ISSNs given as parameters. In order to do so, add {{mono|invalid?{{=}}yes}} (with ? replaced by the parameter number 1 to 9) to the template. In this case, the article will be added to [[:Category:Articles with invalid ISSNs]].

* {{mono|<nowiki>{{ISSN|1028-0836}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836}}
* {{mono|<nowiki>{{ISSN|1028-0836|invalid1=yes}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836|invalid1=yes}}
* {{mono|<nowiki>{{ISSN|1028-0836|invalid1=no}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836|invalid1=no}}
* {{mono|<nowiki>{{ISSN}}</nowiki>}} &nbsp; produces {{ISSN}}

== See also ==
*{{tl|Infobox newspaper}}
*{{tl|Infobox journal}}
*{{tl|ISSN link}} – Similar to this template, but without the "ISSN" text before the numbers. Also allows multiple ISSNs.
*The [[Help:Citation_Style_1#Templates|Citation Style 1 and 2]] family of templates, which provide {{para|issn}} and {{para|eissn}} parameters
*{{tl|ISBN}}
*{{tl|ISMN}}
*{{tl|OCLC}}
*{{tl|OCLC search link}}
*{{tl|UPC}}
*{{tl|CODEN}}
*{{tl|ZDB}}
*[[Wikipedia:ISSN]]
*{{tl|Catalog lookup link}}

<includeonly>{{Sandbox other||
[[Category:Catalog lookup templates]]
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
}}</includeonly>