This page has been “moved” to
Bibliographies introduce 3 new markup elements:
cite(ref-id) makes a reference to a citation, defined elsewhere on the page
(:bib:) … (:bibend:) block marks the location of the citations on the page
On this page… (hide)
The full structure of cite markup is
[Ppi]?[Cc]it[eE][Tti]?(ref-id”notes”)
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 cite options describes the role of the various cite options. They can be used in any combination.
| 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 note options shows, an author can defines notes as prefixes, suffixes, or both.
| 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 |
The full structure of bib markup is
(:bib <options :) … citations (:bibend:)
As bibliography options shows, an author can control most aspects of the bibliography output.
| 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.