1.1 Compilare un file

@translationof Compiling a file

1.1.1 Inserire l’input

@translationof Entering input

“Compilazione” è il termine usato per indicare l’elaborazione di un file di input in formato LilyPond per produrre uno o più file di output. I file di output generalmente sono PDF (per la stampa e la visualizzazione), MIDI (per la riproduzione audio) e PNG (per l’utilizzo online). I file di input di LilyPond sono semplici file di testo.

Questo esempio mostra un semplice file di input:

\version "2.21.3"
{
  c' e' g' e'
}

L’output grafico è:

Inoltre, l’input di LilyPond è sensibile alle maiuscole. ‘{ c d e }’ è un input valido; ‘{ C D E }’ invece produrrà un messaggio di errore.

Generare l’output

@translationof Producing output

Come generare l’output di LilyPond dipende dal tuo sistema operativo e dai programmi che usi.

• MacOS X (grafico)
• Microsoft Windows (grafico)
• Tutti i sistemi operativi (linea di comando)

Si noti che sono disponibili molti altri editor di testo con un miglior supporto per LilyPond. Per maggiori informazioni, si veda (web)Editing facilitato section ‘Editing facilitato’ in Informazioni Generali.

1.1.2 MacOS X

Passo 1. Crea il tuo file ‘.ly’

Clicca due volte su LilyPond.app, si aprirà un file di esempio.

Dai menu in cima a sinistra dello schermo seleziona File > Salva.

Scegli un nome per il tuo file, ad esempio ‘test.ly’.

Passo 2. Compila (con LilyPad)

Dagli stessi menu seleziona Compile > Typeset.

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

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.

Altri comandi

Per creare nuovi file per LilyPond, comincia col selezionare File > New

oppure File > Open per aprire e modificare file esistenti che hai salvato precedentemente.

Devi salvare qualsiasi nuova modifica fatta al file prima di cliccare 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.

1.1.3 Windows

Passo 1. Crea il tuo file ‘.ly’

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

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

Scegli un nome per il tuo file, ad esempio ‘test.ly’.

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.

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

2. Cliccare col tasto destro sul file e dal menu contestuale a comparsa scegliere Generate PDF.

3. O semplicemente cliccare due volte su ‘test.ly’.

Passo 3. Visualizza l’output

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

Altri comandi

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

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.

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.

1.1.4 Linea di comando

@translationof Command-line

Passo 1. Crea il tuo file ‘.ly’

Crea un file di testo chiamato ‘test.ly’ e scrivi:

\version "2.20.0"
{
  c' e' g' e'
}

Passo 2. Compila (da linea di comando)

Per elaborare ‘test.ly’, scrivi il seguente comando nel terminale:

lilypond test.ly

Vedrai qualcosa di simile a questo:

GNU LilyPond 2.20.0
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

Passo 3. Visualizza l’output

Puoi visualizzare o stampare il file ‘test.pdf’.

This document was generated by gub on Luglio 13, 2020 using texi2html 1.82.

Altre lingue: English, català, česky, deutsch, español, français, magyar, 日本語, nederlands.
A proposito della selezione automatica della lingua.