Difference between revisions of "Template:ISSN/doc"

From blackwiki
Jump to navigation Jump to search
imported>Redrose64
(→‎Examples: no need to make it complicated)
 
(47 intermediate revisions by 27 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]]) -->
  
==How to use==
+
== Usage ==
For a publication with the [[International Standard Serial Number]] (ISSN) 1234-5678 <br>
+
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]].
use '''{{[[Template:ISSN|ISSN]]|1234-5678}}''' or '''{{[[Template:ISSN|ISSN]]|12345678}}'''
 
  
Sample use:
+
For a publication with the ISSN 1234-5678, use '''{{tl2|ISSN|1234-5678}}'''. The template supports up to 9 ISSNs.
:<nowiki>{{ISSN|0028-0836}}</nowiki>
 
renders as:
 
:{{ISSN|0028-0836}}
 
  
==Future changes==
+
==Examples==
This is implemented in terms of ISSN search link. That should be the only template to change in case we need a different database or website for ISSN searches.
+
{{tlc|ISSN|0028-0836}}
  
==See also==
+
results in:
*[[Template:Infobox Newspaper]]
+
 
*[[Template:Infobox Journal]]
+
{{ISSN|0028-0836}}
*[[Template:ISSN search link]]
+
 
*[[Wikipedia:ISSN]]
+
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]].
  
<includeonly>
+
* {{mono|<nowiki>{{ISSN|1028-0836}}</nowiki>}} &nbsp; produces {{ISSN|1028-0836}}
<!-- categories and interwiki links -->
+
* {{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