Every RefNotes namespace can have its own rendering style. The style is a collection of properties that define different aspects of how references and notes are rendered.
For the references the styling options are minimal: there is just the reference identifier with some additional formatting. For the notes it gets more sophisticated. A note has three major parts that can be customized: the note identifier, back references and the note text. For example:
Here “1.” is the note identifier, the superscript part contains the back references that link to places on the page where this note was referenced, and the rest is the note text.
By default a namespace inherits the style from its parent. But sometimes it is convenient to override this behavior in order to get an alias to some custom-styled namespace with a long name. The inherit style serves that purpose. For example:
<refnotes t> inherit: :table:stars: </refnotes>
With this syntax you specify that references and notes in the namespace :t: should be rendered using the style of the namespace :table:stars:.
The identifier is used for rendering both references and notes. Usually this identifier is a counter that can be presented in a number of different ways. But if you plan to have a namespace with named notes where the name is more meaningful then just a counter, it is also possible to use the note name as the identifier. For example, it can be useful for bibliographical references that look like this: [Auth09a].
The following styles are supported:
1) [default]a)A)i)I)*)name)The following styles are supported:
sup) [default]text)The following styles are supported:
normal) [default]bold)The following styles are supported:
normal) [default]italic)This style specifies extra characters appearing around the reference identifier.
The following styles are supported:
)) [default]())])[])none)When multiple references to a single note are rendered, there are two ways the references can be presented. One it to assign a unique number to every reference as it is done for DokuWiki footnotes. Another one is to use the same number (the note identifier) for every reference.
The following styles are supported:
ref) [default]note)
Note that if refnote-id style is set to name this style has no effect.
The note preview is a small pop-up that shows up when mouse is hovered over a reference. The pop-up can be static or follow the mouse pointer. The static pop-up is more convenient when there are clickable links in the note text, but you have to hover the mouse pointer over it to make it disappear. The dynamic tooltip disappears as soon as the mouse pointer leaves the reference.
The following styles are supported:
popup) [default]tooltip)none)
When notes are rendered, they are separated from the text above by horizontal ruler. By default the ruler width is 100% of the page but with notes-separator style you can specify the width in any CSS units (e.g. 50%, 100px, 20em, etc.)
The following styles are supported:
100%]none)The standard DokuWiki template justifies most of the text on a page, including the footnotes. It looks okay for normal text (i.e. footnotes) but not so good for book references.
The following styles are supported:
justify) [default]left)This font size is used to render all parts of a note: note identifier, back references and the note text.
The following styles are supported:
normal) [default]small)The following styles are supported:
sup) [default]text)The following styles are supported:
normal) [default]bold)The following styles are supported:
normal) [default]italic)
Similar to the reference-format style but with an extra option to have a dot after the note identifier.
The following styles are supported:
)) [default]())])[]).)none)The list of back references can optionally start with a circumflex (caret) symbol. The symbol can either prefix the back references or be combined with them MediaWiki-style:
The following styles are supported:
none) [default]prefix)merge)
Note that if back-ref-format style is set to note this style has no effect.
The following styles are supported:
sup) [default]text)The following styles are supported:
bold) [default]normal)The following styles are supported:
normal) [default]italic)
The back reference link can be either combined with the note identifier or rendered separately. If there are multiple references to the note, the combined approach renders multiple identifiers that are formatted according to the note-id-format style. Actual values of these identifiers are controlled by the multi-ref-id style.
When the back references are rendered separately from the note identifier, they can be presented either using the back reference counter or just as a row of symbols.
The following styles are supported:
note) [default]a)1)caret)arrow)none)The following styles are supported:
,) [default]none)Controls whether a new scope is created after rendering the notes.
The following styles are supported:
reset) [default]single)