Difference between revisions of "Template:ISSN/doc"

From blackwiki
Jump to navigation Jump to search
imported>Zyxw
(add intro sentence borrowed from Template:ISSN search link/doc and show URL that results from example)
imported>Redrose64
(→‎Examples: no need to make it complicated)
 
(46 intermediate revisions by 26 users not shown)
Line 1: Line 1:
{{documentation subpage}}<includeonly>{{pp-template|small=yes}}</includeonly>
+
{{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 ===
+
== Usage ==
This template generates a link for finding data about a single (print or online) publication via its [[International Standard Serial Number]] (ISSN).  
+
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 either '''{{tl2|ISSN|1234-5678}}''' or '''{{tl2|ISSN|12345678}}'''.
+
For a publication with the ISSN 1234-5678, use '''{{tl2|ISSN|1234-5678}}'''. The template supports up to 9 ISSNs.
  
;Example
+
==Examples==
*Usage: <code><nowiki>{{ISSN|0028-0836}}</nowiki></code>
+
{{tlc|ISSN|0028-0836}}
*Links to: http://worldcat.org/issn/0028-0836
 
*Renders as: {{ISSN|0028-0836}}
 
  
=== See also ===
+
results in:
*[[Template:Infobox Newspaper]]
+
 
*[[Template:Infobox Journal]]
+
{{ISSN|0028-0836}}
*[[Template:ISSN search link]]
+
 
*[[Template:OCLC]]
+
If more than one ISSN is given, the template will separate them using a comma:
*[[Template:OCLC search link]]
+
 
*[[Wikipedia:ISSN]]
+
{{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]].
  
<includeonly>
+
* {{mono|<nowiki>{{ISSN|1028-0836}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836}}
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
+
* {{mono|<nowiki>{{ISSN|1028-0836|invalid1=yes}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836|invalid1=yes}}
[[Category:External link templates|ISSN]]
+
* {{mono|<nowiki>{{ISSN|1028-0836|invalid1=no}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836|invalid1=no}}
 +
* {{mono|<nowiki>{{ISSN}}</nowiki>}} &nbsp; produces {{ISSN}}
  
[[bg:Шаблон:ISSN]]
+
== See also ==
[[da:Skabelon:ISSN]]
+
*{{tl|Infobox newspaper}}
[[de:Vorlage:ISSN]]
+
*{{tl|Infobox journal}}
[[es:Plantilla:ISSN]]
+
*{{tl|ISSN link}} – Similar to this template, but without the "ISSN" text before the numbers. Also allows multiple ISSNs.
[[fi:Malline:ISSN]]
+
*The [[Help:Citation_Style_1#Templates|Citation Style 1 and 2]] family of templates, which provide {{para|issn}} and {{para|eissn}} parameters
[[hr:Predložak:ISSN]]
+
*{{tl|ISBN}}
[[is:Snið:ISSN]]
+
*{{tl|ISMN}}
[[no:Template:ISSN]]
+
*{{tl|OCLC}}
[[pl:Szablon:ISSN]]
+
*{{tl|OCLC search link}}
[[pt:Predefinição:ISSN]]
+
*{{tl|UPC}}
[[ru:Шаблон:ISSN]]
+
*{{tl|CODEN}}
[[sl:Predloga:ISSN]]
+
*{{tl|ZDB}}
[[sv:Mall:ISSN]]
+
*[[Wikipedia:ISSN]]
[[uk:Шаблон:ISSN]]
+
*{{tl|Catalog lookup link}}
[[vi:Tiêu bản:ISSN]]
 
  
</includeonly>
+
<includeonly>{{Sandbox other||
 +
[[Category:Catalog lookup templates]]
 +
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
 +
}}</includeonly>

Latest revision as of 22:49, 2 May 2020

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 reliable source.

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

Examples

{{ISSN|0028-0836}}

results in:

ISSN 0028-0836

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

{{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 |leadout= parameter:

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

results in:

ISSN 0028-0836, 0028-0836 and 0028-0836

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

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

results in:

ISSN 0028-0836, 0028-0836, 0028-0836

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

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

results in:

0028-0836, 0028-0836, 0028-0836

The |plainlink= and |leadout= parameter can be used at the same time:

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

results in:

0028-0836, 0028-0836 as well as 0028-0836

Find ISSN of publication

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.

  • {{ISSN|09516816}} (valid ISSN, but no hyphen)   produces ISSN 09516816 Parameter error in {{issn}}: Invalid ISSN.
  • {{ISSN|0951-6816}} (valid ISSN, with hyphen)   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 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.

  • {{ISSN|1028-0836}}   produces ISSN 1028-0836 Parameter error in {{issn}}: Invalid ISSN.
  • {{ISSN|1028-0836|invalid1=yes}}   produces ISSN 1028-0836
  • {{ISSN|1028-0836|invalid1=no}}   produces ISSN 1028-0836 Parameter error in {{issn}}: Invalid ISSN.
  • {{ISSN}}   produces Parameter error in {{issn}}: Missing ISSN.

See also