Wikipedia:WikiProject Wikisource/Citation Uniformity/Cite wikisource
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) | ||
---|---|---|
| ||
Most commonly used fields (use this and you won't have to delete as much) | ||
| ||
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). " 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). " Sketch of George Jarvis Brush". Popular Science Monthly. 20. D. Appleton & Company. Wikisource. p. 117. ISSN 0161-7370. [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 = | format = | accessdate = | 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 = }} |
last last last lastn editor or editor-last editorn-last archiveurl= url url year or date year publisher page or pages chapter laysummary coauthors or >1 lastn |
(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 at Wikisource title at 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 ‡(no wikilink). Synonymous with "contribution". ‡(no wikilink). |
† This is the preferred field with its alternates listed below.
‡ |chapter=
cannot have wikilinks; |plainchapter=
can have wikilinks
Fields
[edit]Wikilinks
[edit]Except where specifically prohibited in the field descriptions below, most fields can be wikilinked (e.g. title = [[book article|book title]]
), but should generally only be linked to an existing Wikipedia article. Wikilinked fields must escape the characters <>[]{}
rather than including them directly.
Description of fields
[edit]Syntax (for the technical-minded)
[edit]Nested fields rely on their parent fields:
- 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)
Description
[edit]- last: Surname of author. Don't wikilink (use authorlink instead).
- first: Given or first name(s) of author, including title(s) (e.g. Firstname Middlename or Firstname M. or Dr. Firstname M., Snr.). Don't wikilink (use authorlink instead).
- The 'last' and 'first' fields are not ideally suited to authors whose surname is usually written first (e.g. as in Chinese). Use the same format as the source uses to handle these cases.
- first: Given or first name(s) of author, including title(s) (e.g. Firstname Middlename or Firstname M. or Dr. Firstname M., Snr.). Don't wikilink (use authorlink instead).
- mode: Sets element separator, default terminal punctuation, and certain capitalization according to the value provided. For
|mode=cs1
, element separator and terminal punctuation is a period (.
); where appropriate, initial letters of certain words are capitalized ('Retrieved...'). For|mode=cs2
, element separator is a comma (,
); terminal punctuation is omitted; where appropriate, initial letters of certain words are not capitalized ('retrieved...'). These styles correspond to Citation Style 1 and Citation Style 2 respectively. To override default terminal punctuation use postscript. - author-mask:
- contributor-mask:
- editor-mask:
- interviewer-mask:
- subject-mask:
- translator-mask:
- Replaces the name of the (first) author with em dashes or text. Set <name>-mask to a numeric value n to set the dash n em spaces wide; set <name>-mask to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with <name>-link—in this case, the value of <name>-link will be used as (linked) text. In either case, you must still include the values for all names 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. Mask parameters can take an enumerator in the name of the parameter (e.g.|authorn-mask=
) to apply the mask to a specific name.
- Replaces the name of the (first) author with em dashes or text. Set <name>-mask to a numeric value n to set the dash n em spaces wide; set <name>-mask to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with <name>-link—in this case, the value of <name>-link will be used as (linked) text. In either case, you must still include the values for all names 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
- display-authors:
- display-contributors:
- display-editors:
- display-interviewers:
- display-subjects:
- display-translators:
- Controls the number of author (or other kind of contributor) names that are displayed. By default, all authors are displayed. To change the displayed number of names, set the parameter to the desired number. For example,
|display-authors=2
will display only the first two authors in a citation (and not affect the display of the other kinds of contributors).|display-authors=0
is a special case suppressing the display of all authors including the et al.|display-authors=etal
displays all authors in the list followed by et al. Aliases: none.
- Controls the number of author (or other kind of contributor) names that are displayed. By default, all authors are displayed. To change the displayed number of names, set the parameter to the desired number. For example,
- postscript: Controls the closing punctuation for a citation; defaults to a period (
.
); for no terminating punctuation, specify|postscript=none
– leaving|postscript=
empty is the same as omitting it, but is ambiguous. Additional text, or templates that render more than a single terminating punctuation character, will generate a maintenance message.|postscript=
is ignored if quote is defined. See Examples for typical usage.- authorlink: Title of Wikipedia article about author (not the author's personal website). Article should already exist. Must not be wikilinked itself. Do not use this on its own, but along with author or first and last.
- coauthors: Full name of additional author or authors, separated by ", " (e.g. Joe Bloggs, John F. Kennedy, H. R. Dent).
- Whether the surname of the co-authors goes first or last is dependent on the citation style (see the citation style section below) preferred.
- OR: author: Full name of author, preferably surname first. (deprecated) Don't wikilink (use authorlink instead).
- OR: for multiple authors, use the fields first1, last1, ...,firstn, lastn to 'correctly' record all the information about the book (the first nine authors are printed, then et al. is appended if even more authors were specified). Don't wikilink as there are corresponding authorlink1, ..., authorlink9 fields as well. This usage is preferred to the use of coauthors.
- editor: Name of editor/editors. Do not Wikilink any values in the editor field but use editor-link instead. The template automatically adds "ed." after the editor's name unless the chapter parameter is used in which case the template adds "in" before the editor's name which appears after the chapter and before the title. This implies that the author is responsible only for part of the book (including the cited chapter) and the editor responsible for the whole book. If, however, the author(s) and editor(s) are responsible for the whole book, then the editor field or its alternates described below should not be used if the chapter field is being used. Instead, the editor(s) should be included in an author field with possibly "(ed.)" after the surname(s). Alternatively, the editor field may be used if the chapter detail is included in the title field instead of using the chapter field.
- OR: alternatively editor-first and editor-last can be used in the same way as first and last.
- OR: for multiple editors up to four in number, use the fields editor1-first, editor1-last, ...,editorn-first, editorn-last to 'correctly' record all the information about the book in the same way as firstn and lastn.
- editor-link or editor1-link...editorn-link is used in the same way as authorlink or authorlinkn.
- others: To record other contributors to the work, such as "Illustrated by Smith" or "Trans. Smith".
- 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.
- 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.
- accessdate: Full date when url was accessed. Should be used when url field is used. Should be in the same format as other dates in citations in the same article. Must not be wikilinked.
- archive parameters (if used, both must be provided)
- archiveurl: The URL of an archived copy of a web page, if (or in case) the url becomes unavailable. Typically used to refer to services like WebCite and Archive.org.
- archivedate: Date when the item was archived. Should not be wikilinked.
- type: An optional field which can be used to provide additional information about a publication type. The content appears in parentheses following the title. If the publication is a thesis or dissertation, the type might be specified as
type=PhD thesis
, If the publication is an audiobook on compact disk, the type might be specified astype=CD
. - edition: When the book has more than one edition. e.g.: "2nd.", "Revised" etc.. Note that the template automatically displays " ed." after this field, so
edition=2nd
produces "2nd ed.". - series: When the book is part of a series of publications.
- volume: For one book published in several volumes. However, this template displays the text in this field in bold type after the title and series parameters. An alternative is to include the volume information in the title field after the main title (see example below). (NB: there is a separate {{Cite encyclopedia}} template).
- issue: When the book is one of a series that is published periodically.
- date: Full date of publication edition being referenced, in the same format as other dates in citations in the same article. Must not be wikilinked.
- OR: year: Year of publication edition being referenced
- month: Name of the month of publication. If you also have the day, use date instead. Must not be wikilinked.
- origyear: Original publication year, for display alongside the date or year. For clarity, please supply specifics, for instance
origyear=First published 1859
ororigyear=Composed 1904
. This parameter only displays if there is a value for year or date.
- publisher: Publisher should not include corporate designation such as "Ltd" or "Inc".
- location: Geographical place of publication.
- language: The language the book is written in, if it is not English. The template automatically puts parentheses around the text and adds "in" before the language name. If wslanguage is used, it will override the language parameter.
- isbn: International Standard Book Number such as 1-111-22222-9. Note that
|isbn=
, like all field names, must be in lowercase. The field must not be wikilinked as the template automatically creates a link. The template is insensitive to formatting so an ISBN number without dashes ("-") may be used (e.g.|isbn=1111222229
), though ISBNs with correctly formatted dashes are preferred (see Wikipedia:ISBN and ISBN). Please use the 13-digit ISBN where possible; this can normally be found beneath the barcode as a number beginning 978 or 979. For books with the older SBN system (9 digits), use this field but prefix the number with a zero; thus SBN 902888-45-5 should be entered as|isbn=0-902888-45-5
. More information about this feature and its advantages is available at Wikipedia:ISBN. - oclc: Online Computer Library Center ID number, such as 3185581. The field must not be wikilinked as the template automatically creates a link.
- doi: A digital object identifier such as 10.1016/j.coi.2004.08.001. The field must not be wikilinked as the template automatically creates a link.
- doi_brokendate: The date that a digital object identifier link was found to be broken.
- bibcode: A nineteen character Bibcode identifier. The field must not be wikilinked as the template automatically creates a link.
- Several other parameters are available for catalogue or other identifying numbers; these include
|arxiv=
,|asin=
,|issn=
(International Standard Serial Number),|jfm=
,|jstor=
,|lccn=
,|mr=
,|ol=
(Open Library),|osti=
,|pmc=
,|pmid=
,|rfc=
,|ssrn=
and|zbl=
. - id: A unique identifier, used if none of the above are applicable. In this case, you need to specify the kind of identifier you are using, preferably with a template like {{ASIN}} or {{ISSN}}. (Use one of the more specialized parameters if possible; they are linked automatically. In other words, don't use
|id=ISBN 1-111-22222-9 Parameter error in {{ISBN}}: checksum
anymore; use|isbn=1-111-22222-9
. If the book has a SBN but not an ISBN, see|isbn=
.) - pages or page: These parameters are for listing the pages relevant to the citation, not the total number of pages in the book. "
|pages= 5–7
" produces "pp. 5–7", while "|page= 5
" produces "p. 5". The "pp." notation indicating multiple pages, and "p." notation indicating a single page, are placed automatically when you choose between the plural (pages) or singular (page) form of the parameter. Page ranges should be separated by an unspaced en dash (–). - 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.
- nopp: using "page" or "pages", automatically places the p. or pp. notations. If this is inappropriate—for instance, if
page=Front cover
, placing any value afternopp
(e.g.nopp=y
will hide the p. or pp. notation.
- nopp: using "page" or "pages", automatically places the p. or pp. notations. If this is inappropriate—for instance, if
- at: Position within the resource when
|page=
/|pages=
is inappropriate, e.g.|at=para. 14
(when citing a source without page numbers) or|at=no. 456
(something in a numbered list). This parameter is ignored if|page=
/|pages=
is specified.- Using e.g.
|at=para. 14
produces similar results to|page=para. 14
|nopp=y
or|pages=para. 14
|nopp=y
- Using e.g.
- chapter (= contribution): The chapter of the book, written in full. This will create an automatic link to wikisource unless plainchapter is used; plainchapter overrides this parameter. Punctuation (other than quotation marks, which are supplied around the chapter title automatically by the template) should be only included if it is included in the subpage name at Wikisource, as it will be included in the value passed to the parameter. e.g.
|chapter=Chapter 12: Meet Dick and Jane.
produces "Chapter 12: Meet Dick and Jane." ahead of title.- trans_chapter: Acts in the same way as trans_title. The field will be displayed in square brackets within the quotation marks which embrace the chapter field. Use of language parameter is recommended if this parameter is used.
- chapterurl (=contribution-url): URL of an individual chapter of online book. Should be at the same site as url, if any. If chapterurl is used, url should only be used if the beginning of the work and the cited chapter are on separate webpages at the site.
- plainchapter: The chapter of the book, written in full. This overrides the chapter parameter and will not create a link to Wikisource.
- quote: Relevant quote from the book. Should not be excessive in length: More than a few sentences is rarely needed, and if needed then the Wikipedia article's prose should probably more adequately address the topic and/or quote the material directly, e.g. with
{{quote}}
. The template will automatically provided quotation marks, but not a terminal period/full stop (or diaeresis as appropriate), nor initial capitalization, both of which should be added manually. Example:|quote=[I]t was not only competition, but the introduction of new techniques that drew spectators to the events...
- ref: ID for anchor. By default, no anchor is generated. The ordinary nonempty value
|ref=ID
generates an anchor with the givenID
; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing. By default, the template generates an anchor suitable for the {{harv}} template; see anchors for Harvard referencing templates. See "Wikilinks to full references" in Examples below for using the ref field in citation templates in conjunction with short <ref>...</ref> citations. - laysummary: Link to a non-technical summary (or review) of the book
- laydate: Date of summary
- separator: The separator to use in lists of authors, editors, etc. Defaults to ".", but "," may be useful also. If the field is present, but blank, no separator will be used.
- author-separator: Parameter allowing punctuation style to be altered
- author-name-separator: Parameter allowing punctuation style to be altered
- display-authors: By default, the number of authors displayed is limited to 8; if 9 are provided, the ninth is displayed as "et al.". This parameter allows display of fewer authors before the "et al." (e.g.,
|display-authors=2
); alternatively, the "et al." may be suppressed by the use of|display-authors=9
. - postscript: The closing punctuation for the citation. If specified, over-rides the default behaviour of terminating the citation with a full stop. If the field is present, but blank, no terminating punctuation will be used. This may be useful when generating an output consistent with other templates. It is preferred to manually adding ending punctuation, as the punctuation occurs within the <cite> tag, so will appear before any icons added by browser plugins. Ignored if
|quote=
is specified. - lastauthoramp: The separator to use between the last two names in lists of authors. Defaults to "", but "&" may be useful as well.
- 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 that is required. Enter the pagename of the source scan at Wikisource. This pagename should include both the namespace (
Index:
orPage:
) and the filetype (usually.djvu
). Example:|scan=Page:Popular Science Monthly Volume 20.djvu/127
- class: The css class for the citation. Only intended for use with other templates. Do not use this when making citations in the article namespace.
- noicon: This will remove the wikisource icons from the citation (except for the icon at the beginning, which is set or unset with the
firsticon
parameter. As standard, this template places an icon before any link to Wikisource; links with no icon remain internal to Wikipedia.- firsticon: This will place a wikisource icon at the beginning of the citation.
- vb: If used, the text "
This article incorporates text from a publication now in the public domain:
" will be appended at the start of the citation. Any text will activate this parameter but
is the standard.|vb=yes
Examples
[edit]- Just a title
* {{../Cite wikisource | title=Mysterious book }}
- Year and title
* {{../Cite wikisource | title=Mysterious book | year=1901 }}
- Mysterious book. Wikisource. 1901.
- Basic usage
* {{../Cite wikisource | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
- Bloggs, Joe (1974). Book of Bloggs. Wikisource.
- 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}}
- Bloggs, Fred (2001-01-01). " Chapter 2: The History Of The Bloggs Family". In Doe, John. Big Book With Many Chapters and distinct chapter authors. Book Publishers. Wikisource. ISBN 1234567890 Parameter error in {{ISBN}}: checksum.
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}}
Sense and Sensibility. Wikisource.
{{../Cite wikisource|Sense and Sensibility|Jane Austen}}
Jane Austen. Sense and Sensibility. Wikisource.
{{../Cite wikisource|Sentido y sensibilidad|Jane Austen|es}}
Jane Austen (in Spanish). Sentido y sensibilidad. Wikisource.
See also
[edit]- Citing sources: Style guide
- Citation templates
- WikiProject Wikicite
- Wikiproject Wikisource
- {{ws}}
- {{Cite WS}}
Specific Wikisource citation templates
[edit]- Category:Wikisource link templates
- {{Cite Americana}}: Encyclopedia Americana
- {{Cite Appletons'}}: Appletons' Cyclopædia of American Biography
- {{Cite Australasia}}: The Dictionary of Australasian Biography
- {{Cite Catholic Encyclopedia}}: Catholic Encyclopedia
- {{Cite Collier's}}: Collier's New Encyclopaedia
- {{Cite DNB}}: Dictionary of National Biography (1885-1900 edition & 1901 supplement)
- {{Cite DNB12}}: Dictionary of National Biography (1912 supplement)
- {{Cite DNBSupp}}: Dictionary of National Biography (1901 supplement)
- {{Cite EB1911}}: Encyclopædia Britannica (1911)
- {{Cite EB1922}}: Encyclopædia Britannica (1922)
- {{Cite NIE}}: New International Encyclopaedia
- {{NSRW Cite}}: The New Student's Reference Work
- {{Cite Nuttall}}: The Nuttall Encyclopaedia
- {{WsPSM}}: Popular Science Monthly
- {{Cite SBDEL}}: A Short Biographical Dictionary of English Literature
Other citation templates
[edit]- Category:Citation templates
- {{Cite book}}
- {{Cite encyclopedia}}
- {{Cite journal}}
- {{Cite newspaper}}