The online documentation is written in DocBook XML and is converted to html by xsltproc. The documentation is written to be viewed from inside Solfege but it can of course be viewed in a web browser. What make the generated html-files different from regular html is that in addition to links to other help files, you can write links that will start and configure an exercise if you click on it, like this one.
Feel free to ask any questions if you want to write some documentation for Solfege.
protocol:action/exercise/lessoncollection/lessonfile?configuration
Optional, if omitted, the links if to a html file. One possible value: solfege.
Optional, possible values: practise, config or statistics. If omitted, you will view the same part of the exercise you used last time. If the exercise has not been used in this session, you will see the practise page.
Possible values: chord, harmonic-interval, melodic-interval, sing-interval, identify-scale, dictation, id-by-name, twelve-tone, sing-chord, id-tone, compare-intervals, rhythm
Use the value solfege for files distributed with Solfege. Use user for your own files stored in $HOME/lessonfiles. (Optional, only used with lesson file based exercises.)
File name. (Optional, only used with lesson file based exercises.)
Optional. Semicolon-separated list of assignments. Example:
highest_instrument=80; intervals=[1, 2, 3, 4]
Theses two can be used with all exercises that has the New question automatically option on the config page.
Should the user be asked a new question automatically when the current one is answered correctly?
Set the number of seconds of delay before a new question is asked automatically.
integer 0-127
integer 0-127
integer 0-127
integer 0-127
boolean
list of integers, [1, 2, ... 15, 16]
Notename, for example c, fis, or d''
boolean
float
If you use the buttons interface to identify intervals, use this variable to make buttons insensitive that represent intervals the program will not ask for. This variable is a boolean.
integer
list of integers: [-16
list of scale types: ['ionian', 'dorian', 'phrygian', 'lydian', 'mixolydian', 'aeolian', 'lokrisk', 'harmonic_minor', 'melodic_minor']