Difference between revisions of "Template:Cite book/doc"

From Pathfinder Wiki
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
ID & V ok                     
+
<noinclude>{{documentation subpage}}</noinclude><!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
−
s/c a/c:  
+
{{important|1=Please ensure that you <span class=plainlinks>[http://en.wikipedia.org/w/index.php?title=Template:Cite_book/doc&action=edit update the documentation]</span> when adding functionality to or removing functionality from this template.}}
−
Query:  
+
This is balls:
−
Action:  
+
|doi=
−
Outcome:Resolved
+
|bibcode=
 +
|id=
 +
|page=
 +
|pages=
 +
|nopp=
 +
|chapter=
 +
|chapterurl=
 +
|quote=
 +
|ref=
 +
|laysummary=
 +
|laydate=
 +
|separator=
 +
|postscript=
 +
|lastauthoramp=
 +
}}</pre>
 +
| style="vertical-align:top;padding:1ex;" |<pre>
 +
&nbsp;
 +
&nbsp;
 +
last
 +
last
 +
last 
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
editorn-last
 +
editor or editor-last
 +
editorn or editorn-last
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
url
 +
url
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
year or date
 +
&nbsp;
 +
year
 +
&nbsp;
 +
publisher
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
page or pages
 +
&nbsp;
 +
chapter
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
laysummary
 +
&nbsp;
 +
&nbsp;
 +
coauthors or >1 lastn
 +
&nbsp;</pre>
 +
| style="vertical-align:top;padding:1ex;" |<pre>
 +
&nbsp;
 +
(no wikilink)
 +
(no wikilink)
 +
&nbsp;
 +
alternative to first2, last2...first9, last9
 +
(no wikilink). n=1 through 9
 +
&nbsp;
 +
n=1 through 4
 +
n=1 through 4
 +
n=1 through 4
 +
n=1 through 4
 +
n=1 through 4
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
†preferred (no wikilink)
 +
&nbsp;
 +
&nbsp;alternative to date
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
hides automatic 'p' or 'pp'.
 +
&Dagger;(no wikilink)
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;
 +
&nbsp;</pre>
  
−
Branch Person's Name:
+
|}
−
Branch Location:
 
−
Clearway No: 
 
−
Id & V'd By Branch:yes
 
−
Daily P/w Confmd:yes
 
−
CIS Number:
 
−
Query:
 
−
Action:
 
−
Outcome:Resolved
 
  
−
CC Person's Name:
+
† This is the preferred field with its alternates listed below.  
−
CC Location:
 
−
Turret No:
 
−
Id & V'd By CC:yes
 
−
Daily P/w Confmd:yes
 
−
CIS Number:
 
−
Query:
 
−
Action:
 
−
Outcome:Resolved.  
 
  
−
ID only
+
&Dagger; If '''chapterurl''' is provided then '''chapter''' can not have wikilinks.
−
s/c a/c:
 
−
Query:
 
−
Action:Handoff CT as non olb query
 
−
Outcome:Handoff CT
 
  
−
**FAILED SECURITY**
+
==Fields==
−
ID & V Failed
+
===Wikilinks===
−
s/c a/c:
+
Most fields can be wikilinked (i.e. ''title'' = <nowiki>[[book article|book title]]</nowiki>), but should generally only be linked to an existing Wikipedia article. Any wikilinked field '''must not''' contain any brackets apart from normal round brackets <code>()</code> &mdash; don't use <code><nowiki><>[]{}</nowiki></code>.
−
Query:
 
−
Action:Cust failed security...Referred cust to branch with 2 pieces of identification
 
−
Outcome:Refer to Br.  
 
  
−
**NON MEMBER CALL**
+
===Description of fields===
−
s/c a/c :  
+
====<small>Syntax (for the technical-minded)</small>====
−
Query :  
+
<div style="font-size: 90%;">
−
Action: Membership suspended, Please send non member letter
+
Nested fields either rely on their parent fields, or replace them:
−
Outcome: Assigned to non member worklist
+
*''parent''
 +
**''child'' &mdash; may be used '''with''' ''parent'' (and is ignored if ''parent'' is not used)
 +
**OR: ''child2'' &mdash; may be used '''instead''' of ''parent'' (and is ignored if ''parent'' is used)
 +
</div>
  
−
**NON MEMBER CALL WITH PINSENTRY**
+
====Description====
−
s/c a/c :  
+
*'''last''': Surname of author. Don't wikilink (use ''authorlink'' instead).
−
Query :  
+
**'''first''': 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).
−
Action: Checked the details...confirmed the last 4 digits of the debit card...also had access to the debit card pin.. Membership suspended...trf to Onshore
+
***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).
−
Outcome: trf to Onshore
+
**'''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, 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_styles|citation style]] section below) preferred.
 +
*OR: '''author''': Full name of author, preferably surname first. (deprecated)
 +
*OR: for multiple authors, use the fields '''first1''', '''last1''', ...,<b>first''n'', last''n''</b> 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). 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.
 +
*OR: alternatively '''editor-first''' and '''editor-last''' can be used.
 +
*OR: for multiple editors up to four in number, use the fields '''editor1-first''', '''editor1-last''', ...,<b>editor''n''-first, editor''n''-last</b> to 'correctly' record all the information about the book.
 +
**'''editor-link''' or '''editor1-link'''...<b>editor''n''-link</b> is used in the same way as "authorlink".
 +
**The "editor" field and its alternates should only be used when the cited author(s) and the book editor(s) are different. If the whole book is cited, instead of a specific part, use the "author" fields (possibly with extra "(ed.)" instead)
 +
*'''others''': To record other contributors to the work, 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 Wikipedia article. Do not use italics.
 +
*'''url''': URL of an online location where the book can be found. Cannot be used if you wikilinked ''title''. If applicable, can point to the specific page(s) referenced.
 +
**'''format''': Format, e.g. PDF. HTML implied if not specified.
 +
**'''accessdate''': Full date when url was accessed. '''Required when ''url'' field is used.''' Must not be wikilinked.
 +
*'''edition''': When the book has more than one edition. ''e.g.:'' "2nd." (note that " ed." is placed after this field, so <code>edition=2nd</code> 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 {{tl|Cite encyclopedia}} template).
 +
*'''date''': Full date of publication edition being referenced, in the same format as the main text of the article. Must not be wikilinked.
 +
*OR:  '''year''': Year of publication edition being referenced, and '''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 specify as much information as possible, for instance "First published 1859" or "Composed 1904". This parameter only displays if a 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.
 +
*'''isbn''': [[International Standard Book Number]] such as ''1-111-22222-9''.  Note that "isbn", like all field names, must be in lowercase.
 +
*'''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581''
 +
*'''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''.
 +
*'''bibcode''': A nineteen character [[Bibcode]] identifier.
 +
*'''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 {{tl|ASIN}} or {{tl|ISSN}}.  (Use one of the more specialized parameters if possible; they are linked automatically.  In other words, don't use ''<nowiki>id = ISBN 1-111-22222-9</nowiki>'' anymore.  Use ''isbn = 1-111-22222-9''.)
 +
*'''pages''' or '''page''': "<code>|pages= 5–7</code>" produces pp. 5–7, while "<code>|page= 5</code>" 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. These parameters are for listing the pages relevant to the citation, ''not'' the total number of pages in the book.
 +
**'''nopp''': using "page" or "pages", automatically places the p. or pp. notations. If this is inappropriate—for instance, if <code>page=Front cover</code>, placing any value after <code>nopp</code> will hide the p. or pp. notation.
 +
*'''chapter''': The chapter of the book, written in full. Punctuation other than quotes should be included in the value passed to the parameter, e.g. ''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.
 +
*'''ref''': use this parameter to make the reference linkable. The variable is placed after the # in a hyperlink (the [[fragment identifier]]). Such a linkable reference can be made the target of [[Wikipedia:Citing sources/Further considerations#Wikilinks to full_references|wikilinks to full references]], especially useful in short citations like [[Wikipedia:Citing sources#Shortened footnotes|shortened notes]] and [[Wikipedia:Author-date referencing|author-date referencing]]. See an [[#Examples|example]] for using ref field in citation templates below.
 +
*'''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.
 +
*'''postscript''': The closing punctuation for the citation. Defaults to ".", but "" may be useful also.
 +
*'''lastauthoramp''': The separator to use between the last two names in lists of authors.  Defaults to "", but "&amp;" may be useful also.
  
−
**ADD BUSINESS TO PERSONAL**
+
==Examples==
−
Query: Need to Add Business CIS to the Existing Membership.
+
;Just a title:
−
Action: Checked the details...checked that the business is not there on the existing membership no....hence added the CIS to memship no....on branch request
+
:<code><nowiki>* {{cite book | title=Mysterious book }}</nowiki></code>
−
CIS Name:
 
−
CIS Number:
 
−
Sort Code:
 
−
Account No:
 
−
advied that the cust will be able to see the business on his OLB
 
  
−
**REGISTER FOR OLB WITH PASSCODE**
+
:*{{cite book | title = Mysterious book }}
−
ID & V ok
 
−
s/c a/c :
 
−
Query: Cus unable to register for olb/ Cus wants to register fr olb.
 
−
Action: Checked details.... confirmed address ... captured cust email address...advised the mem word...Demo link.
 
−
Outcome:Resolved.
 
  
−
**REGISTER FOR OLB WITH PINSENTRY**
+
;Year and title:
−
ID & V ok
+
:<code><nowiki>* {{cite book | title=Mysterious book | year=1901 }}</nowiki></code>
−
s/c a/c :  
 
−
Query: Cus unable to register for olb/ Cus wants to register fr olb.
 
−
Action: Checked details.... confirmed address ... captured cust email address...registered the cust with Pinsentry....Security link
 
−
Outcome:Resolved.
 
  
−
**CUST ALREADY REGISTERED FOR OLB**
+
:*{{cite book | title = Mysterious book | year = 1901 }}
−
ID & V ok
 
−
s/c a/c :
 
−
Query: Cust wants membership details
 
−
Action: Checked the details....Informed the cust that already reg for
 
−
olb.. Gave mem no ...also checked address ... ordered  a passcode... advice mem word....Demolink
 
−
Outcome:Resolved.
 
  
−
**ORDER PASSCODE**
+
;Basic usage:
−
ID & V ok
+
:<code><nowiki>* {{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}</nowiki></code>
−
s/c a/c :  
 
−
Query: Cust unable to login to olb /Cus wnts passcode for olb.
 
−
Action: Checked the details...Cust locked out of olb.....Checked address...order passcode and advice mem word...Demo link
 
−
Outcome:Resolved
 
  
−
** CUST WANTS THE MEMBERSHIP NO**
+
:*{{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
−
ID & V ok
 
−
s/c a/c :
 
−
Query: Cus wnts to have the memship no.
 
−
Action: Gave the memship no ...Save membership no
 
−
Outcome:Resolved.
 
  
−
**INSTANT ACESS LATER**
+
;Basic usage with url:
−
Checked address and Advise the cust about Instant Access procedure to
+
:<code><nowiki>* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs | edition=1st | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}</nowiki></code>
−
order passcode online..advise mem word as the cust will order it later....Demo link
 
  
−
**CUST IS NOT ABLE TO LOG IN WITH PINSENTRY**
+
:*{{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs | edition=1st | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
−
Id & V ok
 
−
s/c a/c :
 
−
Query: cust was not able to log in
 
−
Action: Checked the details....cust was locked out of OLB....reset the fail count...save membership no....checked the cards....cust was able to log in
 
−
Outcome: All resolved
 
  
−
**CUST IS NOT ABLE TO LOG IN WITH PINSENTRY GETTING EC 1100**
+
;Three authors, title with a piped wikilink, edition
−
Id & V ok
+
:<code><nowiki>* {{cite book | last1=Bloggs | first1=Joe | authorlink=Joe Bloggs | first2=John | last2=Smith | first3=Jim | last3=Smythe | title=[[A Thousand Acres|1000 Acres]] | edition=2nd }}</nowiki></code>
−
s/c a/c :
 
−
Query: cust was locked out of OLB
 
−
Action: Checked the details....cust was locked out of OLB...reset the fail count...save membership no....checked the cards....cust was not able to log in...getting EC 1100...also getting a fail count...trf to Onshore
 
−
Outcome: Trf to Onshore
 
  
−
**SCAM EMAIL NOT REPLIED**
+
:*{{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}}
−
ID only
 
−
s/c a/c :
 
−
Query: Customer received scam email but not replied.
 
−
Action: Advised cust. to forward it to internetsecurity@barclays.co.uk &
 
−
delete the mail from the system...also to run an anti virus....gave fraud disclaimer
 
−
Outcome: Resolved
 
  
−
**NAME AMEND**
+
;Complex usage showing effect of using volume parameter
−
ID & V ok
+
:Without volume parameter:
−
s/c a/c :
+
:<code><nowiki>*{{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-Marshall 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|lastauthoramp=y}}</nowiki></code>
−
Query: Cust called to inform surname changed.  
+
:*{{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-Marshall 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|lastauthoramp=y}}
−
Action:Checked the details..... also checked the maiden name... Updated the name on M.T.and R.B.....i name my a/c 
 
−
Outcome:Resolved
 
  
−
**MISSING PAYMENT**
+
:With volume parameter:
−
Query: Cust had made a payment which the beneficiary did not recived
+
:<code><nowiki>*{{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-Marshall 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}}</nowiki></code>
−
Action: Checked the details...checked that not a barclays payment...also checked that the payment has not reverted back in the a/c...advised the cust that can setup a trace.  
+
*{{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-Marshall 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}}
−
***********************************************************************
 
−
Is this the membership number used to make the payment : YES
 
−
 
 
−
Name of the beneficiary the payment should have gone to:
 
−
Beneficiary phone number:
 
−
Beneficiary contact name (for companies):
 
−
Sortcode and Account number debited:  
 
−
Sortcode and Account number credited (if known):  
 
−
Name of account credited (if known):
 
−
Sortcode and Account number the payment should have gone to:
 
−
Reference used:
 
−
Correct Reference should have used:
 
−
Payment amount: £
 
−
Date payment debited a/c:
 
−
Was this a future-dated or immediate payment? IMMEDIATE / DIARISED
 
−
If future dated when was payment set up ?
 
−
***********************************************************************
 
−
CUSTOMER CONTACT DETAILS -  
 
−
Phone number(But do not promise a call back):                        
 
−
Gave the call reference to customer.
 
  
−
Outcome:Assign to Payments Worklist
+
;Date without day, wikilinked title and publisher, id, pages, location
 +
:<code><nowiki>* {{cite book | last=Cordell | first=Bruce R. | coauthors=Jeff Grubb, David Noonan | year=2001 | month=September | title=[[Manual of the Planes]] | publisher=[[Wizards of the Coast]] | location=Timbuktu | isbn=0-7869-1850-8 | pages= 134-137 }}</nowiki></code>
  
 +
:*{{cite book | last=Cordell | first=Bruce R. | coauthors=Jeff Grubb, David Noonan | year=2001 | month=September | title=[[Manual of the Planes]] | publisher=[[Wizards of the Coast]] | location=Timbuktu | isbn=0-7869-1850-8 | pages= 134-137}}
  
−
**HAND OFF ATM**
+
;Other language
−
ID & V ok                     
+
:<code><nowiki>* {{cite book | last=Bloggs | first=Joe | year=1974 | title=Book of Bloggs | edition=1st | language=German | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}</nowiki></code>
−
s/c a/c: ,203200,40521914
+
 
−
Query: Cust had locked her pin with the card reader
+
:*{{cite book | last=Bloggs | first=Joe | year=1974 | title=Book of Bloggs | edition=1st | language=German | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
−
Action: checked the details....cust had locked her pin with pinsentry....hand off ATM
+
 
−
Outcome: hand off ATM
+
;Using a [[Digital object identifier|DOI]]
 +
:<code><nowiki>*{{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
 +
}}</nowiki></code>
 +
 
 +
:*{{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
 +
}}
 +
 
 +
;[[Wikipedia:Citing sources/Further_considerations#Wikilinks_to_full_references|Wikilinks to full references]]:
 +
:As mentioned, the bibliographical data of the cited source can be “tagged” by an identifier: this enables the system to “find” the target of the wikilinks. This “tagging” with an identifier can be done by enclosing between <nowiki><cite id=…>…</cite></nowiki> tags, but this tool can be superfluous if the bibliographical data are provided with a citation template: the <tt>ref</tt> field of the chosen citation template must be set to the same name.
 +
 
 +
:Wikilink example edit:
 +
<blockquote style="border:1px solid DarkSeaGreen; padding:1em; color:#999; background:white">
 +
<tt>
 +
Shamans may fulfill multiple functions, including healing, curing infertile women, and securing the success of hunts.<span style="color:black;">&lt;ref>'''<nowiki>[</nowiki>[#Mer85|'''Merkur 1985''']]''': 4&lt;/ref></span>
 +
<br>
 +
<br>
 +
<span style="color:#666;">&#61;= Notes ==</span>
 +
<br>
 +
<br>
 +
<span style="color:black;"><nowiki>{{reflist|2}}</nowiki></span>
 +
<br>
 +
<br>
 +
<span style="color:#666;">&#61;= References ==</span>
 +
<br>
 +
<br>
 +
<nowiki>* {{cite book |last=Merkur |first=Daniel |year=1985 |title=Becoming Half Hidden: Shamanism and Initiation among the Inuit |publisher=Almqvist & Wiksell |location=Stockholm |isbn=91-22-00752-0</nowiki> '''<font color=red>|ref=Mer85</font>'''<nowiki>}}</nowiki>
 +
</tt>
 +
</blockquote>
 +
 
 +
:Example rendered result:
 +
<blockquote style="border:1px solid #999; padding:1em; background:white">
 +
Shamans may fulfill multiple functions, including healing, curing infertile women, and securing the success of hunts.<sup id="shaman_function" class="reference">[[#Mer85_4|[1]]]</sup>
 +
<br>
 +
<br>
 +
<font size=3>
 +
<b>
 +
Notes
 +
</b>
 +
</font>
 +
----
 +
<div class="references-small" style="-moz-column-count:2; -webkit-column-count:2; column-count:2;">
 +
<ol class="references">
 +
<li id="Mer85_4">
 +
<b>
 +
[[#shaman_function|^]]
 +
</b>
 +
[[#Mer85|Merkur 1985]]: 4
 +
</li>
 +
</ol>
 +
</div>
 +
<br>
 +
<font size=3><b>References</b></font>
 +
----
 +
* {{cite book |last=Merkur |first=Daniel |year=1985 |title=Becoming Half Hidden: Shamanism and Initiation among the Inuit |publisher=Almqvist & Wiksell |location=Stockholm |isbn=91-22-00752-0 |ref=Mer85}}
 +
</blockquote>
 +
 
 +
:Attention must be paid: not all other citation templates support this. In such cases, the service can be achieved also by enclosing the concerned bibliographical item inside <tt><nowiki><cite id=…>…</cite></nowiki></tt> tags: also this way, it can feature as a target of [[Wikipedia:Citing sources/Further considerations#Wikilinks to full_references|Wikilinks to full references]]. The <tt>id</tt> attribute of the tag must be set to the same name what we would give to the (lacking) <tt>ref</tt> field of the citation template.
 +
 
 +
==Testing==
 +
See [[Template:cite book/regression tests]].
 +
 
 +
==Note==
 +
Note the extra full-stop when the last author ends with an initial, and there is no date:
 +
*{{cite book | last = Invisible | first = M. | title = Mysterious book }}
 +
We don't know of a practical solution to this &mdash; unless there is a way to test the characters of a field?
 +
 
 +
==Citation styles==
 +
Established citation styles for coauthors:
 +
 
 +
*[http://www.english.uiuc.edu/cws/wworkshop/writer_resources/citation_styles/mla/mla.htm 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''."
 +
*[http://www.english.uiuc.edu/cws/wworkshop/writer_resources/citation_styles/apa/apa.htm APA style]: Last, F. & Last, F.
 +
*[http://www.liunet.edu/cwis/cwp/library/workshop/citchi.htm Chicago Manual of Style]: Last, First, and First Last.
 +
*[http://www.liunet.edu/cwis/cwp/library/workshop/cittur.htm Turabian]: same as Chicago Reference List, above.
 +
*[http://www.library.uq.edu.au/training/citation/harvard.html Harvard]: Last, F., Last, F. & Last, F.
 +
 
 +
==COinS==
 +
{{UF-COinS}}
 +
 
 +
==Tools==
 +
See [[Wikipedia:Citing sources#Tools]] for a list of tools which can help create a reference in the 'cite book' format.
 +
 
 +
==See also==
 +
*[[Wikipedia:Citing sources]]: Style guide
 +
*[[Wikipedia:Citation templates]]: Related templates
 +
*[[Wikipedia:WikiProject Wikicite]]
 +
*[[:Category:Citation templates]]
 +
 
 +
<includeonly>
 +
[[Category:Citation templates|{{PAGENAME}}]]
 +
[[Category:Book templates|{{PAGENAME}}]]
 +
 
 +
[[bg:Шаблон:Cite book]]
 +
[[id:Templat:Cite book]]
 +
[[ca:Plantilla:Ref-llibre]]
 +
[[cs:Šablona:Citace knihy]]
 +
[[de:Vorlage:Literatur]]
 +
[[el:Πρότυπο:Cite book]]
 +
[[es:Plantilla:Cita libro]]
 +
[[eo:Ŝablono:Citu libron]]
 +
[[eu:Txantiloi:Liburu erreferentzia]]
 +
[[fr:Modèle:Ouvrage]]
 +
[[ko:틀:서적 인용]]
 +
[[ia:Patrono:Cite book]]
 +
[[it:Template:Cita libro]]
 +
[[hu:Sablon:Cite book]]
 +
[[mk:Шаблон:Книга]]
 +
[[ja:Template:Cite book]]
 +
[[ka:თარგი:Cite book]]
 +
[[nl:Template: citeer boek]]
 +
[[no:mal:Kilde bok]]
 +
[[pms:Template:Cité un lìber]]
 +
[[pl:Szablon:Cytuj książkę]]
 +
[[pl:Szablon:Cite book]]
 +
[[pt:Predefinição:Ref-livro]]
 +
[[ro:Format:Cite book]]
 +
[[ru:Шаблон:Книга]]
 +
[[sk:Šablóna:Cite book]]
 +
[[sl:Predloga:Cite book]]
 +
[[fi:Malline:Kirjaviite]]
 +
[[sv:Mall:Bokref]]
 +
[[vi:Tiêu bản:Chú thích sách]]
 +
[[zh-yue:Template:引書]]
 +
[[zh:Template:Cite book]]
 +
</includeonly>

Revision as of 13:27, 7 April 2009

Script error: No such module "Message box". Template:Important This is balls: |doi= |bibcode= |id= |page= |pages= |nopp= |chapter= |chapterurl= |quote= |ref= |laysummary= |laydate= |separator= |postscript= |lastauthoramp=

}} | style="vertical-align:top;padding:1ex;" |

   
  
 last
 last 
 last  
   
  
  
  
 editorn-last
 editor or editor-last
 editorn or editorn-last
  
  
  
 url
 url
  
  
  
  
 year or date
  
 year
  
 publisher
  
  
  
  
  
  
  
  
 page or pages
  
 chapter
  
  
  
 laysummary
  
  
 coauthors or >1 lastn
  

| style="vertical-align:top;padding:1ex;" |

   
 (no wikilink)
 (no wikilink)
  
 alternative to first2, last2...first9, last9
 (no wikilink). n=1 through 9
  
 n=1 through 4
 n=1 through 4
 n=1 through 4
 n=1 through 4
 n=1 through 4
  
  
  
  
  
  
  
  
 †preferred (no wikilink)
  
  alternative to date
  
  
  
  
  
  
  
  
  
  
  
 hides automatic 'p' or 'pp'.
 ‡(no wikilink)
  
  
  
  
  
  
  
  
  

|}

† 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 (i.e. title = [[book article|book title]]), but should generally only be linked to an existing Wikipedia 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) (e.g. 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, 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)
  • 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). 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.
  • OR: alternatively editor-first and editor-last can be used.
  • 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.
    • editor-link or editor1-link...editorn-link is used in the same way as "authorlink".
    • The "editor" field and its alternates should only be used when the cited author(s) and the book editor(s) are different. If the whole book is cited, instead of a specific part, use the "author" fields (possibly with extra "(ed.)" instead)
  • others: To record other contributors to the work, 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 Wikipedia article. Do not use italics.
  • url: URL of an online location where the book can be found. Cannot be used if you wikilinked title. If applicable, can point to the specific page(s) referenced.
    • format: Format, e.g. PDF. HTML implied if not specified.
    • accessdate: Full date when url was accessed. Required when url field is used. Must not be wikilinked.
  • edition: When the book has more than one edition. e.g.: "2nd." (note that " ed." is placed 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).
  • date: Full date of publication edition being referenced, in the same format as the main text of the article. Must not be wikilinked.
  • OR: year: Year of publication edition being referenced, and 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 specify as much information as possible, for instance "First published 1859" or "Composed 1904". This parameter only displays if a 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.
  • isbn: International Standard Book Number such as 1-111-22222-9. Note that "isbn", like all field names, must be in lowercase.
  • oclc: Online Computer Library Center ID number, such as 3185581
  • doi: A digital object identifier such as 10.1016/j.coi.2004.08.001.
  • bibcode: A nineteen character Bibcode identifier.
  • 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 anymore. Use isbn = 1-111-22222-9.)
  • pages or page: "|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. These parameters are for listing the pages relevant to the citation, not the total number of pages in the book.
    • 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 after nopp will hide the p. or pp. notation.
  • chapter: The chapter of the book, written in full. Punctuation other than quotes should be included in the value passed to the parameter, e.g. 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.
  • ref: use this parameter to make the reference linkable. The variable is placed after the # in a hyperlink (the fragment identifier). Such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and author-date referencing. See an example for using ref field in citation templates below.
  • 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.
  • postscript: The closing punctuation for the citation. Defaults to ".", but "" may be useful also.
  • lastauthoramp: The separator to use between the last two names in lists of authors. Defaults to "", but "&" may be useful also.

Examples

Just a title
* {{cite book | title=Mysterious book }}
  • Mysterious book.
Year and title
* {{cite book | title=Mysterious book | year=1901 }}
  • Mysterious book. 1901.
Basic usage
* {{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
Basic usage with url
* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs | edition=1st | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
Three authors, title with a piped wikilink, edition
* {{cite book | last1=Bloggs | first1=Joe | authorlink=Joe Bloggs | first2=John | last2=Smith | first3=Jim | last3=Smythe | title=[[A Thousand Acres|1000 Acres]] | edition=2nd }}
Complex usage showing effect of using volume parameter
Without volume parameter:
*{{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-Marshall 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|lastauthoramp=y}}
  • Playfair, Major-General I.S.O.; Stitt, Commander G.M.S; Molony, Brigadier C.J.C. & Toomer, Air Vice-Marshall S.E. (2007) [1st. pub. HMSO:1954]. Butler, J.R.M. ed. Mediterranean and Middle East. Volume I: The Early Successes Against Italy (to May 1941). History of the Second World War, United Kingdom Military Series. Uckfield, UK: Naval & Military Press. Template:Hide in printTemplate:Only in print.
With volume parameter:
*{{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-Marshall 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}}
  • Playfair, Major-General I.S.O.; Stitt, Commander G.M.S; Molony, Brigadier C.J.C. & Toomer, Air Vice-Marshall S.E. (2007) [1st. pub. HMSO:1954]. Butler, J.R.M. ed. Mediterranean and Middle East. History of the Second World War, United Kingdom Military Series. Volume I: The Early Successes Against Italy (to May 1941). Uckfield, UK: Naval & Military Press. Template:Hide in printTemplate:Only in print.
Date without day, wikilinked title and publisher, id, pages, location
* {{cite book | last=Cordell | first=Bruce R. | coauthors=Jeff Grubb, David Noonan | year=2001 | month=September | title=[[Manual of the Planes]] | publisher=[[Wizards of the Coast]] | location=Timbuktu | isbn=0-7869-1850-8 | pages= 134-137 }}
Other language
* {{cite book | last=Bloggs | first=Joe | year=1974 | title=Book of Bloggs | edition=1st | language=German | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
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 }}
Wikilinks to full references
As mentioned, the bibliographical data of the cited source can be “tagged” by an identifier: this enables the system to “find” the target of the wikilinks. This “tagging” with an identifier can be done by enclosing between <cite id=…>…</cite> tags, but this tool can be superfluous if the bibliographical data are provided with a citation template: the ref field of the chosen citation template must be set to the same name.
Wikilink example edit:

Shamans may fulfill multiple functions, including healing, curing infertile women, and securing the success of hunts.<ref>[[#Mer85|Merkur 1985]]: 4</ref>

== Notes ==

{{reflist|2}}

== References ==

* {{cite book |last=Merkur |first=Daniel |year=1985 |title=Becoming Half Hidden: Shamanism and Initiation among the Inuit |publisher=Almqvist & Wiksell |location=Stockholm |isbn=91-22-00752-0 |ref=Mer85}}

Example rendered result:

Shamans may fulfill multiple functions, including healing, curing infertile women, and securing the success of hunts.[1]

Notes

  1. ^ Merkur 1985: 4


References

Attention must be paid: not all other citation templates support this. In such cases, the service can be achieved also by enclosing the concerned bibliographical item inside <cite id=…>…</cite> tags: also this way, it can feature as a target of Wikilinks to full references. The id attribute of the tag must be set to the same name what we would give to the (lacking) ref field of the citation template.

Testing

See Template:cite book/regression tests.

Note

Note the extra full-stop when the last author ends with an initial, and there is no date:

  • Invisible, M.. Mysterious book.

We don't know of a practical solution to this — unless there is a way to test the characters of a field?

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.

COinS

Template:UF-COinS

Tools

See Wikipedia:Citing sources for a list of tools which can help create a reference in the 'cite book' format.

See also


Retrieved from "https://wiki.pathfindersonline.org/index.php?title=Template:Cite_book/doc&oldid=56979"