1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of web/download.itexi and
3 @c learning/tutorial.itely
5 Translation of GIT committish: 72012c900e38247806dcc32c01e162f02c63287b
7 When revising a translation, copy the HEAD committish of the
8 version that you are working on. For details, see the Contributors'
9 Guide, node Updating translation committishes..
12 @c This is about "compiling" a lilypond file
13 @c (Learning 1 Tutorial), **not** compiling the
17 @warning{Les instructions qui suivent concernent ceux qui utilisent
18 le lanceur LilyPond. Si vous utilisez l'un des programmes mentionnés
19 au chapitre @rweb{Facilités d'édition}, référez-vous à leur
20 documentation respective en cas de problème.}
23 @subsubheading Étape 1. Création d'un fichier @file{.ly}
25 Lorsque vous faites un double clic sur @command{LilyPond.app}, un
26 fichier exemple s'ouvre.
28 @sourceimage{Learning_Macos_welcome,,,}
30 Dans le menu, en haut et à gauche de la fenêtre, sélectionnez
31 @w{@code{Fichier > Enregistrer}}.
33 @sourceimage{Learning_Macos_Save_menu,,,}
35 Attribuez un nom à votre fichier, par exemple @file{test.ly}.
37 @sourceimage{Learning_Macos_Save_file_with_name,,,}
40 @subsubheading Étape 2. Compilation (avec LilyPad)
42 Dans le menu, sélectionnez
43 @w{@code{Compiler > Typeset}}.
45 @sourceimage{Learning_Macos_Typeset_menu,,,}
47 Une nouvelle fenêtre s'ouvre dans laquelle s'affiche le journal de
48 compilation du fichier que vous venez de sauvegarder.
50 @sourceimage{Learning_Macos_Compiling_log,,,}
53 @subsubheading Étape 3. Visualisation du résultat
55 La compilation s'achève par la création d'un fichier PDF portant le même
56 nom que le fichier source@tie{}; ce nouveau fichier sera automatiquement
57 ouvert par votre lecteur PDF par défaut et affiché à l'écran.
59 @sourceimage{Learning_Macos_pdf_output,,,}
62 @subsubheading Autres commandes
64 Pour créer de nouveaux fichiers pour LilyPond, sélectionnez
65 @w{@code{Fichier > Nouveau}}
67 @sourceimage{Learning_Macos_New_menu,,,}
69 ou @w{@code{Fichier > Ouvrir}} pour reprendre un fichier précédemment
72 @sourceimage{Learning_Macos_Open_menu,,,}
74 Pensez à toujours enregistrer votre travail avant de lancer l'option
75 @w{@code{Compile > Tyepset}} du menu. Si le PDF n'apparaît pas,
76 vérifiez que la fenêtre @qq{log} ne comporte pas d'erreur.
78 Si vous n'utilisez pas le lecteur de PDF par défaut de Mac@tie{}OS et
79 qu'un fichier résultant d'une précédente compilation est encore ouvert
80 dans votre lecteur, la régénération de ce PDF peut bloquer tant que vous
81 ne fermez pas le fichier ouvert.
88 @warning{Les instructions qui suivent partent du principe que vous
89 utilisez l'éditeur LilyPad fourni. Si vous utilisez l'un des programmes
90 répertoriés dans @rweb{Facilités d'édition}, consultez sa documentation
91 en cas de compilation infructueuse.}
94 @subsubheading Étape 1. Création d'un fichier @file{.ly}
96 Double-cliquez sur l'icone LilyPond qui se trouve sur le bureau.
97 S'ouvre alors un fichier d'exemple.
99 @sourceimage{LilyPad,,,}
101 Dans le menu, sélectionnez @w{@code{Fichier > Enregistrer sous}}. Ne
102 prenez pas l'option @w{@code{Fichier > Enregistrer}} pour ce fichier
103 exemple@tie{}: LilyPond attend un nom de fichier valide.
106 @sourceimage{FileSave,,,}
108 Affectez un nom à votre fichier, comme par exemple @file{test.ly}.
110 @sourceimage{SaveAs,,,}
113 @subsubheading Étape 2a. Compilation par glisser-déposer
115 Selon votre préférence, vous pouvez compiler votre fichier
116 en le faisant glisser puis en le déposant sur l'icone LilyPond
118 @sourceimage{DragDrop,,,}
120 ou en ouvrant le menu contextuel par un clic-droit, puis en prenant
121 l'option @w{@code{Ouvrir avec > LilyPond}}.
123 @sourceimage{GenPDF,,,}
126 @subsubheading Étape 2b. Compilation par double-clic
128 Vous pouvez aussi faire un double-clic sur le fichier @file{test.ly}.
131 @subsubheading Étape 3. Visualisation du résultat
133 Au cours de la compilation du fichier @file{test.ly}, une fenêtre
134 d'interpréteur de commande s'ouvre et se referme. Trois fichiers
135 complémentaires seront générés pendant ce temps là. Le fichier PDF
136 contient la gravure de votre fichier @file{test.ly}.
138 @sourceimage{PDFRead,,,}
141 @subsubheading Autres commandes
143 Pour créer un nouveau fichier, sélectionnez @w{@code{Fichier > Nouveau}}
144 à parti de n'importe quel fichier déjà existant ou bien
145 @w{@code{Fichier > Ouvrir}} pour reprendre un fichier sauvegardé.
147 @sourceimage{EditFile,,,}
149 Pensez à toujours enregistrer votre travail avant de compiler votre
150 fichier. Si LilyPond ne crée pas de PDF, consultez le fichier de
151 journalisation -- généré au fil du processus de compilation -- et
152 vérifiez qu'il ne comporte pas d'erreur.
154 @sourceimage{BadLog,,,}
156 Ce fichier journal est remplacé à chaque compilation de votre fichier
159 Le fichier PS est utilisé en interne par LilyPond pour créer le PDF. Il
160 sera écrasé à chaque fois que vous relancerez la compilation de votre
163 Pensez à fermer le fichier dans votre lecteur de PDF à chaque fois que
164 vous relancez la compilation, afin d'être sûr que celle-ci arrive à son
171 @c not lilypad at all, but I ran out of names. :(
172 @macro lilypadCommandLine
173 @warning{Les instructions qui suivent supposent que vous êtes familier
174 de la ligne de commande. Si vous utilisez l'un des programmes
175 répertoriés dans @rweb{Facilités d'édition}, consultez sa documentation
176 en cas de compilation infructueuse.}
179 @subsubheading Étape 1. Création d'un fichier @file{.ly}
181 Créez un fichier texte du nom de @file{test.ly} et saisissez@tie{}:
183 @c double \\ required because this is inside a macro!
185 \\version "@w{@versionStable{}}"
192 @subsubheading Étape 2. Compilation en ligne de commande
194 Pour traiter le fichier @file{test.ly}, tapez ce qui suit à l'invite de
202 Vous verrez alors quelque chose qui ressemblera à@tie{}:
205 GNU LilyPond @w{@versionStable{}}
206 Traitement de « test.ly »
208 Interprétation en cours de la musique...
209 Pré-traitement des éléments graphiques...
210 Détermination du nombre optimal de pages...
211 Répartition de la musique sur une page...
212 Dessin des systèmes...
213 Sortie mise en page vers « test.ps »...
214 Conversion à « ./test.pdf »...
215 Résultat : Compilation menée à son terme, avec succès.
220 Suivant votre installation, ces messages peuvent être traduits ou
224 @subsubheading Étape 3. Visualisation du résultat
226 Vous pouvez à présent visualiser ou imprimer @file{test.pdf}.