Music-format

# Format de la musique

L'interpréteur de musique utilise un langage, similaire à celui utilisé dans GNU Lilypond. Un exemple en dira plus qu'un long discours :

      \staff{
         c, g cisis' < e' g' cis > cis
      }

L'apostrophe (') et la virgule (,) sont utilisés pour indiquer dans quelle octave est la note. Les noms de note sont : `c d e f g a b`, avec des terminaisons comme ceci pour indiquer les altérations : `ceses ces cis cisis` (do bb, do b, do #, do ##). Les silences sont indiqués par un `r`. Les notes faisant partie d'un même accord sont mises entre les signes 'inférieur à' et 'supérieur à' : `<c e g>`

# `\relative`

Le très utile mode `\relative`, comme celui qu'on trouve dans Lilypond, vous évite de taper un tas de virgules et d'apostrophes. L'interpréteur va regarder dans quel octave est la note précédente, et placer la note dans l'octave qui fera l'intervalle le plus petit possible. Regardez les deux exemples suivants :

      \staff\relative c'{
         \key d \time 3/4
         d a a | a2 fis8 a | d4 b b | b2
      }

      \staff\relative c'{
        c e g c e g c e g
      }

# T-uplets

Les T-uplets marchent exactement comme dans GNU Lilypond.

      \times fraction musicexpression

par exemple

      c4 \times 2/3 { d8 d d } e4

Utilisez les commandes `\tupletUp` et `\tupletDown` pour forcer les t-uplets à se placer au dessus ou au dessous de la portée. `\tupletBoth` laisse Solfege décider où placer les t-uplets. (Malheureusement, le code pour les t-uplets n'est pas encore fini, donc pour l'instant `\tupletBoth` donne le même résultat que `\tupletUp`.)

# Clés

Vous pouvez choisir la clé avec la commande `\clef clefname`. La clé par défaut est la clé `violin`. Les clés suivantes sont possibles :

- `violin` (également applelée `treble`, clé de sol)
- `bass` (clé de fa)
- `subbass`
- `baritone`
- `varbaritone`
- `tenor`
- `alto`
- `mezzosoprano`
- `soprano`
- `french`

Un exemple simple :

      \staff{
         \clef bass
         c e g <c e g c'>
      }

# Armure de la clé

Utilisez la commande `\key` pour choisir l'armure :

      \key c \major
      \key e \minor

(fes est l'armure avec le plus de bémols, et eis est l'armure avec le plus de dièses permise)

# Indication de temps

Utilisez la commande `\time` pour fixer l'indication de temps :

      \staff{
          \time 7/8 [c8 c c] d4 e
      }

# `\addvoice`

Utilisez `\addvoice` pour écrire de la musique polyphonique :

      \staff\relative c'{
          \stemup c d e f | g2 g
      }
      \addvoice\relative c'{
          \stemdown c4  b c2 e2 e
      }

# Liaisons

Liez les notes ensemble en utilisant le caractère tilde (`~`). Par exemple :

      \staff\relative c''{
          g ~ [g8 e] f4~ <g f c> ~ <g e c>
      }

# Sauter un ou plusieurs temps

Si vous utilisez le nom de note `s`, un blanc sera laissé pour le temps sauté, sans qu'aucune note soit affichée. Par exemple :

      \staff\relative c'{ c d e f g }
      \addvoice\relative c'{
         \stemDown
         s2 c4 s e4
      }

# Commandes internes

La commande `\transpose` est utilisée par le programme pour transposer des questions. Même si le programme n'indique pas de message d'erreur si cette commande est utilsée dans un fichier leçon, vous ne devez pas l'utiliser : La transposition aléatoire cesserait alors de fonctionner.