LilyPond — Utilisation des programmes

1.1 Utilisation habituelle

La plupart des utilisateurs de LilyPond le font au travers d’une interface graphique (GUI pour graphical user interface). Si vous ne l’avez pas encore parcouru, lisez le Tutoriel. Si vous utilisez un éditeur alternatif pour rédiger vos fichiers LilyPond, référez-vous à la documentation de celui-ci.

1.2 Utilisation en ligne de commande

Nous nous intéresserons ici aux spécificités de LilyPond employé en ligne de commande. La ligne de commande permet de faire appel à certaines options particulières. D’autre part, certains utilitaires associés, tel que midi2ly, ne sont disponibles qu’en ligne de commande.

Par « ligne de commande », nous entendons l’interface de commande du système. Les utilisateurs de Windows seront certainement plus familiers des termes « fenêtre DOS » ou « invite de commande ». Quant aux utilisateurs de MacOS X, ils connaissent assurément les termes « console » et « terminal ».

Notre propos n’est pas ici d’expliquer ce qu’est l’interface de commande pour un système informatique ni comment elle fonctionne. Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux nombreuses documentations que vous pourrez trouver sur ce sujet.

/home/moi/lilypond-2.25.21/bin

C:\Utilisateurs\moi\lilypond-2.25.21\bin

/home/moi/lilypond-2.25.21/bin/lilypond musique.ly

lilypond [option]… fichier…

lilypond *.ly

lilypond fichier.ly 1> stdout.log
lilypond fichier.ly 2> stderr.log
lilypond fichier.ly &> tous.log

find . -name '*.ly' -exec lilypond '{}' \;

forfiles /s /M *.ly /c "cmd /c lilypond @file"

forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c lilypond @file"

forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c lilypond @file"

commande clé=valeur

set? FONTCONFIG_FILE=$INSTALLER_PREFIX/etc/fonts/fonts.conf
prependdir GUILE_LOAD_PATH=$INSTALLER_PREFIX/share/guile/1.8

#!/bin/sh
## les réglages par défaut

username=lily
home=/home
loopdevice=/dev/loop0
jaildir=/mnt/lilyloop
# le préfixe (sans slash au début !)
lilyprefix=usr/local
# le répertoire du système où lilypond est installé
lilydir=/$lilyprefix/lilypond/

userhome=$home/$username
loopfile=$userhome/loopfile
adduser $username
dd if=/dev/zero of=$loopfile bs=1k count=200000
mkdir $jaildir
losetup $loopdevice $loopfile
mkfs -t ext3 $loopdevice 200000
mount -t ext3 $loopdevice $jaildir
mkdir $jaildir/lilyhome
chown $username $jaildir/lilyhome
cd $jaildir

mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
chmod a+w tmp

cp -r -L $lilydir $lilyprefix
cp -L /bin/sh /bin/rm bin
cp -L /usr/bin/convert /usr/bin/gs usr/bin
cp -L /usr/share/fonts/truetype usr/share/fonts

# la formule magique de recopie des bibliothèques
for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh"  \
  "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=>  \
    \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed  \
      's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/'  \
        | sed '/.*=>.*/d'; done | sh -s

# les fichiers partagés pour Ghostscript...
      cp -L -r /usr/share/ghostscript usr/share
# les fichiers partagés pour ImageMagick
      cp -L -r /usr/lib/ImageMagick* usr/lib

### Partant du principe que test.ly est dans /mnt/lilyloop/lilyhome,
### on devrait pouvoir lancer :
### Attention : /$lilyprefix/bin/lilypond est un script qui
### définit LD_LIBRARY_PATH - c'est primordial
      /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly

1.3 Messages d’erreur

Différents messages d’erreur sont susceptibles d’apparaître au cours de la compilation d’un fichier :

Warning – Avertissement ¶

Ce type de message est émis lorsque LilyPond détecte quelque chose de suspect. Si vous avez demandé quelque chose qui sort de l’ordinaire, vous saurez probablement ce à quoi il est fait référence et ignorerez de tels messages sans remord. Néanmoins, les messages d’avertissement indiquent la plupart du temps une incohérence dans le fichier source.

Error – Erreur ¶

LilyPond a détecté une erreur. L’étape en cours, qu’il s’agisse de l’analyse, de l’interprétation des données ou bien du formatage, sera menée à son terme, puis LilyPond s’arrêtera.

Fatal error – Erreur fatale ¶

LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que très rarement, et la plupart du temps en raison d’une installation défectueuse des fontes.

Scheme error – Erreur Scheme ¶

Les erreurs qui interviennent lors de l’exécution de code Scheme sont gérées par l’interpréteur Scheme. L’utilisation du mode verbeux (options -V ou --verbose) vous permettra de localiser l’appel de fonction délictueux.

Programming error – Erreur de programmation ¶

LilyPond est confronté à une incohérence interne. Ce type de message est destiné à venir en aide aux développeurs et débogueurs. En règle générale, vous pouvez tout simplement les ignorer. Parfois, il y en a tant qu’ils masquent ce qui pourrait vous intéresser…

Aborted (core dumped) – Abandon ¶

Ce type de message indique que LilyPond a planté en raison d’une grave erreur de programmation. La survenance d’un tel message est considérée comme de la plus haute importance. Si vous y étiez confronté, transmettez un rapport de bogue.

Lorsque l’avertissement ou l’erreur est directement lié au fichier source, le message est libellé sous la forme

fichier:ligne:colonne: message
contenu de la ligne litigieuse

Un saut de ligne est placé dans la ligne de code, indiquant l’endroit précis du problème, comme ici :

test.ly:2:19: erreur: n'est pas une durée: 5
  { c'4 e'
           5 g' }

Notez que ces coordonnées constituent l’approximation au mieux par LilyPond dans le code ayant déclenché l’avertissement ou l’erreur. En règle générale, erreurs et avertissements surviennent lorsque LilyPond rencontre quelque chose d’inattendu. Lorsque la ligne indiquée ne vous semble pas comporter d’élément litigieux, remontez de quelques lignes dans votre code.

Par ailleurs, des diagnostics peuvent être déclenchés à n’importe quel moment au cours des différentes étapes du traitement. Par exemple, lorsque certaines parties de la source sont traitées plusieurs fois – sortie MIDI et sortie imprimable – ou qu’une même variable musicale est utilisée dans plusieurs contextes, peut apparaître le même message à plusieurs reprises. Les diagnostics effectués à une étape avancée du traitement, tels que les contrôles de mesure, sont aussi susceptibles d’apparaître plusieurs fois.

Vous trouverez d’autres informations sur les erreurs au chapitre Quelques erreurs des plus courantes.

1.4 Quelques erreurs des plus courantes

Les conditions amenant aux erreurs qui suivent sont fréquentes, bien qu’elles ne soient pas évidentes ni facilement localisables. Nous espérons que ces explications vous aideront à les résoudre plus facilement.

\override VerticalAxisGroup.staff-affinity = ##f

\score {
  % Invalide ! Génère l'erreur : syntax error, unexpected \new
  % en français : erreur de syntaxe : \new inattendu
  \new Staff { … }
  \new Staff { … }
}

2.1 LilyPond est une langue vivante

La syntaxe de LilyPond change de temps en temps, que ce soit pour rendre les fichiers plus faciles à lire et à écrire, ou pour intégrer de nouvelles fonctionnalités.

En voici un exemple flagrant :

Tous les noms des propriétés de \paper et \layout sont libellés sous la forme premier-deuxième-troisième. Nous avons constaté, une fois la version 2.11.60 mise à disposition, que la propriété printallheaders ne respectait pas cette convention. Aurions-nous dû la laisser telle que, au risque de dérouter les nouveaux utilisateurs par cette exception au formatage, ou bien la modifier – ce qui allait obliger ceux qui l’avaient déjà utilisée à se mettre en chasse ?

Pour ce cas d’espèce, nous avons décidé de changer le nom de cette propriété en print-all-headers et de permettre à ceux qui avaient utilisé l’ancienne syntaxe de modifier automatiquement leurs fichiers à l’aide de notre utilitaire convert-ly.

Malheureusement, convert-ly ne peut pas réaliser toutes les modifications. Par exemple, dans les versions de LilyPond antérieures à la 2.4.2, les accents et les lettres non anglaises étaient entrées en utilisant LaTeX – par exemple, No\"el. À partir de la version 2.6, le caractère ë doit être entré directement dans le fichier LilyPond comme caractère UTF-8. convert-ly ne peut pas changer tous les caractères LaTeX en caractères UTF-8 ; vous devez mettre à jour vos vieux fichiers LilyPond manuellement.

Les règles de conversion de convert-ly reposent sur la recherche et le remplacement de motifs textuels plutôt que sur les capacités intellectuelles de LilyPond, en conséquence de quoi :

• La fiabilité de la conversion dépend de la qualité même de chaque jeu de règles ainsi que sur la complexité des modifications respectives à apporter. Certaines conversions peuvent donc requérir une intervention manuelle ; la version de « départ » devrait toujours rester disponible pour comparaison.
• Seules des conversions à une syntaxe plus récente sont possibles ; aucune règle ne permet de revenir en arrière. La copie de travail d’un fichier LilyPond ne devrait donc être mise à jour que lorsque la version sur laquelle il repose n’est plus maintenue. Des système de gestion de version tels que Git permettent de se tenir à jour sur plusieurs versions.
• LilyPond, ainsi que Scheme, gèrent plutôt bien l’emplacement ou l’absence d’espaces ; les règles utilisées par convert-ly tendent cependant à effectuer certains postulats en matière de style. Suivre le style adopté dans les différent manuels est un gage de mise à jour sans problème si l’on considère que ces manuels sont eux-même mis à jour avec convert-ly.

2.2 Considérations sur la ligne de commande

Ceci et les sections suivantes couvrent uniquement l’utilisation de convert-ly en ligne de commande. Les applications graphiques telles que Frescobaldi disposent de leur propre interface avec convert-ly.

Par « ligne de commande », nous entendons l’interface de commande du système. Les utilisateurs de Windows seront certainement plus familiers des termes « fenêtre DOS » ou « invite de commande ». Quant aux utilisateurs de MacOS X, ils connaissent assurément les termes « console » et « terminal ».

Notre propos n’est pas ici d’expliquer ce qu’est l’interface de commande pour un système informatique ni comment elle fonctionne. Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux nombreuses documentations que vous pourrez trouver sur ce sujet.

Consultez La variable d’environnement PATH pour savoir comment régler votre système d’exploitation afin de pouvoir utiliser convert-ly en ligne de commande sans avoir à en spécifier le chemin d’accès.

Réglage supplémentaire pour Windows

Les utilisateurs non-Windowsiens peuvent sauter cette section, tout comme les utilisateurs de Windows disposant déjà d’un interpréteur Python (version 3.8 ou supérieure).

convert-ly est en fait un script Python nommé convert-ly.py. Dans l’archive de LilyPond pour Windows, il se trouve dans le même répertoire que le binaire lilypond.exe et un interpréteur Python, python.exe. Partant du principe que vous avez déplié la version 2.25.21 dans un répertoire C:\Utilisateurs\moi et que PATH est correctement réglé, ill faudrait taper

python C:\Utilisateurs\moi\lilypond-2.25.21\bin\convert-ly.py monfichier.ly

ce qui deviendrait vite fastidieux.

Trois étapes sont nécessaires avant de pouvoir omettre l’interpréteur Python (python.exe) et l’extension .py.²

1. Sur la ligne de commande, tapez

   assoc .py=PythonScript
   

   pour associer l’extension .py au type de fichier « PythonScript ».

2. Pour l’instruction suivante, tapez

   ftype PythonScript=C:\Utilisateurs\moi\lilypond-2.25.21\bin\python.exe %1 %*
   

   pour obtenir que les fichiers du type « PythonScript » soient gérés par le python.exe de LilyPond. Il vous faudra régler le chemin d’accès sur la localisation effective, et ne pas oublier ‘%1 %*’ en fin de ligne !

3. Modifiez la variable d’environnement PATHEXT pour y ajouter .py aux valeurs déjà présentes. Ceci se fait de la même manière que pour PATH.

Quittez alors l’invite de commande puis relancez la pour tester que convert-ly --version est opérationnel.

2.3 Exécution de convert-ly

La commande convert-ly utilise les mentions de \version – que vous n’avez sûrement pas oublié de porter dans vos fichiers – pour déterminer le numéro de l’ancienne version. Mettre à jour votre fichier ne vous demande que de lancer

convert-ly -e monfichier.ly

dans le dossier où il se trouve. monfichier.ly sera mis à jour, avec un nouveau numéro en argument à \version, et vous aurez une copie de l’original : monfichier.ly~.

Vous pouvez convertir tous les fichiers d’un dossier en lançant

convert-ly -e *.ly

La conversion d’un jeu de fichiers répartis dans différents sous-répertoires s’obtient en lançant

find . -name '*.ly' -exec convert-ly -e '{}' \;

Ceci aura pour effet de rechercher et convertir tous les fichiers sources dans le répertoire en cours et dans tous ses sous-répertoires. Les fichiers convertis se trouveront à leur emplacement d’origine, tout comme les fichiers originels après renommage.

Les utilisateurs de Windows utiliseront l’instruction

forfiles /s /M *.ly /c "cmd /c convert-ly.py -e @file"

Par ailleurs, il est possible de spécifier de manière explicite le chemin d’accès au dossier comportant des sous-répertoires où se trouvent les fichiers sources, à l’aide de l’option /p :

forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c convert-ly.py -e @file"

Dans le cas où ce chemin d’accès comporte des espaces, l’intégralité de ce chemin devra être borné par des guillemets informatiques :

forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c convert-ly.py -e @file"

2.4 Options en ligne de commande pour convert-ly

L’utilitaire convert-ly se lance de la manière suivante :

convert-ly [option]… fichier…

Par défaut, convert-ly écrit ses données sur la sortie standard.

Vous pouvez utiliser les options :

--version

Affiche le numéro de version et quitte.

-d, --diff-version-update

Actualise la valeur de \version, uniquement si le fichier a été effectivement modifié. Un numéro de version instable sera « arrondi » au niveau de la version stable suivante à moins que celui-ci ne soit supérieur à la version cible. En l’absence de cette option, ou bien si une conversion quelle qu’elle soit a modifié le fichier, la mention de version est porté à la valeur de la règle appliquée la plus récente.

-e, --edit

Édite directement le fichier d’origine. Le fichier originel est renommé en monfichier.ly~ – autrement dit, un tilde est ajouté à l’extension. Ce fichier de sauvegarde, selon le système d’exploitation, peut être « caché ».

Vous pouvez aussi affecter un autre nom au fichier mis à jour et conserver votre fichier original en l’état :

convert-ly monfichier.ly > monnouveaufichier.ly

Voir aussi l’option --backup-numbered.

-b, --backup-numbered

Combiné à l’option ‘-e’, numérote les sauvegardes de telle sorte qu’aucune version antérieure ne soit écrasée. Si le fichier à traîter est monfichier.ly, tente d’enregistrer la sauvegarde sous monfichier.ly.~1~. Si il existe déjà, essaie monfichier.ly.~2~, etc. Les fichiers de sauvegarde, selon le système d’exploitation, peuvent être « cachés ».

-f, --from=from-patchlevel

Définit le numéro de version à partir duquel vous voulez effectuer les conversions. Lorsque cette option n’est pas activée, convert-ly tentera de le déterminer sur la foi de la mention de \version contenue dans le fichier. Cette option s’utilise sous la forme : --from=2.10.25

-h, --help

Affiche l’aide et quitte.

-l loglevel, --loglevel=loglevel

Règle le degré de verbosité à loglevel. Les différentes valeurs sont PROGRESS (par défaut), NONE, WARN, ERROR et DEBUG.

-n, --no-version

Normalement, convert-ly ajoutera une indication de \version à votre fichier s’il n’en comporte pas. Cette option permet de passer outre.

-c, --current-version

Par défaut, convert-ly ajuste la valeur de \version au numéro de version minimal requis. L’activation de cette option lui affectera la version courante de LilyPond (2.25.21).

-s, --show-rules

Affiche les conversions applicables et quitte. Il est possible d’affiner l’information à l’aide des options --from et --to.

-t, --to=to-patchlevel

pour n’appliquer les conversions que jusqu’à une version déterminée. Il s’agit par défaut de la dernière version disponible. Le niveau demandé doit être supérieur à la version de départ.

convert-ly --to=2.14.1 monfichier.ly

-v, --verbose

Affiche une description des règles pendant la conversion.

-w, --warranty

Affiche les informations de garantie et de copyright et quitte.

Lorsqu’il s’agit de fragments inclus dans un fichier Texinfo, il vous faudra lancer

convert-ly --from=… --to=… --no-version *.itely

Lorsque vous désirez savoir quels changements de syntaxe sont intervenus entre deux versions de LilyPond, lancez

convert-ly --from=ancienne --to=récente -s

2.5 Problèmes d’exécution de convert-ly

Lorsque le nom du fichier original ou le chemin qui y mène comporte des espaces, il est indispensable de le borner par des guillemets comme ci-dessous :

convert-ly "D:/Mes Partitions/Ode.ly" > "D:/Mes Partitions/nouveau Ode.ly"

Lorsque la commande convert-ly -e *.ly échoue parce que son expansion dépasse la taille maximale d’une ligne, vous pouvez lancer convert-ly dans une boucle. L’exemple suivant permet, sous Unix, de convertir tous les fichiers .ly d’un même répertoire :

for f in *.ly; do convert-ly -e $f; done

Pour l’interpréteur de commandes de Windows, la syntaxe consacrée est :

for %x in (*.ly) do convert-ly -e "%x"

Toutes les évolutions du langage ne sont pas forcément prises en charge. convert-ly ne tolère qu’une seule option de sortie à la fois. La mise à jour automatique du code Scheme inclus dans les fichiers LilyPond est plus qu’hasardeuse ; attendez-vous à devoir mettre les mains dans le cambouis.

2.6 Conversions manuelles

En théorie, un programme tel que convert-ly devrait pouvoir traiter n’importe quel changement de syntaxe. En effet, si un programme informatique sait interpréter aussi bien une version que l’autre, un autre programme informatique doit alors être capable de traduire un fichier donné³.

Le projet LilyPond ne dispose cependant que de ressources limitées : les conversions ne sont pas toutes automatisées. Lorsque convert-ly n’arrive pas à traîter un changement de syntaxe, il emet un avertissement tel que le suivant (à partir d’une règle de conversion pour 2.23.12).

Not smart enough to convert music following \fine.

Warning: \fine no longer enforces the end of the music.
If your piece has music following \fine that you want to
exclude when it is unfolded, use \volta to exclude it.
Please refer to the manual for details, and update manually.

2.7 Écriture de code supportant différentes versions

Dans certains cas, et tout particulièrement lorsque l’on se contitue une bibliothèque de code, il est souhaitable de pouvoir supporter différentes versions de LilyPond indépendamment des changements de syntaxe. Il est possible d’y parvenir à l’aide de portions de code englobées dans une expression conditionnelle et dont l’exécution se fera relativement à la version utilisée de LilyPond. La fonction ly:version? requiert un opérateur de comparaison op et une version de référence ver sous forme de liste d’entiers jusqu’à trois éléments. Les éléments absents sont ignorés, de telle sorte que '(2 20) est équivalent à toute version de la série 2.20. On peut donc en arriver à des constructions telles que :

#(cond
  ((ly:version? > '(2 20))
   (ly:message "Ce code sera exécuté avec un LilyPond postérieur à 2.20"))
  ((ly:version? = '(2 19 57))
   (ly:message "Ce code ne sera exécuté qu'avec LilyPond 2.19.57"))
  (else (ly:message "Ceci sera exécuté pour toutes les autres versions")))

Ceci viendra naturellement s’intégrer aux fonctions de bibliothèques pour permettre l’utilisation de syntaxes différentes. Une comparaison peut aussi apparaître au sein même de la musique comme ici :

{
  c' d' e' f'
  #(if (ly:version? = '(2 21))
       #{ \override NoteHead.color = #red #}
       #{ \override NoteHead.color = #blue #})
  g' a' b' c''
}

Note : Cette fonction ayant été introduite avec LilyPond 2.21.80, il n’est pas possible d’établir des comparaisons avec des versions qui lui sont antérieures.

3.1 Exemple de document musicologique

Un certain nombre d’ouvrages peuvent être illustrés par des extraits musicaux, qu’il s’agisse d’un traité de musicologie, d’un carnet de chant ou d’un manuel à l’exemple de celui que vous consultez actuellement. Cet agencement peut se faire « à la main » par importation d’un graphique PostScript ou PDF dans le traitement de texte. Les développeurs de LilyPond ont cependant créé un outil permettant d’automatiser ces opérations pour ce qui concerne les documents HTML, LaTeX, Texinfo et DocBook.

Un script – lilypond-book – se charge d’extraire les fragments de musique, puis de les mettre en forme avant de renvoyer la « partition » correspondante. Voici un court exemple utilisable avec LaTeX. Dans la mesure où il est suffisamment parlant, nous nous abstiendrons de le commenter.

Fichier d’entrée

\documentclass[a4paper]{article}

\begin{document}

Un document destiné à être traité par \verb+lilypond-book+ peut tout à
fait mélanger de la musique et du texte.
Par exemple,

\begin{lilypond}
\relative {
  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}

Les options sont indiquées entre crochets.

\begin{lilypond}[fragment,quote,staffsize=26,verbatim]
  c'4 f16
\end{lilypond}

Des extraits plus conséquents peuvent faire l'objet d'un fichier
indépendant, alors inclus avec \verb+\lilypondfile+.

\lilypondfile[quote,noindent]{screech-and-boink.ly}

(Si besoin, remplacez @file{screech-and-boink.ly} par
n'importe quel fichier @file{.ly} qui se trouve dans
le même répertoire que le présent fichier.)

\end{document}

Traitement

Enregistrez ces lignes dans un fichier nommé lilybook.lytex puis, dans un terminal, lancez

lilypond-book --output=out --pdf lilybook.lytex
lilypond-book (GNU LilyPond) 2.25.21 
Lecture de lilybook.lytex...
…nous vous épargnons le verbiage de la console…
Compilation de lilybook.tex...
cd out
pdflatex lilybook
…nous vous épargnons le verbiage de la console…
xpdf lilybook
(remplacez xpdf par votre lecteur de PDF habituel)

Le traitement par lilypond-book puis latex va générer un certain nombre de fichiers temporaires susceptibles d’encombrer inutilement votre répertoire de travail, aussi nous vous recommandons d’utiliser l’option --output=répertoire afin que les fichiers créés soient isolés dans le sous-répertoire répertoire.

Pour terminer, voici le résultat de cet exemple pour LaTeX.⁴

Résultat

Un document destiné à être traité par lilypond-book peut tout à fait mélanger de la musique et du texte. Par exemple, en utilisant la syntaxe Texinfo,

@lilypond
\relative {
  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond

produit

Les options permettant de contrôler l’apparence des extraits peuvent s’ajouter. Par exemple, en utilisant la syntaxe LaTeX,

\begin{lilypond}[fragment, quote, staffsize=26]
c'4 f16
\end{lilypond}

produit

Des extraits plus conséquents peuvent faire l’objet de fichiers indépendants, alors inclus avec \lilypondfile. Par exemple, en utilisant la syntaxe HTML,

<lilypondfile quote noindent>
  snippets/screech-and-boink.ly
</lilypondfile>

produit

Lorsque vous désirez y inclure un tagline, personnalisé ou non, l’intégralité de l’extrait devra apparaître dans une construction de type \book { }.

\book{
  \header{ title = "LilyPond fait ses gammes" }

  \relative { c' d e f g a b c }
}

3.2 Association musique-texte

Nous allons nous intéresser, dans les lignes qui suivent, à la manière d’intégrer LilyPond selon différents types de format.

\begin{lilypond}[liste,des,options]
  VOTRE CODE LILYPOND
\end{lilypond}

\lilypond[liste,des,options]{ VOTRE CODE LILYPOND }

\lilypondfile[liste,des,options]{fichier}

\musicxmlfile[liste,des,options]{fichier}

\begin{lilypond}[quote,fragment,staffsize=26]
  c'4 d' e' f' g'2 g'2
\end{lilypond}

\lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

\def\betweenLilyPondSystem#1{\endinput}

\begin{lilypond}[fragment]
  c'1\( e'( c'~ \break c' d) e f\)
\end{lilypond}

\def\betweenLilyPondSystem#1{
  \ifnum##1<2\else\expandafter\endinput\fi
}

\let\betweenLilyPondSystem\undefined

\def\onlyFirstNSystems#1{
  \def\betweenLilyPondSystem##1{%
    \ifnum##1<#1\else\expandafter\endinput\fi}
}

\onlyFirstNSystems{3}
\begin{lilypond}…\end{lilypond}
\onlyFirstNSystems{1}
\begin{lilypond}…\end{lilypond}

@lilypond[liste,des,options]
  VOTRE CODE LILYPOND
@end lilypond

@lilypond[liste,des,options]{ VOTRE CODE LILYPOND }

@lilypondfile[liste,des,options]{fichier}

@musicxmlfile[liste,des,options]{fichier}

@lilypond[quote,fragment]
c'4 d' e' f' g'2 g'
@end lilypond

@lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

<lilypond liste des options>
  VOTRE CODE LILYPOND
</lilypond>

<lilypond liste des options: VOTRE CODE LILYPOND />

<lilypondfile liste des options>fichier</lilypondfile>

<musicxmlfile liste des options>fichier</musicxmlfile>

<lilypond quote fragment staffsize=26>
  c'4 d' e' f' g'2 g'
</lilypond>

<lilypond quote fragment staffsize=11: <c' e' g'> />

<mediaobject>
  <imageobject>
    <imagedata fileref="music1.ly"
               role="printfilename" />
  </imageobject>
</mediaobject>

<inlinemediaobject>
  <textobject>
    <programlisting language="lilypond"
                    role="fragment verbatim staffsize=16
                          ragged-right relative=2">
\context Staff \with {
  \remove Time_signature_engraver
  \remove Clef_engraver}
  { c4( fis) }
    </programlisting>
  </textobject>
</inlinemediaobject>

3.3 Options applicables aux fragments de musique

Dans les lignes qui suivent, l’appellation « commande lilypond-book » fait référence à toutes celles vues plus haut et qui font appel à lilypond-book pour produire un extrait musical. Pour plus de simplicité, nous ne parlerons que de la syntaxe applicable à Texinfo (autrement dit, débutant par un ‘@’) afin qu’elles soient aisément distinguables des commandes LilyPond.

Nous attirons votre attention sur le fait que les différentes options sont lues de la gauche vers la droite. Si une option est transmise plusieurs fois, seule la dernière sera prise en compte.

Les commandes lilypond-book acceptent les options suivantes :

staffsize=hauteur

Définit la taille de portée à hauteur exprimée en points.

ragged-right

Produit des lignes en pleine largeur avec un espacement naturel. En d’autres termes, sera ajoutée la commande de mise en forme ragged-right = ##t. Il s’agit de l’option par défaut de la commande \lilypond{} en l’absence d’option line-width. C’est aussi l’option par défaut pour l’environnement lilypond lorsque l’option fragment est activée sans avoir défini explicitement de longueur de ligne.

noragged-right

Dans le cas où l’extrait tient sur une seule ligne, la portée sera étirée pour correspondre à la longueur de ligne du texte. Autrement dit, la commande de mise en forme ragged-right = ##f s’ajoute à l’extrait LilyPond.

line-width

line-width=taille\unité

Détermine la longueur de ligne à taille, exprimée en unité. unité peut prendre les valeurs cm, mm, in, pt ou bp. Cette option n’affectera que le résultat de LilyPond – la longueur de la portée – et en aucun cas la mise en forme du texte.

En l’absence d’argument ou lorsque l’option line-width n’est pas utilisée, lilypond-book tentera de déterminer une longueur de ligne par défaut pour les cas où les environnements lilypond ne font pas appel à ragged-right.

Voir aussi l’option papersize.

papersize=chaîne

Détermine le format du papier à chaîne (par exemple a5 ou letter) pour les fragments utilisant \book. Voir Formats de papier prédéfinis pour une liste des différentes tailles disponibles.

Cette option affecte le résultat de LilyPond – les dimensions de la feuille contenant le fragment musical – et en aucaun cas le texte. Une valeur non reconnue de chaîne sera rejetée. lilypond-book émettra un message d’avertissement et l’extrait utilisera le format par défaut, à savoir la taille de papier du documents pour LaTeX et Texinfo, et A4 pour le HTML et le DocBook.

Si l’option papersize est présente mais pas line-width (plus exactement une option line-width sans argument), LilyPond utilise sa propre estimation de la longueur de ligne par défaut de par l’extrait, ignorant aussi l’option quote – lilypond-book émettra toutefois un bloc de citation.

paper-width=taille\unité

Définit la largeur du papier à taille (exprimée en unité) pour les fragments musicaux utilisant \book. unité peut prendre les valeurs cm, mm, in, pt ou bp.

Cette option affecte le résultat de LilyPond – les dimensions de la feuille contenant le fragement musical – et en aucun cas le texte. Cette option, lorsqu’elle est présente, a préséance sur l’option papersize. En l’absence d’option paper-height, la hauteur de la feuille est déterminée à sa valeur par défaut de A4 (296mm).

paper-height=taille\unité

Définit la hauteur du papier à taille (exprimée en unité) pour les fragments musicaux utilisant \book. unité peut prendre les valeurs cm, mm, in, pt ou bp.

Cette option affecte le résultat de LilyPond – les dimensions de la feuille contenant le fragement musical – et en aucun cas le texte. Cette option, lorsqu’elle est présente, a préséance sur l’option papersize. En l’absence d’option paper-width, la largeur de la feuille est déterminée à celle du document pour LaTeX et Texinfo, et à la valeur par défaut de A4 (210mm) pour HTML et DocBook.

Exemple :

\lilypond[paper-width=10\cm, paper-height=57\mm]{
  \book {
    ...
  }
}

notime

Désactive l’impression des métriques et barres de mesure pour l’intégralité de la partition.

fragment

Laisse à lilypond-book le soin d’ajouter ce qui est indispensable, de telle sorte que vous pouvez vous contenter d’un

c'4

sans \layout, \score, etc.

nofragment

N’ajoute rien à ce qui se trouve dans l’environnement LilyPond. À noter qu’il s’agit de l’option par défaut.

inline

inline=vshift

Traite l’extrait pour une utilisation en ligne, autrement dit au fil du texte d’un paragraphe. L’extrait en lui-même est formaté avec un léger décalage à gauche (à peu près équivalent à celui sur la droite) tout en ignorant la valeur donnée à l’option en ligne de commande --left-padding.

En ce qui concerne LaTeX, l’image au fil du texte est décalée verticalement. vshift est un ratio de la hauteur de l’image. En l’absence d’argument est utilisée la valeur par défaut de -0.3, descendant ainsi l’image d’environ un tiers de sa hauteur. Cette valeur par défaut peut s’ajuster à l’aide de l’option en ligne de commande --inline-vshift.

Dans le cas d’une sortie Texinfo, ceci supprime l’insertion d’une ligne vide avant et après l’extrait. Dans le cas d’une sortie HTML, ceci supprime l’insertion des <p> et </p> encadrant l’extrait.

Afin que l’extrait apparaisse réellement au fil du texte dans les modes LaTeX et Texinfo, il est nécessaire de le positionner au sein même du paragraphe, autrement dit éviter toute ligne vide avant et après l’extrait. Par exemple, ce code LaTeX

Le motif
\lilypond[inline,staffsize=11]{
  { \time 2/4 r8 g'[ g' g'] | es'2 }
}
est bien connu.

devient

Le motif est bien connu.

indent=taille\unité

Définit l’indentation du premier système à taille, exprimée en unité – cm, mm, in, pt ou bp. Cette option n’affecte que LilyPond, et en aucun cas la mise en forme du texte.

noindent

Ramène l’indentation du premier système à zéro. Cette option n’affecte que LilyPond, et en aucun cas la mise en forme du texte. Dans la mesure où il s’agit du comportement par défaut, point n’est besoin de spécifier noindent.

quote

Réduit la longueur des lignes musicales de 2*0.4in (soit 2 * 10,16 mm) pour renvoyer l’extrait dans un bloc de citation. La valeur « 0,4 pouce » est contrôlée par l’option exampleindent.

exampleindent

Détermine la valeur de l’indentation qui sera utilisée par l’option quote.

Voir aussi l’option papersize.

relative

relative=n

Utilise le mode d’octave relative. Les notes sont donc par défaut positionnées relativement au do central. L’argument – un nombre entier – fourni à l’option relative spécifie l’octave de départ de l’extrait ; 1 correspond au do central. Cette option relative n’a d’effet que si elle est utilisée en combinaison avec l’option fragment ; autrement dit, l’option fragment est implicite dès lors que relative est explicité.

La documentation de LilyPond, comme nous l’avons déjà vu, use abondamment de lilypond-book. Elle utilise à cet effet quelques options particulières.

verbatim

L’argument de la commande lilypond-book est recopié textuellement dans le fichier généré, avant l’image de la partition. Cependant, cette option n’est pas pleinement opérationnelle lorsqu’un @lilypond{} se trouve au milieu d’un paragraphe.

L’utilisation conjointe d’un verbatim et de la commande lilypondfile permet de n’inclure textuellement qu’une seule partie du fichier source. lilypond-book reproduira alors textuellement la partie du fichier source comprise entre les commentaires begin verbatim et éventuellement end verbatim. Si l’on considère le fichier source suivant, la musique sera interprétée en mode relatif, mais la recopie du code ne comportera pas l’assertion du bloc relative :

\relative { % begin verbatim
  c'4 e2 g4
  f2 e % end verbatim
}

donnera dans un bloc verbatim précédant la partition :

  c4 e2 g4
  f2 e

Si d’aventure vous désirez traduire les commentaires et noms de variable dans le rendu textuel plutôt que dans le fichier source, vous devrez définir la variable d’environnement LYDOC_LOCALEDIR qui pointera vers un répertoire contenant l’arborescence des catalogues de messages – fichiers d’extension .mo – du domaine lilypond-doc.

texidoc

Option disponible uniquement avec Texinfo, et pour @lilypondfile.
Dès lors qu’un fichier toto.ly contient dans sa section \header un champ texidoc, l’appel de lilypond avec l’option --header=texidoc créera le fichier toto.texidoc. C’est l’option texidoc de lilypond-book qui aura pour effet de reproduire le contenu de ce toto.texidoc en préambule de l’extrait de partition – soit avant l’environnement example créé par l’option quote.

Prenons par exemple le fichier toto.ly dont le contenu est

\header {
  texidoc = "This file demonstrates a single note."
}
{ c'4 }

et quelque part dans notre document Texinfo test.texinfo

@lilypondfile[texidoc]{toto.ly}

La ligne de commande suivante produira le résultat escompté.

lilypond-book --pdf \
              --process="lilypond --header=texidoc" \
              test.texinfo

Tous les extraits inclus dans la documentations de LilyPond (voir le répertoire Documentation/snippets de la distribution) sont des fichiers .ly contenant de tels champs texidoc dans leur bloc \header.

Cette option est fort utile dans le cadre de l’adaptation en langue étrangère. En effet, s’il est spécifié dans le document Texinfo une clause @documentlanguage XX, la présence d’une variable texidocXX dans le bloc \header du fichier toto.ly entraînera la reproduction – par l’appel lilypond --header=texidocXX – du contenu de toto.texidocXX en lieu et place de celui de toto.texidoc. XX est en réalité une chaîne de deux caractères telle que « de » pour l’allemand ou « ca » pour le catalan.

doctitle

Option disponible uniquement avec Texinfo, et seulement pour @lilypondfile.
Cette option fonctionne selon le même principe que l’option texidoc : lorsqu’un fichier toto.ly contient dans son \header une variable doctitle et que lilypond est appelé avec l’option doctitle, le contenu de cette variable – une simple ligne de texte – sera recopié dans un fichier toto.doctitle puis inséré dans le document Texinfo sous la forme @lydoctitle texte. @lydoctitle doit faire l’objet d’une macro, définie dans le document Texinfo.

Il en va de l’option doctitle comme de l’option texidoc en matière d’adaptation en langue étrangère.

nogettext

Option disponible uniquement pour Texinfo.
Commentaires et noms de variable ne seront pas traduits dans la recopie textuelle du code.

printfilename

Lorsqu’un fichier source LilyPond est inclus à l’aide de lilypondfile, le nom du fichier sera reproduit juste au dessus de l’extrait. Si le résultat est un fichier HTML, il s’agira alors d’un lien. Seul le nom du fichier est imprimé ; autrement dit, le chemin d’accès au fichier est tronqué.

3.4 Utilisation de lilypond-book

lilypond-book produit un fichier qui aura, selon le format de sortie spécifié, l’extension .tex, .texi, .html ou .xml. Les fichiers .tex, .texi et .xml nécessitent un traitement complémentaire.

Instructions spécifiques à certains formats

LaTeX

Un document LaTeX destiné à l’impression ou à la publication peut se traiter de deux manières différentes : générer directement un PDF à l’aide de pdfLaTeX (XeLaTeX, luaLaTeX), ou bien générer un fichier PostScript avec LaTeX qui sera ensuite passé à un traducteur DVI-PostScript comme dvips. La première façon est de loin la plus simple et c’est celle que nous vous recommandons⁶ ; quelque soit votre préférence, sachez que vous pouvez aller du PostScript au PDF avec des outils tels que ps2pdf et pdf2ps – tous deux inclus dans la distribution de Ghostscript.

La production d’un PDF avec pdfLaTeX se fait en lançant les commandes

lilypond-book --pdf monfichier.lytex
pdflatex monfichier.tex

La séquence LaTeX/dvips/ps2pdf suivante permet de produire un PDF :

lilypond-book monfichier.lytex
latex monfichier.tex
dvips -Ppdf monfichier.dvi
ps2pdf monfichier.ps

Le fichier .dvi généré lors de ce traitement ne contient aucune tête de note, ce qui est tout à fait normal ; elles seront incluses lors de la génération du .ps puis dans le .pdf.

La commande dvips peut déclencher certains messages concernant des fontes, que vous pouvez ignorer sans scrupule.
Si vous utilisez latex en mode colonnage, n’oubliez pas d’ajouter -t landscape aux options de dvips.

Les environnements tels que

\begin{lilypond} … \end{lilypond}

ne sont pas interprétés par LaTeX. En fait, lilypond-book extrait ces « environnements » dans des fichiers accessoires et les traite par LilyPond. Il récupère ensuite les graphiques résultants et crée un fichier .tex dans lequel les macros \begin{lilypond}…\end{lilypond} sont remplacées par des commandes « d’inclusion de graphique ». C’est seulement à ce moment là que LaTeX est lancé – bien que LaTeX aura préalablement tourné, cela aura été en fait sur un document « vide » et pour calculer les dimensions du papier et la longueur de ligne pour l’extrait LilyPon.

Problèmes connus et avertissements

La commande \pageBreak est inopérante dans un environnement \begin{lilypond}…\end{lilypond}.

Il en va de même pour un certain nombre de variables appartenant au bloc \paper. Utilisez, entre autres, un \newcommand avec la macrocommande \betweenLilyPondSystem dans le préambule.

\newcommand{\betweenLilyPondSystem}[1]{\vspace{36mm}\linebreak}

Texinfo

La génération d’un document Texinfo – quel que soit le format final – s’obtient grâce aux commandes Texinfo habituelles, c’est à dire texi2pdf, texi2dvi ou texi2any selon le résultat que vous désirez obtenir. Par défaut, texi2pdf recourt à pdftex pour son traitement, ce que l’on peut constater à l’affichage en console. En pareil cas, lancer lilypond-book avec l’option --pdf générera des bribes de .pdf plutôt que des fichiers .eps. pdftex est incapable d’inclure ces derniers et émettra un message d’erreur dans le cas contraire.

Pour plus de détails, consultez la documentation de Texinfo.

Options en ligne de commande

lilypond-book accepte les options suivantes :

-f format

--format=format

Spécifie le type de document à traiter : html, latex, texi (valeur par défaut), texi-html ou docbook. Lorsque cette option n’est pas mentionnée, lilypond-book tente de déterminer automatiquement le format – voir Extensions de nom de fichier. À l’heure actuelle, texi-html est équivalant à texi.

-F filtre

--filter=filtre

Passe les extrait au travers de filtre avant de traiter le fichier. Cette option ne génèrera pas de partition, mais permet d’appliquer les mises à jour de LilyPond aux extraits avant de traiter le fichier par un nouvel appel à lilypond-book, cette fois-ci sans l’option --filter. Exemple :

lilypond-book --filter='convert-ly --from=2.0.0 -' mon-book.tely

lilypond-book n’autorise pas l’utilisation conjointe des options --filter et --process.

-h

--help

Affiche un bref résumé des options.

-I dir

--include=répertoire

Ajoute répertoire au chemin des inclusions. Lorsque des extraits ont déjà été compilés dans l’un des répertoires inclus, lilypond-book ne les réécrira pas dans le répertoire de sortie ; il sera donc nécessaire, dans la suite du traitement par texi2any ou latex, de penser à utiliser cette même option -I répertoire.

-l loglevel

--loglevel=loglevel

Détermine le degré de verbosité à loglevel. Les différentes valeurs admises sont NONE, ERROR, WARN, PROGRESS (par défaut) et DEBUG. Lorsque cette option n’est pas activée, c’est le niveau déterminé par la variable d’environnement LILYPOND_BOOK_LOGLEVEL qui sera utilisé.

-o rép

--output=répertoire

Regroupe les fichiers générés dans répertoire. lilypond-book crée un certain nombre de fichiers à l’usage de LilyPond. Afin d’éviter de polluer votre répertoire source, nous vous conseillons d’utiliser l’option --output, puis de vous rendre dans ce répertoire pour y lancer les commandes latex ou texi2any.

lilypond-book --output=out monfichier.lytex
cd out
…

--skip-lily-check

Désactive la mise en échec en l’absence de sortie de LilyPond.
Option utilisée pour générer la documentation de LilyPond au format Info sans images.

--skip-png-check

Désactive la mise en échec en l’absence d’images PNG correspondant aux fichiers EPS.
Option utilisée pour générer la documentation de LilyPond au format Info sans images.

--lily-output-dir=rép

Écrit les fichiers lily-XXX dans rép et crée un lien vers le répertoire spécifié par --output. Cette option permet d’économiser du temps lors de la génération de documents qui se trouvent dans différents répertoires et partagent un certain nombre d’extraits identiques.

--lily-loglevel=loglevel

Détermine le degré de verbosité lors des appels à lilypond. Les valeurs autorisée de loglevel sont : NONE, ERROR, WARN, BASIC, PROGRESS, INFO (par défaut) et DEBUG. Lorsque cette option n’est pas activée, c’est le niveau déterminé par la variable d’environnement LILYPOND_LOGLEVEL qui sera utilisé.

--info-images-dir=répertoire

Formate la sortie Texinfo de telle sorte que Info cherche les images de musique dans répertoire.

--inline-vshift=vshift

En ce qui concerne le traitement par LaTeX, utiliser vshift aura pour effet de déplacer verticalement toutes les images au fil du texte. vshift est un ratio de la hauteur de l’image ; sa valeur par défaut est de -0.3, ce qui descendra donc les images d’environ un tiers de leur hauteur respective. Ce facteur peut s’adapter localement en fournissant un argument à l’option inline de l’extrait.

--latex-program=programme

Utilise l’exécutable programme en lieu et place de latex. C’est l’option que vous utiliserez si vous préférez xelatex par exemple.

--left-padding=distance

Insère du blanc à gauche de l’extrait LilyPond. distance est exprimée en millimètres relativement au début de la portée. Sa valeur est par défaut de 3,0mm.

Rappelez-vous que la largeur d’un système dépend des élément positionnés à sa gauche, tels que numéro de mesure et noms d’instrument. Le décalage détermine la distance minimale entre le bord de l’image et le début de la portée (non indentée), ce qui permet d’obtenir un alignement vertical correct des extraits dans le document maître.

Cette option permet de « raccourcir » les lignes de portée et de les décaler vers la droite, de la distance donnée en argument.

Notez bien que distance, lorsqu’utilsée pour décaler, est arrondie à une valeur entière en big point (bp), unité pour les sorties PostScript et PDF – le bp correspond à 1/72 pouce, soit environ 0,353 mm. Ce n’est toutefois pas LilyPond qui raccourcira la longueur de la portée. Il se pourrait donc, si distance ne correspondait pas à un entier multiple de bp, que la longueur de portée paraisse modifiée.

-P commande

--process=commande

Traite les extraits LilyPond avec commande. Par défaut, il s’agit de lilypond.
Rappelez-vous que lilypond-book ne peut en même temps traiter l’option --filter et l’option --process.

--pdf

Crée des fichiers PDF. Si cette option n’est pas définie, seuls seront générés des fichiers PNG et EPS. Cette option permet d’intégrer directement du PDF dans des fichiers LaTeX ou Texinfo.

--redirect-lilypond-output

Le résultat des commandes est habituellement affiché dans le terminal. Cette option permet de rediriger tout le verbiage dans un journal situé dans le même répertoire que le fichier source.

--use-source-file-names

Cette option permet d’affecter aux fichiers correspondant aux extraits de musique le même nom que leur source. Elle n’est fonctionnelle que dans le cas où la partition est incluse à l’aide de lilypondfile, et que les répertoires mentionnés par les options --output-dir et --lily-output-dir diffèrent.

-V

--verbose

lilypond-book sait être volubile ! Cette option est équivalente à --loglevel=DEBUG.

-v

--version

Affiche le numéro de version.

Problèmes connus et avertissements

lilypond-book ne sait pas interpréter la commande Texinfo @pagesize. Dans le même ordre d’idée, des commandes LaTeX modifiant les marges et longueur de ligne mentionnées après le préambule seront ignorées.

Lorsqu’une section LilyPond contient plusieurs \score, seul le premier sera traité.

3.5 Extensions de nom de fichier

Vous pouvez affecter à votre fichier source n’importe quelle extension. Nous vous recommandons cependant un certain nombre d’extensions selon le format de sortie désiré – voir Utilisation de lilypond-book. Une extension hors du commun vous obligera à spécifier le format de sortie, alors que lilpond-book est en mesure de déterminer le format de sortie en fonction de l’extension du fichier source.

extension	format résultant
.html	HTML
.htmly	HTML
.itely	Texinfo
.latex	LaTeX
.lytex	LaTeX
.lyxml	DocBook
.tely	Texinfo
.tex	LaTeX
.texi	Texinfo
.texinfo	Texinfo
.xml	HTML

Lorsque le fichier source a la même extension que celle que lilypond-book affectera au fichier résultant et que vous lancez lilypond-book à partir du répertoire le contenant, vous verrez assurément un message du type « La sortie va écraser le fichier d’entrée ». Aussi ne saurions-nous trop vous conseiller d’utiliser l’option --output.

3.6 Exécution parallèle

Le script lilypond-book ne peut s’utiliser pour des traitements parallèles lorsque le répertoire de sortie est identique. Si vous le tentez, l’utiliation d’un fichier verrou forcera l’exécution séquentielle (dans un ordre arbitraire) des processus lilypond-book.

En d’autres termes, lorsque l’on veut traiter à la fois les documents foo.lytex et bar.lytex (via l’utilitaire make par exemple), il faut soit qu’il se situent dans des répertoires différents – disons foo/foo.lytex et bar/bar.lytex –, soit utiliser l’option de la ligne de commande --output avec des valeurs différentes.

Notez que LilyPond peut, de son côté, traiter plusieurs fichiers sources en parallèle. Dans la mesure où lilypond-book passe en une fois la liste des extraits du document à lilypond, il est possible d’avoir une exécution parallèle à l’aide son option -djob-count.

lilypond-book --process="lilypond -djob-count=4" \
              --output=foo \
              ... \
              foo.lytex

3.7 Modèles pour lilypond-book

Voici quelques canevas dédiés à lilypond-book. Si vous ne savez pas de quoi il retourne, lisez le chapitre Association musique-texte avec lilypond-book.

LaTeX

Vous pouvez inclure des partitions LilyPond dans un document LaTeX.

\documentclass{article}

% insérer ici tous les paquetages reconnus par les moutures de LaTeX
\usepackage[ngerman,finnish,english,french]{babel}
\usepackage{graphicx}
\usepackage{libertinus}

\usepackage{iftex}
\ifxetex
  % pour ce qui est de XeTeX
  \usepackage{xltxtra}
\else
  % inutile en l'absence de pdftex
  \usepackage[T1]{fontenc}
\fi


\begin{document}

\title{Un petit document avec LilyPond et \LaTeX}
\maketitle

Les commandes habituelles de \textbf{fontes} sont fonctionnelles y
compris au fil du \emph{texte}, étant donné qu'\textsf{elles sont
prises en charge par toutes les moutures de \LaTeX{}.} Lorsque
vous avez besoin de commandes particulières du style
\verb+\XeTeX+, pensez à les inclure dans un environnement
\verb+\ifxetex+. Vous pourrez ainsi utiliser l'instruction
\ifxetex commande \XeTeX{} \else commande XeTeX \fi qui, elle,
n'est pas reconnue par pdfTeX par défaut.

Vous pouvez inclure des commandes LilyPond directement dans votre texte,
comme ici~:

\smallskip
\begin[staffsize=12]{lilypond}
{ a2^"foo" b_"bar" c'8 c' c' c' }

\paper {
  property-defaults.fonts.serif = "Libertinus Serif"
}
\end{lilypond}
\smallskip

\noindent
Il est à noter que les fontes utilisées dans l'extrait LilyPond
doivent être définies au sein même de l'extrait, comme illustré.

\selectlanguage{ngerman}
Da die Standard-Eingabekodierung von \LaTeX{} UTF-8 ist,
funktionieren Umlaute u.\,ä. ohne \LaTeX-Akzentbefehle (ßäöü),
wenn sie von der Schriftart unterstützt werden.

\end{document}

Texinfo

Un document Texinfo est tout à fait capable de comporter des fragments de partition LilyPond. Si vous ne le savez pas encore, sachez que l’intégralité de ce manuel est rédigée en Texinfo.

\input texinfo 
@ifnottex
@node Top
@top
@end ifnottex

Du verbiage à la mode Texinfo

@lilypond
\relative {
  a4 b c d
}
@end lilypond

Toujours plus de texte Texinfo, puis des options entre crochets.

@lilypond[verbatim,fragment,ragged-right]
d4 c b a
@end lilypond

@bye

HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<body>

<p>
Un document pour lilypond-book peut absolument mélanger musique et
texte.  Par exemple,
<lilypond>
\relative {
  a'4 b c d
}
</lilypond>
</p>

<p>
Pourquoi pas un peu plus de lilypond, avec des options pour changer :

<lilypond fragment quote staffsize=26 verbatim>
a4 b c d
</lilypond>
</p>

</body>
</html>

3.8 Gestion de la table des matières

Les fonctions ici mentionnées sont incluses dans le paquetage OrchestralLily, disponible sur

https://repo.or.cz/w/orchestrallily.git

Certains utilisateurs privilégient la flexibilité dans la gestion du texte ; ils génèrent la table des matières à partir de LilyPond et la récupèrent dans LaTeX.

Export de la table à partir de LilyPond

Nous partons du principe que LilyPond a généré un seul fichier comportant tous les mouvement de la partition.

#(define (oly:create-toc-file layout pages)
  (let* ((label-table (ly:output-def-lookup layout 'label-page-table)))
    (if (not (null? label-table))
      (let* ((format-line (lambda (toc-item)
             (let* ((label (car toc-item))
                    (text  (caddr toc-item))
                    (label-page (and (list? label-table)
                                     (assoc label label-table)))
                    (page (and label-page (cdr label-page))))
               (format #f "~a, section, 1, {~a}, ~a" page text label))))
             (formatted-toc-items (map format-line (toc-items)))
             (whole-string (string-join formatted-toc-items ",\n"))
             (output-name (ly:parser-output-name))
             (outfilename (format #f "~a.toc" output-name))
             (outfile (open-output-file outfilename)))
        (if (output-port? outfile)
            (display whole-string outfile)
            (ly:warning (G_ "Impossible d'ouvrir le fichier ~a contenant les informations de TdM") outfilename))
        (close-output-port outfile)))))

\paper {
  #(define (page-post-process layout pages) (oly:create-toc-file layout pages))
}

Import de la table dans LaTeX

L’entête de votre fichier LaTeX doit comporter les lignes

\usepackage{pdfpages}
\includescore{nomdelapartition}

où \includescore est défini ainsi :

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \includescore{PossibleExtension}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Read in the TOC entries for a PDF file from the corresponding .toc file.
% This requires some heave latex tweaking, since reading in things from a file
% and inserting it into the arguments of a macro is not (easily) possible

% Solution by Patrick Fimml on #latex on April 18, 2009:
% \readfile{filename}{\variable}
% reads in the contents of the file into \variable (undefined if file
% doesn't exist)
\newread\readfile@f
\def\readfile@line#1{%
{\catcode`\^^M=10\global\read\readfile@f to \readfile@tmp}%
\edef\do{\noexpand\g@addto@macro{\noexpand#1}{\readfile@tmp}}\do%
\ifeof\readfile@f\else%
\readfile@line{#1}%
\fi%
}
\def\readfile#1#2{%
\openin\readfile@f=#1 %
\ifeof\readfile@f%
\typeout{No TOC file #1 available!}%
\else%
\gdef#2{}%
\readfile@line{#2}%
\fi
\closein\readfile@f%
}%


\newcommand{\includescore}[1]{
\def\oly@fname{\oly@basename\@ifmtarg{#1}{}{_#1}}
\let\oly@addtotoc\undefined
\readfile{\oly@xxxxxxxxx}{\oly@addtotoc}
\ifx\oly@addtotoc\undefined
\includepdf[pages=-]{\oly@fname}
\else
\edef\includeit{\noexpand\includepdf[pages=-,addtotoc={\oly@addtotoc}]
{\oly@fname}}\includeit
\fi
}

3.9 Autres méthodes d’association texte-musique

D’autres moyens de mélanger musique et texte sans recourir à lilypond-book sont abordés au chapitre Inclusion de partition LilyPond dans d’autres programmes.

4.1 Pointer-cliquer

Le pointer-cliquer (point and click) permet de se retrouver directement dans le fichier source, à la note que l’on pointe dans le visionneur de PDF. Ceci facilite grandement le repérage des erreurs à partir du fichier imprimable.

export LYEDITOR=atom

atom %(file)s:%(line)s:%(column)s

export LYEDITOR="code --goto %(file)s:%(line)s:%(column)s"

[Desktop Entry]
Version=1.0
Name=lilypond-invoke-editor
GenericName=Textedit URI handler
Comment=URI handler for textedit:
Exec=lilypond-invoke-editor %u
Terminal=false
Type=Application
MimeType=x-scheme-handler/textedit;
Categories=Editor
NoDisplay=true

xdg-desktop-menu install ./lilypond-invoke-editor.desktop
xdg-mime default lilypond-invoke-editor.desktop x-scheme-handler/textedit

xdg-open textedit:///etc/issue:1:0:0

# Pour les liens Textedit
/usr/local/bin/lilypond-invoke-editor Cx -> sanitized_helper,

sudo apparmor_parser -r -T -W /etc/apparmor.d/usr.bin.evince

\pointAndClickOff

\pointAndClickOn

lilypond -dno-point-and-click file.ly

4.2 LilyPond et les éditeurs de texte

Certains éditeurs de texte prennent en charge LilyPond.

(setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))

filetype off
set runtimepath+=/usr/local/share/lilypond/current/vim/
filetype on
syntax on

4.3 Conversion à partir d’autres formats

La musique peut aussi être récupérée par importation d’un autre format. Ce chapitre passe en revue les différents outils prévus à cet effet et inclus dans la distribution. Il existe d’autres outils qui permettent de générer du code LilyPond, comme par exemple des séquenceurs en mode graphique ou des convertisseurs XML. Pour plus de détails, rendez-vous sur le site.

Il s’agit de programmes distincts de lilypond qui se lancent en ligne de commande. Pour plus de précisions, reportez-vous au chapitre Utilisation en ligne de commande.

Problèmes connus et avertissements

Les développeurs ne sont malheureusement pas suffisamment nombreux et disponibles pour maintenir à jour ces programmes, considérez-les donc en l’état. Nous acceptons les patches avec plaisir, mais il y a peu de chance pour que nous soyons en mesure de résoudre les bogues de ces programmes.

midi2ly [option]… fichier-midi

musicxml2ly [option]… fichier-xml

abc2ly [option]… fichier-abc

%%LY voices \set autoBeaming = ##f

%%LY slyrics more words

etf2ly [option]… fichier-etf

4.4 Inclusion de partition LilyPond dans d’autres programmes

Nous allons nous intéresser ici à différents moyens d’associer texte et musique, en laissant de côté l’automatisation grâce à lilypond-book.

lilypond -dseparate-page-formats=pdf monfichier.ly

lilypond -dtall-page-formats=png monfichier.ly

lilypond -dseparate-page-formats=eps,pdf -dtall-page-formats=png,svg monfichier.ly

\paper{
  indent=0\mm
  oddFooterMarkup=##f
  oddHeaderMarkup=##f
  bookTitleMarkup = ##f
  scoreTitleMarkup = ##f
}

… musique …

4.5 Inclusion du travail des autres

Certains utilisateurs ont, pour obtenir des effets particuliers, écrit des fichiers qu’il est toujours possible d’intégrer à LilyPond avec l’instruction \include. Plusieurs sont même désormais inclus dans le programme. Voir aussi Travail sur des fichiers texte.

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.

5.2 Gravure de musique existante

Si vous saisissez de la musique à partir d’une partition existante, c’est-à-dire de la musique déjà écrite,

• n’entrez qu’un seul système de la partition originale à la fois – avec toujours une seule mesure par ligne de texte –, et vérifiez chaque système lorsqu’il est terminé. Vous pouvez utiliser les commandes showLastLength et showFirstLength pour accélérer la compilation – voir Ignorer des passages de la partition ;
• définissez mBreak = { \break } et insérez \mBreak dans le fichier d’entrée pour obtenir des sauts de ligne identiques à la partition originale. Cela facilite la comparaison entre la partition originale et la partition de LilyPond. Lorsque vous avez fini de relire votre musique, vous pouvez définir mBreak = { } pour enlever tous ces sauts de ligne, et laisser LilyPond placer les sauts de ligne selon son propre algorithme ;
• encadrez les notes d’une partie pour instrument transpositeur dans un

  \transpose c tonalité-naturelle {…}
  

  (où tonalité-naturelle correspond à celle de l’instrument en question) de telle sorte que la musique comprise dans cette variable se retrouve en ut. Vous pourrez toujours transposer à l’inverse si besoin lorsque vous ferez appel à cette variable. Des erreurs de transposition seront moins susceptibles de se produire si la musique de toutes les variables est dans la même et unique tonalité.

  De la même manière, prenez toujours le do comme note de départ ou d’arrivée. Ceci aura pour simple conséquence que les autres tonalités que vous utiliserez seront celles propres à chacun des instruments – sib pour une trompette en si bémol, ou lab pour une clarinette en la bémol.

5.3 Projets d’envergure

Lorsque l’on travaille sur un gros projet, il devient vital de structurer clairement ses fichiers LilyPond.

• Utilisez un identificateur pour chaque voix, avec un minimum de structure dans la définition. La structure de la section \score est la plus susceptible de changer, notamment dans une nouvelle version de LilyPond, alors que la définition du violon l’est beaucoup moins.

  violon = \relative {
  g'4 c'8. e16
  }
  …
  \score {
   \new GrandStaff {
     \new Staff {
       \violon
     }
   }
  }
  

• Séparez les retouches des définitions de musique. Nous vous avons déjà invité à adopter une telle pratique, qui par ailleurs devient vitale pour des projets d’importance. Nous pouvons avoir besoin de changer la définition de fpuisp, mais dans ce cas nous n’aurons besoin de le faire qu’une seule fois, et nous pourrons encore éviter de modifier quoi que ce soit à l’intérieur de la définition du violon.

  fpuisp = _\markup{
   \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
  violon = \relative {
  g'4\fpuisp c'8. e16
  }
  

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.

5.5 De la commande make et des fichiers Makefile

La plupart des plates-formes sur lesquelles tourne LilyPond disposent d’un logiciel appelé make. Ce logiciel va lire un fichier spécial, nommé Makefile, qui contient tout ce qu’il faut – les dépendances entre certains fichiers, les instructions successives à traiter par le système – pour aboutir au fichier que vous désirez obtenir. Il pourrait par exemple contenir tout ce qu’il faut pour produire ballade.pdf et ballade.midi à partir de ballade.ly en lançant LilyPond.

La création d’un Makefile peut se révéler pertinente pour certains projets, que ce soit par simple goût personnel ou bien par respect de ceux qui pourront accéder à vos sources. Cette manière de procéder est particulièrement indiquée lorsque vous travaillez sur un projet de grande envergure impliquant de nombreuses inclusions de fichiers et différentes éditions – par exemple un conducteur et un matériel d’orchestre complet avec la partition pour le chef et une partition séparée pour chacun des pupitres – ou bien si votre projet requiert certaines commandes particulières comme lilypond-book. Les Makefiles varient tant en complexité qu’en flexibilité selon les besoin et les aptitudes de celui qui les crée. Le programme GNU Make est installé par défaut sur les distributions GNU/Linux et sur macOS, et il en existe une version pour les environnements Windows.

Consultez le GNU Make Manual pour plus de détails sur ce dont make est capable – vous pourrez même en trouver des versions françaises à l’aide des moteurs de recherche –, dans la mesure où ce qui suit ne donne qu’un bref aperçu de ses possibilités.

Les commandes permettant de définir les règles diffèrent selon la plate-forme : si les différents GNU/Linux et macOS utilisent bash, Windows utilise cmd. Dans le cas de macOS, vous devrez toutefois configurer votre système de telle sorte qu’il utilise l’interpréteur en ligne de commande. Voici quelques exemples de fichier Makefile, avec une version pour GNU/Linux ou macOS et une pour Windows.

Pour commencer, une pièce à quatre mouvements pour orchestre et dont les fichiers sont répartis selon l’arborescence suivante :

Symphonie/
|-- MIDI/
|-- Makefile
|-- Notes/
|   |-- alto.ily
|   |-- cor.ily
|   |-- cello.ily
|   |-- figures.ily
|   |-- hautbois.ily
|   |-- trioCordes.ily
|   |-- violonUn.ily
|   `-- violonDeux.ily
|-- Partitions/
|   |-- symphonie.ly
|   |-- symphonieI.ly
|   |-- symphonieII.ly
|   |-- symphonieIII.ly
|   `-- symphonieIV.ly
|-- PDF/
|-- Pupitres/
|   |-- symphonie-alto.ly
|   |-- symphonie-cello.ly
|   |-- symphonie-cor.ly
|   |-- symphonie-hautbois.ly
|   |-- symphonie-violonUn.ly
|   `-- symphonie-violonDeux.ly
`-- symphonieDefs.ily

Les fichiers .ly des répertoires Partitions et Pupitres récupéreront la notation des fichiers .ily contenus dans le répertoire Notes :

%%% début du fichier "symphonie-cello.ly"
\include "../symphonieDefs.ily"
\include "../Notes/cello.ily"

Le Makefile répertorie des cibles correspondant à score (l’intégrale au format conducteur), mouvements (chacun des mouvements au format conducteur) et pupitres (une partition par pupitre). Il contient aussi une cible archive chargée de générer une archive des fichiers source qui pourra être diffusée sur la toile ou transmise par courriel. Voici ce que contiendrait ce Makefile pour GNU/Linux ou macOS. Ce fichier doit être enregistré sous le nom de Makefile à la racine du projet – ici Symphonie.

# Le préfixe au nom des fichiers résultants
piece := symphonie
# La commande d'appel à lilypond
LILY_CMD := lilypond -ddelete-intermediate-files \
                     -dno-point-and-click

# Les suffixes utilisés dans ce Makefile
.SUFFIXES: .ly .ily .pdf .midi

.DEFAULT_GOAL := score

PDFDIR := PDF
MIDIDIR := MIDI

# Les fichiers sources et résultants sont recherchés dans les
# répertoires listés dans la variable VPATH.  Ceux-ci sont tous
# des sous-répertoires du répertoire courant (fourni par la variable
# de GNU make "CURDIR").
VPATH := \
  $(CURDIR)/Partitions \
  $(CURDIR)/Pupitres \
  $(CURDIR)/Notes \
  $(CURDIR)/$(PDFDIR) \
  $(CURDIR)/$(MIDIDIR)

# La règle type pour créer un PDF et un MIDI à partir d'un fichier
# source LY.
# Les .pdf résultants iront dans le sous-répertoire "PDF" et les
# fichiers .midi dans le sous-répertoire "MIDI".
%.pdf %.midi: %.ly | $(PDFDIR) $(MIDIDIR)
        $(LILY_CMD) $<; \        # tabulation au début de la ligne
        mv "$*.pdf" $(PDFDIR)/   # tabulation au début
        mv "$*.midi" $(MIDIDIR)/ # tabulation au début

$(PDFDIR):
	mkdir $(PDFDIR)

$(MIDIDIR):
	mkdir $(MIDIDIR)

commun := symphonieDefs.ily

notes := \
  alto.ily \
  cello.ily \
  cor.ily \
  hautbois.ily \
  violonUn.ily \
  violonDeux.ily

# Les dépendances selon le mouvement.
$(piece)I.pdf: $(piece)I.ly $(notes) $(commun)
$(piece)II.pdf: $(piece)II.ly $(notes) $(commun)
$(piece)III.pdf: $(piece)III.ly $(notes) $(commun)
$(piece)IV.pdf: $(piece)IV.ly $(notes) $(commun)

# Les dépendances pour la partition intégrale.
$(piece).pdf: $(piece).ly $(notes) $(commun)

# Les dépendances pour les pupitres.
$(piece)-alto.pdf: $(piece)-alto.ly alto.ily $(commun)
$(piece)-cello.pdf: $(piece)-cello.ly cello.ily $(commun)
$(piece)-cor.pdf: $(piece)-cor.ly cor.ily $(commun)
$(piece)-hautbois.pdf: $(piece)-hautbois.ly hautbois.ily $(commun)
$(piece)-violonUn.pdf: $(piece)-violonUn.ly violonUn.ily $(commun)
$(piece)-violonDeux.pdf: $(piece)-violonDeux.ly violonDeux.ily $(commun)

# Lancer "make score" pour générer l'intégrale des quatre mouvements
# en un seul fichier.
.PHONY: score
score: $(piece).pdf

# Lancer "make parties" pour obtenir tous les pupitres.
# Lancer "make symphonie-toto.pdf" pour obtenir la partie
# instrumentale de toto.
# Par exemple : "make symphonie-cello.pdf"
.PHONY: parties
parties: $(piece)-cello.pdf \
         $(piece)-violonUn.pdf \
         $(piece)-violonDeux.pdf \
         $(piece)-alto.pdf \
         $(piece)-hautbois.pdf \
         $(piece)-cor.pdf

# Lancer "make mouvements" pour générer un fichier séparé pour chacun
# des mouvements.
.PHONY: mouvements
mouvements: $(piece)I.pdf \
            $(piece)II.pdf \
            $(piece)III.pdf \
            $(piece)IV.pdf

all: score parties mouvements

Les choses se compliquent sous Windows. Une fois GNU Make pour Windows téléchargé et installé, il vous faudra correctement définir le chemin d’accès au programme Make – dans les variables d’environnement du système – afin que l’interpréteur de commandes DOS puisse le localiser. Pour cela, faites un clic droite sur « Poste de travail », choisissez Propriétés puis Avancées. Cliquez sur Variables d'environnement puis, dans l’onglet Variables système, mettez path en surbrillance et cliquez sur Modifier. Ajoutez alors le chemin d’accès complet à l’exécutable de GNU Make, qui devrait ressembler à :

C:\Program Files\GnuWin32\bin

Il va également falloir adapter le makefile aux particularités de l’interpréteur de commandes et à la présence d’espaces dans le nom de certains répertoire de ce système. Enfin, les fichiers MIDI ont une extension par défaut propre à Windows.

## VERSION POUR WINDOWS
##
piece := symphonie
LILY_CMD := lilypond -ddelete-intermediate-files \
                     -dno-point-and-click

#Détermination du nom de CURDIR sous sa forme 8.3
#(solution pour les espaces dans le PATH)
workdir != $(shell for /f "tokens=*" %%b in ("$(CURDIR)") \
           do @echo %%~sb)

.SUFFIXES: .ly .ily .pdf .mid

.DEFAULT_GOAL := score

PDFDIR := PDF
MIDIDIR := MIDI

VPATH := \
  $(workdir)/Partitions \
  $(workdir)/Pupitres \
  $(workdir)/Notes \
  $(workdir)/$(PDFDIR) \
  $(workdir)/$(MIDIDIR)

%.pdf %.mid: %.ly | $(PDFDIR) $(MIDIDIR)
        $(LILY_CMD) $<                 # tabulation au début de la ligne
        move /Y "$*.pdf" $(PDFDIR)/    # tabulation au début
        move /Y "$*.mid" $(MIDIDIR)/   # tabulation au début

$(PDFDIR):
    mkdir $(PDFDIR)/

$(MIDIDIR):
    mkdir $(MIDIDIR)/

notes := \
  cello.ily \
  figures.ily \
  cor.ily \
  hautbois.ily \
  trioCordes.ily \
  alto.ily \
  violonUn.ily \
  violonDeux.ily

commun := symphonieDefs.ily

$(piece)I.pdf: $(piece)I.ly $(notes) $(commun)
$(piece)II.pdf: $(piece)II.ly $(notes) $(commun)
$(piece)III.pdf: $(piece)III.ly $(notes) $(commun)
$(piece)IV.pdf: $(piece)IV.ly $(notes) $(commun)

$(piece).pdf: $(piece).ly $(notes) $(commun)

$(piece)-cello.pdf: $(piece)-cello.ly cello.ily $(commun)
$(piece)-cor.pdf: $(piece)-cor.ly cor.ily $(commun)
$(piece)-hautbois.pdf: $(piece)-hautbois.ly hautbois.ily $(commun)
$(piece)-alto.pdf: $(piece)-alto.ly alto.ily $(commun)
$(piece)-violonUn.pdf: $(piece)-violonUn.ly violonUn.ily $(commun)
$(piece)-violonDeux.pdf: $(piece)-violonDeux.ly violonDeux.ily $(commun)

.PHONY: score
score: $(piece).pdf $(commun)

.PHONY: parties
parties: $(piece)-cello.pdf \
         $(piece)-violonUn.pdf \
         $(piece)-violonDeux.pdf \
         $(piece)-alto.pdf \
         $(piece)-hautbois.pdf \
         $(piece)-cor.pdf

.PHONY: mouvements
mouvements: $(piece)I.pdf \
           $(piece)II.pdf \
           $(piece)III.pdf \
           $(piece)IV.pdf

all: score parties mouvements

Le Makefile suivant convient pour un document lilypond-book réalisé avec LaTeX. Ce projet contiendra un index, ce qui nécessitera de lancer une deuxième fois latex pour mettre à jour les liens. Les fichiers résultants iront dans le répertoire out pour ce qui est des pdf et dans le répertoire htmlout pour ce qui est du html.

SHELL=/bin/sh
FILE=monprojet
OUTDIR=out
WEBDIR=htmlout
VIEWER=acroread
BROWSER=firefox
LILYBOOK_PDF=lilypond-book --output=$(OUTDIR) --pdf $(FILE).lytex
LILYBOOK_HTML=lilypond-book --output=$(WEBDIR) $(FILE).lytex
PDF=cd $(OUTDIR) && pdflatex $(FILE)
HTML=cd $(WEBDIR) && latex2html $(FILE)
INDEX=cd $(OUTDIR) && makeindex $(FILE)
PREVIEW=$(VIEWER) $(OUTDIR)/$(FILE).pdf &

all: pdf web keep

pdf:
        $(LILYBOOK_PDF)  # tabulation en début de ligne
        $(PDF)           # tabulation en début de ligne
        $(INDEX)         # tabulation en début de ligne
        $(PDF)           # tabulation en début de ligne
        $(PREVIEW)       # tabulation en début de ligne

web:
        $(LILYBOOK_HTML) # tabulation en début de ligne
        $(HTML)          # tabulation en début de ligne
        cp -R $(WEBDIR)/$(FILE)/ ./  # tabulation en début de ligne
        $(BROWSER) $(FILE)/$(FILE).html &  # tabulation en début de ligne

keep: pdf
        cp $(OUTDIR)/$(FILE).pdf $(FILE).pdf  # tabulation en début de ligne

clean:
        rm -rf $(OUTDIR) # tabulation en début de ligne

web-clean:
        rm -rf $(WEBDIR) # tabulation en début de ligne

archive:
        tar -cvvf monprojet.tar \ # tabulation en début de ligne
        --exclude=out/* \
        --exclude=htmlout/* \
        --exclude=monprojet/* \
        --exclude=*midi \
        --exclude=*pdf \
        --exclude=*~ \
        ../MonProjet/*

AVENIR : faire que ça marche sous Windows

Ce makefile n’est malheureusement pas opérationnel sous Windows. La seule alternative qui s’offre aux utilisateurs de Windows consiste à créer un fichier de traitement par lot (.bat) qui contienne les différentes commandes successives. Bien que cette manière de procéder ne tienne aucun compte des dépendances entre fichiers, elle permet de réduire le nombre de processus à lancer dans une seule commande. Vous devrez enregistrer les lignes suivantes dans un fichier construire.bat ou construire.cmd. Ce fichier pourra être exécuté soit en ligne de commande, soit par un double clic sur son icône.

lilypond-book --output=out --pdf monprojet.lytex
cd out
pdflatex monprojet
makeindex monprojet
pdflatex monprojet
cd ..
copy out\monprojet.pdf MonProjet.pdf

Voir aussi

Manuel d’utilisation : Utilisation en ligne de commande, Association musique-texte avec lilypond-book.