Anterior: Varias partituras en un libro, Arriba: Estructura del código de entrada
Un archivo .ly
puede contener cualquier número de expresions
del nivel superior, donde una expresión del nivel superior es una de
las siguientes posibilidades:
\paper
, \midi
y
\layout
. Tal definición en el nivel más alto cambia los
ajustes predeterminados para todo el libro. Si se introduce más de
una de estas definiciones del mismo tipo en el nivel más alto,
cualquier definición en una expresión posterior tiene prioridad.
#(set-default-paper-size "a7" 'landscape)
o
#(ly:set-option 'point-and-click #f)
.
\header
. Esto establece el bloque de encabezamiento
global. Es el bloque que contiene las definiciones de los ajustes
para todo el libro, como el compositor, título, etc.
\score
. Esta partitura se reúne con otras partituras
del nivel superior, y se combina con ellas formando un \book
(libro) único. Este comportamiento se puede cambiar estableciendo el
valor de la variable toplevel-score-handler
en el nivel
superior. El handler predeterminado se define en el archivo de
inicio ../scm/lily.scm.
\book
combina lógicamente varios movimientos (es
decir, varios bloques \score
) en un solo documento. Si hay
varias partituras \score
, se crea un solo archivo de salida
para cada bloque \book
, en el que se concatenan todos los
movimientos correspondientes. La únca razón para especificar
explícitamente bloques \book
en un archivo de entrada
.ly
es si queremos crear varios archivos de salida a partir de
un único archivo de entrada. Una excepción se da dentro de los
documentos de lilypond-book, en los que tenemos que escribir
explícitamente un bloque \book
si queremos tener más de una
única partitura \score
o marcado \markup
en el mismo
ejemplo. Se puede cmbiar este comportamiento estableciendo el valor
de la variable toplevel-book-handler
en el nivel superior. El
handler predeterminado se define en el archivo de inicio
../scm/lily.scm.
\bookpart
. Un libro puede dividirse en varias
partes, utilizando bloques \bookpart
, con objeto de facilitar
la inserción de saltos de página o usar distintos ajustes de
\paper
en las distintas partes.
{ c'4 d' e'2 }
Esto añade la pieza al \score
y la conforma dentro de un libro
único junto a todas las demás partituras \score
y expresiones
musicales del nivel superior. En otras palabras, un archivo que
contiene sólo la expresión musical anterior se traduce a
\book { \score { \new Staff { \new Voice { { c'4 d' e'2 } } } } \layout { } \header { } }
Se puede cambiar este comportamiento estableciendo el valor de la
bariable toplevel-music-handler
en el nivel más alto. El
handler predeterminado se define en el archivo de inicio
../scm/lily.scm.
\markup { 2. Estrofa dos, línea uno }
Los textos de marcado se colocan encima, en medio o debajo de las partituras o expresiones musicales, según donde aparezcan escritos.
fulano = { c4 d e d }
Esto se puede utilizar más tarde en el archivo escribiendo
\fulano
. El nombre de las variables ha de ser exclusivamente
alfabético; sin números, guiones ni barras bajas.
El ejemplo siguiente muestra tres cosas que se pueden introducir en el nivel superior:
\layout { % No justificar la salida ragged-right = ##t } \header { title = "Do-re-mi" } { c'4 d' e2 }
En cualquier punto del archivo se pueden introducir cualquiera de las instrucciones léxicas siguientes:
\version
\include
\sourcefilename
\sourcefileline
%
al principio.
%{ .. %}
.
Manual de aprendizaje: Cómo funcionan los archivos de entrada de LilyPond.