| # | ../info/links_to_other_entries.html | Show tree |
To see these in action, look in the new test folder.
Use Hide tree to show the url for the document in the browser location bar. Then link to it in the normal way.
When your files are downloaded for the web site, all these links will be converted to relative urls.
In the ascii version of the FAQ, they will be changed to references to the relevant subsections of the FAQ.
Altenratively, use the relative urls - these will work in the on site tree, i.e. once your entry on the on-site tree is refreshed.
$.$.$
as the first line of text.
This tells the program 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
You can 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 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.
For instance, you could use
$.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