3.2 Comment les fichiers LilyPond sont organisés

La mise en forme des fichiers d'entrée de LilyPond est vraiment peu astreignante, afin d'offrir assez de souplesse aux utilisateurs expérimentés pour qu'ils puissent organiser leurs fichiers comme ils l'entendent. Cependant, les nouveaux utilisateurs peuvent parfois se perdre en raison de cette souplesse. Cette section présente sommairement l'organisation du code LilyPond, en privilégiant la simplicité au détriment de certains détails. Vous trouverez une description plus complète dans Structure de fichier.

La plupart des exemples de ce manuel sont de courts fragments, par exemple

c4 a b c

Comme vous le savez maintenant (du moins nous l'espèrons), ceci ne peut pas être traité en tant que tel. Il s'agit de formes abrégées des exemples complets ; pour pouvoir être traitées, elles doivent au moins être encadrées par des accolades :

{
  c4 a b c
}

La plupart des exemples font aussi intervenir la commande \relative, suivie de c' ou c''. Elle n'est pas à proprement parler nécessaire pour le traitement des exemples, mais dans la plupart des cas le résultat sera vraiment déplorable si vous l'oubliez.

     
     \relative c'' {
       c4 a b c
     }

C'est ici que nous entamons les choses sérieuses : le code LilyPond, sous cette forme, est en réalité un autre raccourci. Même s'il est traité sans problème, et aboutit au bon résultat, c'est une forme abrégée de :

\score {
  \relative c'' {
    c4 a b c
  }
}

Un bloc \score doit commencer par une et une seule expression musicale. Rappelez-vous que cette expression peut être ce que vous voulez, d'une note toute seule à un gigantesque

{
  \new GrandStaff <<
    collez ici la partition complète de votre opéra de Wagner préféré
  >>
}

Dès lors que tout cela est entre accolades : { ... }, c'est une et une seule expression musicale.

Le bloc \score peut contenir d'autres éléments, tels que

\score {
  { c'4 a b c' }
  \layout { }
  \midi { }
  \header { }
}

Certains préfèrent mettre ces commandes en dehors du bloc \score — par exemple, on met souvent le \header au-dessus. C'est juste là une autre forme abrégée que LilyPond accepte.

Une autre abréviation pratique est la possibilité de définir des variables — également appelées « identificateurs ». Dans tous les modèles, vous trouverez :

melodie = \relative c' {
  c4 a b c
}

\score {
  { \melodie }
}

Lorsque LilyPond examinera ce fichier, il va prendre la valeur de la variable {melodie, c'est-à-dire tout ce qui suit le signe =, et l'insérer partout où il tombera sur \melodie. Vous êtes libre de choisir comment dénommer vos variables¹ ; ce peut être melodie, global, maindroitepiano, ou laTeteAToto. Pour plus de détails, voir Économiser du temps grâce à des identificateurs et fonctions.

Pour une description complète du format des fichiers d'entrée, voir Structure de fichier.

Other languages: English.