Template:Cite book/doc - Revision history

Shawndouglas: Removed separator

2021-07-31T17:40:33Z

Removed separator

← Older revision		Revision as of 17:40, 31 July 2021
Line 14:		Line 14:
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	\| colspan="3" \|		\| colspan="3" \|
	:<code><nowiki>{{cite book \|last1= \|first1= \|authorlink1= \|last2= \|first2= \|authorlink2= \|editor1-first= \|editor1-last= \|editor1-link= \|others= \|title= \|trans_title= \|url= \|archiveurl= \|archivedate= \|format= \|accessdate= \|type= \|edition= \|series= \|volume= \|date= \|year= \|month= \|origyear= \|publisher= \|location= \|language= \|isbn= \|oclc= \|doi= \|id= \|page= \|pages= \|at= \|trans_chapter= \|chapter= \|chapterurl= \|quote= \|ref= \|bibcode= \|laysummary= \|laydate~~= \|separator~~= \|postscript= \|lastauthoramp=}}</nowiki></code>		:<code><nowiki>{{cite book \|last1= \|first1= \|authorlink1= \|last2= \|first2= \|authorlink2= \|editor1-first= \|editor1-last= \|editor1-link= \|others= \|title= \|trans_title= \|url= \|archiveurl= \|archivedate= \|format= \|accessdate= \|type= \|edition= \|series= \|volume= \|date= \|year= \|month= \|origyear= \|publisher= \|location= \|language= \|isbn= \|oclc= \|doi= \|id= \|page= \|pages= \|at= \|trans_chapter= \|chapter= \|chapterurl= \|quote= \|ref= \|bibcode= \|laysummary= \|laydate= \|postscript= \|lastauthoramp=}}</nowiki></code>
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	! colspan="3" \| Most commonly used fields (use this and you won't have to delete as much)		! colspan="3" \| Most commonly used fields (use this and you won't have to delete as much)
Line 106:		Line 106:
	\| laysummary =		\| laysummary =
	\| laydate =		\| laydate =
	~~\| separator =~~
	\| postscript =		\| postscript =
	\| lastauthoramp =		\| lastauthoramp =
Line 288:		Line 287:
	*'''laysummary''': Link to a non-technical summary (or review) of the book		*'''laysummary''': Link to a non-technical summary (or review) of the book
	**'''laydate''': Date of summary		**'''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., {{para\|display-authors\|2}}); alternatively, the "''et al.''" may be suppressed by the use of {{para\|display-authors\|9}}.		*'''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., {{para\|display-authors\|2}}); alternatively, the "''et al.''" may be suppressed by the use of {{para\|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 {{para\|quote}} is specified.		*'''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 {{para\|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.

	==Examples==		==Examples==

Shawndouglas: Removed coauthors

2021-07-31T15:00:33Z

Removed coauthors

← Older revision		Revision as of 15:00, 31 July 2021
Line 14:		Line 14:
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	\| colspan="3" \|		\| colspan="3" \|
	:<code><nowiki>{{cite book \|last1= \|first1= \|authorlink1= \|last2= \|first2= \|authorlink2~~= \|coauthors~~= \|editor1-first= \|editor1-last= \|editor1-link= \|others= \|title= \|trans_title= \|url= \|archiveurl= \|archivedate= \|format= \|accessdate= \|type= \|edition= \|series= \|volume= \|date= \|year= \|month= \|origyear= \|publisher= \|location= \|language= \|isbn= \|oclc= \|doi= \|id= \|page= \|pages= \|at= \|trans_chapter= \|chapter= \|chapterurl= \|quote= \|ref= \|bibcode= \|laysummary= \|laydate= \|separator= \|postscript= \|lastauthoramp=}}</nowiki></code>		:<code><nowiki>{{cite book \|last1= \|first1= \|authorlink1= \|last2= \|first2= \|authorlink2= \|editor1-first= \|editor1-last= \|editor1-link= \|others= \|title= \|trans_title= \|url= \|archiveurl= \|archivedate= \|format= \|accessdate= \|type= \|edition= \|series= \|volume= \|date= \|year= \|month= \|origyear= \|publisher= \|location= \|language= \|isbn= \|oclc= \|doi= \|id= \|page= \|pages= \|at= \|trans_chapter= \|chapter= \|chapterurl= \|quote= \|ref= \|bibcode= \|laysummary= \|laydate= \|separator= \|postscript= \|lastauthoramp=}}</nowiki></code>
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	! colspan="3" \| Most commonly used fields (use this and you won't have to delete as much)		! colspan="3" \| Most commonly used fields (use this and you won't have to delete as much)
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	\| colspan="3" \|		\| colspan="3" \|
	:<code><nowiki>{{cite book \|title= \|last= \|first= \|authorlink~~= \|coauthors~~= \|year= \|publisher= \|location= \|isbn= \|page= \|pages= \|url= \|accessdate=}}</nowiki></code>		:<code><nowiki>{{cite book \|title= \|last= \|first= \|authorlink= \|year= \|publisher= \|location= \|isbn= \|page= \|pages= \|url= \|accessdate=}}</nowiki></code>
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	! Example 1		! Example 1
	\| style="vertical-align: top;" \|<pre style="margin:0px; white-space:normal;">		\| style="vertical-align: top;" \|<pre style="margin:0px; white-space:normal;">
	{{cite book \|last= Cordell \|first= Bruce R. ~~\|coauthors= Jeff Grubb, David Yu~~ \|title= [[Manual of the Planes]] \|publisher= [[Wizards of the Coast]] \|year= 2001 \|month= September \|isbn= 0-7869-1850-8}}		{{cite book \|last= Cordell \|first= Bruce R. \|title= [[Manual of the Planes]] \|publisher= [[Wizards of the Coast]] \|year= 2001 \|month= September \|isbn= 0-7869-1850-8}}
	</pre>		</pre>
	\| style="vertical-align: top;" \|		\| style="vertical-align: top;" \|
	{{cite book \|last= Cordell \|first= Bruce R. ~~\|coauthors= Jeff Grubb, David Yu~~ \|title= [[Manual of the Planes]] \|publisher= [[Wizards of the Coast]] \|year= 2001 \|month= September \|isbn= 0-7869-1850-8}}		{{cite book \|last= Cordell \|first= Bruce R. \|title= [[Manual of the Planes]] \|publisher= [[Wizards of the Coast]] \|year= 2001 \|month= September \|isbn= 0-7869-1850-8}}
	\|- style="vertical-align:top;"		\|- style="vertical-align:top;"
	! Example 2		! Example 2
Line 64:		Line 64:
	\| authormask =		\| authormask =
	\| authorlink =		\| authorlink =
	~~\| coauthors =~~
	\| firstn = \| lastn =		\| firstn = \| lastn =
	\| authorn-link =		\| authorn-link =
Line 162:		Line 161:


	~~coauthors or >1 lastn~~

	</pre>		</pre>
Line 243:		Line 241:
	**{{AuthorMask doc}} See [[#Examples\|Examples]] for typical usage.		**{{AuthorMask doc}} See [[#Examples\|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''.		**'''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_styles\|citation style]] section below) preferred.		***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) Don't wikilink (use ''authorlink'' instead).		*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''', ...,<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). Don't wikilink as there are corresponding '''authorlink1''', ..., '''authorlink9''' fields as well~~. This usage is preferred to the use of '''coauthors'''~~.		*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). Don't wikilink as there are corresponding '''authorlink1''', ..., '''authorlink9''' fields as well.
	*'''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.		*'''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: alternatively '''editor-first''' and '''editor-last''' can be used in the same way as ''first'' and ''last''.
Line 327:		Line 325:
	:*{{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}}		:*{{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}}
	;Date without day, wikilinked title and publisher, id, pages, location		;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>		:<code><nowiki>* {{cite book \| last=Cordell \| first=Bruce R. \| 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}}		:*{{cite book \| last=Cordell \| first=Bruce R. \| 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		;Other language
	:<code><nowiki>* {{cite book \| last=Bloggs \| first=Jean \| year=1974 \| title=Livre de Bloggs \| edition=1st \| language=French\| trans_title=Book of Bloggs\| url=http://en.wikipedia.org/ \| accessdate=2006-02-17 }}</nowiki></code>		:<code><nowiki>* {{cite book \| last=Bloggs \| first=Jean \| year=1974 \| title=Livre de Bloggs \| edition=1st \| language=French\| trans_title=Book of Bloggs\| url=http://en.wikipedia.org/ \| accessdate=2006-02-17 }}</nowiki></code>
Line 437:		Line 435:
	:Following from [[Template_talk:Cite_web/Archive_5#accessmonthday_SNAFU_...\|this]] January 2009 discussion, and numerous others on that page, the parameters {{para\|accessyear}}, {{para\|accessmonthday}} and {{para\|accessdaymonth}} were found to be more trouble than they're worth. They were created in the days of date autoformatting to force a display in ymd or dmy format; now this is deprecated in favour of setting {{para\|dateformat}} in the template and passing the whole date in together as {{para\|accessdate}}. See [[Wikipedia:Bots/Requests_for_approval/MelonBot_12\|Requests for approval/MelonBot 12]] for more information.		:Following from [[Template_talk:Cite_web/Archive_5#accessmonthday_SNAFU_...\|this]] January 2009 discussion, and numerous others on that page, the parameters {{para\|accessyear}}, {{para\|accessmonthday}} and {{para\|accessdaymonth}} were found to be more trouble than they're worth. They were created in the days of date autoformatting to force a display in ymd or dmy format; now this is deprecated in favour of setting {{para\|dateformat}} in the template and passing the whole date in together as {{para\|accessdate}}. See [[Wikipedia:Bots/Requests_for_approval/MelonBot_12\|Requests for approval/MelonBot 12]] for more information.
	:As of February 2011, if any of {{para\|access-date}}, {{para\|accessday}}, {{para\|accessdaymonth}}, {{para\|accessmonth}}, {{para\|accessmonthday}}, {{para\|accessyear}}, {{para\|dateformat}}, or {{para\|day}} is used, then the page is listed in [[:Category:Pages containing cite templates with deprecated parameters]] and subject to correction by [[User:MelonBot]].		:As of February 2011, if any of {{para\|access-date}}, {{para\|accessday}}, {{para\|accessdaymonth}}, {{para\|accessmonth}}, {{para\|accessmonthday}}, {{para\|accessyear}}, {{para\|dateformat}}, or {{para\|day}} is used, then the page is listed in [[:Category:Pages containing cite templates with deprecated parameters]] and subject to correction by [[User:MelonBot]].

	~~==Citation styles==~~
	~~Established citation styles for coauthors:~~

	*[http://www.cws.illinois.edu/workshop/writers/citation/mla/index.html 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.cws.illinois.edu/workshop/writers/citation/apa/index.html 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]{{dl\|date=December 2009}}: Last, F., Last, F. & Last, F.

	==See also==		==See also==

Shawndouglas: Added category.

2011-06-03T01:25:00Z

Added category.

← Older revision		Revision as of 01:25, 3 June 2011
Line 454:		Line 454:
	* [[Template:Cite web short]]		* [[Template:Cite web short]]
	* [http://en.wikipedia.org/wiki/Wikipedia:Citing_sources Wikipedia:Citing sources]		* [http://en.wikipedia.org/wiki/Wikipedia:Citing_sources Wikipedia:Citing sources]

			[[Category:Citation templates]]

Shawndouglas: Added template to support citation documentation.

2011-06-03T00:15:30Z

Added template to support citation documentation.

Show changes