Introduction à LilyPond/Principe général

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche


1. Principe général

Format du fichier[modifier | modifier le wikicode]

Un fichier LilyPond est un fichier texte au format UTF-8, ce qui permet de gérer les accents dans les paroles et les titres (en l'absence d'accent, on peut utiliser de l'ASCII « pur »). Ce fichier source porte l'extension .LY.

Les notes sont représentées par une combinaison de lettres, pour désigner la hauteur des notes, et de chiffres, pour désigner leur durées, inclues à l'intérieur d'accolades, par exemple :

{ c4 d4 } désigne deux noires (valeur 4), un do et un (respectivement « c » et « d »).

Il est possible d'utiliser le nom français des notes à condition de placer en début de fichier la commande:

\include "italiano.ly"

Dans ces conditions, { do4 re4 } désigne deux noires (valeur 4), un do et un .

Pour bien comprendre ce principe, vous pouvez essayer le piano virtuel de Musipédia.


Note
tout fichier devrait commencer par l'indication de la version de LilyPond utilisée, par la commande \version "version" (par exemple \version "2.10"). Cela permet, lorsque l'on retrouve une vieille partition, de connaître la version de l'époque et de pouvoir l'adapter à la nouvelle version de LilyPond.
Si vous souhaitez utiliser la notation française usuelle, placez ensuite votre commande \include "italiano.ly".

Programme dans un environnement graphique[modifier | modifier le wikicode]

Lilypond icone.png Lilypond fichier ly.png
icône de LilyPond
et des fichiers .LY

Les versions récentes de LilyPond fonctionnent dans des environnements graphiques. Elles disposent d'un éditeur de texte intégré. L'utilisation de l'interface graphique varie en fonction de l'environnement.

Sous Microsoft Windows
  • l'éditeur de texte s'appelle LilyPad ; si l'on double-clique sur l'icône de LilyPond, cela lance LilyPad ; on peut alors créer un nouveau fichier source ou bien importer un fichier .LY existant ;
  • pour éditer un fichier .LY existant, on peut aussi utiliser le menu contextuel : cliquer avec le bouton secondaire de la souris[1] sur l'icône du fichier source (.LY), puis choisir Edit file dans le menu ;
  • pour compiler le fichier, il suffit, à partir de l'Explorateur Windows, de cliquer sur l'icône du fichier .LY puis de la faire glisser sur l'icône de LilyPond (drag and drop) ;
  • pour compiler le fichier, on peut également utiliser le menu contextuel : cliquer avec le bouton droit de la souris sur l'icône du fichier source, puis choisir Generate PDF ;
  • si l'on double-clique sur l'icône du fichier source, cela lance une compilation.

La compilation effectuée par le menu contextuel ou par le double-clic sur l'icône du fichier source n'est pas la même que celle effectuée par un glisser-lâcher de l'icône du fichier source sur l'icône de LilyPond.

Sous MacOS X
  • si l'on double-clique sur l'icône de LilyPond, cela lance l'éditeur de texte ; on peut alors créer un nouveau fichier source ou bien importer un fichier .LY existant ;
  • pour éditer un fichier .LY existant, on peut aussi utiliser double-cliquer dessus : cela l'ouvre dans l'éditeur de texte de LilyPond ;
  • pour éditer le fichier, on peut aussi, à partir du Finder, de cliquer sur l'icône du fichier .LY puis de la faire glisser sur l'icône de LilyPond (drag and drop) ;
  • pour compiler un fichier, on peut utiliser le menu Compile | Typeset file de LilyPond ou bien la raccourci clavier touche pomme+[R].
Sous Linux (et également tout systeme d'exploitation pouvant faire tourner Python) il existe un éditeur graphique appelé Frescobaldi.
  • Aperçu PDF en un clic de souris
  • Point & Click: cliquez sur les notes dans le PDF pour passer à la position dans le texte
  • Configuration de partition rapide par assistant
  • Possibilité d'entrer la musique via un périphérique MIDI en utilisant le plugin Rumeur
  • Navigateur de documentation LilyPond avec aide contextuelle
  • Coloration syntaxique avancée
  • Les structures imbriquées peuvent être repliées / déployées pour un aperçu rapide
  • Auto-complétion permettant de saisir rapidement les commandes et les paramètres
  • Nombreux outils de manipulation de notes (transposition, conversion relative / absolue, traduction...) et de rythme (multiplication / division, copier-coller de rythme...)
  • Gestion des césures (paroles)
  • Insertion rapide des articulations et symboles
  • Mise à jour de versions par le biais de convert-ly
  • ...

Programme en ligne de commande[modifier | modifier le wikicode]

Initialement, LilyPond est un programme en ligne de commande. Pour générer la partition et/ou le fichier sonore dans ce mode, on peut donc invoquer le programme lilypond en lui passant le nom du fichier source en paramètre (le fichier source aura été créé par un éditeur de texte indépendant). Si par exemple le fichier source est ma_musique.LY, il faut alors taper en ligne de commande

lilypond ma_musique

Ceci génère en général un fichier PostScript (avec le nom du fichier source et l'extension .PS, ici ma_musique.PS), et/ou, selon les indication à l'intérieur du fichier .LY, un fichier sonore (extension .MID ou .MIDI). Le fichier PostScript peut ensuite être imprimé ou affiché (par exemple avec GhostScript, GS), ou bien converti en PDF (par exemple avec GS).

On peut placer des options avant le nom du fichier à compiler, par exemple :

  • --pdf pour générer directement un fichier PDF ;
  • --tex pour générer un fichier TeX ;
  • --output=nom_de_fichier ou -o=nom_de_fichier pour créer un fichier ayant un nom différent (l'extension est ajoutée automatiquement) ;
  • --verbose ou -V pour avoir des messages plus détaillés ;
  • --format= ou -f= : choix du format (ajouter svg, ps, pdf, png, tex, ou dvi derrière le signe égal)

Par exemple :

lilypond --pdf -o=my_music ma_musique

crée le fichier my_music.PDF à partir de la compilation du fichier ma_musique.LY. On peut avoir la liste des options en tapant lilypond -h ou lilypond --help.

MacOS X

Sous MacOS X, l'application LilyPond.app est en fait un répertoire ; c'est ce répertoire qui contient le programme à appeler en ligne de commande. Le programme lilypond en lui-même est place dans le sous-répertoire Contents/Resources/bin/. On peut ajouter ce chemin aux chemins par défaut en mettant ce chemin complet dans le fichier ~/.profile, sous la forme suivante :

export PATH=$PATH:chemin

par exemple, si LilyPond.app est placé dans /Applications/, on mettra

export PATH=$PATH:/Applications/LilyPond.app/Contents/Resources/bin

Intégration de code LilyPond dans du code LaTeX[modifier | modifier le wikicode]

On peut mettre du code LilyPond dans un fichier LaTeX, ou bien faire appel à un fichier .LY dans le fichier LaTeX. Il faut alors compiler le fichier .TEX avec lilypond-book avant de lancer la compilation avec latex ; cela se fait en ligne de commande.

Voir Programmation LaTeX, Écrire de la musique > Intégration du code LilyPond dans le code LaTeX.

Notes[modifier | modifier le wikicode]

  1. bouton droit, ou « clic droit », si la souris est configurée pour droitier ; bouton gauche si la souris est configurée pour un gaucher

Voir aussi[modifier | modifier le wikicode]

Dans Wikipédia

Introduction < > La hauteur des notes