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...

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]
          

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

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

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

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]

Identify scale(Identificeer toonladder)

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

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

Hier kun je alleen het lesbestand opgeven.

Id tone(Identificeer de noot)

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

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>