Difference between revisions of "Template:Harvrefcol/doc"

From blackwiki
Jump to navigation Jump to search
imported>Gadget850
(Gadget850 moved page Template:Harvrefcol/doc to Template:Cite LSA/doc: more clear name)
 
imported>Jonesey95
Line 1: Line 1:
#REDIRECT [[Template:Cite LSA/doc]]
+
{{Documentation subpage}}
 +
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 +
{{esoteric}}
 +
 
 +
This template creates citations using the [[Linguistic Society of America]] (LSA) style.
 +
 
 +
==Usage==
 +
:: The options that the template offers may seem a bit complicated at first. Don't worry. Most of them are optional. If a book is you want to reference is ''Volume 1'' or ''Volume 2'' of something, then use the|Vol option. If it isn't, then leave|Vol off. Rinse, lather, and repeat.
 +
 
 +
===Hyperlinks between citations & references===
 +
There are several ways to handle linking between citations in the text and references in the articles Reference section.
 +
* Link via Wikipedia link
 +
* Let the Harvard templates select the link ID.
 +
* Set the link ID yourself.
 +
If the ID of an existing link is unknown, use [[Wikipedia:Tools/Navigation_popups|Navigation popups]] to find it.
 +
===Reference to a book, one author===
 +
'''<nowiki>{{Harvrefcol|Surname=|Given=|Authorlink=|Year=|Title=|Place=|Publisher=|ID=|URL=}}</nowiki>'''
 +
 
 +
* '''Surname''' ('''Required'''): The author's surname or last name. (This parameter may also be called '''Last''').
 +
** '''Given''' (''optional''): The author's first or given name. In some reference styles, this should include only the initials. However, you can use the full name if you prefer (as I do). (This parameter may also be called '''First''' or '''Initials''').
 +
***'''Note''': To omit the first name, include the parameter, but do not define it, e.g |First=|. See "Minimal reference" in Examples section below.
 +
** '''Author''' (''optional''): While the ''Surname'' (or ''Last'') tag is mandatory for referencing purposes, use of the ''Author'' parameter will override how the author's name is displayed in the reference.
 +
* '''Authorlink''' (''optional''): Title of a Wikipedia article about author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
 +
* '''Year''' ('''Required'''): Year of publication.
 +
* '''Title''' (''optional''): Title of the book.
 +
* '''Edition''' (''optional''): Number or name of the edition, if not the first; for example: ''Edition=2nd''.
 +
* '''Place''' (''optional''): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: <code>Place=Paris, TX</code> (no period at the end).  Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter.
 +
* '''Publisher''' (''optional''): The name of the publisher. Omit terms such as ''Publishers'', ''Co.'', ''Inc.'', ''Ltd.'', etc., but retain the words ''Books'' or ''Press''.
 +
* '''ID''' (''optional''): Identifier such as ''<nowiki>ISBN 1-111-22222-9</nowiki>''
 +
** '''ISBN''' (''optional''): Use this parameter if the book has an ISBN. Another option would be to use the ISBN as |ID. In that case, a citation in the text of the article would use the ISBN number as the id for a hyperlink.
 +
* '''URL''' (''optional''): An [[url]] of an online location where the book can be found.
 +
* '''Access-date''' (''optional''): The date on which the [[url]] was last accessed.
 +
 
 +
===Reference to an article in a periodical, one author===
 +
'''<nowiki>{{Harvrefcol|Surname=|Given=|Authorlink=|Year=|Title=|Journal=|Volume=|Issue=|Pages=|URL=}}</nowiki>'''
 +
 
 +
* '''Surname''' ('''Required'''): The author's surname or last name. (This parameter may also be called '''Last''').
 +
** '''Given''' (''optional''): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called '''First''' or '''Initials''').
 +
** '''Author''' (''optional''): While the ''Surname'' (or ''Last'') tag is mandatory for referencing purposes, use of the ''Author'' parameter will override how the author's name is displayed in the reference.
 +
* '''Authorlink''' (''optional''): Title of a Wikipedia article about author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
 +
* '''Year''' ('''Required'''): Year of publication in the journal.
 +
* '''Title''' (''optional''): Title of the article.
 +
* '''Journal''' (''optional''): Name of the journal or periodical. (This parameter may also be called '''Periodical''').
 +
* '''Volume''' (''optional''): The volume number of the journal. (This parameter may also be called '''Vol''').
 +
* '''Issue''' (''optional''): The issue number of the journal. (This parameter may also be called '''Number''').
 +
* '''Pages''' (''optional''): The pages in the issue where the article may be found. (If the article is on only one page, use the parameter '''Page''' instead).
 +
* '''URL''' (''optional''): An [[url]] of an online location where the article can be found.
 +
* '''Access-date''' (''optional''): The date on which the [[url]] was last accessed.
 +
 
 +
===Reference to a contribution or chapter in a book, one author and one editor===
 +
'''<nowiki>{{Harvrefcol|Surname=|Given=|Authorlink=|Year=|Chapter=|Editor=|Title=|Place=|Publisher=|Pages=
 +
|ID=|URL=}}</nowiki>'''
 +
 
 +
* '''Surname''' ('''Required'''): The author's surname or last name. (This parameter may also be called '''Last''').
 +
** '''Given''' (''optional''): The author's first or given name. In some reference styles, this should include only the initials. However, you can use the full name if you prefer (as I do). (This parameter may also be called '''First''' or '''Initials''').
 +
** '''Author''' (''optional''): While the ''Surname'' (or ''Last'') tag is mandatory for referencing purposes, use of the ''Author'' parameter will override how the author's name is displayed in the reference.
 +
* '''Authorlink''' (''optional''): Title of a Wikipedia article about author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
 +
* '''Year''' ('''Required'''): Year of publication.
 +
* '''Chapter''' ('''Required for chapters'''): Title of the contribution in the book. (This parameter may also be called '''Contribution''').
 +
* '''Editor''' (''optional''): Name of the editor or editors.
 +
* '''Title''' ('''Required for chapters'''): Title of the book.
 +
* '''Edition''' (''optional''): Number or name of the edition, if not the first; for example: ''Edition=2nd''.
 +
* '''Place''' (''optional''): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: <code>Place=Paris, TX</code> (no period at the end).  Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter.
 +
* '''Publisher''' (''optional''): The name of the publisher. Omit terms such as ''Publishers'', ''Co.'', ''Inc.'', ''Ltd.'', etc., but retain the words ''Books'' or ''Press''.
 +
* '''Pages''' (''optional''): The pages in the book where the chapter or contribution may be found. (If the contribution is on only one page, use the parameter '''Page''' instead).
 +
* '''ID''' (''optional''): Identifier such as ''<nowiki>ISBN 1-111-22222-9</nowiki>''
 +
** '''ISBN''' (''optional''): Use this parameter if the book has an ISBN.
 +
* '''URL''' (''optional''): An [[url]] of an online location where the book can be found.
 +
* '''Access-date''' (''optional''): The date on which the [[url]] was last accessed.
 +
 
 +
===Book or periodical, multiple authors, up to four===
 +
'''<nowiki>{{Harvrefcol|Surname1=|Given1=|Authorlink1=|Surname2=|Given2=|Authorlink2=|Surname3=|Given3=
 +
|Authorlink3=|Surname4=|Given4=|Authorlink4=|Year=|Title=|Place=|Publisher=|ID=|URL=}}</nowiki>'''
 +
 
 +
* '''Surname1''' ('''Required'''): The first author's surname or last name. (This parameter may also be called '''Last1''').
 +
** '''Given1''' (''optional''): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called '''First1''' or '''Initials1''').
 +
***['''Note''': To omit the first name, include the parameter, but do not define it, e.g |First=|. See "Minimal reference" in Examples section below].
 +
** '''Author1''' (''optional''): While the ''Surname1'' (or ''Last1'') tag is mandatory for referencing purposes, use of the ''Author1'' parameter will override how the first author's name is displayed in the reference.
 +
* '''Authorlink1''' (''optional''): Title of a Wikipedia article about the first author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
 +
*Other authors: use ''Surname2'', ''Surname3'', etc.
 +
 
 +
===Examples===
 +
;Harvard references (books and journals):
 +
*For books: <nowiki>{{</nowiki>[[Template:Harvrefcol|Harvrefcol]]<nowiki>|Surname=Turner |Given=O.|Title=History of the Pioneer Settlement of Phelps and Gorham's Purchase, and Morris' Reserve|Publisher=William Alling|Place=[[Rochester, New York]]|Year=1851|URL=http://olivercowdery.com/texts/1851Trn1.htm#turn1851 }}.</nowiki>
 +
*For periodicals: <nowiki>{{</nowiki>[[Template:Harvrefcol|Harvrefcol]]<nowiki>|Surname=Smith|Given=J. III|Authorlink=Joseph Smith III|Title=Last Testimony of Sister Emma|Journal=The Saints' Herald|Volume=26|Issue=19|Year=1879|Page=289|URL=http://www.lavazone2.com/dbroadhu/IL/sain1872.htm#100179 }}.</nowiki>
 +
*Minimal reference: <nowiki>{{</nowiki>[[Template:Harvrefcol|Harvrefcol]]<nowiki>|Last=Jones|First=|Year=2006 }}.</nowiki>
 +
*Multiple authors: <nowiki>{{</nowiki>[[Template:Harvrefcol|Harvrefcol]]<nowiki>|Surname1=Lincoln|Given1=A.|Surname2=Washington|Given2=G.|Surname3=Adams |Given3=J. |Title=All the Presidents' Names|Publisher=The Pentagon|Place=Home Base, New York|Year=2007
 +
}}.</nowiki>
 +
 
 +
Citation examples, based on related citation template (automatically creates a one-directional link to the first matching Harvard reference on the same page):
 +
*<nowiki>{{</nowiki>[[Template:Harvcol|Harvcol]]<nowiki>|Turner|1851|pp=10-11}}</nowiki> (full cite format)
 +
*<nowiki>{{</nowiki>[[Template:Harvcol|Harvcol]]<nowiki>|Smith|1879|p=289}}</nowiki> (short format)
 +
*<nowiki>{{</nowiki>[[Template:Harvcol|Harvcol]]<nowiki>|Jones|2006|loc=section 5|Ref=none}}</nowiki> (non-linking)
 +
*<nowiki>{{</nowiki>[[Template:Harvcol|Harvcol]]<nowiki>|Lincoln|Washington|Adams|2007|pp=88-89}}</nowiki> (multi-author)
 +
 
 +
;Notes
 +
*Because the [[Harvard referencing]] style is based on ''Surname'' and ''Year'', these items are mandatory in both the citation and the reference.
 +
*If there is only one author, the parameters ''Surname'' and ''Given'' may be replaced with ''Last'' and ''First'', respectively.
 +
<!-- *Template is generally compatible with [[Template:Book reference]]. -->
 +
 
 +
===Results===
 +
*{{Harvrefcol|Surname=Turner|Given=O.|Title=History of the Pioneer Settlement of Phelps and Gorham's Purchase, and Morris' Reserve|Publisher=William Alling|Place=[[Rochester, New York]]|Year=1851|URL=http://olivercowdery.com/texts/1851Trn1.htm#turn1851 }}.
 +
*{{Harvrefcol|Surname=Smith|Given=J. III|Authorlink=Joseph Smith III|Title=Last Testimony of Sister Emma|Journal=The Saints' Herald|Volume=26|Issue=19|Year=1879|Pages=289-90|URL=http://www.lavazone2.com/dbroadhu/IL/sain1872.htm#100179 }}.
 +
*{{Harvrefcol|Last=Jones|First=|Year=2006}}.
 +
*{{Harvrefcol|Surname1=Lincoln|Given1=A.|Surname2=Washington|Given2=G.|Surname3=Adams|Given3=J.|Title=All the Presidents' Names|Publisher=The Pentagon|Place=Home Base, New York|Year=2007
 +
}}.
 +
----
 +
<!--
 +
*{{Harvcol|Turner|1851|pp=10-11}}
 +
*{{Harvcol|Smith|1879|p=289}}
 +
*{{Harvcol|Jones|2006|loc=section 5|Ref=none}}
 +
*{{Harvcol|Lincoln|Washington|Adams|2007|pp=88-89}}
 +
-->
 +
 
 +
===See also===
 +
* [[Wikipedia:Cite sources]]: Style guide
 +
* [[Wikipedia:Citation templates]]: Related templates
 +
 
 +
<includeonly>
 +
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
 +
[[Category:LSA style citation templates]]
 +
 
 +
[[ca:Plantilla:Harvrefcol]]
 +
[[fr:Modèle:Référence Harvard]]
 +
</includeonly>

Revision as of 04:43, 22 April 2015

This template creates citations using the Linguistic Society of America (LSA) style.

Usage

The options that the template offers may seem a bit complicated at first. Don't worry. Most of them are optional. If a book is you want to reference is Volume 1 or Volume 2 of something, then use the|Vol option. If it isn't, then leave|Vol off. Rinse, lather, and repeat.

Hyperlinks between citations & references

There are several ways to handle linking between citations in the text and references in the articles Reference section.

  • Link via Wikipedia link
  • Let the Harvard templates select the link ID.
  • Set the link ID yourself.

If the ID of an existing link is unknown, use Navigation popups to find it.

Reference to a book, one author

{{Harvrefcol|Surname=|Given=|Authorlink=|Year=|Title=|Place=|Publisher=|ID=|URL=}}
  • Surname (Required): The author's surname or last name. (This parameter may also be called Last).
    • Given (optional): The author's first or given name. In some reference styles, this should include only the initials. However, you can use the full name if you prefer (as I do). (This parameter may also be called First or Initials).
      • Note: To omit the first name, include the parameter, but do not define it, e.g |First=|. See "Minimal reference" in Examples section below.
    • Author (optional): While the Surname (or Last) tag is mandatory for referencing purposes, use of the Author parameter will override how the author's name is displayed in the reference.
  • Authorlink (optional): Title of a Wikipedia article about author. Article must already exist.
  • Year (Required): Year of publication.
  • Title (optional): Title of the book.
  • Edition (optional): Number or name of the edition, if not the first; for example: Edition=2nd.
  • Place (optional): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: Place=Paris, TX (no period at the end). Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter.
  • Publisher (optional): The name of the publisher. Omit terms such as Publishers, Co., Inc., Ltd., etc., but retain the words Books or Press.
  • ID (optional): Identifier such as ISBN 1-111-22222-9
    • ISBN (optional): Use this parameter if the book has an ISBN. Another option would be to use the ISBN as |ID. In that case, a citation in the text of the article would use the ISBN number as the id for a hyperlink.
  • URL (optional): An url of an online location where the book can be found.
  • Access-date (optional): The date on which the url was last accessed.

Reference to an article in a periodical, one author

{{Harvrefcol|Surname=|Given=|Authorlink=|Year=|Title=|Journal=|Volume=|Issue=|Pages=|URL=}}
  • Surname (Required): The author's surname or last name. (This parameter may also be called Last).
    • Given (optional): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called First or Initials).
    • Author (optional): While the Surname (or Last) tag is mandatory for referencing purposes, use of the Author parameter will override how the author's name is displayed in the reference.
  • Authorlink (optional): Title of a Wikipedia article about author. Article must already exist.
  • Year (Required): Year of publication in the journal.
  • Title (optional): Title of the article.
  • Journal (optional): Name of the journal or periodical. (This parameter may also be called Periodical).
  • Volume (optional): The volume number of the journal. (This parameter may also be called Vol).
  • Issue (optional): The issue number of the journal. (This parameter may also be called Number).
  • Pages (optional): The pages in the issue where the article may be found. (If the article is on only one page, use the parameter Page instead).
  • URL (optional): An url of an online location where the article can be found.
  • Access-date (optional): The date on which the url was last accessed.

Reference to a contribution or chapter in a book, one author and one editor

{{Harvrefcol|Surname=|Given=|Authorlink=|Year=|Chapter=|Editor=|Title=|Place=|Publisher=|Pages=
|ID=|URL=}}
  • Surname (Required): The author's surname or last name. (This parameter may also be called Last).
    • Given (optional): The author's first or given name. In some reference styles, this should include only the initials. However, you can use the full name if you prefer (as I do). (This parameter may also be called First or Initials).
    • Author (optional): While the Surname (or Last) tag is mandatory for referencing purposes, use of the Author parameter will override how the author's name is displayed in the reference.
  • Authorlink (optional): Title of a Wikipedia article about author. Article must already exist.
  • Year (Required): Year of publication.
  • Chapter (Required for chapters): Title of the contribution in the book. (This parameter may also be called Contribution).
  • Editor (optional): Name of the editor or editors.
  • Title (Required for chapters): Title of the book.
  • Edition (optional): Number or name of the edition, if not the first; for example: Edition=2nd.
  • Place (optional): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: Place=Paris, TX (no period at the end). Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter.
  • Publisher (optional): The name of the publisher. Omit terms such as Publishers, Co., Inc., Ltd., etc., but retain the words Books or Press.
  • Pages (optional): The pages in the book where the chapter or contribution may be found. (If the contribution is on only one page, use the parameter Page instead).
  • ID (optional): Identifier such as ISBN 1-111-22222-9
    • ISBN (optional): Use this parameter if the book has an ISBN.
  • URL (optional): An url of an online location where the book can be found.
  • Access-date (optional): The date on which the url was last accessed.

Book or periodical, multiple authors, up to four

{{Harvrefcol|Surname1=|Given1=|Authorlink1=|Surname2=|Given2=|Authorlink2=|Surname3=|Given3=
|Authorlink3=|Surname4=|Given4=|Authorlink4=|Year=|Title=|Place=|Publisher=|ID=|URL=}}
  • Surname1 (Required): The first author's surname or last name. (This parameter may also be called Last1).
    • Given1 (optional): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called First1 or Initials1).
      • [Note: To omit the first name, include the parameter, but do not define it, e.g |First=|. See "Minimal reference" in Examples section below].
    • Author1 (optional): While the Surname1 (or Last1) tag is mandatory for referencing purposes, use of the Author1 parameter will override how the first author's name is displayed in the reference.
  • Authorlink1 (optional): Title of a Wikipedia article about the first author. Article must already exist.
  • Other authors: use Surname2, Surname3, etc.

Examples

Harvard references (books and journals)
  • For books: {{Harvrefcol|Surname=Turner |Given=O.|Title=History of the Pioneer Settlement of Phelps and Gorham's Purchase, and Morris' Reserve|Publisher=William Alling|Place=[[Rochester, New York]]|Year=1851|URL=http://olivercowdery.com/texts/1851Trn1.htm#turn1851 }}.
  • For periodicals: {{Harvrefcol|Surname=Smith|Given=J. III|Authorlink=Joseph Smith III|Title=Last Testimony of Sister Emma|Journal=The Saints' Herald|Volume=26|Issue=19|Year=1879|Page=289|URL=http://www.lavazone2.com/dbroadhu/IL/sain1872.htm#100179 }}.
  • Minimal reference: {{Harvrefcol|Last=Jones|First=|Year=2006 }}.
  • Multiple authors: {{Harvrefcol|Surname1=Lincoln|Given1=A.|Surname2=Washington|Given2=G.|Surname3=Adams |Given3=J. |Title=All the Presidents' Names|Publisher=The Pentagon|Place=Home Base, New York|Year=2007 }}.

Citation examples, based on related citation template (automatically creates a one-directional link to the first matching Harvard reference on the same page):

  • {{Harvcol|Turner|1851|pp=10-11}} (full cite format)
  • {{Harvcol|Smith|1879|p=289}} (short format)
  • {{Harvcol|Jones|2006|loc=section 5|Ref=none}} (non-linking)
  • {{Harvcol|Lincoln|Washington|Adams|2007|pp=88-89}} (multi-author)
Notes
  • Because the Harvard referencing style is based on Surname and Year, these items are mandatory in both the citation and the reference.
  • If there is only one author, the parameters Surname and Given may be replaced with Last and First, respectively.

Results


See also