Documentation/fr/included/generating-output.itexi

   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
  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.}
  21
  22
  23 @subsubheading Étape 1. Création d'un fichier @file{.ly}
  24
  25 Lorsque vous faites un double clic sur @command{LilyPond.app}, un
  26 fichier exemple s'ouvre.
  27
  28 @sourceimage{Learning_Macos_welcome,,,}
  29
  30 Dans 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
  35 Attribuez 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
  42 Dans le menu, sélectionnez
  43 @w{@code{Compiler > Typeset}}.
  44
  45 @sourceimage{Learning_Macos_Typeset_menu,,,}
  46
  47 Une nouvelle fenêtre s'ouvre dans laquelle s'affiche le journal de
  48 compilation 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
  55 La compilation s'achève par la création d'un fichier PDF portant le même
  56 nom que le fichier source ; ce nouveau fichier sera automatiquement
  57 ouvert 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
  64 Pour créer de nouveaux fichiers pour LilyPond, sélectionnez
  65 @w{@code{Fichier > Nouveau}}
  66
  67 @sourceimage{Learning_Macos_New_menu,,,}
  68
  69 ou @w{@code{Fichier > Ouvrir}} pour reprendre un fichier précédemment
  70 enregistré.
  71
  72 @sourceimage{Learning_Macos_Open_menu,,,}
  73
  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.
  77
  78 Si vous n'utilisez pas le lecteur de PDF par défaut de Mac 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.
  82
  83
  84 @end macro
  85
  86
  87 @macro lilypadWindows
  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}, référez-vous à leur
  91 documentation respective en cas de problème.}
  92
  93
  94 @subsubheading Étape 1. Création d'un fichier @file{.ly}
  95
  96 Double-cliquez sur l'icone LilyPond qui se trouve sur le bureau.
  97 S'ouvre alors un fichier d'exemple.
  98
  99 @sourceimage{LilyPad,,,}
 100
 101 Dans le menu, sélectionnez @w{@code{Fichier > Enregistrer sous}}
 102 (@emph{Save as@dots{}}).  Ne prenez pas l'option @w{@code{Fichier >
 103 Enregistrer}} (@emph{Save}) pour ce fichier exemple : LilyPond attend un
 104 nom de fichier valide.
 105
 106
 107 @sourceimage{FileSave,,,}
 108
 109 Affectez un nom à votre fichier, comme par exemple @file{test.ly}.
 110
 111 @sourceimage{SaveAs,,,}
 112
 113
 114 @subsubheading Étape 2. Compilation
 115
 116 La transformation d'un fichier LilyPond en partition s'obtient par
 117 compilation.  Celle-ci peut se lancer de différentes manières :
 118 par glisser-déposer, par un clic de droite, par un double clic ou
 119 encore en ligne de commande (dans une fenêtre d'interpréteur DOS).
 120 Nous examinerons ici les trois premières options.
 121
 122 1. Faire glisser puis déposer le fichier sur l'icone LilyPond
 123
 124 @sourceimage{DragDrop,,,}
 125
 126
 127 Bien qu'il ne semble pas se passer grand chose, deux fichiers --
 128 @file{test.log} et @file{test.pdf} -- devraient apparaître après
 129 quelques instants sur votre bureau.
 130
 131 2. Ouvrir le menu contextuel par un clic-droit, puis en prendre
 132 l'option @w{@code{Generate PDF @dots{} }} (@emph{Générer le PDF}).
 133
 134 @sourceimage{GenPDF,,,}
 135
 136 3. 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
 142 double-clic sur son icône devrait l'ouvrir dans votre lecteur PDF :
 143
 144 @sourceimage{PDFRead,,,}
 145
 146
 147 @subsubheading Autres commandes
 148
 149 Pour 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
 152 modification d'un fichier existant est aussi accessible à partir de
 153 l'option @w{@code{Edit source}} (@emph{Éditer la source}) du menu
 154 contextuel.
 155
 156 @sourceimage{EditFile,,,}
 157
 158 Pensez à toujours enregistrer votre travail avant de compiler votre
 159 fichier.  Si LilyPond ne crée pas de PDF ou que le résultat ne
 160 correspond pas à vos attentes, consultez le fichier de journalisation --
 161 généré au fil du processus de compilation -- et vérifiez qu'il ne
 162 comporte pas d'erreur.
 163
 164 @sourceimage{BadLog,,,}
 165
 166 Ce fichier journal est remplacé à chaque compilation de votre fichier
 167 LilyPond.
 168
 169 Pensez à fermer le fichier dans votre lecteur de PDF à chaque fois que
 170 vous relancez la compilation, afin d'être sûr que celle-ci arrive à son
 171 terme.
 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
 180 de la ligne de commande.  Si vous utilisez l'un des programmes
 181 répertoriés dans @rweb{Facilités d'édition}, référez-vous à leur
 182 documentation respective en cas de problème.}
 183
 184
 185 @subsubheading Étape 1. Création d'un fichier @file{.ly}
 186
 187 Cré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
 200 Pour traiter le fichier @file{test.ly}, tapez ce qui suit à l'invite de
 201 commande :
 202
 203 @example
 204 lilypond test.ly
 205 @end example
 206
 207 @noindent
 208 Vous verrez alors quelque chose qui ressemblera à :
 209
 210 @example
 211 GNU LilyPond @w{@versionStable{}}
 212 Traitement de « test.ly »
 213 Analyse...
 214 Interprétation en cours de la musique...
 215 Pré-traitement des éléments graphiques...
 216 Détermination du nombre optimal de pages...
 217 Répartition de la musique sur une page...
 218 Dessin des systèmes...
 219 Sortie mise en page vers « test.ps »...
 220 Conversion à « ./test.pdf »...
 221 Résultat : Compilation menée à son terme, avec succès.
 222 @end example
 223
 224 @c DIV specific
 225 @noindent
 226 Suivant votre installation, ces messages peuvent être traduits ou
 227 non.
 228 @c END DIV
 229
 230 @subsubheading Étape 3. Visualisation du résultat
 231
 232 Vous pouvez à présent visualiser ou imprimer @file{test.pdf}.
 233
 234 @end macro