4.6.3 Autres sources de documentation
La Référence du programme contient beaucoup d’informations sur LilyPond. Cependant vous pouvez en découvrir encore plus en consultant les fichiers internes de LilyPond. Pour cela, il vous faut d’abord connaître le répertoire ad hoc sur votre système. L’emplacement du répertoire dépend (a) du fait que, pour vous procurer LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou vous l’avez installé grâce à votre gestionnaire de paquetages (c’est-à-dire distribué avec Linux ou installé avec fink ou cygwin), ou encore vous l’avez compilé directement à partir des sources ; et (b) du système d’exploitation sous lequel il tourne.
Téléchargé depuis lilypond.org
- Linux
‘INSTALLDIR/lilypond/usr/share/lilypond/current/’
- MacOS X
‘INSTALLDIR/LilyPond.app/Contents/Resources/share/lilypond/current/’ Pour accéder à ce dossier, deux possibilités : soit, dans un Terminal, taper
cd
suivi du chemin complet ci-dessus ; soit Control-cliquer (ou clic droit) sur l’application LilyPond et sélectionner ‘Afficher le contenu du paquet’. - Windows
Dans l’Explorateur Windows, voir ‘INSTALLDIR/LilyPond/usr/share/lilypond/current/’
Installé par un gestionnaire de paquetages ou compilé d’après les sources
‘PREFIX/share/lilypond/X.Y.Z/’, où
PREFIX est déterminé par votre gestionnaire de paquetages ou par le script
configure
, et X.Y.Z est le numéro de version de LilyPond.
Dans ce répertoire, deux sous-répertoires sont particulièrement intéressants :
- ‘ly/’ - contient les fichiers en format LilyPond
- ‘scm/’ - contient les fichiers en format Scheme
Commençons par examiner quelques fichiers contenus dans ‘ly/’.
Nous ouvrons ‘ly/property-init.ly’ dans un éditeur de texte – celui
que vous avez l’habitude d’utiliser pour les fichiers .ly
fera très
bien l’affaire. Ce fichier contient les définitions de toutes les commandes
standard prédéfinies de LilyPond, comme \stemUp
et
\slurDotted
. Vous pouvez constater que ce n’est rien d’autre
que des définitions de variables composées d’un ou plusieurs groupes
de commandes \override
. Par exemple, \tieDotted
est défini comme :
tieDotted = { \override Tie #'dash-period = #0.75 \override Tie #'dash-fraction = #0.1 }
Si vous n’aimez pas les valeurs par défaut, les commandes prédéfinies peuvent être facilement redéfinies, comme n’importe quelle autre variable, en tête de votre fichier d’entrée.
Voici les fichiers les plus utiles dans le répertoire ‘ly/’:
Nom de fichier | Contenu |
---|---|
‘ly/engraver-init.ly’ | Définitions des Contextes de graveurs |
‘ly/paper-defaults-init.ly’ | Réglages papier par défaut |
‘ly/performer-init.ly’ | Définitions des Contextes d’interprétation |
‘ly/property-init.ly’ | Définitions de toutes les commandes prédéfinies courantes |
‘ly/spanner-init.ly’ | Définitions des commandes prédéfinies pour les bandeaux |
Les autres réglages (comme les définitions de commandes markup) sont
conservés comme fichiers .scm
(Scheme). Le langage de
programmation Scheme offre une interface programmable dans le
processus interne de LilyPond. De plus amples explications sur ces
fichiers dépasseraient le cadre de ce manuel, dans la mesure où elles
requièrent la connaissance du langage Scheme. Les utilisateurs qui
souhaiteraient comprendre le fonctionnement de ces fichiers de
configuration doivent être avertis que des connaissances techniques
substantielles et beaucoup de temps sont nécessaires (voir
Tutoriel Scheme).
Si c’est votre cas, les fichiers Scheme les plus utiles à connaître sont :
Nom de fichier | Contenu |
---|---|
‘scm/auto-beam.scm’ | Régles par défaut des ligatures subalternes |
‘scm/define-grobs.scm’ | Réglages par défaut des propriétés de grobs |
‘scm/define-markup-commands.scm’ | Spécification de toutes les commandes de markup |
‘scm/midi.scm’ | Réglages par défaut pour les sorties MIDI |
‘scm/output-lib.scm’ | Réglages affectant l’apparence des frets, couleurs, altérations, barres de mesure, etc |
‘scm/parser-clef.scm’ | Définition des clefs prises en charge |
‘scm/script.scm’ | Réglages par défaut des articulations |