5.1 Suggestions générales

Voici quelques conseils qui vous permettront d’éviter, voire même résoudre, la plupart des problèmes de saisie.

• Ajoutez toujours le numéro de version dans chaque fichier, quelle que soit sa taille. Par expérience, il est très difficile de se rappeler quelle version de LilyPond a servi au moment de la création d’un fichier. Ceci s’avèrera d’autant plus utile lors d’une mise à jour (convert-ly requiert la présence d’une ligne \version) ou si vous transmettez votre fichier à d’autres utilisateurs – y compris pour demander de l’aide sur les listes de diffusion. Vous noterez par ailleurs que tous les fichiers modèles de LilyPond ont une mention \version.
• Une mesure par ligne de texte. Si la musique en elle-même ou le résultat que vous désirez contient quelque chose de compliqué, il est souvent bon de n’écrire qu’une seule mesure par ligne. Économiser de la place en tassant huit mesures par ligne, ça ne vaut pas vraiment le coup si l’on doit corriger vos fichiers.
• Ajoutez des contrôles de limite ou numéro de mesure et d’octaviation – voir Vérification des limites et numéros de mesure et Vérifications d’octave. Si vous avez ajouté des contrôles de loin en loin et que vous faites une erreur, vous pourrez la retrouver plus rapidement. « De loin en loin », qu’est-ce à dire ? Cela dépend de la complexité de la musique. Pour de la musique très simple, à certains endroits stratégiques. Pour de la musique très complexe ou avec une multiplicité de voix, peut-être à chaque mesure.
• Ajoutez des commentaires. Utilisez soit des numéros de mesure (assez souvent), soit des références au contenu musical – « second thème des violons », « quatrième variation », etc. Vous pouvez ne pas avoir besoin des commentaires lorsque vous écrivez une pièce pour la première fois, mais si vous souhaitez y revenir deux ou trois ans plus tard pour changer quelque chose, ou si vous donnez le fichier source à un ami, ce sera beaucoup plus difficile de déterminer vos intentions ou la manière dont votre fichier est structuré si vous n’y avez pas adjoint de commentaires.
• Mentionnez les durées au début de chaque section ou variable. Si vous saisissez c4 d e au début d’une phrase, vous vous épargnerez des problèmes si, plus tard, vous modifiez votre musique.
• Indentez les accolades et indications de musique en parallèle. Beaucoup de problèmes viennent d’un défaut de parité entre { et } ou << et >>. Par exemple,

  \new Staff {
    \relative {
      r4 g'8 g c8 c4 d |
      e4 r8 |
      % Ossia section
      <<
        { f8 c c | }
        \new Staff {
          f8 f c |
        }
      >>
      r4 |
    }
  }
  

  est bien plus facile à appréhender que

  \new Staff { \relative { r4 g'8 g c4 c8 d | e4 r8
  % Ossia section
  << { f8 c c } \new Staff { f8 f c } >> r4 | } }
  

• Séparez les affinages de mise en forme de la musique elle-même, ne serait-ce qu’en positionnant les dérogations au sein du bloc \layout :

  \score {
    …musique…
    \layout {
     \override TabStaff.Stemstencil = ##f
   }
  }
  

  Ceci n’aura par pour effet de générer un contexte supplémentaire, mais s’appliquera dès sa création. Voyez Économie de saisie grâce aux identificateurs et fonctions et Feuilles de style.