Links to other entries, and numbering of sub-sections

To see these in action, look in the new test folder.

In html:

Just link to the page in the on site tree, in the normal way.

Use Hide tree to show the url in the browser location bar.

When your files are downloaded for the web site, all links to the on-site tree are converted to relative urls.

In the ascii version of the FAQ, they will be changed to references to the relevant subsections of the FAQ.

You can also use the relative urls, and abbreviated relative urls of the next section - naturally these won't work in the working draft tree, but will work in the on site tree, i.e. once your entry on the on-site tree is refreshed.

top

In ascii:

Make sure you have

$.$.$

as the first line of text.

This tells the program that it is okay to look for ascii bookmarks in your text, and convert them.

To refer to another entry:

See ../margoschulter/what_is_microtonality

This uses the relative url, which you can read from the head of the entry.

It can be abbreviated:

See ../margoschulter/why_12_notes

To change the words used for the link:

See ../margoschulter/why_12_notes| Margo Schulter's entry "Why 12 notes,..."|

The text between | | characters is what the user will see as the text to click on.

To refer to a sub section:

See ../margoschulter/why_12_notes#2.2.1

See ../margoschulter/why_12_notes#2.2.1| Margo Schulter's entry "Why 12 notes,..." section 2.2.1.|

To use sub-sections, as in Margo Schulter's article What is microtonality? use

$.1 $.2, $.2.1

etc.

as the section headers,

and $$.1, $$.2, $$.2.1 to refer to them:

See $$.1, See $$.2, See $$.2.1

In the final ascii faq, if your entry was section 4.1, these would be changed to

See 4.1. #1, See 4.1. #2, See 4.1. #2.1.

The sub sections can use any numbering system, or you can use words too - basically they are just bookmarks.

To use words as bookmarks instead:

$.Intro, $.Perspectives_and_paradoxes, ...

See $$.Perspectives_and_paradoxes

These would change to

4.1.#Intro

4.1.#Perspectives and paradoxes

See 4.1.#Perspectives and paradoxes

Note the full stop after the dollar - this makes it easy to recognise your bookmarks - as the dollar sign is seldom followed by a full stop in normal use. Also note the double dollar sign to distinguish links to sub sections from the section headers themselves.

To switch off ascii bookmarks, e.g. if you need to use $. (i.e. dollar followed by full stop) for something such as an Ascii diagram:

$$off

$$on

top