# Introduction à LilyPond/Gestion de partitions volumineuses

* Principe général
* Structure du fichier
* La hauteur des notes
* Le rythme
* Une ligne mélodique complète
* Partition de chant et grille d'accords
* Association de plusieurs voix
* Gestion de partitions volumineuses
* Notation spécifique à certains instruments
* Mise en forme d'une partition
* Génération d'un fichier de son
* Afficher du texte
* Programmation
* LilyPond et Python
* Voir aussi
* Index
* Principe général
* Structure du fichier
* La hauteur des notes
* Le rythme
* Une ligne mélodique complète
* Partition de chant et grille d'accords
* Association de plusieurs voix
* Gestion de partitions volumineuses
* Notation spécifique à certains instruments
* Mise en forme d'une partition
* Génération d'un fichier de son
* Afficher du texte
* Programmation
* LilyPond et Python
* Voir aussi
* Index
[ Modifier le sommaire ]
Une partition peut vite devenir volumineuse, surtout lorsqu'elle contient plusieurs voix. Pour vous aider à gérer cette situation, LilyPond dispose de trois outils : les commentaires, les variables et la possibilité de scinder la partition en plusieurs fichiers. Par ailleurs, il y a la possibilité de créer plusieurs partitions dans un même document, comme par exemple les différentes pièces d'une œuvre. Enfin, la gestion des voix nécessite un peu de rigueur, et la mise en place de certains éléments peut faciliter le déchiffrage par les musiciens.

## Les commentaires

LilyPond est au fond un langage de programmation (voir le chapitre Programmation). Ce que vous tapez dans l'éditeur de texte est appelé le « code source ». Une bonne pratique de programmation consiste à commenter le code source. Cela permet :
* à d'autres personnes de comprendre ce que vous faites, et donc de pouvoir retravailler la partition, la corriger, la modifier ;
* de pouvoir retrouver rapidement un passage, soit en mettant en évidence certaines parties, soit en mettant des mots-clefs que vous pouvez retrouver avec la fonction de recherche de l'éditeur de texte (en général par le menu Édition | Rechercher).
Un commentaire s'introduit avec le signe pourcent « % » ; tout ce qui suit ce signe sur la ligne est ignoré.

### Exemple

Vous pouvez définir tout un bloc de commentaires, c'est-à-dire plusieurs lignes. Un bloc de commentaire est ouvert par %{ et est fermé par %}.
Une des manières de faire ressortir une partie du code consiste à mettre un commentaire entouré d'étoiles.

### Exemple

Les commentaires permettent aussi de faire des essais : plutôt que de modifier une ligne, vous pouvez la mettre en commentaire, la copier et modifier la copie, ce qui permet de revenir en arrière facilement.

### Exemple
## Les variables

Une variable est un nom qui se substitue à une expression musicale, c'est-à-dire à des notes dans une paire d'accolades. Pour déclarer la variable, on écrit simplement :
Pour utiliser cette variable, il suffit d'en écrire le nom précédé d'une barre de fraction inversée :
Comme de nombreux caractères ont des fonctions précises dans LilyPond (caractères spéciaux), il importe que le nom de la variable ne comporte que des lettres, et en particulier pas d'espace, de point, de chiffre, de tiret ni de tiret de soulignement.
Le nom de variable ne doit bien entendu pas être un nom de commande LilyPond.

### Exemple

    Frère Jacques en canon
Si vous travaillez avec plusieurs voix, une bonne pratique consiste à définir chaque voix dans une variable portant un nom explicite, puis d'utiliser ces variables dans une deuxième partie de fichier qui sera assez courte.

### Exemple

(Voir le chapitre suivant pour l'explication de TabStaff.)
L'utilisation de variables permet par ailleurs de faciliter le suivi de l'évolution de LilyPond. En effet, la description de la musique (donc le contenu des variables) est peu susceptible de changer, contrairement aux instructions spécifiques qui entourent cette musique. Ce point est d'autant plus important que le projet est volumineux.
Une variable peut également contenir une chaîne de caractère (éventuellement contenue dans un \markup {…} et assortie d'un indicateur de position « ^ » ou « _ »

## Scinder la partition en plusieurs fichiers

Il est possible de scinder la partition sur plusieurs fichiers. Chaque fichier élémentaire sert alors à définir une variable, et cette variable est utilisée dans un autre fichier, dit « fichier maître ». Le fichier élémentaire est intégré dans le fichier maître par la commande \include "nom_de_fichier".

### Exemple

    Le fichier chant.LY contient
    le fichier guitare.LY contient
    le fichier maître (par exemple nom_du_morceau.LY) contient

## Plusieurs partitions

Il est possible de mettre plusieurs partitions, contenues dans un contexte \score {…}, dans un même document. Pour cela, il faut utiliser un contexte global \book {…} (littéralement « livre ») qui contient les différentes partitions.
Il peut alors y avoir :
* un en-tête général, définissant le titre de l'œuvre et le nom de l'auteur ;
* un en-tête par partition, définissant le nom de la pièce.
Il est possible de placer du texte (par exemple des paroles) entre les partitions contenues dans le livre, avec la commande \markup (sur ce point, voir Partition de chant et grille d'accords > Paroles en fin de morceau).

### Exemple
## Gestion des voix

Pour les petites partitions, on peut laisser les voix se « créer toutes seules ». Avec les grandes partition, il faut :
* créer explicitement les portées et les voix avec la commande \new type ;
* donner des noms aux voix, en ajoutant = "NomDeVoix" après le type de voix ;
* regrouper les voix de même type dans des groupes (StaffGroup, PianoStaff, GrandStaff et ChoirStaff).
Le fait d'associer un nom à une voix permet de faire passer une ligne mélodique d'une voix à une autre, et d'associer des paroles à une voix donnée (voir ci-après).

### Exemple
## Aide au déchiffrage

Les grandes partitions sont en général des morceaux longs. Un certain nombre d'éléments facilitent le déchiffrage.

### Repères de répétition

LilyPond numérote les mesures et indique le numéro au début de chaque ligne. Cela permet, lors des répétitions, de reprendre à un endroit donné (« on reprend mesure 56 »). Il est possible de placer des repères, par exemple à l'introduction de nouveaux thèmes, ou aux « changements d'ambiance ». Pour cela, il suffit de mettre \mark \default avant la première note de la mesure visée ; cela place une lettre, qui facilite le repérage (« on reprend à B », « à la levée de C », « 8 après D »…).
Si l'on veut que le repère soit aligné avec la barre de mesure, on met :
Par défaut, les repères sont des lettres. Si l'on ne veut pas commencer au A mais, par exemple, à la 8e lettre (le H), on utilise :
Si l'on veut que la lettre soit encadrée, on utilise (avant le premier repère, par exemple au début de l'environnement \new Staff) :
Si l'on veut que les repères soient des nombres, on utilise :
et pour des nombres encadrés, on utilise :
Si l'on veut imposer un repère de répétition, il suffit de remplacer le default par la chaîne de caractère désirée, par exemple :

### Numérotation des mesures

La numérotation des mesures est automatique. Si l'on veut changer le numéro à partir d'une mesure on utilise la syntaxe suivante :
ici, la mesure sera numérotée 50, celle d'après 51, etc.
Par défaut, le numéro de la première mesure d'un environnement \score n'est pas affiché. Pour forcer l'affichage du numéro, il faut commencer la partie par une barre vide, \bar "".
Pour forcer l'apparition du numéro pour une mesure donnée, on peut utiliser :
Pour les version 2.16 et antérieures de LilyPond, il faut rajouter des apostrophes à la syntaxe : \override Score.BarNumber #'break-visibility = #'#(#t #t #t) et \revert Score.BarNumber #'break-visibility.
Si l'on n'annule pas la première commande (en supprimant l'instruction \revert…), alors ce sont toutes les mesures qui sont numérotées à partir de la commande \override… Pour être un peu plus précis sur la syntaxe :
* le premier booléen #t indique que le numéro de la dernière mesure de la ligne est visible ;
* le deuxième #t indique que les numéros au milieu de la ligne sont visibles ;
* le troisième #t indique que le numéro de la première mesure de la ligne est visible.

### Citation d'une mélodie

Certaines parties ont de nombreuses mesures à compter. Le démarrage de l'instrument peut parfois être annoncé par le thème joué par un autre instrument. Le fait de citer ce thème facilite le travail du musicien, qui permet de vérifier que l'on a compté correctement et, le cas échéant, de se corriger.
Pour cela, on a recours à une deuxième voix sur la portée pour citer la mélodie en parallèle des derniers silences.

#### Exemple

Il y a possibilité d'« automatiser » cela en utilisant les fonctions \addquote et \quoteDuring ou \cueDuring.

## Voir aussi
### Dans Wikipédia

Association de plusieurs voix < ↑ > Notation spécifique à certains instruments