CZ:Citation style: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>David Tribe
imported>Gareth Leng
No edit summary
Line 1: Line 1:
(This is a preliminary draft)
(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. Perhaps the best way to supply this citation information is to mark the text with a superscript [[hyperlink]] to a note, like this <ref name=Example1>A definitive direction to the source of the information is supplied here.</ref>, and then provide in the hyperlinked note an unambiguous direction to reliable source that validates the statement, such as a published book, a scholarly journal, or a government agency website.
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.
 
The placement the citation markup is usually just after the section to which the citation is most relevant, or at the end of the  paragraph, where there may be 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>


The advantage of this last method is that it minimizes the number of superscripted numbers appearing in the text.
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:
 
The markup code used to produce the note [1] is this:


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


If a citation is used several times in the one article it is useful to give the citation a name.
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>
 
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>


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 />
Line 24: Line 18:


It produces a list of all notes used in the text.  
It 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.
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.
 
Note too how the references are organized in numerical order automatically by the <nowiki><references/></nowiki> markup.


==Placement of the citation list==
==Placing the citation list==
Generally the collected citation list is placed directly after the main article.
Generally the collected citation list is placed directly after the main article.


==Content of the citation==
==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:
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
: 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 provides in order the names of the author, year of publication, article title (hyperlinked to the original full article) the full journal title, volume, pages, the unique document identification number, and the code used by the PubMed medical abstracting service 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
 
Using such a long and comprehensive title conveys maximum information to the reader, but which 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).
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).
Line 59: Line 48:
<nowiki> Benner SA ''et al.'' (1989) PMID 2476811</nowiki>
<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 citataions is that if an error is made in the citation, it may be very difficult for others to correct with a right citation.
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.


==Book citations==
==Book citations==
Line 69: Line 58:


==How can authors work out how to cite publications correctly==
==How can authors work out how to cite publications correctly==
A guide for how to provide citation details is provided to prospective authors by each scholarly publication. 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:
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:
"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:
Line 96: Line 85:


==Examples of other citation styles in the natural sciences==
==Examples of other citation styles in the natural sciences==
 
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).  
Professional standards require consistent and accurate citations in an article, and to do this 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
:1.  Lockhart, P. J., Steel, M. A., Hendy, M. D. & Penny, D. (1994) Mol. Biol. Evol. '''11''', 605-612
Line 112: Line 97:
2 is a book and 3 a book chapter.
2 is a book and 3 a book chapter.


 
The following is another PNAS citation of an article in the journal ''Molecular Biology and Evolution'', published by Oxford Journals:  
The following another PNAS citation of an article in the journal ''Molecular Biology and Evolution'', published by Oxford Journals:  


: 4.  Lake, J. A. (1991) Mol. Biol. Evol. '''8''', 378-385
: 4.  Lake, J. A. (1991) Mol. Biol. Evol. '''8''', 378-385
Line 138: Line 122:
==Abbreviations and their meaning==
==Abbreviations and their meaning==
===Journal abbreviations===
===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.


==Types of bibliographic information==
==Types of bibliographic information==
Line 150: Line 135:
====Citations====
====Citations====
<references/>
<references/>


[[Category:CZ Live]]
[[Category:CZ Live]]
[[Category:Biology Workgroup (Top)]]
[[Category:Biology Workgroup (Top)]]
[[Category:Library and Information Science Workgroup]]
[[Category:Library and Information Science Workgroup]]

Revision as of 08:50, 1 February 2007

(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 [1], 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.[2]

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:

<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 notes used in an article

The <references/> markup 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.

It 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 <references/> markup.

Placing the citation list

Generally the collected citation list is placed directly after the main article.

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) 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 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:

Benner SA ''et al.'' (1989) PMID 2476811

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.

Book citations

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

or alternatively, Dawkins R (2004) The Ancestor's Tale ISBN 0618005838

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 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:

Published Papers

1. Sanger F, Nicklen S, Coulson AR (1977) DNA sequencing with chain-terminating inhibitors. Proc Natl Acad Sci U S A 74: 5463–5467.

Accepted Papers

Same as above, but "In press" appears instead of the page numbers. Example: Adv Clin Path. In press.

Electronic Journal Articles

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

1. Bates B (1992) Bargaining for life: A social history of tuberculosis. Philadelphia: University of Pennsylvania Press. 435 p.

Book Chapters

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)

Examples of other citation styles in the natural sciences

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
2. Syvanen, M. & Kado, C. I., eds. (1998) Horizontal Gene Transfer (Chapman & Hall, London).
3. Day, M. (1998) in Horizontal Gene Transfer, eds. Syvanen, M. & Kado, C. I. (Chapman & Hall, London), pp. 144-167.


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. 2 is a book and 3 a book chapter.

The following is another PNAS citation of an article in the journal Molecular Biology and Evolution, published by Oxford Journals:

4. Lake, J. A. (1991) Mol. Biol. Evol. 8, 378-385

It is available on line as a pdf file

Here we will find, at last, an article title:

Letter to the Editor. The Order of Sequence Alignment Can Bias the Selection of Tree Topology. James A. Lake

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.

Types of bibliographic information

PubMed

Electronic publications and hyper-linked citation resources

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.

References

Citations