Recent Changes
Recent Changes · Search:

Bibliographies.BibliographyFeatures History

Hide minor edits - Show changes to output

Added lines 1-4:

This page has been "moved" to
12 October 2006 at 07:03 PM by John Rankin - define bib and cite mrkup options
Added lines 1-76:
[[Bibliographies]] introduce 3 new markup elements:

* [@cite(ref-id)@] makes a reference to a citation, defined elsewhere on the page

* a [@(:bib:)@] ... [@(:bibend:)@] block marks the location of the citations on the page

* within a bib ... bibend block, lines starting with * or # or : followed by ref-id define citations


!!! "cite" makes a reference

The full structure of cite markup is


The ref-id must start with a letter and may be followed by any combimation of letters, numbers, and [-.:] characters. Accented letters are ''allowed'' -- the ref-id is converted into a valid HTML anchor.

The TAB(bib-cite) describes the role of the various cite options. They can be used in any combination.

||id=bib-cite"cite options" border=1 bordercolor=silver cellspacing=0 cellpadding=3
||!The available cite options !||
||!Option ||!Sample ||!Produces ||!Comment ||
||cite ||[=cite(Smith:2006)=] ||Smith (2006) ||default ||
||p ||[=pcite(Smith:2006)=] ||Smith 2006 ||no parentheses ||
||P ||[=Pcite(Smith:2006)=] ||(Smith, 2006) ||outside parentheses ||
||i ||[=icite(Smith:2006)=] ||Smith, 2006 ||implied parentheses ||
||cite ||[=cite(delMonte:2006)=] ||del Monte (2006) ||spaced name ||
||C ||[=Cite(delMonte:2006)=] ||Del Monte (2006) ||capital first letter ||
||cite ||[=cite(Fee:Fie:Foe:2006)=] ||Fee et al. (2006) ||default is et al. ||
||citE ||[=cite(Fee:Fie:Foe:2006)=] ||Fee, Fie and Foe (2006) ||expanded names ||
||t ||[=citet(Smith:2006)=] ||(2006) ||suppress author text ||
||T ||[=citeT(Smith:2006)=] ||Smith ||author text only ||
||i ||[=citei(Smith:2006"p 5")=] ||(p 5) ||implied text ||
||nocite ||[=nocite(Smith:2006)=] ||''no output'' ||list in bibliography ||

As TAB(bib-note) shows, an author can defines notes as prefixes, suffixes, or both.

||id=bib-note"note options" border=1 bordercolor=silver cellspacing=0 cellpadding=3
||!The available note options !||
||!Option ||!Sample ||!Produces ||!Comment ||
||"suffix" ||[=cite(Smith:2006"p 5")=] ||Smith (2006, p 5) ||note suffix ||
||"prefix"" ||[=cite(Smith:2006"see"")=] ||see Smith (2006) ||note prefix ||
||"pre"suf" ||[=cite(Smith:2006"see"p 5")=] ||see Smith (2006, p 5) ||both ||


!!! "bib" makes a citation block

The full structure of bib markup is

(:bib <options :)

... citations


As TAB(bib-opt) shows, an author can control most aspects of the bibliography output.

||id=bib-opt"bibliography options" border=1 bordercolor=silver cellspacing=0 cellpadding=3
||!The available bibliography options !||
||!Option ||!Sample ||!Comment ||
||page ||page=Citations ||includes the citations from page ||
||fmt ||fmt=text ||default is year-style references only ||
|| ||fmt=bib ||list unreferenced citations only ||
|| ||fmt=* ||year-style references and unreferenced citations ||
|| ||fmt=num ||produces numbered references ||
|| ||fmt=# ||number references and list unreferenced citations ||
||sort ||sort=yes ||sort references and unreferenced citations ||
|| ||sort=ref ||sort only the references ||
|| ||sort=bib ||sort only the unreferenced citations ||
|| ||sort=no ||sort neither references nor unreferenced citations ||

For example, [=(:bib page="PageA PageB PageC" fmt=bib sort=no :)=] will generate an unsorted list of the citations defined on pages A, B and C. Any duplicate ref-ids will be listed separately. By default, lists of citaations are sorted by the ref-id.

Page last modified on 22 October 2006 at 12:26 AM