## Archivos de ayuda

ARREGLAME ¡Ahora usamos docbook! El código fuente para la documentación se escribe en texinfo y se convierte a texto html plano. Adicionalmente a enlaces a otras ayudas, puede escribir enlaces que pueden iniciar y configurar un ejercicio al hacer clic en ellos, como ahref(solfege:/harmonic-interval, this one).

Siéntase libre de hacer cualquier pregunta o escribir alguna documentación para Solfege, incluso le puedo dar un curso rápido de texinfo via email si es necesario...

### La literal especial `solfege:`, enlaces

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

`protocol`

  Opcional, si es omitido, enlaza a un archivo html. Un posible valor: `solfege`.

`action`

  Opcional, valores posibles: `practise`, `config` o `statistics`. Si se omite, verá la misma parte del ejercicio que usó por última vez. Si no se usó un ejercicio en la última sesión, verá la página de práctica.

`exercise`

  Valores posibles: `chord, harmonic-interval, melodic-interval, sing-interval, identify-scale, dictation, id-by-name, twelve-tone, sing-chord, id-tone, compare-intervals, rhythm`

`lessoncollection`

  Use el valor `solfege` para archivos distribuidos con Solfege. Use `user` para sus propias archivos guardados `$HOME/lessonfiles`. (Opcional, solo usado con lecciones basadas en ejercicios.)

`lessonfile`

  Nombre archivo. (Opcional, slo se usa con lecciones basadas en ejercicios.)

`configuration`

  Opcional. Asignaciones o parámetros separados por semi-comas. Ejemplo:

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

### Listado de variables usados para las configuraciones

Estos se pueden usar con todos los ejercicios que tengan la opción de Nueva pregunta automáticamente en la página de configuración.

`new_question_automatically = true | false`

  ¿Se le deberá hacer una pregunta nueva al usuario de forma automática una vez que conteste correctamente?

`seconds_before_question = float`

  Definir el número de segundos antes de que se se haga una nueva pregunta de forma automática.

#### Chord

`highest_instrument`, `middle_instrument`, `lowest_instrument`,

  integer 0-127

`highest_instrument_velocity`, `middle_instrument_velocity`, `lowest_instrument_velocity`,

  entero 0-127

#### Intervalo armónico

`highest_instrument`, `lowest_instrument`,

  entero 0-127

`highest_instrument_velocity`, `lowest_instrument_velocity`,

  entero 0-127

`override_default_instrument`

  booleano

`intervals`

  lista de enteros, [1, 2, ... 15, 16]

`highest_tone`, `lowest_tone`,

  Nombre de una nota, por ejemplo `c`, `fis,` or `d''`

`new_question_automatically`

  booleano

`seconds_before_new_question`

  flotante

#### Intervalo armónico e intervalo melódico

`disable_unused_intervals`

  Si usa la interface de botones para identificar intervalos, use esta variable para hacer que los botones sean insensibles que representen intervalos por los que el programa no preguntará. Esta variable es de tipo `boolean`.

#### Intervalo melódico y cantar intervalo

`number_of_intervals`

  integer

`ask_for_intervals_nn`

  list of integers: [-16

#### Identificar escala

`scales`

  lista de tipos de escala: ['ionian', 'dorian', 'phrygian', 'lydian', 'mixolydian', 'aeolian', 'lokrisk', 'harmonic_minor', 'melodic_minor']

#### Id by name, dictation, harmonic progression dictation

Solamente para especificar una lección.

#### Id tone

`c_weight`

  0..1000

`one_chance_only`

  boolean

`warning_sound`

  boolean

`repeat_question`

  boolean