Template:ISBN

Template documentation

[view] [edit] [history] [purge]

Usage

Use this template to create a link (or list of links) to Special:BookSources for one or more International Standard Book Numbers with the usual "ISBN" prefix. The template supports 10- and 13-digit ISBNs (with or without hyphens).

{{ISBN|0-7475-3269-9}}

results in:

ISBN 0-7475-3269-9

And:

{{ISBN|978-1-4133-0454-1}}

results in:

ISBN 978-1-4133-0454-1

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

{{ISBN|978-1-4133-0454-1|978-1-4133-0454-1|978-1-4133-0454-1}}

results in:

ISBN 978-1-4133-0454-1, 978-1-4133-0454-1, 978-1-4133-0454-1

Alternatively the conjunction between the last two list items can be defined using the leadout= parameter:

{{ISBN|978-1-4133-0454-1|978-1-4133-0454-1|978-1-4133-0454-1|leadout=, and}}

results in:

ISBN 978-1-4133-0454-1, 978-1-4133-0454-1, and 978-1-4133-0454-1

If the leading "ISBN" should not be a link (for example because it is already linked in the article), the link can be suppressed using the link=no parameter:

{{ISBN|978-1-4133-0454-1|978-1-4133-0454-1|978-1-4133-0454-1|link=no}}

results in:

ISBN 978-1-4133-0454-1, 978-1-4133-0454-1, 978-1-4133-0454-1

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

{{ISBN|978-1-4133-0454-1|978-1-4133-0454-1|978-1-4133-0454-1|plainlink=yes}}

results in:

978-1-4133-0454-1, 978-1-4133-0454-1, 978-1-4133-0454-1

(Alternatively the {{ISBNT}} template can be used.)

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

{{ISBN|978-1-4133-0454-1|978-1-4133-0454-1|978-1-4133-0454-1|plainlink=yes|leadout=as well as}}

results in:

978-1-4133-0454-1, 978-1-4133-0454-1 as well as 978-1-4133-0454-1

Formatting

The template preserves the formatting of the input values, for example:

{{ISBN|978-1-4133-0454-1|978141330454-1|978 1-41330-454-1}}

results in:

ISBN 978-1-4133-0454-1, 978141330454-1, 978 1-41330-454-1

Error checking

This template uses Module:Check isxn to validate the ISBN. If the ISBN is not valid, this subtemplate will still generate the link, and it will add the article to Category:Pages with ISBN errors.

Since invalid ISBNs are sometimes used in publications, it is possible to disable the validity check for individual ISBNs 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:Pages with listed invalid ISBNs.

• {{ISBN|1-4133-0451-0}}   produces ISBN 1-4133-0451-0

• {{ISBN|1-4133-0451-0|invalid1=yes}}   produces ISBN 1-4133-0451-0

• {{ISBN|1-4133-0451-0|invalid1=no}}   produces ISBN 1-4133-0451-0

• {{ISBN}}   produces

Tracking categories

• Category:Pages with ISBN errors (1)
• Category:Pages with listed invalid ISBNs (1)
• Category:Pages using ISBN template with unknown parameters (0)

See also

• Wikipedia:ISBN
• {{SBN}}, similar template for SBNs rather than ISBNs
• {{ISBNT}}, to make an ISBN link without a visible prefix
• {{Listed Invalid ISBN}}, to link an ISBN that is invalid but printed in a source publication.
• {{Format ISBN}}, to hyphenate an ISBN according to official rules
• {{OCLC}}, to link directly to Worldcat; useful for books with no ISBN.
• {{PMID}}
• {{IETF RFC}}
• {{ISMN}}
• {{ISSN}}
• {{Catalog lookup link}}
• {{ISBN missing}}

Template Data

Use this template to create a link (or list of links) to Special:BookSources for one or more International Standard Book Numbers with the usual "ISBN" prefix

Template parameters

Parameter		Description	Type	Status
ISBN #1	1	first ISBN to put in the list Example 0-674-01181-3	String	required
ISBN #2	2	second ISBN to put in the list Example 0-674-04200-3	String	suggested
ISBN #3	3	third ISBN to put in the list Example 0-674-01169-3	String	optional
ISBN #4	4	fourth ISBN to put in the list Example 0-674-01181-6	String	optional
ISBN #5	5	fifth ISBN to put in the list Example 0-674-02181-5	String	optional
6	6	no description	Unknown	optional
7	7	no description	Unknown	optional
8	8	no description	Unknown	optional
9	9	no description	Unknown	optional
Suppress link to article?	link	If 'no', does not produce a link before the list Example no	String	optional
Suppress link to ISBN?	plainlink	If 'yes', does not produce "[[ISBN]]: " before the list Example yes	String	optional
last list joiner text	leadout	Text between second-to-last and last book ISBN's Example as well as	String	optional
invalid1	invalid1	no description	Unknown	optional
invalid2	invalid2	no description	Unknown	optional
invalid3	invalid3	no description	Unknown	optional
invalid4	invalid4	no description	Unknown	optional
invalid5	invalid5	no description	Unknown	optional
invalid6	invalid6	no description	Unknown	optional
invalid7	invalid7	no description	Unknown	optional
invalid8	invalid8	no description	Unknown	optional
invalid9	invalid9	no description	Unknown	optional

The above documentation is transcluded from Template:ISBN/doc. (edit | history)
Editors can experiment in this template’s sandbox (create | mirror) and testcases (create) pages.
Please add categories to the /doc subpage. Subpages of this template.