]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/it/learning/fundamental.itely
Issue 4894: Remove unescaped @funindex entries
[lilypond.git] / Documentation / it / learning / fundamental.itely
index 512da3f4093addc87420a720e6c85c85a5ff6c03..dd89ae504912dd67c7552a9049a5725ce5bf6fac 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
 
 @ignore
-    Translation of GIT committish: 01980ec7e46ccd03ff7a379b6299842d788b8f8a
+    Translation of GIT committish: 8451fc41680f500fff56f826017b53dc3dcbf65d
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -36,7 +36,7 @@ agli utenti esperti una grande flessibilità nell'organizzare i file come
 preferiscono.  Ma questa flessibilità può creare confusione nei nuovi
 utenti.  Questa sezione spiegherà in parte questa struttura, ma
 sorvolerà su alcuni dettagli in favore della semplicità.  Per una
-descrizione completa del formato di input, si veda @ruser{File structure}.
+descrizione completa del formato di input, si veda @ruser{Struttura del file}.
 
 @menu
 * Introduzione alla struttura di un file di LilyPond::
@@ -71,9 +71,7 @@ Ci sono molte varianti a questo modello di base, ma questo esempio
 serve da utile punto di partenza.
 
 @funindex \book
-@funindex book
 @funindex \score
-@funindex score
 @cindex book (libro)
 @cindex score (partitura)
 @cindex libro
@@ -159,11 +157,8 @@ elementi, come ad esempio
 @end example
 
 @funindex \header
-@funindex header
 @funindex \layout
-@funindex layout
 @funindex \midi
-@funindex midi
 @cindex header
 @cindex layout
 @cindex midi
@@ -182,14 +177,13 @@ Altri due comandi che non hai incontrato finora sono
 @code{\layout @{ @}} e @code{\midi @{@}}.  Se questi appaiono come
 in figura, LilyPond creerà rispettivamente un output per la stampa
 e uno per il MIDI.  Sono descritti dettagliatamente nella
-Guida alla notazione, in @ruser{Score layout}, e
-@ruser{Creating MIDI files}.
+Guida alla notazione, in @ruser{Formattazione della partitura}, e
+@ruser{Creazione dell'output MIDI}.
 
 @cindex partiture, multiple
 @cindex libro, blocco implicito
 @cindex implicito, blocco del libro
 @funindex \book
-@funindex book
 
 Puoi scrivere molteplici blocchi @code{\score}.  Ciascuno verrà
 trattato come una partitura separata, ma saranno tutti combinati in
@@ -217,12 +211,12 @@ che si trova dentro un blocco @code{\score} riguarda solo quel blocco
 blocco @code{\score} (e quindi in un blocco @code{\book}, esplicitamente
 o implicitamente) riguarderà ogni @code{\score} in quel @code{\book}.
 
-Per maggiori dettagli si veda @ruser{Multiple scores in a book}.
+Per maggiori dettagli si veda @ruser{Molteplici partiture in un libro}.
 
 @cindex variabili
 
 Un'altra grande scorciatoia è la possibilità di definire variabili, come è
-spiegato in @ref{Organizzare i brani con le variabili}).  Tutti
+spiegato in @ref{Organizing pieces with variables}).  Tutti
 i modelli usano questa forma
 
 @example
@@ -242,12 +236,12 @@ ciò che si trova dopo il segno di uguale) e lo inserisce ovunque si trovi
 altro nome.  Ricordati che puoi usare quasi ogni nome che vuoi, purché esso
 contenga solo caratteri alfabetici e sia diverso dai nomi dei comandi di
 LilyPond.  Le esatte limitazioni relative ai nomi delle variabili sono spiegate
-dettagliatamente in @ruser{File structure}.
+dettagliatamente in @ruser{Struttura del file}.
 
 
 @seealso
 Per una definizione completa del formato di input, si veda
-@ruser{File structure}.
+@ruser{Struttura del file}.
 
 
 @node La partitura è una (singola) espressione musicale composta
@@ -255,7 +249,6 @@ Per una definizione completa del formato di input, si veda
 @translationof Score is a (single) compound musical expression
 
 @funindex \score
-@funindex score
 @cindex partitura
 @cindex score
 @cindex contenuto di un blocco score
@@ -264,7 +257,7 @@ Per una definizione completa del formato di input, si veda
 @cindex composta, espressione musicale
 
 Abbiamo visto l'organizzazione generale dei file di input di LilyPond nella
-sezione precedente, @ref{Introduzione alla struttura di un file di LilyPond}.
+sezione precedente, @ref{Introduction to the LilyPond file structure}.
 Ma sembra che abbiamo saltato la parte più importante: cosa dobbiamo
 scrivere dopo @code{\score}?
 
@@ -277,7 +270,7 @@ semplicemente, che @emph{non c'è} alcun mistero.  La seguente frase spiega tutt
 
 @noindent
 Per capire cosa si intende per espressione musicale, potrebbe esserti utile
-ripassare il tutorial, @ref{Espressioni musicali}.  In quella sezione, abbiamo
+ripassare il tutorial, @ref{Music expressions explained}.  In quella sezione, abbiamo
 visto come costruire grandi espressioni musicali a partire da piccoli brani --
 abbiamo iniziato con le note, poi gli accordi, etc.  Adesso inizieremo da una
 grande espressione musicale e proseguiremo poi a spiegarne i dettagli. Per
@@ -313,7 +306,7 @@ simultanee, ad esempio due voci simultanee, o una voce con del testo.  Vogliamo
 avere una voce con del testo, dunque ci servono le parentesi ad angolo.  Aggiungeremo
 la musica vera e propria in seguito; per adesso mettiamo soltanto delle semplici
 note e del testo.  Se hai dimenticato come aggiungere del testo, potresti voler
-ripassare @code{\addlyrics} in @ref{Impostare canzoni semplici}.
+ripassare @code{\addlyrics} in @ref{Setting simple songs}.
 
 @lilypond[verbatim,quote,ragged-right]
 \score {
@@ -356,7 +349,7 @@ interpretati come testo, li facciamo precedere da @code{\lyricmode}.  Come in
 @code{\addlyrics}, questo comando trasforma la modalità di input in modalità
 testo.  Senza di esso, LilyPond cercherebbe di interpretare i contenuti come
 se fossero note, e questo produrrebbe degli errori.  (Sono disponibili molte
-altre modalità di input, si veda @ruser{Input modes}.)
+altre modalità di input, si veda @ruser{Modalità di inserimento}.)
 
 Dunque se aggiungiamo un po' di note e una chiave di basso per la mano
 sinistra, otteniamo un brano musicale vero e proprio:
@@ -393,7 +386,7 @@ di testo si trovi nella stessa posizione orizzontale.
 
 
 @seealso
-Guida alla notazione: @ruser{Structure of a score}.
+Guida alla notazione: @ruser{Struttura di una partitura}.
 
 
 @node Annidare le espressioni musicali
@@ -593,9 +586,11 @@ Ovviamente, una singola voce può contenere molte note in un accordo,
 dunque quando l'uso delle voci multiple è davvero necessario?  Si osservi
 questo esempio di quattro accordi:
 
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-\key g \major
-<d g>4 <d fis> <d a'> <d g>
+@lilypond[quote,verbatim,fragment,ragged-right]
+\relative {
+  \key g \major
+  <d' g>4 <d fis> <d a'> <d g>
+}
 @end lilypond
 
 Questa musica può essere espressa usando soltanto i simboli dell'accordo,
@@ -629,7 +624,7 @@ la nota di passaggio che la legatura di portamento:
 @lilypond[quote,verbatim,ragged-right]
 \relative {
   \key g \major
-  %    Voice "1"               Voice "2"
+  %    Voice = "1"             Voice = "2"
   << { g'4 fis8( g) a4 g } \\ { d4 d d d }  >>
 }
 @end lilypond
@@ -641,7 +636,7 @@ Ecco un altro semplice esempio:
 @lilypond[quote,verbatim,ragged-right]
 \relative {
   \key d \minor
-  %    Voice "1"             Voice "2"
+  %    Voice = "1"           Voice = "2"
   << { r4 g' g4. a8 }   \\ { d,2 d4 g }       >> |
   << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >> |
   << { a2. r4 }         \\ { fis2. s4 }       >> |
@@ -656,12 +651,12 @@ ogni battuta è preferibile dividere ogni voce, così:
 @lilypond[quote,verbatim,ragged-right]
 <<
   \key d \minor
-  \relative { % Voice "1"
+  \relative { % Voice "1"
     r4 g' g4. a8 |
     bes4 bes c bes |
     a2. r4 |
   } \\
-  \relative { % Voice "2"
+  \relative { % Voice "2"
     d'2 d4 g |
     g4 g g8( a) g4 |
     fis2. s4 |
@@ -688,7 +683,7 @@ legature di valore, dinamica, etc., è impostata correttamente.
 \new Staff \relative {
   % Main voice
   c'16 d e f
-  %    Voice "1"     Voice "2"                Voice "3"
+  %    Voice = "1"   Voice = "2"              Voice = "3"
   << { g4 f e } \\ { r8 e4 d c8~ } >> |
   << { d2 e }   \\ { c8 b16 a b8 g~ 2 } \\ { s4 b c2 } >> |
 }
@@ -921,8 +916,8 @@ situazioni, gli spostamenti applicati da LilyPond potrebbero non riuscire
 a evitare le collisioni.  LilyPond fornisce molti modi per aggiustare la collocazione
 orizzontale delle note.  Per ora, non siamo ancora pronti a cercare di
 correggere questo problema, dunque dovremo aspettare fino a una
-prossima sezione -- si veda la proprietà @code{force-hshift} in @ref{Fixing
-overlapping notation}.
+prossima sezione -- si veda la proprietà @code{force-hshift} in
+@ref{Fixing overlapping notation}.
 
 @warning{Il testo e gli @emph{spanner} (come le legature di portamento e di valore, le
 forcelle, etc.) non possono essere create @q{attraverso} le voci.}
@@ -936,15 +931,10 @@ Guida alla notazione: @ruser{Più voci}.
 @translationof Explicitly instantiating voices
 
 @funindex \voiceOne
-@funindex voiceOne
 @funindex \voiceTwo
-@funindex voiceTwo
 @funindex \voiceThree
-@funindex voiceThree
 @funindex \voiceFour
-@funindex voiceFour
 @funindex \oneVoice
-@funindex oneVoice
 @funindex \new Voice
 @cindex contesti della voce, creazione dei
 
@@ -1131,13 +1121,9 @@ come nel seguente esempio:
 @cindex note, collisioni di
 @cindex comandi di spostamento
 @funindex \shiftOff
-@funindex shiftOff
 @funindex \shiftOn
-@funindex shiftOn
 @funindex \shiftOnn
-@funindex shiftOnn
 @funindex \shiftOnnn
-@funindex shiftOnnn
 
 Le note maggiormente ravvicinate all'interno di un accordo o quelle che
 compaiono nello stesso momento in voci diverse sono disposte in due, e
@@ -1167,7 +1153,8 @@ voce con gambi in su e una nota (o accordo) di una voce con gambi in
 giù.  Se note di due voci che hanno i gambi nella stessa direzione
 sono poste nella stessa posizione ed entrambe le voci non hanno uno
 spostamento specificato oppure ne hanno uno dello stesso tipo, si
-produrrà il messaggio di errore @qq{Too many clashing note columns}.
+produrrà il messaggio di errore
+@qq{questa voce ha bisogno di un'impostazione @code{@bs{}\voiceXx} o @code{@bs{}\shiftXx}}.
 
 
 @seealso
@@ -1186,7 +1173,6 @@ espressioni -- note e testo.
 
 @funindex \new Lyrics
 @funindex \lyricsto
-@funindex lyricsto
 @funindex Lyrics
 @cindex Lyrics, creazione di un contesto
 @cindex testo, creazione di un contesto
@@ -1221,7 +1207,6 @@ necessario creare esplicitamente contesti @code{Staff} e @code{Voice}.
 @cindex testo e travatura
 @cindex travatura e testo
 @funindex \autoBeamOff
-@funindex autoBeamOff
 
 La disposizione automatica delle travature predefinita di LilyPond funziona
 bene per la musica strumentale, ma non altrettanto per la musica con testi,
@@ -1232,7 +1217,6 @@ di melismi nel testo.  Nell'esempio precedente usiamo il comando
 @funindex \new ChoirStaff
 @funindex ChoirStaff
 @funindex \lyricmode
-@funindex lyricmode
 @cindex struttura di una partitura vocale
 @cindex rigo per un coro
 
@@ -1341,7 +1325,7 @@ VerseFour  =
 @end lilypond
 
 @seealso
-Guida alla notazione: @ruser{Vocal music}.
+Guida alla notazione: @ruser{Musica vocale}.
 
 
 @node Contesti e incisori
@@ -1432,7 +1416,7 @@ maiuscola: ad esempio, @code{GregorianTranscriptionStaff}.
 
 
 @seealso
-Guida alla notazione: @ruser{Contexts  explained}.
+Guida alla notazione: @ruser{Tutto sui contesti}.
 
 
 @node Creare i contesti
@@ -1440,7 +1424,6 @@ Guida alla notazione: @ruser{Contexts  explained}.
 @translationof Creating contexts
 
 @funindex \new
-@funindex new
 @cindex nuovi contesti
 @cindex creazione di contesti
 @cindex contesti, creazione di
@@ -1556,11 +1539,11 @@ anche numeri e spazi, ma in questo caso deve essere compreso tra virgolette,
 ovvero @code{\new Staff = "MioPentagramma 1" @var{espressione-musicale}}.
 Il nome identificativo viene utilizzato per riportare a quel
 particolare esempio di un contesto.  Abbiamo visto questo utilizzo
-nella sezione sul testo, si veda @ref{Voci e musica vocale}.
+nella sezione sul testo, si veda @ref{Voices and vocals}.
 
 
 @seealso
-Guida alla notazione: @ruser{Creating and referencing contexts}.
+Guida alla notazione: @ruser{Creazione e citazione di un contesto}.
 
 
 @node Gli incisori
@@ -1656,9 +1639,7 @@ Guida al funzionamento interno: @rinternals{Engravers and Performers}.
 @cindex contesto, proprietà del, modificare
 @cindex modificare le proprietà del contesto
 @funindex \set
-@funindex set
 @funindex \unset
-@funindex unset
 
 I contesti si occupano di tenere i valori di un certo numero di
 @emph{proprietà} del contesto.  Molte di queste possono essere cambiate
@@ -1667,22 +1648,22 @@ l'aspetto dell'output.  Per cambiarle si usa il comando
 @code{\set}.  Questo assume la seguente forma
 
 @example
-\set @emph{NomeDelContesto}.@emph{nomeDellaProprietà} = #@emph{valore}
+\set @emph{NomeContesto}.@emph{nomeProprietà} = #@emph{valore}
 @end example
 
-Dove il @emph{NomeDelContesto} è di solito @code{Score},
+Dove il @emph{NomeContesto} è di solito @code{Score},
 @code{Staff} o @code{Voice}.  Può essere omesso, e in questo
 caso viene considerato il contesto attuale (solitamente @code{Voice}).
 
-I nomi delle proprietà del contesto consistono in parole unite
-insieme e senza lineette o trattini bassi, e solo la prima
-parola inizia con una lettera maiuscola.  Ecco alcuni esempi
+I nomi delle proprietà di contesto consistono in parole unite
+insieme e senza lineette o trattini bassi, e tutte le parole tranne
+la prima iniziano con una lettera maiuscola.  Ecco alcuni esempi
 di quelle più usate comunemente.  Ma ne esistono molte altre.
 
 @c attempt to force this onto a new page
 @need 50
 @multitable @columnfractions .25 .15 .45 .15
-@headitem nomeDellaProprietà
+@headitem nomeProprietà
   @tab Tipo
   @tab Funzione
   @tab Valore di esempio
@@ -1850,7 +1831,6 @@ modo molto più generale usando il potente comando @code{\markup}.
 @subsubheading Impostare le proprietà di contesto con @code{\with}
 
 @funindex \with
-@funindex with
 @cindex contesto, proprietà del, impostare con \with
 
 Il valore predefinito delle proprietà di contesto possono essere impostate
@@ -1899,7 +1879,6 @@ questo nuovo valore predefinito può essere recuperato col comando
 
 @cindex contesto, proprietà del, impostare con \context
 @funindex \context
-@funindex context
 
 I valori delle proprietà di un contesto possono essere impostate in @emph{tutti}
 i contesti di un particolare tipo, così come in tutti i contesti @code{Staff}, con un
@@ -1961,8 +1940,8 @@ comandi @code{\set} incorporati nelle asserzioni musicali.
 
 @seealso
 Guida alla notazione:
-@ruser{Changing context default settings},
-@ruser{The set command}.
+@ruser{Modifica delle impostazioni predefinite di un contesto},
+@ruser{Il comando set}.
 
 Guida al funzionamento interno:
 @rinternals{Contexts},
@@ -1979,9 +1958,7 @@ Guida al funzionamento interno:
 @cindex rimuovere gli incisori
 
 @funindex \consists
-@funindex consists
 @funindex \remove
-@funindex remove
 
 Abbiamo visto che ciascuno dei contesti contiene vari incisori, ognuno
 dei quali ha il compito di produrre una parte specifica dell'output,
@@ -2076,7 +2053,6 @@ l'intervallo di tutte le note in tutte le voci di quel pentagramma:
 @subsubheading Modificare tutti i contesti dello stesso tipo
 
 @funindex \layout
-@funindex layout
 
 Gli esempi precedenti mostrano come rimuovere o aggiungere degli incisori
 a contesti individuali.  È anche possibile rimuovere o aggiungere gli
@@ -2126,8 +2102,8 @@ per tutti i contesti di un particolare tipo includendo il comando
 @code{\set} in un blocco @code{\context} nello stesso modo.
 
 @seealso
-Guida alla notazione: @ruser{Modifying context plug-ins},
-@ruser{Changing context default settings}.
+Guida alla notazione: @ruser{Modifica dei componenti aggiuntivi di un contesto},
+@ruser{Modifica delle impostazioni predefinite di un contesto}.
 
 @knownissues
 Gli incisori @code{Stem_engraver} e @code{Beam_engraver} fissano i propri
@@ -2875,7 +2851,7 @@ L'allungabilità dei righi può essere controllata con la proprietà
 (gli oggetti grafici vengono comunemente chiamati @q{grob} nella documentazione
 di lilypond)    -- non preoccuparti dei dettagli in questo momento; in seguito
 verrà fornita una spiegazione approfondita.  I curiosi possono dare
-un'occhiata a @ruser{Overview of modifying properties}.
+un'occhiata a @ruser{Panoramica sulla modifica delle proprietà}.
 In questo caso, vogliamo modificare soltanto la sottoproprietà
 @code{allungabilità}.  Di nuovo, chi è curioso può trovare i valori predefiniti
 per la proprietà staff-staff-spacing nel file @file{scm/define-grobs.scm}
@@ -3027,11 +3003,11 @@ violin = \new Staff {
 Tuttavia, puoi usare queste variabili (note anche come
 macro, o comandi definiti dall'utente) anche per le modifiche manuali:
 
-@c TODO Avoid padtext - not needed with skylining
 @lilypond[quote,verbatim,ragged-right]
 dolce = \markup { \italic \bold dolce }
 
-padText = { \once \override TextScript.padding = #5.0 }
+centreText = { \once \override TextScript.self-alignment-X = #CENTER }
+
 fthenp =_\markup {
   \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
 }
@@ -3039,9 +3015,9 @@ fthenp =_\markup {
 violin = \relative {
   \repeat volta 2 {
     c''4._\dolce b8 a8 g a b |
-    \padText
-    c4.^"hi there!" d8 e' f g d |
-    c,4.\fthenp b8 c4 c-. |
+    \centreText
+    c4.^"hi there!" d8 e f g d |
+    c4.\fthenp b8 c4 c-. |
   }
 }
 
@@ -3049,7 +3025,6 @@ violin = \relative {
   {
     \violin
   }
-  \layout { ragged-right = ##t }
 }
 @end lilypond
 
@@ -3063,7 +3038,7 @@ soprattutto l'ultima linea.
 violin = \relative @{
   \repeat volta 2 @{
     c''4._\markup @{ \italic \bold dolce @} b8 a8 g a b |
-    \once \override TextScript.padding = #5.0
+    \once \override TextScript.self-alignment-X = #CENTER
     c4.^"hi there!" d8 e' f g d |
     c,4.\markup @{
       \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p
@@ -3074,9 +3049,9 @@ violin = \relative @{
 @end example
 
 Finora abbiamo visto la sostituzione statica -- quando LilyPond
-vede @code{\padText}, lo sostituisce con quel che noi abbiamo
+vede @code{\centreText}, lo sostituisce con quel che noi abbiamo
 definito che sia (ovvero tutto ciò che sta a destra di
-@code{padtext=}).
+@code{centreText=}).
 
 LilyPond può gestire anche la sostituzione non statica (la puoi
 immaginare come una funzione).
@@ -3180,21 +3155,17 @@ R2*3
 @end example
 
 Quando la parte viene stampata, le pause multiple devono essere
-condensate.  Si può fare impostando una variabile run-time
+compresse.  Esiste una funzione musicale per fare ciò:
 
 @example
-\set Score.skipBars = ##t
+\compressMMRests @{ ... @}
 @end example
 
-@noindent
-Questo comando imposta la proprietà @code{skipBars} nel contesto
-@code{Score} su vero (@code{##t}).  Aggiungendo la pausa e questa
-opzione alla musica precedente, si arriva al seguente risultato
+Applicandola a @code{hornNotes} si ottiene:
 
 @lilypond[quote,ragged-right]
-\transpose f c' \relative {
+\compressMMRests \transpose f c' \relative {
   \time 2/4
-  \set Score.skipBars = ##t
   R2*3 |
   r4 f8 a | cis4 f | e4 d |
 }
@@ -3234,3 +3205,14 @@ ovvero
   }
 >>
 @end lilypond
+
+@seealso
+Manuale di apprendimento:
+@ref{Organizing pieces with variables}.
+
+Guida alla notazione:
+@ruser{Trasposizione},
+@ruser{Scrittura delle parti},
+@ruser{Pause d'intero},
+@ruser{Inclusione di file LilyPond}.
+