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 4@ignore 5 Translation of GIT committish: febe2e4ff91dda9227e85274ae045e23c6b4ec28 6 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.. 10@end ignore 11 12@c This is about "compiling" a lilypond file 13@c (Learning 1 Tutorial), **not** compiling the 14@c source code. 15 16@macro lilypadOSX 17@warning{Les instructions qui suivent concernent ceux qui utilisent 18le lanceur LilyPond. Si vous utilisez l'un des programmes mentionnés 19au chapitre @rweb{Facilités d'édition}, référez-vous à leur 20documentation respective en cas de problème.} 21 22 23@subsubheading Étape 1. Création d'un fichier @file{.ly} 24 25Lorsque vous faites un double clic sur @command{LilyPond.app}, un 26fichier exemple s'ouvre. 27 28@sourceimage{Learning_Macos_welcome,,,} 29 30Dans le menu, en haut et à gauche de la fenêtre, sélectionnez 31@w{@code{Fichier > Enregistrer}}. 32 33@sourceimage{Learning_Macos_Save_menu,,,} 34 35Attribuez un nom à votre fichier, par exemple @file{test.ly}. 36 37@sourceimage{Learning_Macos_Save_file_with_name,,,} 38 39 40@subsubheading Étape 2. Compilation (avec LilyPad) 41 42Dans le menu, sélectionnez 43@w{@code{Compiler > Typeset}}. 44 45@sourceimage{Learning_Macos_Typeset_menu,,,} 46 47Une nouvelle fenêtre s'ouvre dans laquelle s'affiche le journal de 48compilation du fichier que vous venez de sauvegarder. 49 50@sourceimage{Learning_Macos_Compiling_log,,,} 51 52 53@subsubheading Étape 3. Visualisation du résultat 54 55La compilation s'achève par la création d'un fichier PDF portant le même 56nom que le fichier source ; ce nouveau fichier sera automatiquement 57ouvert par votre lecteur PDF par défaut et affiché à l'écran. 58 59@sourceimage{Learning_Macos_pdf_output,,,} 60 61 62@subsubheading Autres commandes 63 64Pour créer de nouveaux fichiers pour LilyPond, sélectionnez 65@w{@code{Fichier > Nouveau}} 66 67@sourceimage{Learning_Macos_New_menu,,,} 68 69ou @w{@code{Fichier > Ouvrir}} pour reprendre un fichier précédemment 70enregistré. 71 72@sourceimage{Learning_Macos_Open_menu,,,} 73 74Pensez à toujours enregistrer votre travail avant de lancer l'option 75@w{@code{Compile > Tyepset}} du menu. Si le PDF n'apparaît pas, 76vérifiez que la fenêtre @qq{log} ne comporte pas d'erreur. 77 78Si vous n'utilisez pas le lecteur de PDF par défaut de Mac OS et 79qu'un fichier résultant d'une précédente compilation est encore ouvert 80dans votre lecteur, la régénération de ce PDF peut bloquer tant que vous 81ne fermez pas le fichier ouvert. 82 83 84@end macro 85 86 87@macro lilypadWindows 88@warning{Les instructions qui suivent partent du principe que vous 89utilisez l'éditeur LilyPad fourni. Si vous utilisez l'un des programmes 90répertoriés dans @rweb{Facilités d'édition}, référez-vous à leur 91documentation respective en cas de problème.} 92 93 94@subsubheading Étape 1. Création d'un fichier @file{.ly} 95 96Double-cliquez sur l'icone LilyPond qui se trouve sur le bureau. 97S'ouvre alors un fichier d'exemple. 98 99@sourceimage{LilyPad,,,} 100 101Dans le menu, sélectionnez @w{@code{Fichier > Enregistrer sous}} 102(@emph{Save as@dots{}}). Ne prenez pas l'option @w{@code{Fichier > 103Enregistrer}} (@emph{Save}) pour ce fichier exemple : LilyPond attend un 104nom de fichier valide. 105 106 107@sourceimage{FileSave,,,} 108 109Affectez un nom à votre fichier, comme par exemple @file{test.ly}. 110 111@sourceimage{SaveAs,,,} 112 113 114@subsubheading Étape 2. Compilation 115 116La transformation d'un fichier LilyPond en partition s'obtient par 117compilation. Celle-ci peut se lancer de différentes manières : 118par glisser-déposer, par un clic de droite, par un double clic ou 119encore en ligne de commande (dans une fenêtre d'interpréteur DOS). 120Nous examinerons ici les trois premières options. 121 1221. Faire glisser puis déposer le fichier sur l'icone LilyPond 123 124@sourceimage{DragDrop,,,} 125 126 127Bien qu'il ne semble pas se passer grand chose, deux fichiers -- 128@file{test.log} et @file{test.pdf} -- devraient apparaître après 129quelques instants sur votre bureau. 130 1312. Ouvrir le menu contextuel par un clic-droit, puis en prendre 132l'option @w{@code{Generate PDF @dots{} }} (@emph{Générer le PDF}). 133 134@sourceimage{GenPDF,,,} 135 1363. Faire un double-clic sur le fichier @file{test.ly}. 137 138 139@subsubheading Étape 3. Visualisation du résultat 140 141@file{test.pdf} contient la gravure de votre fichier @file{test.ly}. Un 142double-clic sur son icône devrait l'ouvrir dans votre lecteur PDF : 143 144@sourceimage{PDFRead,,,} 145 146 147@subsubheading Autres commandes 148 149Pour créer un nouveau fichier, sélectionnez @w{@code{Fichier > Nouveau}} 150à partir de n'importe quel fichier déjà existant ou bien 151@w{@code{Fichier > Ouvrir}} pour reprendre un fichier sauvegardé. La 152modification d'un fichier existant est aussi accessible à partir de 153l'option @w{@code{Edit source}} (@emph{Éditer la source}) du menu 154contextuel. 155 156@sourceimage{EditFile,,,} 157 158Pensez à toujours enregistrer votre travail avant de compiler votre 159fichier. Si LilyPond ne crée pas de PDF ou que le résultat ne 160correspond pas à vos attentes, consultez le fichier de journalisation -- 161généré au fil du processus de compilation -- et vérifiez qu'il ne 162comporte pas d'erreur. 163 164@sourceimage{BadLog,,,} 165 166Ce fichier journal est remplacé à chaque compilation de votre fichier 167LilyPond. 168 169Pensez à fermer le fichier dans votre lecteur de PDF à chaque fois que 170vous relancez la compilation, afin d'être sûr que celle-ci arrive à son 171terme. 172 173 174@end macro 175 176 177@c not lilypad at all, but I ran out of names. :( 178@macro lilypadCommandLine 179@warning{Les instructions qui suivent supposent que vous êtes familier 180de la ligne de commande. Si vous utilisez l'un des programmes 181répertoriés dans @rweb{Facilités d'édition}, référez-vous à leur 182documentation respective en cas de problème.} 183 184 185@subsubheading Étape 1. Création d'un fichier @file{.ly} 186 187Créez un fichier texte du nom de @file{test.ly} et saisissez : 188 189@c double \\ required because this is inside a macro! 190@example 191\\version "@w{@versionStable{}}" 192@{ 193@ @ c' e' g' e' 194@} 195@end example 196 197 198@subsubheading Étape 2. Compilation en ligne de commande 199 200Pour traiter le fichier @file{test.ly}, tapez ce qui suit à l'invite de 201commande : 202 203@example 204lilypond test.ly 205@end example 206 207@noindent 208Vous verrez alors quelque chose qui ressemblera à : 209 210@example 211GNU LilyPond @w{@versionStable{}} 212Traitement de « test.ly » 213Analyse... 214Interprétation en cours de la musique... 215Pré-traitement des éléments graphiques... 216Détermination du nombre optimal de pages... 217Répartition de la musique sur une page... 218Dessin des systèmes... 219Sortie mise en page vers « test.ps »... 220Conversion à « ./test.pdf »... 221Résultat : Compilation menée à son terme, avec succès. 222@end example 223 224@c DIV specific 225@noindent 226Suivant votre installation, ces messages peuvent être traduits ou 227non. 228@c END DIV 229 230@subsubheading Étape 3. Visualisation du résultat 231 232Vous pouvez à présent visualiser ou imprimer @file{test.pdf}. 233 234@end macro 235