4.5 Résolution de problèmes — tout remettre à plat

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 d'entrée. 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 arrive, 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' {
%{
 c4 c c c
 d d d d
%}
}

Maintenant commencez à décommenter petit à petit le partie de basse jusqu'à ce que vous localisiez la ligne qui pose problème.

Une autre technique de déboguage très utile est la construction d'Exemples minimaux.

Other languages: English.