Template:Cite wikisource/doc

From Wikipedia, the free encyclopedia
Jump to: navigation, search

This template is used to cite sources in Wikipedia. It is specifically for works in the sister project Wikisource.

Usage[edit]

All field names must be in lowercase.

Copy a blank version to use. Remember to use the "|" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.

No templates or magic words are necessary when using an ISBN, OCLC number, or DOI as an identifier. Instead of using the id field in these instances, simply use the appropriate field. For instance, type isbn= followed by the number instead of id=ISBN. Templates are available for other identification number types to be used in the ID field ({{ISSN}}, {{LCCN}}, {{LCC}}, etc.) if these aren't available. See also the complete description of fields.

Full version (copy and paste text below and delete parameters you don't need)
{{cite wikisource |class= |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |coauthors= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans_title= |plaintitle= |wslink= |archiveurl= |archivedate= |type= |edition= |series= |volume= |date= |year= |month= |origyear= |publisher= |location= |language= |wslanguage= |isbn= |oclc= |doi= |id= |page= |pages= |at= |wspage= |trans_chapter= |chapter= |plainchapter= |quote= |ref= |bibcode= |laysummary= |laydate= |separator= |postscript= |lastauthoramp= |scan= |noicon= |firsticon= |vb=}}
Most commonly used fields (use this and you won't have to delete as much)
{{cite wikisource |title= |wslink= |last= |first= |authorlink= |coauthors= |year= |publisher= |location= |page= |pages= |scan=}}
Example 1
{{cite wikisource |editor-first= Hugh |editor-last= Chisholm |chapter= Aard-vark |wslink= 1911 Encyclopædia Britannica |plaintitle= [[Encyclopædia Britannica Eleventh Edition|Encyclopædia Britannica]] |edition= Eleventh |year= 1911 |publisher= Cambridge University Press}}

Chisholm, Hugh, ed. (1911). "Wikisource link to Aard-vark". Encyclopædia Britannica (Eleventh ed.). Cambridge University Press. Wikisource.

Example 2
{{cite wikisource
 | class        = journal
 | first        = T. E.
 | last         = Lounsbury
 | chapter      = Sketch of George Jarvis Brush
 | wslink       = Popular Science Monthly/Volume 20/November 1881
 | plaintitle   = [[Popular Science Monthly]]
 | volume       = 20
 | month        = November
 | year         = 1881
 | page         = 117
 | wspage       = 117
 | publisher    = [[D. Appleton & Company]]
 | issn         = 0161-7370
 | scan         = Page:Popular Science Monthly Volume 20.djvu/127
}}

Lounsbury, T. E. (November 1881). "Wikisource link to Sketch of George Jarvis Brush". Popular Science Monthly. 20. D. Appleton & Company. Wikisource. Wikisource page link 117. ISSN 0161-7370. Wikisource link [scan]

Vertical list Prerequisites * Brief instructions
{{cite wikisource
| class         = 
| last          = 
| first         = 
| authormask    = 
| authorlink    = 
| coauthors     = 
| firstn =  | lastn = 
| authorn-link  = 
| editor        = 
| editorn-last  = 
| editorn-first = 
| editor-link   = 
| editorn-link  = 
| others        = 
| title         = 
| trans_title   = 
| plaintitle    = 
| wslink        = 
| archiveurl    = 
| archivedate   = 
| type          = 
| edition       = 
| series        = 
| volume        = 
| date          = 
| origyear      = 
| year          = 
| month         = 
| publisher     = 
| location      = 
| wslanguage    = 
| language      = 
| isbn          = 
| oclc          = 
| doi           = 
| bibcode       = 
| id            = 
| page          = 
| pages         = 
| nopp          = 
| at            = 
| wspage        = 
| chapter       = 
| trans_chapter = 
| plainchapter  = 
| quote         = 
| ref           = 
| laysummary    = 
| laydate       = 
| separator     = 
| postscript    = 
| lastauthoramp = 
| scan          = 
| noicon        = 
| firsticon     = 
| vb            = 
}}



last

last
last

lastn



editor or editor-last
editorn-last






archiveurl=





year or date

year

publisher









page or pages



chapter




laysummary


coauthors or >1 lastn
Page: (Wikisource)






(no wikilink)
(no wikilink)


alternative to first2, last2...first9, last9
(no wikilink). n=1 through 9
n=1 through 9

n=1 through 4
n=1 through 4

n=1 through 4

title to display (links to Wikisource)

title to display (no link to Wikisource)
title at Wikisource (links to Wikisource)






†preferred (no 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
(Links to Wikisource)
‡(no wikilink).  Synonymous with "contribution". (Links to Wikisource)

‡(wikilink allowed). (No link to Wikisource)












† This is the preferred field with its alternates listed below.

|chapter= cannot have wikilinks; |plainchapter= can have wikilinks

Examples[edit]

Just a title
* {{cite wikisource | title=Mysterious book }}
Year and title
* {{cite wikisource | title=Mysterious book | year=1901 }}
Basic usage
* {{cite wikisource | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
Citing a chapter in a book with different authors for different chapters and an editor
* {{cite wikisource |last=Bloggs | first=Fred |editor-first=John| editor-last=Doe |plaintitle=Big Compilation Book With Many Chapters and distinct chapter authors |publisher=Book Publishers |date=2001-01-01 |pages=100–110 |chapter=Chapter 2: The History Of The Bloggs Family |isbn=1234567890}}

Parameters[edit]

Syntax[edit]

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. As a general rule, only one data item per parameter. Do not include explanatory or alternate text:

  • Use |date=27 September 2007 not |date=27 September 2007 (print version 25 September)

Use of templates within the citation template, is generally discouraged because many of these templates will add extraneous HTML or CSS that will be rendered in the metadata. Also, HTML entities, for example  , –, etc, should not be used in parameters that contribute to the metadata. Do not include Wiki markup '' (italic font) or ''' (bold font) because these markup characters will contaminate the metadata.

COinS metadata is created for these parameters:

  • |periodical=, |journal=, |newspaper=, |magazine=, |work=, |website=, |encyclopedia=, |encyclopaedia=, |dictionary=
  • |chapter=, |contribution=, |entry=, |article=, |section=
  • |title=
  • |publicationplace=, |publication-place=, |place=, |location=
  • |date=, |year=, |publicationdate=, |publication-date=
  • |series=, |version=
  • |volume=
  • |issue=, |number=
  • |page=, |pages=, |at=
  • |edition=
  • |publisher=, |distributor=, |institution=
  • |url=
  • |chapterurl=, |chapter-url=, |contributionurl=, |contribution-url=, |sectionurl=
  • |author#=, |Author#=, |authors#=, |author#-last=, |author-last#=, |last#=, |surname#=
  • any of the named identifiers (|isbn=, |issn=, |doi=, |pmc=, etc)

By default, sets of fields are terminated with a period (.). This can be an issue when the last field uses an abbreviation or initial that ends with a period, as then two periods will display (..). The only solution is to not include the last period in the value for the set of fields.

Description[edit]

Authors[edit]

  • 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. Requires last; first name will not display if last is empty.
    • OR: for multiple authors, use last1, first1 through last9, first9 for up to nine 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 author9.
  • authorlink: Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: authorlink1, author-link, author1-link, author1link.
  • OR: for multiple authors, use authorlink1 through authorlink9. Aliases: author1-link through author9-link.
  • coauthors: (deprecated) Names of coauthors. Requires author, authors, or lastn Include coauthors in author or authors or use separate authorn or lastn/firstn to list coauthors.
  • 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 or else the anchor will not match the inline link.

Title[edit]

  • title: Title of book. This, or plaintitle, is the only required parameter. Title of book on Wikisource. This must not be wikilinked. This must not have any formatting. It will be automatically linked to Wikisource.
    • plaintitle: Title of book. This, or title, is the only required parameter. If plaintitle is used, it will override title. This can be useful in cases where the chapter should be the link to wikisource (for example, with articles in journals or encyclopaedias, the title should be the title of the journal or encyclopedia and the chapter should be the article). Can be wikilinked but only to an existing Wikipedia article. Do not use italics.
    • wslink: The full link to the work on Wikisource. To be used where the title is different to the page name or where subpages are involved (particularly with periodicals and works in volumes). If chapter is used, the interwiki link will append the chapter name to wslink as a subpage. If title is used, the link will follow wslink but display as title. If plaintitle is used, the will only create a link to wikisource if chapter is also used.
    • anchor: In combination with title, chapter and/or wslink, the link to wikisource can be extended to a specific section by adding anchor name in this parameter. This must be the same anchor name as the anchor on Wikisource. This will not change the displayed text in the citation; to do that, use the at parameter as well. This parameter can be used in addition to wspage as it affects the main link, not the page number link.
    • trans_title: If the book cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the title field and it will point to the url link, if used. Use of language parameter is recommended if this parameter is used.
  • language: The language the source is written in, if not English. Displays in parentheses with "in" before the language name. Use the full language name; do not use templates.
  • wslanguage: The language of the wikisource hosting the work (if not English Wikisource) in the ISO 639-1 (two-letter) or ISO 639-2 (three letter) code for the language. (For example, fr indicates French Wikisource.)
  • type: Provides additional information about the media type of the source; format in sentence case. Displays in parentheses following the title. Examples: Thesis, Booklet, CD liner, Press release.
  • chapter: The chapter heading of the source. May be wikilinked or may use chapter-url, but not both. Displays in quotes.
    • trans-chapter: English translation of the chapter heading, if the source cited is in a foreign language. Displays in square brackets after the chapter field; if chapter-url is defined, then trans-chapter is included in the link. Use of the language parameter is recommended.
  • plainchapter: The chapter of the book, written in full. This overrides the chapter parameter and will not create a link to Wikisource.

Date[edit]

  • date: Date of source being referenced. Can be full date (day, month, and year) or partial date (month and year, year). Use same format as other publication dates in the citations.[date 1] Required when year is used to disambiguate {{sfn}} links to multiple-work citations by the same author in the same year.[more] Do not wikilink. Displays after the authors and is enclosed in parentheses. If there is no author, then displays after publisher.
  • OR:
    • year: Year of source being referenced. Required with some types of {{sfn}} citations;[more] otherwise use date.
    • month: Name of the month or season of publication. If you also have the day, use date instead. Do not wikilink.
  • origyear: Original publication year; displays after the date or year. For clarity, please supply specifics. For example: |origyear=First published 1859 or |origyear=Composed 1904.
  1. ^ Publication dates in references within an article should all have the same format. This may be a different format from that used for archive and access dates. See: MOS:DATEUNIFY.

Publisher[edit]

  • publisher: Name of publisher; may be wikilinked if relevant. The publisher is the company that publishes the work being cited. Do not use the publisher parameter for the name of a work (e.g., a book, encyclopedia, newspaper, magazine, journal, website). Not normally used for periodicals. Corporate designations such as "Ltd", "Inc" or "GmbH" are not usually included. Omit where the publisher's name is substantially the same as the name of the work (for example, The New York Times Co. publishes The New York Times newspaper, so there is no reason to name the publisher). Displays after title; if work is defined, then publisher is enclosed in parentheses.
  • place: Geographical place of publication; generally not wikilinked; omit when the name of the work includes the location; examples: The Boston Globe, The Times of India. Displays after the title; if work is defined, then location is enclosed in parentheses. Alias: location
  • publication-place: If any one of publication-place, place or location are defined, then the location shows after the title; if publication-place and place or location are defined, then place or location are shown before the title prefixed with "written at" and publication-place is shown after the title.
  • publication-date: Date of publication when different from the date the work was written. Displays only if year or date are defined and only if different, else publication-date is used and displayed as date. Use the same format as other dates in the article; do not wikilink. Follows publisher; if work is not defined, then publication-date is preceded by "published" and enclosed in parenthesis.
  • via: Name of the content deliverer (if different from publisher) that presents the source in a format other than the original (e.g. NewsBank); or when the URL provided does not make clear the identity of the deliverer; or where no URL or DOI is available (EBSCO); or if the deliverer requests attribution; or as suggested in WP:The Wikipedia Library (e.g. Credo, HighBeam). |via= permits adding a level of detail to "say where you found it" within the syntax of the citation template. |via= is not intended to replace |publisher=. See also |registration= and |subscription=.

Edition, series, volume[edit]

  • edition: When the publication has more than one edition; for example: "2nd", "Revised" etc. Displays " ed." after this field, so |edition=2nd produces "2nd ed." Does not display if a periodical field is defined.
  • series or version: When the source is part of a series, such as a book series or a journal where the issue numbering has restarted.
  • volume: For one publication published in several volumes. Displays after the title and series fields; displays in bold— if bolding is not desired, then include the volume information in the title field.

In-source locations[edit]

  • page: The number of a single page in the source that supports the content. Use either |page= or |pages=, but not both. Displays preceded by p. unless |nopp=y.
  • OR: pages: A range of pages in the source that supports the content. Use either |page= or |pages=, but not both. Separate using an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source. Displays preceded by pp. unless |nopp=y.
    • nopp: Set to y to suppress the p. or pp. notations where this is inappropriate; for example, where |page=Front cover.
  • OR: at: For sources where a page number is inappropriate or insufficient. Overridden by |page= or |pages=. Use only one of |page=, |pages=, or |at=.
Examples: page (p.) or pages (pp.); section (sec.), column (col.), paragraph (para.); track; hours, minutes and seconds; act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, verse.
  • wspage: The page number on Wikisource. This will usually be an anchor within a larger page. It can be useful to guide the reader to a specific item in a larger body of text. Anchors are automatically generated for proofread texts at Wikisource but can be added manually if necessary.

Anchor[edit]

Identifiers[edit]

  • id: A unique identifier, used where none of the specialized identifiers are applicable; wikilink or use a template as applicable.

These identifiers create links and are designed to accept a single value. Using multiple values or other text will break the link and/or invalidate the identifier. In general, the parameters should include only the variable part of the identifier, e.g. rfc=822 or pmc=345678.

  • arxiv: arXiv identifier; for example: arxiv=hep-th/9205027 (before April 2007) or arxiv=0706.0001 (since April 2007). Do not include extraneous file extensions like ".pdf" or ".html".
  • asin: Amazon Standard Identification Number; if first character of asin value is a digit, use isbn.
    • asin-tld: ASIN top-level domain for Amazon sites other than the US; valid values: ca, cn, co.jp, co.uk, de, es, fr, it
  • bibcode: Bibcode; used by a number of astronomical data systems; for example: 1974AJ.....79..819H
  • doi: Digital object identifier; for example: 10.1038/news070508-7. It is checked to ensure it begins with (10.).
    • doi_brokendate: Date the DOI was found to be non-working at http://dx.doi.org. Use the same format as other dates in the article.
  • isbn: International Standard Book Number; for example: 978-0-8126-9593-9. (See: Wikipedia:ISBN and ISBN). Dashes in the ISBN are optional, but preferred. Use the ISBN actually printed on or in the book. Use the 13-digit ISBN – beginning with 978 or 979 – when it is available. If only a 10-digit ISBN is printed on or in the book, use it. ISBNs can be found on the page with the publisher's information – usually the back of the title page – or beneath the barcode as a number beginning with 978 or 979 (barcodes beginning with any other numbers are not ISBNs). For sources with the older 9-digit SBN system, prefix the number with a zero; thus, SBN 902888-45-5 should be entered as |isbn=0-902888-45-5. Do not convert a 10-digit ISBN to 13-digit by just adding the 978 prefix; the last digit is a calculated check digit and just making changes to the numbers will make the ISBN invalid. This parameter should hold only the ISBN without any additional characters. It is checked for length, invalid characters – anything other than numbers, spaces, and hyphens, with "X" permitted as the last character in a 10-digit ISBN – and the proper check digit. Alias: ISBN
  • issn: International Standard Serial Number; eight characters may be split into two groups of four using a hyphen, but not an en dash or a space.
  • jfm: Jahrbuch über die Fortschritte der Mathematik
  • jstor: JSTOR abstract; for example: "jstor=3793107" will generate JSTOR 3793107.
  • lccn: Library of Congress Control Number. When present, alphabetic prefix characters are to be lower case.A certain amount of reformatting may be necessary, such as the use of one or more zeroes instead of a hyphen; for example, if the book shows "Library of Congress Catalog Card Number 89-61500", this would be entered as |lccn=89061500. Help with formatting may be found at LCCN (Library of Congress Control Number) and How does LCCN Permalink normalize LCCNs?
  • mr: Mathematical Reviews
  • oclc: OCLC
  • ol: Open Library identifier; do not include "OL" in the value.
  • osti: Office of Scientific and Technical Information
  • pmc: PubMed Central; use article number for full-text free repository of a journal article. E.g. pmc=345678. Do not include "PMC" in the value. See also |pmid= below; these are two different identifiers.
  • pmid: PubMed; use unique identifier. See also |pmc= above; these are two different identifiers.
  • rfc: Request for Comments
  • ssrn: Social Science Research Network
  • zbl: Zentralblatt MATH

Quote[edit]

  • quote: Relevant text quoted from the source. Displays enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation.

Editors[edit]

  • 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.
    • 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 editor4-last, editor4-first for up to four editors.
  • 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 editor4-link.
Display:
If authors: Authors are first, followed by the editors and the included work, 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."; more than three editors will be followed by "et al., eds."

Laysummary[edit]

  • laysummary: URL link to a non-technical summary or review of the source; the URL title is set to "Lay summary".
    • laysource: Name of the source of the laysummary. Displays in italics and preceded by an endash.
    • laydate: Date of the summary. Displays in parentheses.

Display options[edit]

  • author-mask: Replaces the name of the first author with em dashes or text. Set author-mask to a numeric value n to set the dash n em spaces wide; set author-mask to a text value to display the text without a trailing author separator; for example, "with". You must still include the values for all authors for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as Shortened footnotes. Do not use in a list generated by {{reflist}}, <references /> or similar as there is no control of the order in which references are displayed.
  • author-name-separator: Controls the separator between last and first names; defaults to a comma and space (, ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as &#32; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
  • author-separator: Controls the separator between authors; defaults to a semicolon and space (; ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as &#32; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
  • display-authors: Controls the number of author names that are displayed when a citation is published. To control the displayed number of author names, set display-authors to the desired number. For example, |display-authors=2 will display only the first two authors in a citation. By default, the only the first eight cited authors are displayed; subsequent authors beyond eight are represented in the published citation by "et al." If a citation contains nine author names and one wishes all nine author names to display, "et al." may be suppressed by setting |display-authors=9. Aliases: displayauthors.
  • lastauthoramp: Switches the separator between the last two names of the author list to space ampersand space ( & ) when set to any value. Example: |lastauthoramp=yes
  • postscript: Controls the closing punctuation for a citation; defaults to a period (.); if the parameter is present, but blank, no terminating punctuation will be used. Ignored if quote is defined.
  • separator: Controls the punctuation used to separate lists of authors, editors, etc. Defaults to a period (.); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as &#32; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.

Wikisource[edit]

  • scan: Many works hosted on Wikisource are proofread from scans also hosted by the project. This parameter will provide a link to the source scan on which the citation is based, if required. Enter the pagename of the source scan at Wikisource. This pagename should include both the namespace (Index: or Page:) and the filetype (usually .djvu). Example: |scan=Page:Popular Science Monthly Volume 20.djvu/127
  • class: The CSS class for the citation; use only when this template is used as a metatemplate; do not use directly when making citations in the article namespace.
  • noicon: If |noicon=yes, then Wikisource icons will not be added to Wikisource links.
  • firsticon: If |firsticon=yes, then the Wikisource icon will be prepended.
  • vb: If |vb=yes, then the text "This article incorporates text from a publication now in the public domain:" will be prepended.

Backward compatibility[edit]

An earlier iteration of this template used only a few unnamed parameters. This template is backward compatible with the previous usage. The following format will function correctly:

{{cite wikisource|work title|author|wikisource language}}

Only the first parameter is necessary; the rest are optional.

Examples[edit]

{{cite wikisource|Sense and Sensibility}}

Wikisource link to Sense and Sensibility. Wikisource.

{{cite wikisource|Sense and Sensibility|Jane Austen}}

Jane Austen. Wikisource link to Sense and Sensibility. Wikisource.

{{cite wikisource|Sentido y sensibilidad|Jane Austen|es}}

Jane Austen (in Spanish). Wikisource link to Sentido y sensibilidad. Wikisource.

See also[edit]

Specific Wikisource citation templates[edit]

This template produces COinS metadata; see COinS in Wikipedia for background information.