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.
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:
- a bibliography section containing a list of the references you would like to cite in the text, and,
- an in-text citation, which "calls" the reference from 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:
#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]
- 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:
- 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.)
- ISBN (isbn=number): For books, this will insert the full reference automatically, based only on the ISBN. (See StickWillams2009 ref. above.)
- 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>.
- 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:
- Robert Stick and Spencer Williams wrote a book about carbohydrates and enzymes .
- The catalytic mechanisms of enzymic glycosyl transfer have been reviewed .
- 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].
- Sinnott, M.L. (1990) Catalytic mechanisms of enzymic glycosyl transfer. Chem. Rev. 90, 1171-1202. DOI: 10.1021/cr00105a006
- He S and Withers SG. Assignment of sweet almond beta-glucosidase as a family 1 glycosidase and identification of its active site nucleophile. J Biol Chem. 1997 Oct 3;272(40):24864-7.
- Comfort DA, Bobrov KS, Ivanen DR, Shabalin KA, Harris JM, Kulminskaya AA, Brumer H, and Kelly RM. Biochemical analysis of Thermotoga maritima GH36 alpha-galactosidase (TmGalA) confirms the mechanistic commonality of clan GH-D glycoside hydrolases. Biochemistry. 2007 Mar 20;46(11):3319-30. DOI:10.1021/bi061521n |
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