Textile Test Page.

A Humane Web Text Generator.

Input

What’s new
Bugfixes
Extended syntax
- Link overrides for footnotes.
- Attributes for list items.
New features

h3. Auto-numbered Notes.

Textile 2.2 adds auto-numbered notes to your arsenal. These are intended to allow very simple self-ordering lists of items. Note support is made up of three components...

# Definitions of the notes themselves. These can appear by themselves on any new line in your document.
# References, scattered throughout your document, to the notes.
# One or more placeholders showing where the sequenced list of notes should appear in your document.

h4. Note Definitions.

Note definitions must start on their own line. Each definition has a _*label*_ which can be any alphabetic or numeric character, underscore, dash or colon...

bc. note#label1. Note one's text goes here.

bc. note#label2. This note's text goes here.

Each of these definitions will be removed from your text's flow as textile processes the document and will be remembered in textile in order to allow the references and the note list to be generated. Notes can reference other notes, or even footnotes should you wish to mix-n-match the two.

h4. Note References.

You can make reference to any note in a very similar manner to footnotes -- except that this time you must use the note's _*label*_ (including the # character.) For example, you might write...

bc. scientists say[#label] the moon is...

As textile processes the document it uses the order in which it finds such references to sequence the note definitions into an ordered note list. It inserts superscripts (linked or unlinked, using the same format as footnote link overrides) that will correspond to the correct note in the list.

If you wish to refer to a note _*without*_ linking to it then add an exclamation mark after the label.

bc. scientists say[#label!] the moon is...

You can refer to the same note as many times as you wish.

h4. Note List (or lists.)

You can tell textile where to place the list of notes in your document using the notelist tag.

By default the list will show only the notes which are actually referenced in your document, though you can also tell the notelist to include the unreferenced notes too using the '+' modifier. You can also control the way the notes in the list link back to their references. By default, all backlinks will be shown.

You can override the list's link settings by appending a link override character to the end of any note's label. Like this...

h4. Note List Backlink Sequence characters.

When notes in a note list have references then they can show links from the note, back to to the place in the text where they were referenced. By default, the letter used in this backlink is 'a'. For notes that have multiple backlinks, each link is given the next letter in the alphabet. If you wish to use a different initial backlink character you can define the starting character before the list's link setting (if any) like this...

bc. notelist:α^+.

... where greek *α* will be the text of the first backlink, followed by *β* and so on. Any backlink starting character must preceed the list backlink setting and the unreferenced setting.

h4. Examples...

French cheese production is classified under four categories, and PDO/AOC rules dictate which category(ies) each protected cheese may be assigned to; Fermier[#Fermier], Artisanal[#Artisanal], Coopérative[#Coopérative] or Industriel[#Industriel]. Of the four categories, it is the opinion of this author, that Artisanal[#Artisanal] cheeses are the best available.

note#Unrefereced. See "Appellation d'Origine Contrôlée":http://en.wikipedia.org/wiki/Appellation_d%27Origine_Contr%C3%B4l%C3%A9e (AOC) system for more details.

note#Fermier. A farmhouse cheese, which is produced on the farm where the milk is produced.

note#Artisanal. A producer producing cheese in relatively small quantities using milk from their own farm, but may also purchase milk from local farms.

note#Coopérative. A dairy with local milk producers in an area that have joined to produce cheese. In larger coopératives quantities of cheese produced may be relatively large, akin to some industriel producers (many may be classed as factory-made[#Industriel]).

note#Industriel. A factory-made cheese from milk sourced locally or regionally, perhaps all over France (depending on the AOC/PDO regulations for specific cheeses).

h3. Cheese notes (with Greek back ref. chars.)...

notelist:α+.

h3. Cheese notes (with English back ref. chars.)...

notelist+.