@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@c This file is part of web/download.itexi and
@c learning/tutorial.itely
@ignore
    Translation of GIT committish: 63f65db72ca60bb87a6515a4f20a172c4a2897dc

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore

@c This is about "compiling" a lilypond file
@c (Learning 1 Tutorial), **not** compiling the
@c source code.

@macro lilypadOSX
@warning{Queste istruzioni presumono che tu stia usando il programma
LilyPond.  Se stai usando uno dei programmi descritti in
@rweb{Editing facilitato}, in caso di problemi consulta la documentazione
di quei programmi.}


@subsubheading Passo 1. Crea il tuo file @file{.ly}

Clicca due volte su @command{LilyPond.app}, si aprirà un file di esempio.

@sourceimage{Learning_Macos_welcome,,,}

Dai menu in cima a sinistra dello schermo seleziona
@w{@code{File > Salva}}.

@sourceimage{Learning_Macos_Save_menu,,,}

Scegli un nome per il tuo file, ad esempio @file{test.ly}.

@sourceimage{Learning_Macos_Save_file_with_name,,,}


@subsubheading Passo 2. Compila (con LilyPad)

Dagli stessi menu seleziona
@w{@code{Compile > Typeset}}.

@sourceimage{Learning_Macos_Typeset_menu,,,}

Si aprirà una nuova finestra che mostra i messaggi di log della compilazione
del file che hai appena salvato.

@sourceimage{Learning_Macos_Compiling_log,,,}


@subsubheading Passo 3. Visualizza l'output

Quando la compilazione è finita, un file PDF con lo stesso nome del file
originale viene creato e automaticamente aperto nel visualizzatore
PDF predefinito, che lo mostrerà sullo schermo.

@sourceimage{Learning_Macos_pdf_output,,,}


@subsubheading Altri comandi

Per creare nuovi file per LilyPond, comincia col selezionare
@w{@code{File > New}}

@sourceimage{Learning_Macos_New_menu,,,}

oppure @w{@code{File > Open}} per aprire e modificare file esistenti che
hai salvato precedentemente.

@sourceimage{Learning_Macos_Open_menu,,,}

Devi salvare qualsiasi nuova modifica fatta al file prima di cliccare
@w{@code{Compile > Typeset}} e se il file PDF non compare controlla se
ci sono degli errori nella finestra dei messaggi di log.

Se non stai usando il visualizzatore d'anteprima PDF incluso nel sistema
operativo del Mac e un file PDF generato da una compilazione precedente
è aperto, qualsiasi compilazione successiva potrebbe non riuscire a
generare un PDF aggiornato finché non chiudi l'originale.



@end macro


@macro lilypadWindows
@warning{Queste istruzioni presumono che tu stia usando l'editor LilyPad
incluso nel programma.  Se stai usando uno dei programmi descritti in
@rweb{Editing facilitato}, in caso di problemi nel compilare un file consulta
la documentazione di quei programmi.}


@subsubheading Passo 1. Crea il tuo file @file{.ly}

Clicca due volte sull'icona di LilyPond sulla scrivania e si aprirà
un file di esempio.

@sourceimage{LilyPad,,,}

Dai menu che appaiono in cima al file di esempio seleziona
@w{@code{File > Salva come}}.  Non usare @w{@code{File > Salva}}
per il file di esempio perché non funzionerà finché non gli darai
un nome di file valido per LilyPond.

@sourceimage{FileSave,,,}

Scegli un nome per il tuo file, ad esempio @file{test.ly}.

@sourceimage{SaveAs,,,}


@subsubheading Passo 2. Compila

Per trasformare il file LilyPond in una partitura devi compilarlo.  Ci sono
vari modi per farlo: il trascina e rilascia (drag and drop), il clic destro,
il doppio clic o la linea di comando (nel riquadro del terminale DOS).  Vediamo
intanto i primi tre.

1. Trascinare e rilasciare il file sull'icona LilyPond che si trova nel desktop.

@sourceimage{DragDrop,,,}

Sembrerà che non stia accadendo niente, ma dopo pochi secondi dovresti
vedere due nuovi file sul desktop: @file{test.log} e @file{test.pdf}.

2. Cliccare col tasto destro sul file e dal menu contestuale a comparsa scegliere
@w{@code{Generate PDF}}.

@sourceimage{GenPDF,,,}


3. O semplicemente cliccare due volte su @file{test.ly}.


@subsubheading Passo 3. Visualizza l'output

@file{test.pdf} contiene il file @file{test.ly} compilato.  Cliccalo due
volte e si dovrebbe aprire in un visualizzatore PDF:

@sourceimage{PDFRead,,,}


@subsubheading Altri comandi

Per creare un nuovo file, per prima cosa seleziona @w{@code{File > Nuovo}} se
hai aperto un file creato in precedenza oppure @w{@code{File > Apri}}
per aprire e modificare i file che hai salvato prima.  Puoi modificare
un file anche facendo un clic destro e selezionando @w{@code{Edit Source}}.

@sourceimage{EditFile,,,}

Devi salvare qualsiasi nuova modifica prima di compilare.  Se il file
PDF non viene creato o l'output non è quello che ti aspetti, controlla
se ci sono degli errori nel file di log che sarà stato creato durante
il tentativo di compilazione.

@sourceimage{BadLog,,,}

Questo file di log viene sovrascritto ogni volta che compili il file LilyPond.

Se visualizzi il file in un lettore PDF, devi chiudere il PDF se desideri
provare una nuova compilazione, perché potrebbe non riuscire a creare il
nuovo file PDF mentre è ancora aperto per la visualizzazione.

@sourceimage{BadLog2,,,}

@end macro


@c not lilypad at all, but I ran out of names.  :(
@macro lilypadCommandLine
@warning{Queste istruzioni presumono che tu abbia familiarità con i
programmi a linea di comando.  Se stai usando uno dei programmi descritti in
@rweb{Editing facilitato}, in caso di problemi nel compilare un file consulta
la documentazione di quei programmi.}


@subsubheading Passo 1. Crea il tuo file @file{.ly}

Crea un file di testo chiamato @file{test.ly} e scrivi:

@c double \\ required because this is inside a macro!
@example
\\version "@w{@versionStable{}}"
@{
@ @ c' e' g' e'
@}
@end example


@subsubheading Passo 2. Compila (da linea di comando)

Per elaborare @file{test.ly}, scrivi il seguente comando nel terminale:

@example
lilypond test.ly
@end example

@noindent
Vedrai qualcosa di simile a questo:

@example
GNU LilyPond @w{@versionStable{}}
Processing `test.ly'
Parsing...
Interpreting music...
Preprocessing graphical objects...
Solving 1 page-breaking chunks...[1: 1 pages]
Drawing systems...
Layout output to `test.ps'...
Converting to `./test.pdf'...
Success: compilation successfully completed
@end example

@subsubheading Passo 3. Visualizza l'output

Puoi visualizzare o stampare il file @file{test.pdf}.

@end macro