Helpfile-format

On this page...

# Fichiers d'aide

La documentation en ligne est écrite dans le format utilisé par PmWiki.

La documentation est écrite pour être lue depuis Solfege mais peut bien sûr être vue dans un navigateur web.

Ce qui rend les fichiers html générés différents des fichier html normaux, c'est qu'en plus des liens avec d'autres fichiers d'aide, vous pouvez écrire des liens qui vont démarrer et configurer un exercice, comme celui ci.

N'hésitez pas à poser des questions si vous voulez écrire de la documentation pour Solfege.

## Les liens spéciaux `solfege:`

`protocol:action/exercise/lessoncollection/lessonfile?configuration`

`protocol`
  Option, s'il est omis le lien pointe sur un fichier html. Une valeur possible: `solfege`.
`action`
  Option, valeurs possibles: `practise`, `config` ou `statistics`. S'il est omis, vous verrez le même onglet de l'exercice que la dernière fois que vous l'avez utilisé. Si l'exercice n'a pas été utilisé dans cette session, vous verrez l'onglet exercices.
`exercise`
  Valeurs possibles: `chord, harmonic-interval, melodic-interval, sing-interval, identify-scale, dictation, id-by-name, twelve-tone,` `sing-chord, id-tone, compare-intervals, rhythm`
`lessoncollection`
  Utilisez la valeur `solfege` pour les fichiers distribués avec Solfege. Utilisez `user` pour vos propres fichiers stockés dans `$HOME/lessonfiles`. (Option, seulement utilisé avec les exercices basés sur des fichiers leçons.)
`lessonfile`
  Nom de fichier. (Option, utilisé seulement avec les exercices basés sur des fichiers leçons.)
`configuration`
  Option. Liste de définitions séparées par des points virgules. Exemple:

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

## Liste des variables utilisées pour la configuration

Les deux suivantes peuvent être utilisées avec tous les exercices qui ont l'option Nouvelle question automatique dans l'onglet de configuration.

`new_question_automatically = true | false`
  Faut-il poser une nouvelle question automatiquement lorsque la précédente a été résolue ?
`seconds_before_question = float`
  Indique le nombre de secondes de délai avant de poser automatiquement une nouvelle question.

### Accords

`highest_instrument`
`middle_instrument`
`lowest_instrument`
  entier 0-127
`highest_instrument_velocity`
`middle_instrument_velocity`
`lowest_instrument_velocity`
  entier 0-127

### Intervalles harmoniques

`highest_instrument`
`lowest_instrument`
  entier 0-127
`highest_instrument_velocity`
`lowest_instrument_velocity`
  entier 0-127
`override_default_instrument`
  booléen
`intervals`
  liste d'entiers, [1, 2, ... 15, 16]
`highest_tone`
`lowest_tone`
  Nom de note, par exemple `c`, `fis,` or `d''`
`new_question_automatically`
  booléen
`seconds_before_new_question`
  nombre (float)

### Intervalles harmoniques et mélodiques

`disable_unused_intervals`
  Si vous utilisez les boutons de l'interface pour identifier les intervalles, utilisez cette variable pour rendre inopérants les boutons qui représentent les intervalles que le programme ne demande pas. Cette variable est un `booléen`.

### Intervalles mélodiques et chanter l'intervalle

`number_of_intervals`
  entier
`ask_for_intervals_nn`
  liste d'entiers: [-16

FIXME

### Gammes et modes

`scales`
  liste de types de gammes : ['ionian', 'dorian', 'phrygian', 'lydian', 'mixolydian', 'aeolian', 'lokrisk', 'harmonic_minor', 'melodic_minor']

### Reconnaître, dictée de notes, dictée d'accords

Seulement spécifier le fichier leçon.

### Trouver la note

`c_weight`
  0..1000
`one_chance_only`
  booléen
`warning_sound`
  booléen
`repeat_question`
  booléen