Guida alla Notazione di LilyPond: 4.1 Formattazione della pagina

[ ? ]

4.1.1 Il blocco `\paper`

@translationof The paper block

I blocchi \paper possono essere posizionati in tre punti diversi, in modo da formare una gerarchia discendente di blocchi \paper:

All’inizio del file di input, prima di tutti i blocchi \book, \bookpart e \score.
Dentro un blocco \book ma fuori da tutti i blocchi \bookpart e \score in esso racchiusi.
Dentro un blocco \bookpart ma fuori da tutti i blocchi \score in esso racchiusi.

Non è possibile inserire un blocco \paper in un blocco \score.

I valori dei campi vengono filtrati dall’alto verso il basso attraverso questa gerarchia: i valori impostati nei livelli più alti della gerarchia persistono finché non sono sovrascritti da un valore impostato in un livello più basso.

Vari blocchi \paper possono apparire in ognuno di questi livelli, per esempio come parti di vari file inclusi con \include. In questo caso, i campi di ciascun livello vengono combinati e i valori riscontrati per ultimi avranno la precedenza in caso di campi duplicati.

Le impostazioni che possono apparire in un blocco \paper comprendono:

la funzione Scheme set-paper-size,
le variabili \paper per personalizzare la formattazione della pagina e
le definizioni di markup usate per personalizzare la formattazione di intestazioni, piè di pagina e titoli.

La funzione set-paper-size è trattata nella prossima sezione, Formato carta e ridimensionamento automatico. Le variabili \paper che si occupano della formattazione della pagina sono trattate in sezioni successive. Le definizioni di markup relative a intestazioni, piè di pagina e titoli sono trattate in Titoli intestazioni e piè di pagina personalizzati.

La maggior parte delle variabili \paper funzionano soltanto in un blocco \paper. Le poche che funzionano anche in un blocco \layout sono elencate in Il blocco \layout.

Se non indicato diversamente, tutte le variabili \paper che corrispondono a distanze sulla pagina sono misurate in millimetri, a meno che un’unità di misura diversa non sia specificata dall’utente. Per esempio, la seguente dichiarazione imposta top-margin su dieci millimetri:

\paper {
  top-margin = 10
}

Per impostarla su 0.5 pollici, usare il suffisso di unità \in (inch = pollice):

\paper {
  top-margin = 0.5\in
}

I suffissi di unità disponibili sono \mm, \cm, \in e \pt. Queste unità sono semplici valori utili per convertire dai millimetri e sono definite in ‘ly/paper-defaults-init.ly’. Solo per chiarezza, quando si usano i millimetri, di solito si usa il suffisso \mm, anche se non è tecnicamente necessario.

È anche possibile definire i valori di \paper con Scheme. L’equivalente Scheme dell’esempio precedente è:

\paper {
  #(define top-margin (* 0.5 in))
}

Vedi anche

Guida alla notazione: Formato carta e ridimensionamento automatico, Titoli intestazioni e piè di pagina personalizzati, Il blocco \layout.

File installati: ‘ly/paper-defaults-init.ly’.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

4.1.2 Formato carta e ridimensionamento automatico

@translationof Paper size and automatic scaling

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Impostare il formato carta

@translationof Setting the paper size

‘A4’ è il valore predefinito quando non viene impostato esplicitamente alcun formato carta. Esistono due funzioni che permettono di cambiare formato:

set-default-paper-size

#(set-default-paper-size "quarto")

che deve sempre trovarsi nel livello superiore, e

set-paper-size

\paper {
  #(set-paper-size "tabloid")
}

che deve sempre trovarsi in un blocco \paper.

La funzione set-default-paper-size, se usata nel livello superiore, deve precedere qualsiasi blocco \paper. set-default-paper-size imposta il formato di tutte le pagine, mentre set-paper-size imposta il formato soltanto di quelle pagine a cui è applicato il blocco \paper. Per esempio, se il blocco \paper si trova all’inizio del file, applicherà il formato a tutte le pagine. Se il blocco \paper si trova dentro un blocco \book, il formato verrà applicato a quel libro soltanto.

Quando si usa la funzione set-paper-size, questa deve essere posta prima di qualsiasi altra funzione usata nello stesso blocco \paper. Vedi Ridimensionamento automatico al formato carta.

I formati carta sono definiti in ‘scm/paper.scm’, e sebbene sia possibile aggiungere formati personalizzati in questo file, tali aggiunte verrebbero sovrascritte da successivi aggiornamenti del software. I formati disponibili sono elencati in Formati carta predefiniti.

È tuttavia possibile aggiungere un formato personalizzato nel file di input per poi utilizzarlo con set-default-paper-size o set-paper-size:

#(set! paper-alist (cons '("mio formato" . (cons (* 15 in) (* 3 in))) paper-alist))

\paper {
  #(set-paper-size "mio formato")
}

Si può usare qualsiasi unità di misura: in (inch, o pollici), cm (centimetri) e mm (millimetri).

Aggiungendo il simbolo 'landscape alla funzione del formato, le pagine vengono ruotate di 90 gradi e le linee occupano il maggior spazio a disposizione.

#(set-default-paper-size "a6" 'landscape)

Appendendo ‘landscape’ (orizzontale) al nome del formato, è possibile scambiare le dimensioni della carta senza ruotare la stampa (come quando si stampa in formato cartolina o si creano dei file grafici da includere invece di un documento indipendente):

#(set-default-paper-size "a6landscape")

Quando il formato termina con un esplicito ‘landscape’ (orizzontale) o ‘portrait’ (verticale), la presenza di un simbolo 'landscape influisce solo sull’orientamento della stampa, non sul formato usato per la formattazione.

Vedi anche

Guida alla notazione: Ridimensionamento automatico al formato carta, Formati carta predefiniti.

File installati: ‘scm/paper.scm’.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Ridimensionamento automatico al formato carta

@translationof Automatic scaling to paper size

Se il formato viene cambiato con una delle funzioni Scheme (set-default-paper-size o set-paper-size), i valori di diverse variabili \paper sono automaticamente ricalcolati in base alla nuova dimensione. Per aggirare il ridimensionamento automatico di una certa variabile, impostare la variabile dopo aver impostato il formato. Fare attenzione al fatto che il ridimensionamento automatico non viene attivato se si impostano le variabili paper-height o paper-width, anche se paper-width può influenzare altri valori (ma questo è un argomento diverso dal ridimensionamento ed è trattato in seguito). Le funzioni set-default-paper-size e set-paper-size sono descritte in Impostare il formato carta.

Le dimensioni verticali interessate dal ridimensionamento automatico sono top-margin e bottom-margin (vedi @ref{Fixed vertical spacing paper variables,,Variabili fisse della spaziatura verticale di @code{\paper}}). Le dimensioni orizzontali interessate dal ridimensionamento automatico sono left-margin, right-margin, inner-margin, outer-margin, binding-offset, indent e short-indent (vedi @ref{Horizontal spacing paper variables,,Variabili della spaziatura orizzontale di @code{\paper}}).

I valori predefiniti di queste dimensioni sono impostati in ‘ly/paper-defaults-init.ly’ e salvati in variabili interne chiamate top-margin-default, bottom-margin-default, etc. Questi valori si riferiscono al formato predefinito a4. Per riferimento, nel formato a4 il valore di paper-height è 297\mm e quello di paper-width è 210\mm.

Vedi anche

Guida alla notazione: @ref{Fixed vertical spacing paper variables,,Variabili fisse della spaziatura verticale di @code{\paper}}, @ref{Horizontal spacing paper variables,,Variabili della spaziatura orizzontale di @code{\paper}}.

File installati: ‘ly/paper-defaults-init.ly’, ‘scm/paper.scm’.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

4.1.3 Variabili `\paper` della spaziatura verticale fissa

@translationof Fixed vertical spacing paper variables

Nota: Alcune dimensioni definite nel blocco \paper sono ridimensionate automaticamente in base al formato carta, portando a possibili risultati imprevisti. Vedi Ridimensionamento automatico al formato carta.

I valori predefiniti (prima del ridimensionamento) sono definiti in ‘ly/paper-defaults-init.ly’.

paper-height: L’altezza della pagina (valore predefinito: non impostata). Il ridimensionamento automatico di alcune dimensioni verticali non è influenzato da questa.
top-margin: Il margine tra il punto più alto della pagina e il punto più alto dell’area di stampa. Se il formato viene modificato, il valore predefinito di questa dimensione viene ridimensionato di conseguenza.
bottom-margin: Il margine tra il punto più basso dell’area di stampa e il punto più basso della pagina. Se il formato viene modificato, il valore predefinito di questa dimensione viene ridimensionato di conseguenza.
ragged-bottom: Se impostato su vero, i sistemi avranno la loro naturale spaziatura. Non saranno giustificati, ovvero non saranno né compressi né allungati verticalmente per stare nella pagina.
ragged-last-bottom: Se impostato su falso, l’ultima pagina, e l’ultima pagina di ogni sezione creata con un blocco \bookpart, saranno giustificate verticalmente come nelle pagine precedenti.

Vedi anche

Guida alla notazione: Ridimensionamento automatico al formato carta.

File installati: ‘ly/paper-defaults-init.ly’.

Frammenti: (snippets)Spacing section ‘Spacing’ in Frammenti di codice.

Problemi noti e avvertimenti

I titoli (definiti nel blocco \header) sono considerati un sistema, dunque ragged-bottom e ragged-last-bottom aggiungeranno spazio tra i titoli e il primo sistema della partitura.

Formati carta definiti esplicitamente sovrascriveranno qualsiasi impostazione di margine superiore o inferiore definito dall’utente.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

4.1.4 Variabili `\paper` della spaziatura verticale flessibile

@translationof Flexible vertical spacing paper variables

Nella maggior parte dei casi è preferibile che le distanze verticali tra certi elementi (come margini, titoli, sistemi e partiture separate) siano flessibili, così che siano ben compresse o allungate a seconda della situazione. Sono disponibili diverse variabili \paper (elencate sotto) per regolare il comportamento di allungamento di queste dimensioni.

Nota bene che le variabili \paper trattate in questa sezione non regolano la spaziatura dei righi dei singoli sistemi. La spaziatura interna ai sistemi è controllata dalle proprietà del grob, solitamente inserite in un blocco \score o \layout e non in un blocco \paper. Vedi Spaziatura verticale flessibile all’interno dei sistemi.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Struttura delle liste associative flessibili della spaziatura verticale

@translationof Structure of flexible vertical spacing alists

Ognuna delle variabili \paper flessibili della spaziatura verticale è una lista associativa (alist) composta da quattro elementi:

basic-distance – la distanza verticale, misurata in spazi rigo, tra i punti di riferimento dei due elementi, quando non si verificano collisioni e non sono attivi allungamenti o compressioni. Il punto di riferimento di un markup (un titolo o un markup di un livello superiore) è il suo punto più alto, mentre quello di un sistema è il centro verticale del più vicino StaffSymbol, anche se una linea diversa da un rigo (come un contesto Lyrics) si trova nel mezzo. Valori di basic-distance inferiori a quelli di padding o minimum-distance non hanno senso, dato che la distanza risultante non sarà mai inferiore a quella definita per padding o minimum-distance.
minimum-distance – la minima distanza verticale consentita, misurata in spazi rigo, tra i punti di riferimento dei due elementi, quando la compressione è attiva. Valori di minimum-distance inferiori a quelli di padding non hanno senso, perché la distanza risultante non sarà mai inferiore a quella definita per padding.
padding – la quantità minima di spazio verticale libero tra i profili (skyline) dei due elementi, misurata in spazi rigo.
stretchability – una misura, priva di unità di misura, della relativa propensione della dimensione a allungarsi. Se pari a zero, la distanza non si allungherà (a meno che non ci siano delle collisioni). Se positiva, il significato del valore di stretchability di una certa dimensione sta nella sua relazione con i valori di stretchability delle altre dimensioni. Per esempio, se una dimensione ha un valore di stretchability doppio rispetto a un’altra, si allungherà il doppio. I valori devono essere non negativi e finiti. Il valore +inf.0 causa un errore di programmazione e viene ingorato, ma si può usare 1.0e7 per ottenere un’elasticità allungabile quasi all’infinito. Se non impostata, il valore predefinito equivale a quello di basic-distance. Nota che la propensione della dimensione a comprimersi non può essere impostata direttamente dall’utente ed è uguale a (basic-distance - minimum-distance).

Se in una pagina lo spazio verticale non è giustificato (ovvero con ragged-bottom impostato su vero) la distanza risultante è data dal valore più grande assegnato a una di queste tre proprietà:

basic-distance,
minimum-distance e
padding con l’aggiunta della più piccola distanza necessaria a eliminare collisioni.

In caso di partiture con molte pagine in cui l’ultima pagina non è giustificata (ovvero con ragged-last-bottom impostato su vero), l’ultima pagina usa la stessa spaziatura della pagina precedente, purché ci sia abbastanza spazio.

I metodi specifici per modificare le liste associative (alist) sono trattati in Modifica delle liste associative. L’esempio seguente illustra i due modi in cui queste possono essere modificate. La prima dichiarazione aggiorna un elemento-valore individualmente, mentre la seconda ridefinisce completamente la variabile:

\paper {
  system-system-spacing.basic-distance = #8
  score-system-spacing =
    #'((basic-distance . 12)
       (minimum-distance . 6)
       (padding . 1)
       (stretchability . 12))
}

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Elenco delle variabili `\paper` flessibili della spaziatura verticale

@translationof List of flexible vertical spacing paper variables

I nomi di queste variabili hanno il formato superiore-inferiore-spacing, dove superiore e inferiore indicano gli elementi di cui stabilire la distanza. Ogni distanza viene misurata tra i punti di riferimento dei due elementi (vedi la descrizione precedente della struttura della lista associativa). Nei nomi di queste variabili il termine ‘markup’ si riferisce sia ai titoli (bookTitleMarkup o scoreTitleMarkup) sia ai markup di livello superiore (vedi Struttura del file). Tutte le distanze sono misurate in spazi rigo.

Le impostazioni predefinite sono definite in ‘ly/paper-defaults-init.ly’.

markup-system-spacing: la distanza tra il testo (titolo o markup di livello superiore) e il sistema che lo segue.
score-markup-spacing: la distanza tra l’ultimo sistema di un brano e il testo (titolo o markup di livello superiore) che lo segue.
score-system-spacing: la distanza tra l’ultimo sistema di un brano e il primo sistema del brano successivo, quando non c’è alcun testo (titolo o markup di livello superiore) tra di loro.
system-system-spacing: la distanza tra due sistemi di uno stesso brano.
markup-markup-spacing: la distanza tra due testi (titoli o markup di livello superiore).
last-bottom-spacing: la distanza tra l’ultimo sistema o l’ultimo markup di livello superiore di una pagina e la fine dello spazio stampabile (ovvero la parte superiore del margine inferiore).
top-system-spacing: la distanza tra l’inizio dello spazio stampabile (ovvero la parte inferiore del margine superiore) e il primo sistema di una pagina, quando non c’è alcun testo (titolo o markup di livello superiore) tra di loro.
top-markup-spacing: la distanza tra l’inizio dello spazio stampabile (ovvero la parte inferiore del margine superiore) e il primo testo (titolo o markup di livello superiore) di una pagina, quando non c’è alcun sistema tra i due.

Vedi anche

Guida alla notazione: Spaziatura verticale flessibile all’interno dei sistemi.

File installati: ‘ly/paper-defaults-init.ly’.

Frammenti: (snippets)Spacing section ‘Spacing’ in Frammenti di codice.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

4.1.5 Variabili `\paper` della spaziatura orizzontale

@translationof Horizontal spacing paper variables

Nota: Alcune dimensioni in \paper sono ridimensionate automaticamente in base al formato carta, producendo talvolta un risultato inatteso. Vedi Ridimensionamento automatico al formato carta.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Variabili `\paper` per larghezze e margini

@translationof paper variables for widths and margins

I valori predefiniti (prima del ridimensionamento) non elencati qui si trovano in ‘ly/paper-defaults-init.ly’.

paper-width

Larghezza della pagina (non impostata inizialmente). paper-width, pur non avendo effetto sul ridimensionamento automatico di alcune dimensioni orizzontali, influenza la variabile line-width. Se sono impostate sia paper-width che line-width, saranno modificate anche left-margin e right-margin. Vedi anche check-consistency.

line-width

Se specificata in un blocco \paper definisce la lunghezza orizzontale disponibile per i righi musicali nei sistemi non indentati. Se non specificata, la larghezza della linea (line-width) del foglio è determinata dalla sottrazione (paper-width - left-margin - right-margin). Se line-width è specificata nel blocco \paper e entrambi i margini, left-margin e right-margin, non lo sono, questi saranno aggiornati in modo da centrare i sistemi sulla pagina automaticamente. Vedi anche check-consistency.

Le variabili line-width per i singoli brani possono essere specificate nel blocco \layout di ogni brano, ovvero dentro un blocco \score. Questi valori regolano la larghezza delle linee prodotte brano per brano. Se line-width non viene specificata per un brano, il suo valore predefinito coincide con la larghezza della linea del foglio, ovvero col valore della variabile line-width del blocco \paper. Impostando line-width per un brano in particolare, ovvero all’interno di un blocco \score, i margini del foglio non vengono modificati. Le linee del rigo, la cui lunghezza è determinata dalla variabile line-width del brano, sono allineate a sinistra all’interno dello spazio definito dalla variabile line-width del foglio. Se le variabili line-width del brano e del foglio sono uguali, le linee del rigo si estenderanno esattamente dal margine sinistro al margine destro, ma se quella del brano è maggiore di quella del foglio le linee del rigo andranno oltre il margine destro.

left-margin

Margine tra il bordo sinistro della pagina e l’inizio delle linee del rigo nei sistemi non indentati. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Se left-margin non è impostato, e sono impostati sia line-width che right-margin, allora left-margin equivale alla differenza (paper-width - line-width - right-margin). Se è impostata soltanto line-width, entrambi i margini sono impostati su ((paper-width - line-width) / 2), e di conseguenza i sistemi sono centrati sulla pagina. Vedi anche check-consistency.

right-margin

Margine tra il bordo destro della pagina e la fine delle linee del rigo in sistemi giustificati. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Se right-margin non è impostato, e sono impostati sia line-width che left-margin, allora right-margin equivale a (paper-width - line-width - left-margin). Se è impostata soltanto line-width, entrambi i margini sono impostati su ((paper-width - line-width) / 2), e di conseguenza i sistemi sono centrati sulla pagina. Vedi anche check-consistency.

check-consistency

Se impostata su vero (valore predefinito), appare un avvertimento nella console se la somma di left-margin, line-width e right-margin non corrisponde esattamente a paper-width, e a ciascuna di queste variabili (eccetto paper-width) sarà assegnato il suo valore predefinito (ridimensionato in base al formato, se richiesto). Se impostato su falso, qualsiasi incongruenza viene ignorata e i sistemi potrebbero andare oltre il bordo della pagina.

ragged-right

Se impostato su vero, i sistemi non occuperanno interamente la larghezza della linea, ovvero non saranno giustificati. Termineranno invece alla loro lunghezza orizzontale naturale. Valori predefiniti: #t (true = vero) per i brani con un unico sistema, e #f (false = falso) per i brani con due o più sistemi. Questa variabile può essere impostata anche in un blocco \layout.

ragged-last

Se impostata su vero, l’ultimo sistema del brano non occuperà interamente la larghezza della linea, ovvero non sarà giustificato. Terminerà invece alla sua lunghezza orizzontale naturale. Valore predefinito: #f (false = falso). Questa variabile può essere impostata anche in un blocco \layout.

Vedi anche

Guida alla notazione: Ridimensionamento automatico al formato carta.

File installati: ‘ly/paper-defaults-init.ly’.

Problemi noti e avvertimenti

Formati carta definiti esplicitamente sovrascriveranno qualsiasi margine destro o sinistro definito dall’utente.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Variabili `\paper` per la modalità due pagine per foglio

@translationof paper variables for two-sided mode

I valori predefiniti (prima del ridimensionamento) sono definiti in ‘ly/paper-defaults-init.ly’.

two-sided: Se impostata su vero, vengono usati inner-margin, outer-margin e binding-offset per determinare i margini a seconda che il numero di pagina sia dispari o pari. Questa variabile sovrascrive left-margin e right-margin.
inner-margin: Margine del lato interno di tutte le pagine se queste fanno parte di un libro. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Funziona soltanto con two-sided impostato su vero.
outer-margin: È il margine del lato esterno di tutte le pagine se queste fanno parte di un libro. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Funziona soltanto con two-sided impostato su vero.
binding-offset: Quantità di spazio da aggiungere a inner-margin per assicurarsi che niente sia nascosto dalla rilegatura. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Funziona soltanto con two-sided impostato su vero.

Vedi anche

Guida alla notazione: Ridimensionamento automatico al formato carta.

File installati: ‘ly/paper-defaults-init.ly’.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Variabili `\paper` per spostamenti e indentazioni

@translationof paper variables for shifts and indents

I valori predefiniti (prima del ridimensionamento) non elencati qui sono visibili in ‘ly/paper-defaults-init.ly’.

horizontal-shift: È la quantità di spazio di cui spostare a destra tutti i sistemi (inclusi i titoli e i separatori dei sistemi). Valore predefinito: 0.0\mm.
indent: Livello di indentazione del primo sistema di un brano. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Lo spazio compreso in line-width disponibile per il primo sistema è ridotto di questa quantità. indent può essere specificato anche in blocchi \layout per impostare l’indentazione brano per brano.
short-indent: Livello di indentazione di tutti i sistemi di un brano eccetto il primo sistema. Se il formato è modificato, il valore predefinito di questa dimensione viene ridimensionato proporzionalmente. Lo spazio compreso in line-width disponibile per tutti i sistemi tranne il primo è ridotto di questa quantità. short-indent può essere specificato anche in blocchi \layout per impostare le brevi indentazioni brano per brano.

Vedi anche

Guida alla notazione: Ridimensionamento automatico al formato carta.

File installati: ‘ly/paper-defaults-init.ly’.

Frammenti: (snippets)Spacing section ‘Spacing’ in Frammenti di codice.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

4.1.6 Altre variabili di `\paper`

@translationof Other paper variables

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Variabili di `\paper` per l’interruzione di linea

@translationof paper variables for line breaking

max-systems-per-page: Il numero massimo di sistemi che saranno disposti in una pagina. Attualmente ciò è supportanto soltanto dall’algoritmo ly:optimal-breaking. Valore predefinito: non impostato.
min-systems-per-page: Il numero minimo di sistemi che saranno disposti in una pagina. Ciò potrebbe riempire troppo le pagine, se il numero è troppo grande. Attualmente ciò è supportanto soltanto dall’algoritmo ly:optimal-breaking. Valore predefinito: non impostato.
systems-per-page: Il numero di sistemi da disporre in una pagina. Attualmente ciò è supportanto soltanto dall’algoritmo ly:optimal-breaking. Valore predefinito: non impostato.
system-count: Il numero di sistemi da usare per un brano. Valore predefinito: non impostato. Questa variabile può essere impostata anche in un blocco \layout.

Vedi anche

Guida alla notazione: Interruzioni di linea.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Variabili di `\paper` per l’interruzione di pagina

@translationof paper variables for page breaking

I valori predefiniti non elencati qui sono visibili in ‘ly/paper-defaults-init.ly’

page-breaking: L’algoritmo di interruzione di pagina da usare. Le opzioni sono ly:minimal-breaking, ly:page-turn-breaking, ly:one-page-breaking, ly:one-line-breaking, ly:one-line-auto-height-breaking e ly:optimal-breaking (predefinito).
page-breaking-system-system-spacing: Induce il sistema di interruzione di pagina a credere che system-system-spacing sia impostato in modo diverso dal modo in cui è impostato realmente. Per esempio, se page-breaking-system-system-spacing.padding è impostato su un valore molto più grande di system-system-spacing.padding, il sistema di interruzione di pagina disporrà meno sistemi su ciascuna pagina. Valore predefinito: non impostato.
page-count: Il numero di pagine da usare per un brano, non impostato.

Le variabili seguenti sono attive soltanto quando page-breaking è impostato su ly:page-turn-breaking. Le interruzioni di pagina vengono quindi scelte per minimizzare il numero di voltate di pagina. Dato che le voltate di pagina si rendono necessarie quando si passa da una pagina con numero dispari a una con numero pari, verrà solitamente favorita una formattazione in cui l’ultima pagina abbia un numero dispari. I punti preferiti per le voltate di pagina possono essere indicati manualmente col comando \allowPageTurn o automaticamente includendo l’incisore Page_turn_engraver (vedi Voltata di pagina ottimale).

Se le scelte disponibili per avere voltate di pagina adeguate sono insufficienti, LilyPond potrebbe inserire una pagina vuota all’interno di un brano o tra i brani (se ce ne sono almeno due), oppure potrebbe terminare un brano su una pagina pari. Aumentando i valori delle seguenti tre variabili diminuisce la probabilità che queste entrino in azione.

I valori sono penalità: maggiore il valore, minore la probabilità che si verifichi l’azione associata rispetto alle altre scelte.

blank-page-penalty: La penalità per avere una pagina vuota nel mezzo di un brano. Se il valore di blank-page-penalty è grande ed è selezionato ly:page-turn-breaking, sarà meno probabile che LilyPond insersica una pagina nel mezzo del brano. Aggiungerà invece maggior spazio tra i sistemi per occupare la pagina vuota e quella successiva. Valore predefinito: 5.
blank-last-page-penalty: La penalità per terminare il brano su una pagina pari. Se il valore di blank-last-page-penalty è grande ed è selezionato ly:page-turn-breaking, sarà meno probabile che LilyPond produca una partitura in cui l’ultima pagina sia pari. Regolerà invece la spaziatura in modo da usare una pagina in più o in meno. Valore predefinito: 0.
blank-after-score-page-penalty: La penalità per avere una pagina vuota dopo la fine di un brano e prima di quello successivo. Il valore predefinito è inferiore a blank-page-penalty, in modo che siano inserite preferibilmente pagine vuote al termine di un brano piuttosto che nel mezzo di un brano. Valore predefinito: 2.

Vedi anche

Guida alla notazione: Interruzioni di pagina, Interruzione di pagina ottimale, Voltata di pagina ottimale, Interruzione di pagina minimale, Interruzione di pagina di una pagina, Interruzione di pagina su una linea, Interruzione di pagina su una linea con altezza automatica.

File installati: ‘ly/paper-defaults-init.ly’.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[ ? ]

Variabili di `\paper` per la numerazione delle pagine

@translationof paper variables for page numbering

I valori predefiniti non elencati qui sono visibili in ‘ly/paper-defaults-init.ly’

auto-first-page-number: L’algoritmo di interruzione di pagina si comporta diversamente a seconda che il numero della prima pagina sia dispari o pari. Se questa variabile è impostata su vero, l’algoritmo di interruzione di pagina deciderà se iniziare con un numero dispari o un numero pari. Quindi il numero della prima pagina resterà lo stesso o aumenterà di uno. Valore predefinito: #f (falso).
first-page-number: Il valore del numero di pagina della prima pagina.
print-first-page-number: Se impostato su vero, appare il numero di pagina sulla prima pagina.
print-page-number: Se impostato su falso, non apparirano i numeri di pagina.
page-number-type: Il tipo di numero usato per numerare le pagine. Le opzioni possibili sono roman-lower, roman-upper e arabic. Valore predefinito: 'arabic.

Vedi anche

File installati: ‘ly/paper-defaults-init.ly’.

Problemi noti e avvertimenti

I numeri di pagina dispari sono sempre sulla destra. Se la musica deve iniziare a pagina 1, ci deve essere una pagina vuota sulla seconda di copertina in modo che pagina 1 sia sul lato destro.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]