Uten navn

### 0.1 Helpbestanden

De broncode voor de online-documentatie is geschreven in texinfo en is daarna geconventeerd naar standaard html.

Naast dat je verwijzingen kunt aanmaken naar andere helpbestanden, kun je ook verwijzingen aanmaken die een oefening starten en configureren als je er op klikt. Zoals bijvoorbeeld: deze verwijzing.

Stel mij gerust vragen als je documentatie voor GNU Solfege wilt schrijven. Eventueel kan ik je ook een snelle prive cursus texinfo via email geven als je daar behoefte aan hebt...

#### 0.1.1 De speciale `solfege:` verwijzingen

De speciale `solfege:` verwijzingen zijn als volgt opgebouwd: `[protocol:][actie/]oefening/[lescollectie/lesbestand?configuratie]`

`protocol`
  Het protocol is optioneel. Als je hier niets invuld is het een verwijzing naar een html-bestand. De enige andere waarde is: `solfege`.
`actie`
  De actie is optioneel. Als je hier niets invuld krijg je het scherm te zien zoals je het in deze sessie het laatst hebt achtergelaten. Als je deze oefening echter nog niet hebt gedaan krijg je het beginscherm van de oefening. Mogelijke waardens zijn: `practise`, `config` of `statistics`.
`oefening`
  `chord`(Akkoorden), `harmonic-interval`(Harmonische intervallen), `melodic-interval`(Melodische intervallen), `sing-interval`(Zing het interval), `identify-scale`(Identificeer de toonladder), `dictation`(Dicteren), `id-by-name`(Identificeer via naam), `twelve-tone`(Zing de twaalfde toon), `sing-chord`(Zing het akkoord), `id-tone`(Identificeer de toon), `compare-intervals`(Vergelijk de intervallen), `rhythm`(Ritme)
`lescollectie`
  Gebruik de waarde `solfege` voor de bestanden die meegeleverd worden met GNU Solfege of gebruik `user` voor jouw eigen collectie van lesbestanden die in `$HOME/lessonfiles` staan. Dit veld is optioneel en wordt alleen gebruikt bij oefeningen waar men gebruik kan maken van lesbestanden.
`lesbestand`
  De naam van het lesbestand. Dit veld is optioneel en wordt alleen gebruikt bij oefeningen waar men gebruik kan maken van lesbestanden.
`configuratie`
  Optioneel. Dit is een lijst van toekenningen die met een puntcomma zijn gescheiden. Voorbeeld:

                highest_instrumnt=80; intervals=[1, 2, 3, 4]

#### 0.1.2 Lijst van variabelen

Deze twee variabelen kunnen bij alle oefeningen worden gebruikt die een Stel automatisch een nieuwe vraag optie hebben in het configuratiescherm.

`new_question_automatically = true | false`
`seconds_Before_question = float`

##### 0.1.2.1 Chord(Akkoorden)

`highest_instrument, middle_instrument, lowest_instrument`
  integer 0-127
`highest_instrument_velocity, middle_instrument_velocity, lowest_instrument_velocity`
  integer 0-127
`override_default_instrument`
  boolean

##### 0.1.2.2 Harmonic intervall(Harmonische intervallen)

`highest_instrument, lowest_instrument`
  integer 0-127
`highest_instrument_velocity, lowest_instrument_velocity`
  integer 0-127
`override_default_instrument`
  boolean
`intervals`
  lijst van integers, [1, 2, ... 15, 16]
`highest_tone, lowest_tone`
  Nootnamen zoals `c`, `fis,`, or `d''`
`new_question_automatically`
  boolean
`seconds_before_new_question`
  float

##### 0.1.2.3 Melodic intervall(Melodische intervallen), sing intervall(Zing het interval)

`number_of_intervals`
  integer
`ask_for_intervals_nn, waar nn is groter of gelijk aan 0`
  lijst van integers: [-16, -15 ... 15, 16]

##### 0.1.2.4 Identify scale(Identificeer toonladder)

`scales`
  Lijst van toonladdersoorten: ['ionian', 'dorian', 'phrygian', 'lydian', 'mixolydian', 'aeolian', 'lokrisk', 'harmonic_minor', 'melodic_minor']

##### 0.1.2.5 Id by name(Identificeer via naam), dictation(Dicteren), harmonic progression dictation(Harmonische progressie dicteren)

Hier kun je alleen het lesbestand opgeven.

##### 0.1.2.6 Id tone(Identificeer de noot)

`c_weight, cis_weight etc..`
  0..1000
`one_chance_only`
  boolean
`warning_sound`
  boolean
`repeat_question`
  boolean

#### 0.1.3 `solfegescript`

Een tijdje terug heb ik een experimentele functie aan GNU Solfege toegevoegd. Deze functie zorgt er voor dat de documentatie de juiste toetsbindingen toont. Ook al wijzigt de gebruiker deze. Je kunt dit bereiken met de onderstaande code:

         <script type="text/solfegescript">
           get_string("chord/new_ak")
         </script>