5.4 Résolution de problèmes
Tôt ou tard, vous écrirez un fichier que LilyPond ne peut pas compiler. Les messages que LilyPond affiche peuvent vous aider à trouver l’erreur, mais dans beaucoup de cas vous aurez besoin de faire quelques recherches pour déterminer la source du problème.
Pour ce faire, les outils les plus puissants sont le commentaire de
fin de ligne, indiqué par %, et le commentaire multilignes (ou
bloc de commentaire), indiqué par %{ … %}. Si vous ne
pouvez localiser le problème, commencez par mettre en commentaire de
grandes parties de votre fichier source. Après avoir mis en
commentaire une section, essayez de compiler à nouveau. Si cela
fonctionne, c’est que le problème se situe dans cette partie du
fichier. Si cela ne fonctionne pas, continuez à mettre en commentaire
d’autres sections, jusqu’à ce que vous ayez quelque chose qui compile.
Dans un cas extrême, vous pourriez en arriver à
\score {
<<
% \melodie
% \harmonie
% \basse
>>
\layout{}
}
c’est-à-dire un fichier sans aucune musique.
Si cela se produit, ne vous découragez pas. Décommentez un peu, la
partie de basse par exemple, et voyez si ça fonctionne. Si ce n’est pas
le cas, placez en commentaire toute la partie de basse, mais laissez
\basse décommenté dans le bloc \score.
basse = \relative {
%{
c'4 c c c
d d d d
%}
}
Maintenant commencez à décommenter petit à petit la partie de
basse jusqu’à ce que vous localisiez la ligne qui pose
problème.
Une autre technique de débogage très utile est la construction d’un exemple minimaliste.