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{Learning_Win7_Welcome_File_Whole,,,}
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{Learning_Win7_Save_Menu,,,}
108 Affectez un nom à votre fichier, comme par exemple @file{test.ly}.
110 @sourceimage{Learning_Win7_Save_File_With_Name,,,}
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{Learning_Win7_Open_Dragndrop,,,}
120 ou en ouvrant le menu contextuel par un clic-droit, puis en prenant
121 l'option @w{@code{Ouvrir avec > LilyPond}}.
123 @sourceimage{Learning_Win7_Open_Context_Menu,,,}
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à.
137 @sourceimage{Learning_Win7_All_Files_Created,,,}
139 Le fichier PDF contient la gravure de votre fichier @file{test.ly}.
141 @sourceimage{Learning_Win7_Pdf_Output,,,}
144 @subsubheading Autres commandes
146 Pour créer un nouveau fichier, sélectionnez @w{@code{Fichier > Nouveau}}
147 à parti de n'importe quel fichier déjà existant
149 @sourceimage{Learning_Win7_New_Menu,,,}
152 ou bien @w{@code{Fichier > Ouvrir}} pour reprendre un fichier sauvegardé.
154 @sourceimage{Learning_Win7_Open_Menu,,,}
156 Pensez à toujours enregistrer votre travail avant de compiler votre
157 fichier. Si LilyPond ne crée pas de PDF, consultez le fichier de
158 journalisation -- généré au fil du processus de compilation -- et
159 vérifiez qu'il ne comporte pas d'erreur.
161 @sourceimage{Learning_Win7_Log_File,,,}
163 Ce fichier journal est remplacé à chaque compilation de votre fichier
166 Le fichier PS est utilisé en interne par LilyPond pour créer le PDF. Il
167 sera écrasé à chaque fois que vous relancerez la compilation de votre
170 Pensez à fermer le fichier dans votre lecteur de PDF à chaque fois que
171 vous relancez la compilation, afin d'être sûr que celle-ci arrive à son
178 @c not lilypad at all, but I ran out of names. :(
179 @macro lilypadCommandLine
180 @warning{Les instructions qui suivent supposent que vous êtes familier
181 de la ligne de commande. Si vous utilisez l'un des programmes
182 répertoriés dans @rweb{Facilités d'édition}, consultez sa documentation
183 en cas de compilation infructueuse.}
186 @subsubheading Étape 1. Création d'un fichier @file{.ly}
188 Créez un fichier texte du nom de @file{test.ly} et saisissez@tie{}:
190 @c double \\ required because this is inside a macro!
192 \\version "@w{@versionStable{}}"
199 @subsubheading Étape 2. Compilation en ligne de commande
201 Pour traiter le fichier @file{test.ly}, tapez ce qui suit à l'invite de
209 Vous verrez alors quelque chose qui ressemblera à@tie{}:
212 GNU LilyPond @w{@versionStable{}}
213 Traitement de « test.ly »
215 Interprétation en cours de la musique...
216 Pré-traitement des éléments graphiques...
217 Détermination du nombre optimal de pages...
218 Répartition de la musique sur une page...
219 Dessin des systèmes...
220 Sortie mise en page vers « test.ps »...
221 Conversion à « ./test.pdf »...
222 Résultat : Compilation menée à son terme, avec succès.
227 Suivant votre installation, ces messages peuvent être traduits ou
231 @subsubheading Étape 3. Visualisation du résultat
233 Vous pouvez à présent visualiser ou imprimer @file{test.pdf}.