2.1.3 Travailler sur des fichiers texte

Le traitement des fichiers source de LilyPond est semblable à celui du code de nombreux langages de programmation répandus : la casse est prise en compte, et les caractères considérés comme espaces ont généralement peu d'importance. Les expressions sont délimitées par des accolades { }, et les commentaires par % ou %{ ... %}.

Si cette phrase vous paraît incompréhensible, ne vous en faites pas ! Tous ces termes vont être expliqués :

• La casse : LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale n'a pas la même valeur qu'une lettre minuscule. Les notes, par exemple, doivent être entrées en minuscules : { c d e } est un code valide, alors que { C D E } produira un message d'erreur.
• Les espaces multiples : LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la ligne. { c d e } a le même sens que { c     d   e } ou que

                {
       c                        d
        e }
  

  Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude à prendre est d'indenter les blocs de code avec soit des tabulations soit des doubles espaces :

       {
         c d e
       }
  

• Expressions musicales : Tout morceau saisi dans LilyPond doit être placé entre { accolades }. Ces caractères indiquent à LilyPond que ce bloc de texte est une et une seule expression musicale, tout comme les parenthèses `()' en mathématiques. Il est préférable, pour éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à moins qu'ils se trouvent au début ou à la fin d'une ligne.

  Une fonction — \relative { } par exemple — compte également comme une seule expression musicale.

• Les commentaires : Un commentaire est une indication pour tout lecteur humain d'un fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun effet sur la partition imprimée. On distingue deux types de commentaires :
  • la ligne de commentaire, introduite par le symbole `%' : tout ce qui suit ce symbole sur cette ligne sera ignoré.
  • le bloc de commentaire, qui peut être de plusieurs lignes voire de toute une section : tout ce qui se trouve entre %{ et %} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
  Le fragment suivant met en évidence quelques usages possibles des commentaires :

       % voici les notes de "ah vous dirai-je maman"
        c4 c g' g a a g2
       
       %{
          Ces lignes et les notes qui suivent
          seront ignorées, car elles se trouvent
          dans un bloc de commentaire.
       
          g g f f e e d d c2
       %}
  

Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans Suggestions de saisie des fichiers LilyPond.

Autres langues : English, español, deutsch.