Sjabloon:Cite book
This template has recently been updated to use the Lua programming language, to run 6-12x times faster. See: WP:Lua-based cite templates. |
{{#invoke:Infobox|infobox}}
This Citation Style 1 template is used to create citations for books. When citing an article in a periodical, use {{cite journal}}. For edited collections, use {{cite encyclopedia}}.
Usage
Copy a blank version to use. All parameter names must be in lowercase. Use the "|" (pipe) character between each parameter. Delete unused parameters to avoid clutter in the edit window. Some samples may include the current date. If the date is not current, then
the page.
|
|
Vertical list | Prerequisites | Brief instructions / notes |
---|---|---|
{{cite book | last = | first = | authorlink = | last1 = | first1 = | authorlink1 = | editor1-last = | editor1-first = | editor1-link = | others = | title = | trans_title = | url = | archiveurl = | archivedate = | format = | accessdate = | type = | edition = | series = | volume = | date = | origyear = | year = | month = | publisher = | location = | language = | isbn = | oclc = | lccn = | doi = | bibcode = | id = | page = | pages = | nopp = | at = | chapter = | trans_chapter = | chapterurl = | quote = | ref = | layurl = | laysource= = | laydate = | author-mask = | author-name-separator = | author-separator = | display-authors = | separator = | postscript = | lastauthoramp = }} |
last last editor1-last editor1-last archivedate archiveurl url url year or date year publisher page or pages chapter layurl layurl lastn for n>1 |
increment as needed increment as needed increment as needed increment as needed increment as needed increment as needed insert URL of online version of the book or an extract, if available †preferred (do not wikilink) alternative to date always include ISBN if one has been assigned hides automatic 'p' or 'pp'. alternative to page/pages when those are used with nopp do not wikilink |chapter if |chapterurl provided |
- If a field name is listed in the Prerequisites column it is a prerequisite for the field to the left.
† This is the preferred parameter with its alternates listed below.
Examples
Title
{{cite book |title=Mysterious book}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Title and year
{{cite book |title=Mysterious book |year=1901}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Basic usage (single author)
{{cite book |last=Bloggs |first=Joe |authorlink=Joe Bloggs |year=1974 |title=Book of Bloggs}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Basic usage (two authors)
{{cite book |last1=Bloggs |first1=Joe |authorlink1=Joe Bloggs |last2=Bloggs |first2=Fred |authorlink2=Fred Bloggs |year=1974 |title=Book of Bloggs}}:
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Basic usage with url (and accessdate) and edition
{{cite book |last=Bloggs |first=Joe |authorlink=Joe Bloggs |year=1974 |title=Book of Bloggs |edition=1st |url=http://en.wikipedia.org/ |accessdate=February 17, 2006}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Citing a chapter in a book with different authors for different chapters and an editor
{{cite book |last=Bloggs |first=Fred |editor-first=John |editor-last=Doe |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Citing a chapter in a book with two joint authors and an editor
{{cite book |last1=Bloggs |first1=Joe |last2=Egg |first2=Fred |editor-last=Doe |editor-first=John |title=Big Book with Many Chapters and Two Co-authors |publisher=Book Publishers |date=January 1, 2001 |origyear=1st. Pub. 1986 |pages=100–110 |chapter=Chapter 6: Getting There |chapterurl=http://en.wikipedia.org/ |isbn=978-1-234-56789-7 |lastauthoramp=y}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Three authors, title with a piped wikilink, edition
{{cite book |last1=Bloggs |first1=Joe |authorlink1=Joe Bloggs |first2=John |last2=Smith |first3=Jim |last3=Smythe |title=[[A Thousand Acres|1000 Acres]] |edition=2nd}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Complex usage showing effect of using volume parameter and lastauthoramp parameter (without volume and lastauthoramp)
{{cite book |first1=Major-General I.S.O. |last1=Playfair |authorlink1=Ian Stanley Ord Playfair |first2=Commander G.M.S |last2=Stitt |first3=Brigadier C.J.C. |last3=Molony |first4=Air Vice-Marshal S.E. |last4=Toomer |editor-first=J.R.M |editor-last=Butler |series=History of the Second World War, United Kingdom Military Series |title=Mediterranean and Middle East. Volume I: The Early Successes Against Italy (to May 1941) |publisher=Naval & Military Press |location=Uckfield, UK |year=2007 |origyear=1st. pub. [[HMSO]]:1954 |isbn=1-845740-65-3}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Complex usage showing effect of using volume parameter and lastauthoramp parameter (with volume and lastauthoramp)
{{cite book |first1=Major-General I.S.O. |last1=Playfair |authorlink1=Ian Stanley Ord Playfair |first2=Commander G.M.S |last2=Stitt |first3=Brigadier C.J.C. |last3=Molony |first4=Air Vice-Marshal S.E. |last4=Toomer |editor-first=J.R.M |editor-last=Butler |series=History of the Second World War, United Kingdom Military Series |title=Mediterranean and Middle East |volume=Volume I: The Early Successes Against Italy (to May 1941) |publisher=Naval & Military Press |location=Uckfield, UK |year=2007 |origyear=1st. pub. [[HMSO]]:1954 |isbn=1-845740-65-3 |lastauthoramp=y}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Date without day, wikilinked title and publisher, pages, edition, location
{{cite book |last1=Cordell |first1=Bruce R. |last2=Grubb |first2=Jeff |last3=Noonan |first3=David |year=2001 |month=September |title=[[Manual of the Planes]] |edition=3rd |publisher=[[Wizards of the Coast]] |location=Renton, Wash. |isbn=0-7869-1850-0 |pages=134–137}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Other language
{{cite book |last=Bloggs |first=Jean |year=1974 |title=Livre de Bloggs |edition=1st |language=French |trans_title=Book of Bloggs |url=http://en.wikipedia.org/ |accessdate=February 17, 2006}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Using a DOI
{{cite book |last=Mumford |first=David |authorlink=David Mumford |year=1999 |title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians |edition=2nd |publisher=[[Springer-Verlag]] |doi=10.1007/b62130 |isbn=354063293X}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Using author-mask parameter
{{cite book |first1=Major-General I.S.O. |last1=Playfair |authorlink1=Ian Stanley Ord Playfair |last2=Stitt |first2=Commander G.M.S |last3=Molony |first3=Brigadier C.J.C. |last4=Toomer |first4=Air Vice-Marshal S.E. |editor-last=Butler |editor-first=J.R.M |editor-link=James Ramsay Montagu Butler |series=History of the Second World War, United Kingdom Military Series |title=Mediterranean and Middle East Volume I: The Early Successes Against Italy (to May 1941) |publisher=Naval & Military Press |location=Uckfield, UK |year=2004 |origyear=1st. pub. [[HMSO]]:1954 |isbn=1-845740-65-3 |lastauthoramp=y}}
{{cite book |first1=Major-General I.S.O. |last1=Playfair |authorlink1=Ian Stanley Ord Playfair |last2=Flynn |first2=Captain F.C. (R.N.) |last3=Molony |first3=Brigadier C.J.C. |last4=Toomer |first4=Air Vice-Marshal S.E. |editor-last=Butler |editor-first=J.R.M |editor-link=James Ramsay Montagu Butler |series=History of the Second World War, United Kingdom Military Series |title=The Mediterranean and Middle East, Volume II: The Germans come to the help of their Ally (1941) |publisher=Naval & Military Press |location=Uckfield, UK |year=2004 |origyear=1st. pub. [[HMSO]]:1956 |isbn=1-845740-66-1 |lastauthoramp=y |author-mask=2}}
{{cite book |first1=Major-General I.S.O. |last1=Playfair |authorlink1=Ian Stanley Ord Playfair |last2=Flynn |first2=Captain F.C. (R.N.) |last3=Molony |first3=Brigadier C.J.C. |last4=Gleave |first4=Group Captain T.P. |editor-last=Butler |editor-first=Sir James |editor-link=James Ramsay Montagu Butler |series=History of the Second World War, United Kingdom Military Series |title=The Mediterranean and Middle East, Volume III: British Fortunes reach their Lowest Ebb (September 1941 to September 1942) |publisher=Naval & Military Press |location=Uckfield, UK |year=2004 |origyear=1st. pub. [[HMSO]]:1960 |isbn=1-845740-67-X |lastauthoramp=y |author-mask=2}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Using display-authors parameter
{{cite book |first1=Major-General I.S.O. |last1=Playfair |authorlink1=Ian Stanley Ord Playfair |last2=Stitt |first2=Commander G.M.S |last3=Molony |first3=Brigadier C.J.C. |last4=Toomer |first4=Air Vice-Marshal S.E. |editor-last=Butler |editor-first=J.R.M |editor-link=James Ramsay Montagu Butler |series=History of the Second World War, United Kingdom Military Series |title=Mediterranean and Middle East Volume I: The Early Successes Against Italy (to May 1941) |publisher=Naval & Military Press |location=Uckfield, UK |year=2004 |origyear=1st. pub. [[HMSO]]:1954 |isbn=1-845740-65-3 |display-authors=1}}
- {{#invoke:citation/CS1|citation
|CitationClass=book }}
Parameters
Syntax
Nested parameters rely on their parent parameters:
- parent
- OR: parent2—may be used instead of parent
- child—may be used with parent (and is ignored if parent is not used)
- OR: child2—may be used instead of child (and is ignored if parent2 is not used)
- Where aliases are listed, only one of the parameters may be defined; if multiple aliased parameters are defined, then only one will show.
This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata; see Wikipedia:COinS.
- Be careful using templates within the citation template, as many will add a lot of extraneous HTML or CSS that will be rendered in the meta-data.
- Known templates that should not be used: {{smallcaps}}.
By default, sets of fields are terminated with a period (.); this can be an issue when the last field in an abbreviation or initial with a period, as two periods then display. The only solution is to not include the last period in the value for the set of fields.
Deprecated
These parameters are deprecated and will no longer work. Use will place the page in Category:Pages containing cite templates with deprecated parameters.
- access-date · accessed · accessdaymonth · accessday · accessmonthday · accessmonth · accessyear: Use accessdate to include the full date of access.
- day: Use date to include the day, month and year.
- dateformat · doilabel: These parameters are no longer supported.
Description
Authors
- last: Surname of author. Do not wikilink—use authorlink instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use last to include the same format as the source. Aliases: last1, author, authors, author1.
- first: Given or first names of author, including title(s); for example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use authorlink instead. Aliases: first1.
- OR: for multiple authors, use last1, first1 through lastn, firstn where n is any consecutive number for an unlimited number of authors. By default, if nine authors are defined, then only eight will show and "et al." will show in place of the last author; see the display parameters to change. Aliases: author1 through authorn.
- authorlink: Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: authorlink1, author-link, author1-link.
- OR: for multiple authors, use authorlink1 through authorlinkn. Aliases: author1-link through authorn-link.
- coauthors: (deprecated) Names of coauthors. Use the same format as the authors.
- others: To record other contributors to the work, such as Illustrated by John Smith or Translated by John Smith.
- When using Shortened footnotes or Parenthetical referencing styles with templates, do not use multiple names in one field else the anchor will not match the inline link.
Title
Sjabloon:Citation Style documentation/title Sjabloon:Citation Style documentation/type Sjabloon:Citation Style documentation/chapter Sjabloon:Citation Style documentation/language
Date
Sjabloon:Citation Style documentation/date
Publisher
Sjabloon:Citation Style documentation/publisher
Edition, series, volume
Sjabloon:Citation Style documentation/edition Sjabloon:Citation Style documentation/series Sjabloon:Citation Style documentation/volume
In-source locations
Sjabloon:Citation Style documentation/pages
URL
Sjabloon:Citation Style documentation/url
Anchor
Sjabloon:Citation Style documentation/ref
Identifiers
Sjabloon:Citation Style documentation/id1 Sjabloon:Citation Style documentation/id2
Quote
Sjabloon:Citation Style documentation/quote
Editors
- editor-last: Surname of editor. Do not wikilink—use editor-link instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use editor-last to include the same format as the source. Aliases: editor1-last, editor, editors, editorn.
- editor-first: Given or first names of editor, including title(s); example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use editor-link instead. Aliases: editor1-first.
- OR: for multiple editors, use editor1-last, editor1-first through editorn-last, editorn-first.
- editor-link: Title of existing Wikipedia article about the editor—not the editor's website; do not wikilink. Aliases: editor1-link.
- OR: for multiple editors, use editor1-link through editorn-link.
- Display:
- If authors: Authors are first, followed by the included work, then "In" and the editors, then the main work.
- If no authors: Editors appear before the included work; a single editor is followed by "ed."; multiple editors are followed by "eds."; exactly four editors will show three editors followed by "et al., eds."
Laysummary
Sjabloon:Citation Style documentation/lay
Display options
Sjabloon:Citation Style documentation/display
Testing
See Template:cite book/regression tests.
Template data
<templatedata> {
"description": "This template formats a citation to a book using the provided bibliographic information (such as author and title) as well as various formatting options.", "params": { "url": { "label": "URL", "description": "The URL of the online location where the text of the publication can be found", "type": "string" }, "title": { "label": "Source title", "description": "The title of the source page on the website; displays in quotes", "type": "string", "required": true }, "last": { "label": "Last name", "description": "The surname of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors", "type": "string" }, "first": { "label": "First name", "description": "Given or first name, middle names, or initials of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors", "type": "string" }, "date": { "label": "Source date", "description": "Full date of the source; do not wikilink", "type": "string", "required": true }, "work": { "label": "Work", "description": "Name of the work in which the cited book text is found", "type": "string", "required": true }, "publisher": { "label": "Publisher", "description": "Name of the publisher; displays after title", "type": "string" }, "accessdate": { "label": "URL access date", "description": "The full date when the original URL was accessed; do not wikilink", "type": "string" }, "authorlink": { "label": "Author link", "description": "Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors", "type": "string/wiki-page-name" }, "others": { "label": "Others", "description": "Used to record other contributions to the work, such as 'Illustrated by John Smith' or 'Translated by John Smith'", "type": "string" }, "month": { "label": "Month of publication", "description": "Name of the month of publication; do not wikilink; use 'date' instead, if day of month is also known", "type": "string" }, "year": { "label": "Year of publication", "description": "Year of the source being referenced; use 'date' instead, if month and day are also known", "type": "string" }, "origyear": { "label": "Original year", "description": "Original year of publication; provide specifics", "type": "string" }, "isbn": { "label": "ISBN", "description": "International Standard Book Number; use the 13-digit ISBN where possible", "type": "string" }, "editor-last": { "label": "Editor last name", "description": "The surname of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors; alias of 'editor1-last', 'editor', and 'editors'", "type": "string" }, "editor-first": { "label": "Editor first name", "description": "Given or first name, middle names, or initials of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors; alias of 'editor1-first'", "type": "string" }, "editor-link": { "label": "Editor link", "description": "Title of existing Wikipedia article about the editor; can suffix with a numeral to add additional editors; alias of 'editor1-link'", "type": "string/wiki-page-name" }, "edition": { "label": "Edition", "description": "When the publication has more than one edition; for example: '2nd', 'Revised' etc.; suffixed by ' ed.'", "type": "string" }, "series": { "label": "Series identifier", "description": "Series identifier when the source is part of a series, such as a book series or a journal; alias of 'version'", "type": "string" }, "volume": { "label": "Volume", "description": "For one publication published in several volumes", "type": "string" }, "location": { "label": "Location of publication", "description": "Geographical place of publication; usually not wikilinked; omit when the publication name includes place; alias of 'place'", "type": "string" }, "publication-place": { "label": "Place of publication", "description": "Publication place shows after title; if 'place' or 'location' are also given, they are displayed before the title prefixed with 'written at'", "type": "string" }, "publication-date": { "label": "Publication date", "description": "Date of publication when different from the date the work was written; do not wikilink", "type": "string" }, "page": { "label": "Page", "description": "Page in the source that supports the content; displays after 'p.'", "type": "string" }, "pages": { "label": "Pages", "description": "Pages in the source that support the content (not an indication of the number of pages in the source; displays after 'pp.'", "type": "string" }, "nopp": { "label": "No pp", "description": "Set to 'y' to suppress the 'p.' or 'pp.' display with 'page' or 'pages' when inappropriate (such as 'Front cover')", "type": "string" }, "at": { "label": "At", "description": "May be used instead of 'page' or 'pages' where a page number is inappropriate or insufficient", "type": "string" }, "language": { "label": "Language", "description": "The language in which the source is written, if not English; use the full language name; do not use icons or templates", "type": "string" }, "trans_title": { "label": "Translated title", "description": "An English language title, if the source cited is in a foreign language; 'language' is recommended", "type": "string" }, "chapter": { "label": "Chapter", "description": "The chapter heading of the source; may be wikilinked or with 'chapterurl' but not both", "type": "string" }, "trans_chapter": { "label": "Translated chapter", "description": "An English language chapter heading, if the source cited is in a foreign language; 'language' is recommended", "type": "string" }, "chapterurl": { "label": "Chapter URL", "description": "The URL of the online location where the text of the chapter can be found; alias of 'chapter-url'", "type": "string" }, "type": { "label": "Type", "description": "Additional information about the media type of the source; format in sentence case", "type": "string" }, "format": { "label": "Format", "description": "Format of the work referred to by 'url'; examples: PDF, DOC, XLS; do not specify HTML", "type": "string" }, "arxiv": { "label": "arXiv identifier", "description": "An identifier for arXive electronic preprints of scientific papers", "type": "string" }, "asin": { "label": "ASIN", "description": "Amazon Standard Identification Number; 10 characters", "type": "string" }, "asin-tld": { "label": "ASIN TLD", "description": "ASIN top-level domain for Amazon sites other than the US", "type": "string" }, "bibcode": { "label": "Bibcode", "description": "Bibliographic Reference Code (REFCODE); 19 characters", "type": "string" }, "doi": { "label": "DOI", "description": "Digital Object Identifier; begins with '10.'", "type": "string" }, "doi_brokendate": { "label": "DOI broken date", "description": "The date that the DOI was determined to be broken", "type": "string" }, "issn": { "label": "ISSN", "description": "International Standard Serial Number; 8 characters; may be split into two groups of four using a hyphen", "type": "string" }, "jfm": { "label": "jfm code", "description": "Jahrbuch über die Fortschritte der Mathematik classification code", "type": "string" }, "jstor": { "label": "JSTOR", "description": "JSTOR identifier", "type": "string" }, "lccn": { "label": "LCCN", "description": "Library of Congress Control Number", "type": "string" }, "mr": { "label": "MR", "description": "Mathematical Reviews identifier", "type": "string" }, "oclc": { "label": "OCLC", "description": "Online Computer Library Center number", "type": "string" }, "ol": { "label": "OL", "description": "Open Library identifier", "type": "string" }, "osti": { "label": "OSTI", "description": "Office of Scientific and Technical Information identifier", "type": "string" }, "pmc": { "label": "PMC", "description": "PubMed Center article number", "type": "string" }, "pmid": { "label": "PMID", "description": "PubMed Unique Identifier", "type": "string" }, "rfc": { "label": "RFC", "description": "Request for Comments number", "type": "string" }, "ssrn": { "label": "SSRN", "description": "Social Science Research Network", "type": "string" }, "zbl": { "label": "Zbl", "description": "Zentralblatt MATH journal identifier", "type": "string" }, "id": { "label": "id", "description": "A unique identifier used where none of the specialized ones are applicable", "type": "string" }, "archiveurl": { "label": "Archive URL", "description": "The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archivedate'", "type": "string" }, "archivedate": { "label": "Archive date", "description": "Date when the original URL was archived; do not wikilink", "type": "string" }, "deadurl": { "label": "Dead URL", "description": "If set to 'no', the title display is adjusted; useful for when the URL is archived preemptively but still live", "type": "string" }, "quote": { "label": "Quote", "description": "Relevant text quoted from the source; displays last, enclosed in quotes; needs to include terminating punctuation", "type": "string" }, "ref": { "label": "Ref", "description": "An anchor identifier; can be made the target of wikilinks to full references; special value 'harv' generates an anchor suitable for the harv template", "type": "string" }, "separator": { "label": "Separator", "description": "The punctuation used to separate lists of authors, editors, etc.; a space must be encoded as do not use an asterisk, colon, or hash mark", "type": "string", "default": "." }, "postscript": { "label": "Postscript", "description": "The closing punctuation for the citation; ignored if 'quote' is defined", "type": "string", "default": "." }, "layurl": { "label": "Lay URL", "description": "URL link to a non-technical summary or review of the source; alias of 'laysummary'", "type": "string" }, "laysource": { "label": "Lay source", "description": "Name of the source of the laysummary; displays in italics, preceded by an en dash", "type": "string" }, "laydate": { "label": "Lay date", "description": "Date of the summary; displays in parentheses", "type": "string" }, "author-mask": { "label": "Author mask", "description": "Replaces the name of the first author with em dashes or text; set to a numeric value 'n' to set the dash 'n' em spaces wide; set to a text value to display the text without a trailing author separator; for example, 'with' instead", "type": "string" }, "author-name-separator": { "label": "Author name separator", "description": "Changes the separator between last and first names; defaults to a comma and space; a space must be encoded as do not use an asterisk, colon, or hash mark", "type": "string", "default": ", " }, "author-separator": { "label": "Author separator", "description": "Changes the separator between authors; defaults to a semicolon and space; a space must be encoded as do not use an asterisk, colon, or hash mark", "type": "string", "default": "; " }, "display-authors": { "label": "Display authors", "description": "number of authors to display before 'et al.' is used; default is to do so after 8 of 9 are listed; alias of 'displayauthors'", "type": "number", "default": "8" }, "lastauthoramp": { "label": "Last author ampersand", "description": "When set to any value, changes the separator between the last two names of the author list to 'space ampersand space'", "type": "string" } }
} </templatedata>
See also
Sjabloon:Citation Style 1 {{#invoke: Navbox | navbox }} This template produces COinS metadata; see COinS in Wikipedia for background information.
The above documentation is transcluded from Sjabloon:Cite book/doc. (edit | history) Editors can experiment in this template's sandbox (create) and testcases (create) pages. Please add categories and interwikis to the /doc subpage. Subpages of this template. |