Suivant : , Haut : Organisation des fichiers LilyPond


3.1.1 Introduction à la structure de fichier LilyPond

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, ces formeulations 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
     }

[image of music]

C'est ici que nous passons aux 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.

Un autre raccourci 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 rencontrera \melodie. Vous êtes libre de choisir comment dénommer vos variables1 ; ce peut être melodie, global, maindroitepiano, ou laTeteAToto. Pour plus de détails, voir with identifiers and functions Économies de saisie grâce aux identificateurs et fonctions.

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


Notes de bas de page

[1] Les noms de variables sont sensibles à la casse, et ne peuvent contenir ni chiffre, ni tiret, ni caractère accentué.


Suivant : , Haut : Organisation des fichiers LilyPond

Cette page documente LilyPond-2.11.40 (branche de développement).

Rapportez toute anomalie en français à lilypond-user-fr@gnu.org ou en anglais à http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs

Vos suggestions à propos de la documentation sont les bienvenues.

Autres langues : English.