Template:quote-book/documentation

Usage
This template can be used in a dictionary entry to provide a quotation from a book.

For citations in "References" and "Further reading" sections, and on talk pages, use.

Sample templates

 * Most basic parameters for English quotations


 * Most basic parameters for non-English quotations


 * Commonly used parameters

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



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  tags, like this: " ". Alternatively, use a named parameter such as.

Basic examples
A basic example: undefined Here, the author is preceded by, which links to a Wikipedia entry under the same name. The year is preceded by  to indicate an approximate year, which is processed specially and displayed with a tooltip explaining the meaning of c.. Note also the difference between pageurl, which provides a URL to a specific page and is used to link the page number, and the overall URL specified using url, which is converted into a superscript reference following the title.

Another basic example: undefined Here, a date is specified in place of a year, and two authors are given, semicolon-separated, which when displayed become comma-separated.

Another basic example: undefined This shows the correct use of et al., which should follow a semicolon in a list of authors or other entities. It will be correctly italicized and the preceding delimiter removed.

The following an example of quoting a textbook. undefined Textbooks often have no author listed, but only editors, as in this case. Here, the pages are compound, with a hyphen in the middle. To avoid the page number from being interpreted as a range of page numbers and displayed as pages 12-29, precede the page number with an exclamation point, which is a signal to respect the name of the parameter (otherwise page and pages are aliases of each other, with either one displaying as page or pages depending on the parameter value).

Chapter in an anthology
The following is a basic example of quoting a chapter in an anthology.

undefined

The following is a similar example. undefined Note the use of chapter_number to specify the chapter number along with the name.

The following is an example of citing a conference paper. Generally, they should be cited similarly to chapters in anthologies; in this case, the anthology is the conference proceedigs. undefined Here, we identify a section within the paper by section and section_number. (You can also use section_plain if the section number should not be preceded by the word "section"; chapter_plain works similarly.)

Prefaces and commentaries
When quoting a preface, commentary of the like written by someone other than the primary author of a work, place the author of the quote in author and the primary author in mainauthor. An example follows: undefined The book in question is a volume of collected works by the famous German mathematician, and what is being quoted is a section entitled Notes to *1970, where *1970 refers to what is commonly known as (of the existence of God). The author of the note itself is. Note that individual authors in a combined field such as editors can have Wikipedia and language prefixes (as well as inline modifiers).

Reprintings, translations and quoting one book in another
The following example is of a reprinting of a book: undefined Here, the first set of parameters specify the original version and the second set the reprinting. newversion defaults to "republished [as]", so it does not need to be explicitly given.

The following is another smilar example: undefined

The following example is of a book translated into English: undefined Some comments:
 * When original is used like this, to indicate a translation, the original author can be placed either in the author or by field. The former is generally preferred in a straight translation, but the latter can be used in cases of free translation, annotated editions and the like.
 * Note also the use of origyear to indicate the year the original work was first published.
 * The newversion format described above can be used to quote translations, in place of using original and by. To use this, use translated as, placing the information on the original work in the primary set of parameters and the information on the translation in the second set of parameters. In particular, this method must be used if more information is to be presented on the original work than merely its title, author and year.

The following example is another example of a book translated into English, this time using newversion: undefined

The following example is of one book quoted in another, using newversion (which is preferred): undefined The situation here is that the book Hegelianism and Personality by Andrew Seth (later known as Andrew Seth Pringle-Pattison), 2nd edition of 1893 (first edition published 1887), was quoted in Darwin and Hegel, with other Philosophical Studies by David George Ritchie, also published 1893. Note that (somewhat confusingly), the author of the newversion work (here, the quoting work) is placed in 2ndauthor rather than author2. The reason for this is that author2, author3, etc. were originally used to specify additional authors of the primary work. This method is now deprecated and it is preferred to place all authors in the author field, semicolon-separated.

The following is the same example, expressed using quotee and quoted_in: undefined Note in particular that (rather confusingly) the original author and title are placed in quotee and title, while the quoting author and title are placed in author and quoted in. No further fields are provided to express any other information about the original work other than the others field, into which all remaining information must be crammed. It is strongly recommended to avoid this format, but you will see existing examples using it.

The following is an example of a journal article reprinted in a book. Journal articles are actually expressed using quote-journal, but the same underlying code is used, making it possible to effectively use two different templates in the primary work and new version. To do that, use the type2 field, in this case book: undefined Note that if journal were used to quote a journal article reprinted in another journal, the article in the reprinting journal would be expressed using title2 and the journal title in journal2. When book is used, chapter2 and title2 must be used instead. (journal2 cannot be used, and in fact will throw an error.) Note also the use of  and , which are the HTML entities for left and right brackets  respectively. These are used to avoid parsing errors, as the call to w directly inside them expands to a raw link, and without the HTML entity, there would be three left brackets in a row, which would be misparsed.

Foreign-language examples
Quoted text in a foreign language: undefined

Quoted text in a foreign language, of a book in a series: undefined Here, the authors of this scholarly work were listed as "Paul Hoffmann, together with Stefan H. Brandenburger, Ulrike Brauner and Thomas Hieke", which we handle by listing the other authors as coauthors.

Quoted text with automatic transliteration: undefined

Quoted text with automatic transliteration and use of subst and : undefined

Quoted text with automatic transliteration, of a translation, with use of original, origtext and origlang: undefined Here, the original text in English was freely translated into Russian, and so we present the original text along with a literal translation back into English. Usually with translations, we put the original author in the author field and the translator in the tlr field, but here due to the free translation we are treating the translator as the author and putting the original author in the by field. Note that the language of the original text is duplicated in both the origtext field (as a prefix) and the origlang field. This is necessary because the two fields serve different purposes, and the use of origlang may not always be correct (as in the following example).

Another example of quoted text from a translation, using newversion: undefined Here, an original work in German was translated into Ottoman Turkish and used to illustrate an Ottoman Turkish term. The use of newversion allows full bibliographic information to be given for the original work as well as the translation. In such a case, the original text language is placed in lang2 (or in some cases in origlang2, when there are two layers of translation).

Yet another example of quoted text from a translation, using both original and newversion to express two layers of translation: undefined Here, an original work in Old Chinese (the ) was translated into French as L'œuvre complète de Tchouang-tseu, and from there translated into Italian as Zhuang-zi [Chuang-tzu] (the brackets are in the original title). The template does not support two different newversion levels, but this can be expressed using a combination of original and newversion, as shown. Note also the use of the  modifier in the translator's name to express the original version in traditional Chinese characters and the Romanization in Pinyin.

The following example shows the use of termlang (to indicate a term in one language contained in a quotation in a different language) and brackets (to specify that the quotation presents a mention of a term rather than a use per se): undefined

TemplateData
{   "description": "This template can be used in a dictionary entry to provide a quotation from a book.", "params": { "1": {           "label": "Language", "description": "A comma-separated list of language codes indicating the language(s) of the quoted text.", "example": "en", "type": "string", "required": true, "suggested": true },       "worklang": { "label": "Work language", "description": "A comma-separated list of language codes indicating the language(s) that the book is written in, if different from the quoted text.", "example": "de", "type": "string" },       "termlang": { "label": "Term language", "description": "A language code indicating the language of the term being illustrated, if different from the quoted text. If specified, this language is the one used when adding the page to a category of the form \"Category:[Language] terms with quotations\"; otherwise, the first listed language specified using \"1\" is used. Only specify this parameter if the language of the quotation is different from the term's language, e.g. a Middle English quotation used to illustrate a modern English term or an English definition of a Vietnamese term in a Vietnamese-English dictionary.", "example": "it", "type": "string" },       "title": { "label": "Title", "description": "The title of the book.", "type": "string", "required": true, "example": "Animal Farm" },       "trans-title": { "label": "Translated title", "description": "If the title of the book is not in English, this parameter can be used to provide an English translation of the title.", "type": "string", "example": "The Ingenious Gentleman Don Quixote of La Mancha" },       "year": { "label": "Year of (first) publication", "description": "The year that the book was published. Prefix with \"a.\", \"c.\" or \"p.\" to indicate a publication year that is ante (before), circa (about), or post (after) the year specified.", "type": "number", "aliases": ["2"], "suggested": true, "example": "1945" },       "year_published": { "label": "Year of cited publication", "description": "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", "type": "number" },       "origyear": { "label": "Original year of publication", "description": "The year when the book was originally published. Use either \"origdate\", or \"origyear\" (and \"origmonth\"), not both.", "type": "number", "example": "1942" },       "date": { "label": "Date of publication", "description": "Use either \"year\" or \"date\", not both.", "type": "string", "example": "17 August 1945" },       "origdate": { "label": "Original date of publication", "description": "The date when the book was originally published. Use either \"origdate\", or \"origyear\" (and \"origmonth\"), not both.", "type": "string", "example": "17 August 1942" },       "author": { "label": "Author", "description": "The name of the author of the book quoted. Additional authors can be added using the parameters \"author2\" to \"author5\".", "type": "string", "example": "George Orwell", "suggested": true },       "first": { "label": "Author first name", "description": "The first name of the author of the book quoted. Use either \"author\", or \"last\" and \"first\".", "type": "string", "example": "George" },       "last": { "label": "Author last name", "description": "The last name of the author of the book quoted. Use either \"author\", or \"last\" and \"first\".", "type": "string", "example": "Orwell" },		"authorlink": { "label": "Wikipedia author page", "description": "English Wikipedia article about the author.", "type": "string", "example": "George Orwell", "suggested": false },       "editor": { "label": "Editor", "description": "The name(s) of the editor(s) of the book. Separate multiple names with semicolons.", "aliases": ["editors"], "type": "string" },       "translator": { "label": "Translator", "description": "The name(s) of the translator(s) of the book. Separate multiple names with semicolons.", "aliases": ["translators", "tlr"], "type": "string" },       "page": { "label": "Page", "description": "The page number or range of page numbers of the book. Use an en dash (–) to separate the page numbers in the range.", "type": "number", "example": "123, 56–57", "aliases": ["pages"], "suggested": true },       "pageurl": { "label": "Page URL", "description": "The URL or web address of the webpage containing the page(s) of the book referred to. The page number(s) will be linked to this webpage.", "type": "url", "example": "https://books.google.com/books?id=p98NAAAAQAAJ&pg=PA1" },       "line": { "label": "Line number(s)", "description": "If quoting a play or a poem, the line number(s) quoted. Use an en dash (–) to separate the line numbers in a range.", "type": "number", "example": "1–2", "aliases": ["lines"] },       "section": { "label": "Section", "description": "Use this parameter to identify a page or other portion of a book that does not have page numbers.", "example": "Act II, scene iv", "type": "string" },       "sectionurl": { "label": "Section URL", "description": "The URL of the webpage containing the section of the book referred to. The section number will be linked to this webpage.", "type": "url" },      "column": { "label": "Column number(s)", "aliases": ["columns"], "description": "The column number or range of column numbers of the book. Use an en dash to separate the column numbers in the range.", "example": "1–4", "type": "string" },       "columnurl": { "label": "Column URL", "description": "The URL of the webpage containing the column(s) of the book referred to. The column number(s) will be linked to this webpage.", "type": "url" },       "chapter": { "label": "Chapter", "description": "The chapter of the book quoted. You can either specify a chapter number in Arabic or Roman numerals or a chapter title.", "type": "string", "aliases": ["entry"], "example": "4, IV, Some Chapter Title" },       "chapterurl": { "label": "Chapter URL", "description": "The URL of an external webpage to link to the chapter. For example, if the book has no page numbers, the webpage can be linked to the chapter or entry name using this parameter. Do not link to any website that has content in breach of copyright.", "aliases": ["entryurl"], "type": "url" },       "trans-chapter": { "label": "Translated chapter", "description": "If the chapter of, or entry in, the book is not in English, this parameter can be used to provide an English translation of the chapter or entry.", "aliases": ["trans-entry"], "type": "string" },       "volume": { "label": "Volume number", "description": "The volume number of the book.", "type": "number", "example": "2" },       "volume_plain": { "label": "Volume title", "description": "The volume name of the book. Use if you wish to suppress the word \"volume\" appearing in front of the volume number.", "type": "string", "example": "book II" },       "series": { "label": "Series", "description": "The book series that the book belongs to.", "type": "string", "example": "Signet Classic" },       "seriesvolume": { "label": "Series volume", "description": " The volume number of the book within the \"series\".", "type": "string", "example": "CT334" },       "genre": { "label": "Genre", "description": "The literary genre of the book.", "example": "\"fiction\", \"non-fiction\"", "suggestedvalues": [ "fiction", "non-fiction" ],           "type": "string" },       "format": { "label": "Format", "description": "The format that the book is in.", "example": "\"hardcover\", \"paperback\"", "suggestedvalues": [ "hardcover", "paperback" ],           "type": "string" },       "isbn": { "label": "ISBN", "description": "International Standard Book Number", "type": "string", "example": "9780452284241", "aliases": ["ISBN"], "suggested": true },       "issn": { "label": "ISSN", "description": "International Standard Serial Number", "type": "string", "aliases": ["ISSN"], "example": "2049-3630" },       "oclc": { "label": "OCLC", "description": "Online Computer Library Center number (www.worldcat.org)", "type": "number", "aliases": ["OCLC"], "example": "53163540" },       "lccn": { "label": "LCCN", "description": " Library of Congress Control Number", "type": "string", "aliases": ["LCCN"], "example": "n78-890351" },       "ol": { "label": "Open Library number", "description": "Internet Archive Open Library number (openlibrary.org)", "type": "string", "aliases": ["OL"], "example": "OL7954505M" },       "doi": { "label": "DOI", "description": "Digital object identifier", "type": "string", "aliases": ["DOI"], "example": "10.3352/jeehp.2013.10.3" },       "id": { "label": "Other id", "description": "Use for an identifier other than the ones listed above.", "type": "string" },       "publisher": { "label": "Publisher", "description": "The name of one or more publishers of the book. If more than one publisher is stated, separate the names with semicolons.", "type": "string", "example": "Secker and Warburg" },       "location": { "label": "Location", "description": "The location where the book was published. If more than one location is stated, separate the locations with semicolons.", "type": "string", "example": "London" },       "edition": { "label": "Edition", "description": "The edition of the book quoted. If quoting from the first edition of the book, it is usually not necessary to specify this fact.", "type": "string", "example": "\"2nd\", \"3rd corrected and revised\"" },       "url": { "label": "URL", "description": "The URL or web address of an external website containing the full text of the book. Do not link to any website that has content in breach of copyright.", "type": "url", "example": "https://www.gutenberg.org/files/2828/2828-h/2828-h.htm" },       "archiveurl": { "label": "Archive URL", "description": "Use \"archiveurl\" to indicate the URL of a webpage on a website such as the Internet Archive at which the webpage has been archived.", "type": "url", "example": "https://web.archive.org/web/20120210005807/https://time.com/time/magazine/article/0,9171,912563,00.html" },   	"archivedate": { "label": "Archive date", "description": "The date on which \"archiveurl\" was archived.", "type": "string", "example": "2012-02-10" },       "brackets": { "label": "Brackets", "description": "Use \"on\" to surround a quotation with brackets. This indicates that the quotation contains a mere mention of a term or does not provide an actual instance of a term but provides information about related terms.", "type": "boolean", "example": "on" },       "author2": { "description": "additional author", "type": "string" },       "authorlink2": { "description": "additional author Wikipedia article", "type": "string" },       "author3": { "inherits": "author2" },       "authorlink3": { "inherits": "authorlink2" },       "author4": { "inherits": "author2" },       "authorlink4": { "inherits": "authorlink2" },       "author5": { "inherits": "author2" },       "authorlink5": { "inherits": "authorlink2" },       "passage": { "label": "Quoted passage", "description": "The text being quoted. Use boldface to highlight the term being defined.", "aliases": ["text"], "type": "content", "required": true, "example": "Boxer was an enormous beast, nearly eighteen hands high, " },       "translation": { "label": "Translation", "description": "If the quoted text is not in English, this parameter can be used to provide an English translation of it. Don't use automated (machine-provided) translations.", "aliases": ["t"], "type": "content" },       "transliteration": { "label": "Transliteration", "description": "If the quoted text uses a different writing system from the Latin alphabet (the usual alphabet used in English), this parameter can be used to provide a transliteration of it into the Latin alphabet. Note that many languages provide an automatic transliteration if this argument is not specified.", "aliases": ["tr"], "type": "content" },       "footer": { "label": "Footer", "description": "This parameter can be used to specify arbitrary text to insert in a separate line at the bottom, to specify a comment, footnote, etc.", "type": "content" },       "quoted_in": { "label": "Quoted in", "description": "If the quoted text is from book \"A\" which states that the text is from another book \"B\", use \"title\", \"edition\" and \"others\" to provide information about book \"B\". Use \"quoted_in\" for the title of book \"A\".", "type": "string" },       "original": { "label": "Original title of work", "description": "If you are citing a derivative work such as a translation, state the title of the original work.", "example": "El ingenioso hidalgo Don Quijote de la Mancha", "type": "string" },       "type": { "label": "Type of derivative work", "description": "If you are citing a derivative work such as a translation, state the type of derivative work. If not indicated, the template assumes that the derivative work is a translation.", "example": "Translation", "type": "string" },       "by": { "label": "Author of original work", "description": "If you are citing a derivative work such as a translation, state the author of the original work.", "example": "Miguel de Cervantes", "type": "string" },       "by2": { "label": "Author of original work", "description": "If \"by\" is used to state the author of another translated version of the work, \"by2\" can be used to state the author of the original work.", "type": "string" }   },    "maps": { "citoid": { "language": "1", "title": "title", "bookTitle": "title", "publicationTitle": "title", "translator": "translator", "author": ["author", "author2", "author3", "author4", "author5"], "editor": "editor", "publisher": "publisher", "date": "date", "place": "location", "edition": "edition", "ISSN": ["issn"], "ISBN": ["isbn"], "oclc": "oclc", "pages": "page", "volume": "volume", "series": "series", "DOI": "doi", "url": "url" }   },    "paramOrder": [ "1",       "worklang", "termlang", "author", "authorlink", "editor", "title", "trans-title", "chapter", "chapterurl", "trans-chapter", "page", "pageurl", "line", "section", "sectionurl", "column", "columnurl", "passage", "translation", "transliteration", "year", "year_published", "origyear", "date", "origdate", "publisher", "location", "edition", "genre", "format", "url", "archiveurl", "archivedate", "translator", "volume", "volume_plain", "series", "seriesvolume", "isbn", "issn", "oclc", "doi", "lccn", "ol", "id", "brackets", "last", "first", "quoted_in", "original", "type", "by", "by2", "footer", "author2", "authorlink2", "author3", "authorlink3", "author4", "authorlink4", "author5", "authorlink5" ],   "format": "inline" }