CAZypedia needs your help!
We have many unassigned pages in need of Authors and Responsible Curators. See a page that's out-of-date and just needs a touch-up? - You are also welcome to become a CAZypedian. Here's how.
Scientists at all career stages, including students, are welcome to contribute.
Learn more about CAZypedia's misson here and in this article.
Totally new to the CAZy classification? Read this first.

Help:References

From CAZypedia
Revision as of 08:38, 4 June 2013 by Harry Brumer (talk | contribs) (fixed broken ISBN)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

CAZypedia uses the BiblioPlus extension for creating in-text citations and a reference list. Full details about BiblioPlus can be found at the BiblioPlus homepage and the homepage of its predecessor, Biblio. The following is a succinct set of instructions for using BiblioPlus with CAZypedia.

The basics

In some sense, BiblioPlus works a bit like the software program EndNote, in that it automatically numbers the bibliography based on the order that citations appear in the text. Also like EndNote, BiblioPlus relies on two pieces of information to make this happen:

  1. a bibliography section containing a list of the references you would like to cite in the text, and,
  2. an in-text citation, which "calls" the reference from the bibliography.


The bibliography

This section is placed at the bottom of the page, between the <biblio>...</biblio> tags, under the heading Reference list. Each reference begins on a new line with a hash sign (#), followed by a citation tag, and finally the reference itself.

For example, a bibliography section might look like this in the wiki editor:


<biblio>
#Comfort2007 pmid=17323919
#He1999 pmid=9312086
#StickWillams2009 isbn=9780240521183
#Sinnott1990 Sinnott, M.L. (1990) Catalytic mechanisms of enzymic glycosyl transfer. Chem. Rev. 90, 1171-1202. [http://dx.doi.org/10.1021/cr00105a006 DOI: 10.1021/cr00105a006]
</biblio>

Note that:

  • The citation tag should be in Harvard-style Author-Year format; e.g. Sinnott1990, StickWillams2009, etc.
  • References can be in one of three different forms:
    1. PubMed IDs (pmid=number): If the reference has a PubMed ID, placing this after the citation tag will insert the complete reference, as well as DOI and PubMed links, with no additional typing whatsoever on your part. (See Comfort2007 and He1999 refs. above.)
    2. ISBN (isbn=number): For books, this will insert the full reference automatically, based only on the ISBN. (See StickWillams2009 ref. above.)
    3. A full, typed reference: Here, whatever follows the reference code is placed verbatim into the reference list - you can put in any text, with any formatting you want. This should only be used when the reference does not have a PubMed ID or ISBN. (See Sinnott1990 ref. above.)
  • References in the bibliography can be in any order, i.e., the reference list does not have to be in the same order as the citations appear in the text. The BiblioPlus software will automatically number the reference list correctly regardless.

The in-text citation

To cite a specific reference from the bibliography in a page, the citation tag of that reference is placed between the two <cite> </cite> tags in the main text.

For example, citations in the main text might look like this in the wiki editor:


  • Robert Stick and Spencer Williams wrote a book about carbohydrates and enzymes <cite>StickWillams2009</cite>.
  • The catalytic mechanisms of enzymic glycosyl transfer have been reviewed <cite>Sinnott1990</cite>.
  • If you want to include multiple references in one place, that is OK, too. Just separate them with spaces in one pair of <cite> tags, like this: <cite>He1999 Comfort2007</cite>.

Note that:

  • The citation tags will be automatically converted into reference numbers according to their first use in the text. You should not try to (and you won't be able to) type/correct the reference numbers; errors in numbering are usually due to typos in the citation tags themselves (either in the text or in the bibliography).
  • As mentioned above, citation tags, should be in Harvard-style Author-Year format (e.g., Sinnott1990)
  • Citation tags are case sensitive.


How it looks on the page

If the bibliography and in-text citations from above are combined, as they would be on a real CAZypedia page, the result looks like this:

Main text:


  • Robert Stick and Spencer Williams wrote a book about carbohydrates and enzymes [1].
  • The catalytic mechanisms of enzymic glycosyl transfer have been reviewed [2].
  • If you want to include multiple references in one place, that is OK, too. Just separate them with spaces in one pair of <cite> tags, like this: [3, 4].


Reference list:


  1. [StickWillams2009]
  2. Sinnott, M.L. (1990) Catalytic mechanisms of enzymic glycosyl transfer. Chem. Rev. 90, 1171-1202. DOI: 10.1021/cr00105a006

    [Sinnott1990]
  3. He S and Withers SG. (1997). Assignment of sweet almond beta-glucosidase as a family 1 glycosidase and identification of its active site nucleophile. J Biol Chem. 1997;272(40):24864-7. DOI:10.1074/jbc.272.40.24864 | PubMed ID:9312086 [He1999]
  4. Comfort DA, Bobrov KS, Ivanen DR, Shabalin KA, Harris JM, Kulminskaya AA, Brumer H, and Kelly RM. (2007). Biochemical analysis of Thermotoga maritima GH36 alpha-galactosidase (TmGalA) confirms the mechanistic commonality of clan GH-D glycoside hydrolases. Biochemistry. 2007;46(11):3319-30. DOI:10.1021/bi061521n | PubMed ID:17323919 [Comfort2007]

All Medline abstracts: PubMed

More referencing examples

This page demonstrates how the above would be used in a real CAZypedia page, and also includes some extra examples: Help:References/More examples