1.1 Compilation d’un fichier

@translationof Compiling a file

Nous allons ici parler de la « compilation », ou comment LilyPond traite le fichier source que vous avez écrit, pour en faire quelque chose d’imprimable.

1.1.1 Saisie de la musique

@translationof Entering input

Pour créer une partition avec LilyPond, on écrit un fichier texte, appelé fichier source, qui décrit la notation musicale. La compilation de ce fichier source par LilyPond produit un fichier graphique imprimable, et si on le désire un fichier MIDI qui peut être joué par un séquenceur.

Voici un premier exemple simple de fichier source LilyPond.

\version "2.21.3"
{
  c' e' g' e'
}

La compilation de ce fichier donnera quelque chose de sembable à l’image ci-dessous.

Il est aussi possible d’utiliser les noms de notes français « do re mi fa sol la si », en insérant au début du fichier la ligne \language "italiano".

De plus, LilyPond est sensible à la casse : le code ‘{ c d e }’ est valide, alors que ‘{ C D E }’ produira un message d’erreur.

Production de la partition

@translationof Producing output

Dans cette section nous expliquerons quelles commandes exécuter et comment voir ou imprimer le résultat produit par LilyPond.

• MacOS X (graphique)
• Microsoft Windows (graphique)
• Tous systèmes (ligne de commande)

Notez qu’il existe plusieurs éditeurs de texte disponibles avec un bon support de LilyPond ; consultez (web)Facilités d’édition section ‘Facilités d'édition’ dans Informations générales.

1.1.2 MacOS X

Étape 1. Création d’un fichier ‘.ly’

Lorsque vous faites un double clic sur LilyPond.app, un fichier exemple s’ouvre.

Dans le menu, en haut et à gauche de la fenêtre, sélectionnez Fichier > Enregistrer.

Attribuez un nom à votre fichier, par exemple ‘test.ly’.

Étape 2. Compilation (avec LilyPad)

Dans le menu, sélectionnez Compiler > Typeset.

Une nouvelle fenêtre s’ouvre dans laquelle s’affiche le journal de compilation du fichier que vous venez de sauvegarder.

Étape 3. Visualisation du résultat

La compilation s’achève par la création d’un fichier PDF portant le même nom que le fichier source ; ce nouveau fichier sera automatiquement ouvert par votre lecteur PDF par défaut et affiché à l’écran.

Autres commandes

Pour créer de nouveaux fichiers pour LilyPond, sélectionnez Fichier > Nouveau

ou Fichier > Ouvrir pour reprendre un fichier précédemment enregistré.

Pensez à toujours enregistrer votre travail avant de lancer l’option Compile > Tyepset du menu. Si le PDF n’apparaît pas, vérifiez que la fenêtre « log » ne comporte pas d’erreur.

Si vous n’utilisez pas le lecteur de PDF par défaut de Mac OS et qu’un fichier résultant d’une précédente compilation est encore ouvert dans votre lecteur, la régénération de ce PDF peut bloquer tant que vous ne fermez pas le fichier ouvert.

1.1.3 Windows

Étape 1. Création d’un fichier ‘.ly’

Double-cliquez sur l’icone LilyPond qui se trouve sur le bureau. S’ouvre alors un fichier d’exemple.

Dans le menu, sélectionnez Fichier > Enregistrer sous (Save as…). Ne prenez pas l’option Fichier > Enregistrer (Save) pour ce fichier exemple : LilyPond attend un nom de fichier valide.

Affectez un nom à votre fichier, comme par exemple ‘test.ly’.

Étape 2. Compilation

La transformation d’un fichier LilyPond en partition s’obtient par compilation. Celle-ci peut se lancer de différentes manières : par glisser-déposer, par un clic de droite, par un double clic ou encore en ligne de commande (dans une fenêtre d’interpréteur DOS). Nous examinerons ici les trois premières options.

1. Faire glisser puis déposer le fichier sur l’icone LilyPond

Bien qu’il ne semble pas se passer grand chose, deux fichiers – ‘test.log’ et ‘test.pdf’ – devraient apparaître après quelques instants sur votre bureau.

2. Ouvrir le menu contextuel par un clic-droit, puis en prendre l’option Generate PDF … (Générer le PDF).

3. Faire un double-clic sur le fichier ‘test.ly’.

Étape 3. Visualisation du résultat

‘test.pdf’ contient la gravure de votre fichier ‘test.ly’. Un double-clic sur son icône devrait l’ouvrir dans votre lecteur PDF :

Autres commandes

Pour créer un nouveau fichier, sélectionnez Fichier > Nouveau à partir de n’importe quel fichier déjà existant ou bien Fichier > Ouvrir pour reprendre un fichier sauvegardé. La modification d’un fichier existant est aussi accessible à partir de l’option Edit source (Éditer la source) du menu contextuel.

Pensez à toujours enregistrer votre travail avant de compiler votre fichier. Si LilyPond ne crée pas de PDF ou que le résultat ne correspond pas à vos attentes, consultez le fichier de journalisation – généré au fil du processus de compilation – et vérifiez qu’il ne comporte pas d’erreur.

Ce fichier journal est remplacé à chaque compilation de votre fichier LilyPond.

Pensez à fermer le fichier dans votre lecteur de PDF à chaque fois que vous relancez la compilation, afin d’être sûr que celle-ci arrive à son terme.

1.1.4 Ligne de commande

@translationof Command-line

Étape 1. Création d’un fichier ‘.ly’

Créez un fichier texte du nom de ‘test.ly’ et saisissez :

\version "2.20.0"
{
  c' e' g' e'
}

Étape 2. Compilation en ligne de commande

Pour traiter le fichier ‘test.ly’, tapez ce qui suit à l’invite de commande :

lilypond test.ly

Vous verrez alors quelque chose qui ressemblera à :

GNU LilyPond 2.20.0
Traitement de « test.ly »
Analyse...
Interprétation en cours de la musique...
Pré-traitement des éléments graphiques...
Détermination du nombre optimal de pages...
Répartition de la musique sur une page...
Dessin des systèmes...
Sortie mise en page vers « test.ps »...
Conversion à « ./test.pdf »...
Résultat : Compilation menée à son terme, avec succès.

Suivant votre installation, ces messages peuvent être traduits ou non.

Étape 3. Visualisation du résultat

Vous pouvez à présent visualiser ou imprimer ‘test.pdf’.

Ce document a été généré le le 13 juillet 2020 par gub en utilisant texi2html 1.82.

Autres langues : English, català, česky, deutsch, español, magyar, italiano, 日本語, nederlands.
À propos de la sélection automatique de la langue.