සැකිල්ල:cite-book/documentation

Usage

This template may be used for creating citations in “References” sections and on discussion pages. For indicating quotations in dictionary entries, please use {{quote-book}}.

Sample template

Most commonly used parameters

{{cite-book
|author=
|authorlink=
|chapter=
|editor=|editors=
|title=
|url=
|archiveurl=
|archivedate=
|edition=
|location=
|publisher=
|year=
|volume=
|section=
|page=|pages=
|pageurl=
|isbn=
|oclc=
|text=}}

All available parameters

{{cite-book|author=|last=|first=|authorlink=|author2=|last2=|first2=|authorlink2=|author3=|last3=|first3=|authorlink3=|author4=|last4=|first4=|authorlink4=|author5=|last5=|first5=|authorlink5=|coauthors=|quotee=|trl=|translator=|translators=|chapter=|trans-chapter=|chapterurl=|entry=|entryurl=|trans-entry=|mainauthor=|mainauthors=|editor=|editors=|title=|trans-title=|series=|seriesvolume=|url=|archiveurl=|archivedate=|edition=|location=|publisher=|month=|year=|year_published=|date=|genre=|volume=|issue=|others=|section=|sectionurl=|page=|pages=|pageurl=|column=|columns=|columnurl=|line=|lines=|bibcode=|doi=|isbn=|issn=|jstor=|lccn=|oclc=|ol=|pmid=|ssrn=|id=|text=|passage=|text_block=|passage_block=|t=|translation=|footer=|lang=|newversion=|2ndauthor=}}

Certain basic parameters can be used in the template without any named parameters, as follows:

#* {{cite-book|[year]|[author]|[title]|[url]|[page]|[passage]|[translation]}}

This will not work if any of the parameters contains an equals (“=”) sign. The value of any parameter containing an equals sign must be surrounded by <nowiki> tags, like this: “<nowiki>http://foo.com?id=bar</nowiki>”. Alternatively, use a named parameter such as url.

The following example:

{{cite-book|author=Bryan A. Garner|authorlink=Bryan A. Garner|title=A Dictionary of Modern Legal Usage|edition=3rd|location=New York, N.Y.; Oxford|publisher={{w|Oxford University Press}}|year=2011|isbn=978-0-19-538420-8}}.

produces this:

Bryan A. Garner (2011) A Dictionary of Modern Legal Usage, 3rd edition, New York, N.Y.; Oxford: Oxford University Press, →ISBN.

Parameters

All parameters are optional except for those marked “Mandatory”, and may contain inline interwiki or external links as needed.

Parameter	Description
author or last and first	The author’s name. Use either author, or last and first, not both. Additional authors can be added using the parameters author2 to author5, or last2 and first2 to last5 and first5.
authorlink	The name of an English Wikipedia article about the author, which will be linked to the author’s name. Additional articles can be linked to other authors’ names using the parameters authorlink2 to authorlink5. Do not add the prefix “:en:” or “w:”. Alternatively, link the author’s name directly, like this: “author=[[w:Charles Butler (lawyer)|Charles Butler]]” or “author={{w|Edward Coke}}”.
coauthors	The names of one or more coauthors. If there is more than one, separate the names with semicolons.
quotee	The name of the person being quoted, if the whole passage quoted is a quotation of someone other than the author.
trl, translator, or translators	The name(s) of the translator(s) of the book. Separate multiple names with semicolons.
chapter or entry	The name of the chapter of, or entry in, the book referred to. You can either specify a chapter number in Arabic or Roman numerals (for example, “chapter=7” or “chapter=VII”) or a chapter title (for example, “chapter=Introduction”).
trans-chapter or trans-entry	If the chapter of, or entry in, the book is not in English, one of these parameters can be used to provide an English translation of the chapter or entry.
chapterurl or entryurl	The URL or web address of a website where the full text of the chapter of, or entry in, the book can be accessed. Do not link to any website that has content in breach of copyright.
mainauthor or mainauthors	If you wish to indicate who a part of a book such as a foreword or introduction was written by, use |author= to do so, and use |mainauthor= to indicate the author(s) of the main part of the book.
editor or editors	The name of one or more editors of the book.
title	Mandatory: the title of the book.
trans-title	If the title of the book is not in English, this parameter can be used to provide an English translation of the title.
series and seriesvolume	The book series that the book belongs to, and the volume number of the book within the series.
url	The URL or web address of a website where the full text of the book can be accessed.
archiveurl and archivedate	The URL or web address of a webpage on a website such as the Internet Archive or Perma.cc at which the webpage has been archived, and the date on which the webpage was archived. Both archiveurl and archivedate must be used together.
edition	The edition of the book. It is usually not necessary to indicate the first or only edition of a book.
location	The location(s) where the book was published. If more than one location is stated, separate the locations with semicolons, like this: “London; New York, N.Y.”.
publisher	The name of one or more publishers of the book. If more than one publisher is stated, separate the names with semicolons.
(month and) year or date	Mandatory: the (month and) year, or date, of publication of the book.
year_published	If year is used to state the year when the original version of the book was published, year_published can be used to state the year in which the version quoted from was published, for example, “|year=1665|year_published=2005”.
genre	The genre of the book.
volume	If the book is one of a set consisting of multiple volumes, the volume number of the book referred to.
issue	The issue number of the volume referred to. For example, if the issue is "volume 1, number 3", then type "issue=3".
others	Other information about the book.
section	If the page of the book referred to has no number (for example, “frontispiece” or “title page”), use this parameter to refer to it. The word “page” or “pages” will not be displayed.
sectionurl	The URL or web address of the webpage containing the section of the book referred to. The section number will be linked to this webpage.
line or lines	If quoting a play or a poem, the line number(s) quoted. Use line to indicate a single page, and lines to indicate a range of lines. For example, lines=1–2 will display "lines 1–2". Use an en dash to separate the line numbers in a range.
page and/or pages	The page number or range of page numbers referred to. The parameters page and pages can be used together to indicate that the citation refers to, for example, “page 3 of 10”. If pages is used alone it can be used to indicate a range of pages. For example, “pages=1–2” will display “pages 1–2”. Use an en dash to separate the page numbers in the range.
pageurl	The URL or web address of the webpage containing the page of the book referred to. The page number(s) will be linked to this webpage.
column or columns	The column number or range of column numbers of the book. Use an en dash to separate the column numbers in the range.
columnurl	The URL or web address of the webpage containing the column(s) of the book referred to. The column number(s) will be linked to this webpage.
bibcode, doi, isbn, issn, jstor, lccn, oclc, ol, pmid, ssrn, and/or id	The bibcode, digital object identifier (DOI), International Standard Book Number (ISBN), International Standard Serial Number (ISSN), JSTOR number, Library of Congress Control Number (LCCN), Online Computer Library Center (OCLC) number (which can be looked up at the WorldCat website), Open Library number, PubMed Identifier (PMID), or Social Science Research Network (SSRN) number of the book. If the book’s ISBN number is stated, it is usually not necessary to indicate its OCLC number. Use id for an identifier other than the ones listed above.
text or passage	A passage from the book that you wish to quote. If the passage exceeds 300 characters, it is automatically displayed in a separate text block. To suppress this, use text_block=no or passage_block=no.
text_block or passage_block	This parameter can be used in two ways: To have the template display a quote in a separate text block. Use text_block=no or passage_block=no together with text or passage to ensure that the quote is not displayed in a separate text block (see text or passage above).
t or translation	A translation of the passage.
footer	This parameter can be used to specify arbitrary text to insert in a separate line at the bottom, to specify a comment, footnote, etc.
lang, language, or worklang	A code indicating the language that the book is written in (preferred; for a list of the codes, see Wiktionary:List of languages), or the names of one or more languages written in full. It is unnecessary to indicate the language if the book is written in English.
Quoting a new version of a book
The following parameters can be used to indicate a new version of the book, such as a reprint, a new edition, or some other republished version.
newversion	The template assumes that a new version of the book is referred to if location2 (see below) is used. It then behaves as follows: If an author, editor and/or book title are stated, it indicates "republished as". If only the place of publication, publisher and date of publication are stated, it indicates "republished". If an edition is stated, no text is displayed. Use newversion to override this behaviour, for example, by indicating "quoted in" or "reprinted as".
2ndauthor (or 2ndlast and 2ndfirst) and 2ndauthorlink	Use these parameters to indicate the author of the new version of the book.
editor2, title2, location2, etc.	Most of the parameters listed above can be applied to a new version of the book by adding "2" after the parameter name. It is recommended that at a minimum the imprint information of the new version of the book should be provided using location2, publisher2, and date2 or year2. Note that the use of location2 is mandatory to cause the template to recognize that a new version of the book is being indicated.

Technical information

This template makes use of {{cite-meta}}.

See also

• {{quote-book}} – for quotations in dictionary entries
• {{cite book}} – the corresponding template at the English Wikipedia.