Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Template:Cite book: Difference between revisions

Template page
Shane (talk | contribs)
updated
Joe Beaudoin Jr. (talk | contribs)
adding a check for internal wiki articles before outputting an external link for "url" attribute
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>__NOTOC__ =Documentation=
<noinclude>__NOTOC__  
=Documentation=
This template is used to [[BW:CITE|cite sources]] in ''Battlestar Wiki''. It is specifically for books.
This template is used to [[BW:CITE|cite sources]] in ''Battlestar Wiki''. It is specifically for books.


Line 13: Line 14:
  | first =  
  | first =  
  | authorlink =  
  | authorlink =  
| authorlinkurl = ''Not Active''
  | coauthors =  
  | coauthors =  
  | editor =  
  | editor =  
Line 45: Line 47:
  last (no wikilink)
  last (no wikilink)
  last  
  last  
  last
  &nbsp;
  &nbsp;
  &nbsp;
  &nbsp;
  &nbsp;
Line 63: Line 65:
  &nbsp;
  &nbsp;
  publisher
  publisher
&nbsp;
  &nbsp;
  &nbsp;
  &nbsp;
  &nbsp;
Line 75: Line 78:
  | first =  
  | first =  
  | authorlink =  
  | authorlink =  
| authorlinkurl = ''Not Active''
  | coauthors =  
  | coauthors =  
  | year =  
  | year =  
Line 119: Line 123:
* '''title''': Title of book. '''''This is the only required parameter.''''' Can be wikilinked '''only''' to an existing ''Battlestar Wiki'' article. Do not use italics.
* '''title''': Title of book. '''''This is the only required parameter.''''' Can be wikilinked '''only''' to an existing ''Battlestar Wiki'' article. Do not use italics.
* '''url''': URL of an online book. Cannot be used if you wikilinked ''title''.
* '''url''': URL of an online book. Cannot be used if you wikilinked ''title''.
** '''format''': Format, i.e. PDF. HTTP implied if not specified.
** '''[[Template:formattype|format]]''': Format, i.e. PDF. HTML implied if not specified.
** '''accessdate''': Full date when item was accessed, in [[Wikipedia:ISO 8601|ISO 8601]] YYYY-MM-DD format, eg. ''2006-02-17''. '''Required when ''url'' field is used.''' Must not be wikilinked.
** '''accessdate''': Full date when item was accessed, in [[Wikipedia:ISO 8601|ISO 8601]] YYYY-MM-DD format, eg. ''2006-02-17''. '''Required when ''url'' field is used.''' Must not be wikilinked.
*** OR:  '''accessyear''': Year when item was accessed, and '''accessmonth''': Month when item was accessed. If you also have the day, use ''accessdate'' instead. Must not be wikilinked.
*** OR:  '''accessyear''': Year when item was accessed, and '''accessmonth''': Month when item was accessed. If you also have the day, use ''accessdate'' instead. Must not be wikilinked.
Line 140: Line 144:
* [[Template:cite book/bsg novel 2005]] - Used for the [[Battlestar Galactica (2005 Novel)]] citations.
* [[Template:cite book/bsg novel 2005]] - Used for the [[Battlestar Galactica (2005 Novel)]] citations.
** Usage: {{tlp|cite book/bsg novel 2005|''Page Number''}}
** Usage: {{tlp|cite book/bsg novel 2005|''Page Number''}}
 
* [[Template:cite book/bsg novel 2005]] - Used for the ''[[So Say We All: The Complete, Uncensored, Unauthorized Oral History of Battlestar Galactica]]'' citations.
** Usage: {{tlp|cite book/sswa|''Page Number''}}


==Citation styles==
==Citation styles==
Line 153: Line 158:
[[Category:Citation templates|{{PAGENAME}}]]
[[Category:Citation templates|{{PAGENAME}}]]
[[Category:Templates using ParserFunctions|{{PAGENAME}}]]
[[Category:Templates using ParserFunctions|{{PAGENAME}}]]
[[de:Vorlage:Cite book]]
</noinclude><includeonly><cite class="book" style="font-style:normal" {{
</noinclude><includeonly><cite class="book" style="font-style:normal" {{
   #if: {{{ref|}}}
   #if: {{{ref|}}}
Line 208: Line 214:
   | &#32;{{{editor}}}
   | &#32;{{{editor}}}
}} ''{{
}} ''{{
   #if: {{{url|}}} | [{{{url}}} {{{title}}}] | {{{title}}}
   #if: {{{url|}}} | {{#ifexist:{{{url}}}|[[{{{url}}}|{{{title}}}]]|[{{{url}}} {{{title}}}]}} | {{{title}}}
}}''{{
}}''{{
   #if: {{{format|}}} | &#32;({{{format}}})
   #if: {{{format|}}} | &#32;({{formattype|{{{format}}}}})
}}{{
}}{{
   #if: {{{others|}}} | , {{{others}}}
   #if: {{{others|}}} | , {{{others}}}
Line 228: Line 234:
   #if: {{{id|}}} | . {{{id}}}
   #if: {{{id|}}} | . {{{id}}}
}}{{
}}{{
   #if: {{{pages|}}} | ,&#32;{{{pages}}}
   #if: {{{pages|}}} | , p. {{{pages}}}
}}{{
}}{{
   #if: {{{accessdate|}}}
   #if: {{{accessdate|}}}

Latest revision as of 01:19, 9 February 2020

Documentation

This template is used to cite sources in Battlestar Wiki. It is specifically for books.

Usage

All fields must be lowercase. Copy a blank version to use:

Full version Brief Instructions Most common fields
  
 {{cite book
 | last = 
 | first = 
 | authorlink = 
 | authorlinkurl = ''Not Active''
 | coauthors = 
 | editor = 
 | others = 
 | title = 
 | origdate = 
 | origyear = 
 | origmonth = 
 | url = 
 | format = 
 | accessdate = 
 | accessyear = 
 | accessmonth = 
 | edition = 
 | date = 
 | year = 
 | month = 
 | publisher = 
 | location = 
 | language = 
 | id = 
 | doi =
 | pages = 
 | chapter = 
 | chapterurl = 
 | quote =
 }}
  
 {{ Prerequisites*
 (no wikilink)
 last (no wikilink)
 last 
   
  
  
 REQUIRED**
 † preferred (no wikilink)
  alt to origdate
  alt to origdate
  
 url
 url †preferred (no wikilink)
      alt to accessdate
      alt to accessdate
  
 † preferred (no wikilink)
  alt to date
  alt to date
  
 publisher
  
  
  
  
  
 (no wikilink)‡
 chapter
  
 }}
{{cite book
 | last = 
 | first = 
 | authorlink = 
 | authorlinkurl = ''Not Active''
 | coauthors = 
 | year = 
 | title = 
 | publisher = 
 | location = 
 | id = 
 }}
The field listed below is a prerequisite for the field to the left. For example last is a prerequisite to first meaning first will NOT be displayed even if it has a value unless last also has a value.
∗∗ Wikilinks must link to an existing article, and cannot be used if url is used below.
This is the preferred field with its alternates listed below.
If chapterurl is provided then chapter can not have wikilinks.

Fields

Wikilinks

Most fields can be wikilinked (ie. title = [[book article|book title]]), but should generally only be linked to an existing Battlestar Wiki article. Any wikilinked field must not contain any brackets apart from normal round brackets () — don't use <>[]{}.

Description of fields

Syntax (for the technical-minded)

Nested fields either rely on their parent fields, or replace them:

  • parent
    • child — may be used with parent (and is ignored if parent is not used)
    • OR: child2 — may be used instead of parent (and is ignored if parent is used)

Description

  • last: Surname of author. Don't wikilink (use authorlink instead).
    • first: First name(s) of author, including title(s) (eg. Firstname Middlename or Firstname M. or Dr. Firstname M., Snr.). Don't wikilink (use authorlink instead).
      • The `last' and `first' fields are poorly named for the case of an author whose surname is usually written first (e.g. as in Chinese). They also have the problem of only communicating which is the surname, not communicating where the surname is usually written. Consider deprecating first,last fields, and reinstating author field, using the notation "Smith, John" or "Hu Ke Jie" as appropriate (i.e. always writing surname first, and using comma or not depending on whether the name is usually written surname last or first).
    • authorlink: Title of Wikipedia article about author. 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, surname last, separated by ", " (eg. Joe Bloggs, John F. Kennedy, H. R. Dent).
      • Someone please confirm that surname is to go last even for people whose name is usually written surname first. Consider rethinking this field, e.g. using Bloggs, Joe and Kennedy, John F. and Dent, H. R. and Hu Ke Jie.
    • OR: author: Full name of author, preferably surname first.
  • editor: Name of editor/editors. No text is added, so labels such as "(ed.)" have to be supplied by the user.
  • others: For uses such as "illustrated by Smith" or "trans. Smith".
  • title: Title of book. This is the only required parameter. Can be wikilinked only to an existing Battlestar Wiki article. Do not use italics.
  • url: URL of an online book. Cannot be used if you wikilinked title.
    • format: Format, i.e. PDF. HTML implied if not specified.
    • accessdate: Full date when item was accessed, in ISO 8601 YYYY-MM-DD format, eg. 2006-02-17. Required when url field is used. Must not be wikilinked.
      • OR: accessyear: Year when item was accessed, and accessmonth: Month when item was accessed. If you also have the day, use accessdate instead. Must not be wikilinked.
  • edition: When the book has more than one edition. eg: "2nd edition".
  • origdate: Full date of publication of original edition, in ISO 8601 YYYY-MM-DD format, eg. 2004-06-27. Must not be wikilinked.
    • OR: origyear: Year of publication of original edition, and origmonth: Month of publication of original edition. If you also have the day, use date instead. Must not be wikilinked.
  • date: Full date of publication, in ISO 8601 YYYY-MM-DD format, eg. 2006-02-17. Must not be wikilinked.
    • OR: year: Year of publication, and month: Name of the month of publication. If you also have the day, use date instead. Must not be wikilinked.
  • publisher: Publisher should not include corporate designation such is "Ltd" or "Inc".
    • location: Place of publication.
  • language: The language the book is written in, if it is not English.
  • id: Identifier such as ISBN 1-111-22222-9. Remember, you must specify the kind of identifier, not just give a number.
  • doi: digital object identifier.
  • pages: 5–7: first page and optional last page. This is for listing the pages relevant to the citation, not the total number of pages in the book.
  • chapter: The chapter of the book, written in full. Punctuation other than quotes should be included in the value passed to the parameter, eg. chapter = Meet Dick and Jane. produces "Meet Dick and Jane." ahead of title.
    • chapterurl: URL of an individual chapter of online book. Should be at the same site as url, if any.
  • quote: Relevant quote from the book.

Sub Templates of Cite Book

Citation styles

Established citation styles for coauthors:

MLA style
Last, First and First Last. "If there are more than three authors, you may list only the first author followed by the phrase et al."
APA style
Last, F. & Last, F.
Chicago Manual of Style
Last, First, and First Last.
Turabian
same as Chicago Reference List, above.
Harvard
Last, F., Last, F. & Last, F.