Documentation/it/included/generating-output.itexi

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
   2 @c This file is part of web/download.itexi and
   3 @c learning/tutorial.itely
   4 @ignore
   5     Translation of GIT committish: 7a5bfc62fcac71d5c996b2df58921fd2fe783415
   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{Queste istruzioni presumono che tu stia usando il programma
  18 LilyPond.  Se stai usando uno dei programmi descritti in
  19 @rweb{Editing facilitato}, in caso di problemi consulta la documentazione
  20 di quei programmi.}
  21
  22
  23 @subsubheading Passo 1. Crea il tuo file @file{.ly}
  24
  25 Clicca due volte su @command{LilyPond.app}, si aprirà un file di esempio.
  26
  27 @sourceimage{Learning_Macos_welcome,,,}
  28
  29 Dai menu in cima a sinistra dello schermo seleziona
  30 @w{@code{File > Salva}}.
  31
  32 @sourceimage{Learning_Macos_Save_menu,,,}
  33
  34 Scegli un nome per il tuo file, ad esempio @file{test.ly}.
  35
  36 @sourceimage{Learning_Macos_Save_file_with_name,,,}
  37
  38
  39 @subsubheading Passo 2. Compila (con LilyPad)
  40
  41 Dagli stessi menu seleziona
  42 @w{@code{Compile > Typeset}}.
  43
  44 @sourceimage{Learning_Macos_Typeset_menu,,,}
  45
  46 Si aprirà una nuova finestra che mostra i messaggi di log della compilazione
  47 del file che hai appena salvato.
  48
  49 @sourceimage{Learning_Macos_Compiling_log,,,}
  50
  51
  52 @subsubheading Passo 3. Visualizza l'output
  53
  54 Quando la compilazione è finita, un file PDF con lo stesso nome del file
  55 originale viene creato e automaticamente aperto nel visualizzatore
  56 PDF predefinito, che lo mostrerà sullo schermo.
  57
  58 @sourceimage{Learning_Macos_pdf_output,,,}
  59
  60
  61 @subsubheading Altri comandi
  62
  63 Per creare nuovi file per LilyPond, comincia col selezionare
  64 @w{@code{File > New}}
  65
  66 @sourceimage{Learning_Macos_New_menu,,,}
  67
  68 oppure @w{@code{File > Open}} per aprire e modificare file esistenti che
  69 hai salvato precedentemente.
  70
  71 @sourceimage{Learning_Macos_Open_menu,,,}
  72
  73 Devi salvare qualsiasi nuova modifica fatta al file prima di cliccare
  74 @w{@code{Compile > Typeset}} e se il file PDF non compare controlla se
  75 ci sono degli errori nella finestra dei messaggi di log.
  76
  77 Se non stai usando il visualizzatore d'anteprima PDF incluso nel sistema
  78 operativo del Mac e un file PDF generato da una compilazione precedente
  79 è aperto, qualsiasi compilazione successiva potrebbe non riuscire a
  80 generare un PDF aggiornato finché non chiudi l'originale.
  81
  82
  83
  84 @end macro
  85
  86
  87 @macro lilypadWindows
  88 @warning{Queste istruzioni presumono che tu stia usando l'editor LilyPad
  89 incluso nel programma.  Se stai usando uno dei programmi descritti in
  90 @rweb{Editing facilitato}, in caso di problemi nel compilare un file consulta
  91 la documentazione di quei programmi.}
  92
  93
  94 @subsubheading Passo 1. Crea il tuo file @file{.ly}
  95
  96 Clicca due volte sull'icona di LilyPond sulla scrivania e si aprirà
  97 un file di esempio.
  98
  99 @sourceimage{LilyPad,,,}
 100
 101 Dai menu che appaiono in cima al file di esempio seleziona
 102 @w{@code{File > Salva come}}.  Non usare @w{@code{File > Salva}}
 103 per il file di esempio perché non funzionerà finché non gli darai
 104 un nome di file valido per LilyPond.
 105
 106 @sourceimage{FileSave,,,}
 107
 108 Scegli un nome per il tuo file, ad esempio @file{test.ly}.
 109
 110 @sourceimage{SaveAs,,,}
 111
 112
 113 @subsubheading Passo 2. Compila
 114
 115 Per trasformare il file LilyPond in una partitura devi compilarlo.  Ci sono
 116 vari modi per farlo: il trascina e rilascia (drag and drop), il clic destro,
 117 il doppio clic o la linea di comando (nel riquadro del terminale DOS).  Vediamo
 118 intanto i primi tre.
 119
 120 1. Trascinare e rilasciare il file sull'icona LilyPond che si trova nel desktop.
 121
 122 @sourceimage{DragDrop,,,}
 123
 124 Sembrerà che non stia accadendo niente, ma dopo pochi secondi dovresti
 125 vedere due nuovi file sul desktop: @file{test.log} e @file{test.pdf}.
 126
 127 2. Cliccare col tasto destro sul file e dal menu contestuale a comparsa scegliere
 128 @w{@code{Generate PDF}}.
 129
 130 @sourceimage{GenPDF,,,}
 131
 132
 133 3. O semplicemente cliccare due volte su @file{test.ly}.
 134
 135
 136 @subsubheading Passo 3. Visualizza l'output
 137
 138 @file{test.pdf} contiene il file @file{test.ly} compilato.  Cliccalo due
 139 volte e si dovrebbe aprire in un visualizzatore PDF:
 140
 141 @sourceimage{PDFRead,,,}
 142
 143
 144 @subsubheading Altri comandi
 145
 146 Per creare un nuovo file, per prima cosa seleziona @w{@code{File > Nuovo}} se
 147 hai aperto un file creato in precedenza oppure @w{@code{File > Apri}}
 148 per aprire e modificare i file che hai salvato prima.  Puoi modificare
 149 un file anche facendo un clic destro e selezionando @w{@code{Edit Source}}.
 150
 151 @sourceimage{EditFile,,,}
 152
 153 Devi salvare qualsiasi nuova modifica prima di compilare.  Se il file
 154 PDF non viene creato o l'output non è quello che ti aspetti, controlla
 155 se ci sono degli errori nel file di log che sarà stato creato durante
 156 il tentativo di compilazione.
 157
 158 @sourceimage{BadLog,,,}
 159
 160 Questo file di log viene sovrascritto ogni volta che compili il file LilyPond.
 161
 162 Se visualizzi il file in un lettore PDF, devi chiudere il PDF se desideri
 163 provare una nuova compilazione, perché potrebbe non riuscire a creare il
 164 nuovo file PDF mentre è ancora aperto per la visualizzazione.
 165
 166 @sourceimage{BadLog2,,,}
 167
 168 @end macro
 169
 170
 171 @c not lilypad at all, but I ran out of names.  :(
 172 @macro lilypadCommandLine
 173 @warning{Queste istruzioni presumono che tu abbia familiarità con i
 174 programmi a linea di comando.  Se stai usando uno dei programmi descritti in
 175 @rweb{Editing facilitato}, in caso di problemi nel compilare un file consulta
 176 la documentazione di quei programmi.}
 177
 178
 179 @subsubheading Passo 1. Crea il tuo file @file{.ly}
 180
 181 Crea un file di testo chiamato @file{test.ly} e scrivi:
 182
 183 @c double \\ required because this is inside a macro!
 184 @example
 185 \\version "@w{@versionStable{}}"
 186 @{
 187 @ @ c' e' g' e'
 188 @}
 189 @end example
 190
 191
 192 @subsubheading Passo 2. Compila (da linea di comando)
 193
 194 Per elaborare @file{test.ly}, scrivi il seguente comando nel terminale:
 195
 196 @example
 197 lilypond test.ly
 198 @end example
 199
 200 @noindent
 201 Vedrai qualcosa di simile a questo:
 202
 203 @example
 204 GNU LilyPond @w{@versionStable{}}
 205 Processing `test.ly'
 206 Parsing...
 207 Interpreting music...
 208 Preprocessing graphical objects...
 209 Solving 1 page-breaking chunks...[1: 1 pages]
 210 Drawing systems...
 211 Layout output to `test.ps'...
 212 Converting to `./test.pdf'...
 213 Success: compilation successfully completed
 214 @end example
 215
 216 @subsubheading Passo 3. Visualizza l'output
 217
 218 Puoi visualizzare o stampare il file @file{test.pdf}.
 219
 220 @end macro