CZ:Citation style: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Anthony.Sebastian
imported>John R. Brews
(→‎Listing the 'references' or 'notes': list-defined references)
 
(27 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Content Policy}}
A '''citation''' allows the reader to verify a statement made in the text, see the source of data, gain more detail about a claim, or to explore the original context of a quoted passage.
(This is a preliminary draft)


A '''citation''' allows the reader to verify a statement made in the text, see the source of data, gain more detail about a claim, or to explore the original context of a quoted passage. Usually, the text is marked with a superscript [[hyperlink]] that is linked to a note, like this,<ref name=Example1>A definitive direction to the source of the information is supplied here.</ref> that directs the reader to a reliable source that validates the statement, such as a published book, a scholarly journal, or a government agency website. The citation mark is usually placed after the section to which the citation is most relevant, or at the end of the paragraph, where more than one source of validation may be indicated.<ref name=Several1>Source 1.
==Generating the citation list==
To insert a note or reference, the text is marked with a superscript [[hyperlink]] that is linked to a note, like this,<ref name=Example1>A definitive direction to the source of the information is supplied here.</ref>. This may direct the reader to a reliable source that validates the statement, such as a book, a scholarly journal, or a government agency website, or to a note that makes an explanatory comment or adds a tangential piece of information. The citation mark is usually placed after the section to which the citation is most relevant, or at the end of the paragraph, where more than one source of validation may be indicated.<ref name=Several1>Source 1.
* Source 2.
* Source 2.
* Source 3. (This is what we are doing in many Citizendium biology pages to reduce clutter).</ref>
* Source 3. (This is what we are doing in many Citizendium biology pages to reduce clutter).</ref> It should be placed after any punctuation mark and there should be no space before it.


The advantage of this last method is that it minimizes the number of superscripted numbers appearing in the text. The markup code used to produce the note [1] is this:
This  minimizes the number of superscripted numbers appearing in the text. The markup code used to produce the note [1] is:


<nowiki><ref name=Example1>A definitive direction to the source of the information is supplied here.</ref></nowiki>
<pre><ref name=Example1>A definitive direction to the source of the information is supplied here.</ref></pre>


If a citation is used several times in the one article it is useful to give the citation a name. This is done the first time a source is used by using the markup <nowiki><ref name=Dickens1859></nowiki>.<ref name=Dickens1859>Charles Dickens (1859) ''A Tale of Two Cities''.</ref>
If a citation is used several times in the one article it is useful to give the citation a name. This is done the first time a source is used by using the markup <nowiki><ref name=Dickens1859></nowiki>.<ref name=Dickens1859>Charles Dickens (1859) ''A Tale of Two Cities''.</ref>
Line 14: Line 14:
The named reference markup for the note [3] is easy to repeat here using its name.<ref name=Dickens1859 />
The named reference markup for the note [3] is easy to repeat here using its name.<ref name=Dickens1859 />


==Listing the notes used in an article==
==Listing the 'references' or 'notes' ==
The <nowiki><references/></nowiki> markup produces the following result when placed just here:  
The <nowiki><references/></nowiki> markup symbol produces the following result when placed just here:  
<references/>
<references/>


The <nowiki><references/></nowiki> markup produces a list of all notes used in the text.  
The <nowiki><references/></nowiki> markup produces a list of all notes used in the text.  
See how note [3] has two symbols which are superscripted links referring back to where [3] was used in the text. Try clicking on them to see the service they provide to the reader. Note too how the references are organized in numerical order automatically by the <nowiki><references/></nowiki> markup.
See how note [3] has two symbols which are superscripted links referring back to where [3] was used in the text. Note how the references are organized in numerical order automatically.
 
Generally, the citation list is placed directly after the main article.<ref>''Chicago Manual of Style'', 14th ed., Part 1, see section 1.82, "Back Matter."  This edition of the Chicago Manual of Style discusses the construction of a "book."</ref>
==Placing the citation list==
Generally, the collected citation list is placed directly after the main article and before a bibliography.<ref>''Chicago Manual of Style'', 14th ed., Part 1, see section 1.82, "Back Matter."  This edition of the Chicago Manual of Style discusses the construction of a "book."</ref>
 
==Content of the citation==
Here is a full citation of an article in a scientific journal that provides comprehensive and definitive information about the source of the article:
 
: Benner SA, Ellington AD, Tauer A. (1989) [http://www.pnas.org/cgi/content/abstract/86/18/7054 Modern metabolism as a palimpsest of the RNA world.] Proceedings of the  National Academy of Science of the  U S A. Volume 86, pages 7054-8 doi:10.1073/pnas.86.18.7054 PMID 2476811
 
This gives, in order, the names of the author, year of publication, the article title (hyperlinked to the original article), the full journal title, volume, pages, the unique document identification number, and the code used by the PubMed medical abstracting service (PMID 2476811). Using such a long and comprehensive title conveys maximum information to the reader, but when many references are cited, takes up much space
 
It is therefore usual to abbreviate the citation, and it is suggested that most journal citations on Citizendium should follow this form (very similar the internet publication [http://journals.plos.org/plosbiology/guidelines.php Public Library of Science Biology] (PLoS Biology), which provides a good model for consistent citation style at Citizendium (see below).
 
: Benner SA ''et al.'' (1989) Modern metabolism as a palimpsest of the RNA world. Proc Natl Acad Sci U S A 86:7054-8 PMID 2476811
 
Note that ''et al.'' stands for the Latin ''et alia'', meaning 'and others'.
 
Alternatively even shorter abbreviations might be used in some articles, relying on certain unique codes now available for scientific articles.
 
: Benner SA ''et al.'' (1989) doi:10.1073/pnas.86.18.7054
 
or
 
: Benner SA ''et al.'' (1989) PMID 2476811
 
The markup for this last citation is simple:
 
<nowiki> Benner SA ''et al.'' (1989) PMID 2476811</nowiki>
 
Note how the Mediawiki software provides an automatic hyperlink to a very useful summary and cross references available at the PubMed website. The weakness of these short citations is that, if an error is made, it may be difficult for others to correct it by finding the intended citation.
 
When providing a doi (digital object identifier) for an article (e.g., the Brenner article above), formatting it as
[http: //dx.doi.org/10.1073/pnas.86.18.7054 Article title.] Note: you must omit space after http: for this to work, giving the result as shown next line:
 
gives direct link to article via the article title: [http://dx.doi.org/10.1073/pnas.86.18.7054 Modern metabolism as a palimpsest of the RNA world.] The link takes you to the journal, showing usually the article's abstract, and links to full-text and downloadable PDF, sometimes free, other times requiring an institutional or personal subscription.
 
==Book citations==
A good example is
[[Richard Dawkins]] (2004) ''The Ancestor's Tale''  ISBN 0618005838; Audio (2005) ISBN 0752873210 [http://www.metacritic.com/books/authors/dawkinsrichard/ancestorstale Reviews here]
 
or alternatively,
Dawkins R (2004) ''The Ancestor's Tale''  ISBN 0618005838
 
In many instances it will be necessary to mention the title of a book, or journal in the text of an article, and for this the name, such as ''A Tale of Two Cities'' , or ''Scientific American'' should be in ''italics''. The markup for this is :
 
<nowiki>''A Tale of Two Cities''</nowiki>
 
==How can authors work out how to cite publications correctly==
Every scholarly publication provides its own guide for authors about how to provide citation details. One accessible example which provides useful guidance for formulation of Citizendium citation style  is from the internet publication [http://journals.plos.org/plosbiology/guidelines.php Public Library of Science Biology] (PLoS Biology), an Open Access journal. They give the following guidelines for submitted manuscripts:


"PLoS uses the numbered citation (citation-sequence) method. References are listed and numbered in the order that they appear in the text. In the text, citations should be indicated by the reference number in brackets. Multiple citations within a single set of brackets should be separated by commas. Where there are more than three sequential citations, they should be given as a range. ... For all references, list the first five authors; add "et al." if there are additional authors. You can include a DOI number for the full-text article as an alternative to or in addition to traditional volume and page numbers. Please use the following style for the reference list:
Besides the <nowiki><references/></nowiki> template, Citizendium provides the <nowiki>{{Reflist}}</nowiki> and its variants described at [[CZ: List-defined references]].


'''Published Papers'''
==Preferred reference style==


1. Sanger F, Nicklen S, Coulson AR (1977) DNA sequencing with chain-terminating inhibitors. Proc Natl Acad Sci U S A 74: 5463–5467.
For scientific articles, the preferred style is very similar to the internet publication [http://journals.plos.org/plosbiology/guidelines.php Public Library of Science Biology] (PLoS Biology):


'''Accepted Papers'''
'''Journal articles'''
:Benner SA ''et al.'' (1989) Modern metabolism as a palimpsest of the RNA world ''Proc Natl Acad Sci USA'' 86:7054-8 PMID 2476811


Same as above, but "In press" appears instead of the page numbers. Example: Adv Clin Path. In press.
Note that ''et al.'' stands for the Latin ''et alia'', meaning 'and others', and is used when there are more than two authors.


'''Electronic Journal Articles'''  
'''Electronic Journal Articles'''  
 
:Loker WM (1996) "Campesinos" and the crisis of modernization in Latin America ''Jour Pol Ecol'' 3. Available: http://www.library.arizona.edu/ej/jpe/volume_3/ascii-lokeriso.txt. Accessed 11 August 2006.
1. Loker WM (1996) "Campesinos" and the crisis of modernization in Latin America. Jour Pol Ecol 3. Available: http://www.library.arizona.edu/ej/jpe/volume_3/ascii-lokeriso.txt. Accessed 11 August 2006.


'''Books'''
'''Books'''
 
:Richard Dawkins (2004) ''The Ancestor's Tale''  ISBN 0618005838; Audio (2005) ISBN 0752873210 [http://www.metacritic.com/books/authors/dawkinsrichard/ancestorstale Reviews here]
1. Bates B (1992) Bargaining for life: A social history of tuberculosis. Philadelphia: University of Pennsylvania Press. 435 p.


'''Book Chapters'''
'''Book Chapters'''
:Hansen B (1991) New York City epidemics and history for the public. In: Harden VA, Risse GB, editors. ''AIDS and the historian'' Bethesda: National Institutes of Health pp. 21–8


1. Hansen B (1991) New York City epidemics and history for the public. In: Harden VA, Risse GB, editors. AIDS and the historian. Bethesda: National Institutes of Health. pp. 21–28."


(End of direct quote from PLoS Biology)
===Journal abbreviations===
There are several different conventions for abbreviating Journal titles. The most common convention in scientific journals is that used by Index Medicus (and followed by PubMed). Abbreviations follow complex rules; for instance "-ogy" is always lost, so Biology becomes Biol); one exception to this is that where the title of a journal is a single word this is never abbreviated. Thus ''The Journal of Endocrinology'' is abbreviated as ''J Endocrinol'', but ''Endocrinology'' is left unabbreviated.


==Examples of other citation styles in the natural sciences==
The National Center for Biotechnology Information (NCBI) provides a service for [http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=journals  looking up]  journal names and abbreviations, and a list of journal names.
Professional standards require consistent and accurate citations, and so authors need to be aware of the wide variety of citation styles used in published works. A survey of them can alert writers to some of the pitfalls that make it easy to have citation errors in article. Here are three examples of citations from ''Proceedings of the National Academy of Sciences, USA'', a well respected scientific journal (often called just ''PNAS'' by scientists).  


:1. Lockhart, P. J., Steel, M. A., Hendy, M. D. & Penny, D. (1994) Mol. Biol. Evol. '''11''', 605-612
==Electronic publications and hyper-linked citation resources==
The use of hyper-links to readily available publications available through the www is encouraged. Some resources, such as JSTOR, Project Muse, ''New York Times'', and other electronic archives are readily available to researchers through their institutional affiliations. For the general public however, access is limited. JSTOR recommends that independent researchers (1) join a participating publisher or scholarly society, (2) visit a subscribing library, or (3) purchase the article from the publisher.[http://www.jstor.org/logon?S1=c0a83465.11653e360350&T=6]


:2.  Syvanen, M. & Kado, C. I., eds. (1998) Horizontal Gene Transfer (Chapman & Hall, London).
When you hyper-link a citation resource, include a short notation such as [http://www.jstor.org/help/access_options.html online source].


:3. Day, M. (1998) in Horizontal Gene Transfer, eds. Syvanen, M. & Kado, C. I. (Chapman & Hall, London), pp. 144-167.
When providing a doi (digital object identifier) for an article, format it as
<pre>[http://dx.doi.org/10.1073/pnas.86.18.7054 Article title.]</pre>


This produces a direct link to the article's abstract, and links to full-text and downloadable PDF.  For example:
:[http://dx.doi.org/10.1073/pnas.86.18.7054 Modern metabolism as a palimpsest of the RNA world.]


Citation 1 is a journal citation but unfortunately for the reader PNAS USA does not give the article's title. Note the volume number is given in bold text, followed by page numbers.
==Avoid "ibid."==
2 is a book and 3 a book chapter.
If you have two or more footnotes in a row that cite the same source, avoid using "ibid." (the abbreviation for Latin ''ibidem,'' "in the same place") for the ones following the first one. If another author inserts text in the middle of the article and cites another source, then the subsequent "ibid."s will suddenly refer to the wrong source.


The following is another PNAS citation of an article in the journal ''Molecular Biology and Evolution'', published by Oxford Journals:
To prevent this confusing result, you can cite the previously-cited source using the author's surname plus either "op. cit." (abbreviation for "work cited") or a shortened title of the work. For example, if the first citation is


: 4. Lake, J. A. (1991) Mol. Biol. Evol. '''8''', 378-385
1. Robert Peters, ''Where the Bee Sucks: Workers, Drones and Queens of Contemporary American Poetry,'' p. 140.


It is available on line as a [http://mbe.oxfordjournals.org/cgi/reprint/8/3/378?ijkey=3be4240c3ec4499652a784fcc2b022ccc645f0ae&keytype2=tf_ipsecsha pdf file]
then the second could be either


Here we will find, at last, an article ''title'':
2. Peters, op. cit., p. 191.


: Letter to the Editor. The Order of Sequence Alignment Can Bias the Selection of Tree Topology. James A. Lake
or
 
In the text of Lake (1991), the citation style is like this: (Lake et al. 1984; Woese and Olsen 1986), and in the end-notes the citations are listed like this:
 
:LITERATURE CITED
:BALDACCI, B., F. GUINET, J. TILLIT, G. ZACCAI, and A.-M. DE RECONDO. 1990. Functional
:implications related to the gene structure of the elongation factor EF-Tu form ''Halobacterium''
:''marismortui''. Nucleic Acids Res. '''18''':507-511.
 
 
The article titles are given in full, but the system for providing page numbers is different from PNAS, and the author's names are capitalized.
 
In short, many different citation styles are used today in scholarly literature.
 
==Abbreviations and their meaning==
===Journal abbreviations===
Again there are several different conventions for abbreviating Journal titles (and a few journals prefer to give journal titles in full). The most common convention used in scientific journals is that used by Index Medicus (and followed by PubMed). Abbreviations are not arbitrary, but follow complex rules; for instance "-ogy" is always lost, so Biology becomes Biol); one exception to this rule is that where the title of a journal is a single word this is never abbreviated. Thus ''The Journal of Endocrinology'' is abbreviated as ''J Endocrinol'', but ''Endocrinology'' is left unabbreviated.
 
The National Center for Biotechnology Information (NCBI) provides a service for [http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=journals  looking up]  journal names and abbreviations, and a list of journal names.


==Types of bibliographic information==
2. Peters, ''Where the Bee Sucks,'' p. 191.
==PubMed==
 
==Electronic publications and hyper-linked citation resources==
 
It is encouraged that the Citizens' Compendium include hyper-links to readily available publications available through the www. Note that some resources, such as JSTOR, Project Muse, ''New York Times'', and other electronic archives are readily available to researchers who have access to them through their institutional affiliations.  For the general public however, access is limited.  JSTOR for instance recommends that independent researchers (1) join a participating publisher or scholarly society, (2) visit a subscribing library, or (3) purchase the article from the publisher.[http://www.jstor.org/logon?S1=c0a83465.11653e360350&T=6]
 
It is recommended that when you hyper-link a citation resource that you include a short notation such as [http://www.jstor.org/help/access_options.html online source].


==Practice at Citizendium==
==Practice at Citizendium==
The principles behind the choice of any style of citations to provide the reader with enough information to find the source for himself or herself, with efficient use of limited space  and an aesthetically pleasing appearance on the page. Although Citizendium is an electronic encyclopedia, there are nevertheless limitations on space to enable articles to be printed compactly. Electronic links mean that, strictly, fewer details need be given to enable sources to be located efficiently - for a citation on PubMed everything is redundant except the PMID number. However citations do more than merely point to a source, they are also open acknowledgments of the origin of ideas and information. Listing sources clearly is an explicit and courteous recognition of the debt that authors have to other authors.
The principles behind the choice of any style of citations is to provide the reader with enough information to find the source for himself or herself, with efficient use of limited space  and an aesthetically pleasing appearance on the page. Electronic links mean that, strictly, fewer details need be given to enable sources to be located efficiently - for a citation on PubMed everything is redundant except the PMID number. However citations do more than merely point to a source, they are also open acknowledgments of the origin of ideas and information. Listing sources clearly is an explicit and courteous recognition of the debt that authors have to other authors.


==References==
==References==
====Citations====
<references/>
<references/>
{{Content Policy}}

Latest revision as of 07:25, 20 September 2011

A citation allows the reader to verify a statement made in the text, see the source of data, gain more detail about a claim, or to explore the original context of a quoted passage.

Generating the citation list

To insert a note or reference, the text is marked with a superscript hyperlink that is linked to a note, like this,[1]. This may direct the reader to a reliable source that validates the statement, such as a book, a scholarly journal, or a government agency website, or to a note that makes an explanatory comment or adds a tangential piece of information. The citation mark is usually placed after the section to which the citation is most relevant, or at the end of the paragraph, where more than one source of validation may be indicated.[2] It should be placed after any punctuation mark and there should be no space before it.

This minimizes the number of superscripted numbers appearing in the text. The markup code used to produce the note [1] is:

<ref name=Example1>A definitive direction to the source of the information is supplied here.</ref>

If a citation is used several times in the one article it is useful to give the citation a name. This is done the first time a source is used by using the markup <ref name=Dickens1859>.[3]

The named reference markup for the note [3] is easy to repeat here using its name.[3]

Listing the 'references' or 'notes'

The <references/> markup symbol produces the following result when placed just here:

  1. A definitive direction to the source of the information is supplied here.
  2. Source 1.
    • Source 2.
    • Source 3. (This is what we are doing in many Citizendium biology pages to reduce clutter).
  3. 3.0 3.1 Charles Dickens (1859) A Tale of Two Cities.

The <references/> markup produces a list of all notes used in the text. See how note [3] has two symbols which are superscripted links referring back to where [3] was used in the text. Note how the references are organized in numerical order automatically. Generally, the citation list is placed directly after the main article.[1]

Besides the <references/> template, Citizendium provides the {{Reflist}} and its variants described at CZ: List-defined references.

Preferred reference style

For scientific articles, the preferred style is very similar to the internet publication Public Library of Science Biology (PLoS Biology):

Journal articles

Benner SA et al. (1989) Modern metabolism as a palimpsest of the RNA world Proc Natl Acad Sci USA 86:7054-8 PMID 2476811

Note that et al. stands for the Latin et alia, meaning 'and others', and is used when there are more than two authors.

Electronic Journal Articles

Loker WM (1996) "Campesinos" and the crisis of modernization in Latin America Jour Pol Ecol 3. Available: http://www.library.arizona.edu/ej/jpe/volume_3/ascii-lokeriso.txt. Accessed 11 August 2006.

Books

Richard Dawkins (2004) The Ancestor's Tale ISBN 0618005838; Audio (2005) ISBN 0752873210 Reviews here

Book Chapters

Hansen B (1991) New York City epidemics and history for the public. In: Harden VA, Risse GB, editors. AIDS and the historian Bethesda: National Institutes of Health pp. 21–8


Journal abbreviations

There are several different conventions for abbreviating Journal titles. The most common convention in scientific journals is that used by Index Medicus (and followed by PubMed). Abbreviations follow complex rules; for instance "-ogy" is always lost, so Biology becomes Biol); one exception to this is that where the title of a journal is a single word this is never abbreviated. Thus The Journal of Endocrinology is abbreviated as J Endocrinol, but Endocrinology is left unabbreviated.

The National Center for Biotechnology Information (NCBI) provides a service for looking up journal names and abbreviations, and a list of journal names.

Electronic publications and hyper-linked citation resources

The use of hyper-links to readily available publications available through the www is encouraged. Some resources, such as JSTOR, Project Muse, New York Times, and other electronic archives are readily available to researchers through their institutional affiliations. For the general public however, access is limited. JSTOR recommends that independent researchers (1) join a participating publisher or scholarly society, (2) visit a subscribing library, or (3) purchase the article from the publisher.[1]

When you hyper-link a citation resource, include a short notation such as online source.

When providing a doi (digital object identifier) for an article, format it as

[http://dx.doi.org/10.1073/pnas.86.18.7054 Article title.]

This produces a direct link to the article's abstract, and links to full-text and downloadable PDF. For example:

Modern metabolism as a palimpsest of the RNA world.

Avoid "ibid."

If you have two or more footnotes in a row that cite the same source, avoid using "ibid." (the abbreviation for Latin ibidem, "in the same place") for the ones following the first one. If another author inserts text in the middle of the article and cites another source, then the subsequent "ibid."s will suddenly refer to the wrong source.

To prevent this confusing result, you can cite the previously-cited source using the author's surname plus either "op. cit." (abbreviation for "work cited") or a shortened title of the work. For example, if the first citation is

1. Robert Peters, Where the Bee Sucks: Workers, Drones and Queens of Contemporary American Poetry, p. 140.

then the second could be either

2. Peters, op. cit., p. 191.

or

2. Peters, Where the Bee Sucks, p. 191.

Practice at Citizendium

The principles behind the choice of any style of citations is to provide the reader with enough information to find the source for himself or herself, with efficient use of limited space and an aesthetically pleasing appearance on the page. Electronic links mean that, strictly, fewer details need be given to enable sources to be located efficiently - for a citation on PubMed everything is redundant except the PMID number. However citations do more than merely point to a source, they are also open acknowledgments of the origin of ideas and information. Listing sources clearly is an explicit and courteous recognition of the debt that authors have to other authors.

References

  1. Chicago Manual of Style, 14th ed., Part 1, see section 1.82, "Back Matter." This edition of the Chicago Manual of Style discusses the construction of a "book."


Citizendium Content Policy
Approval Standards | Article Mechanics | Subpages | Importing material from other sources | Citable articles
How to Edit
Getting Started Organization Technical Help
Policies Content Policy
Welcome Page