apuntes-24-book.tex

   1 \section{Varias partituras en un documento: libros.  Marcados de alto nivel}
   2
   3
   4 \subsection{Modelo}
   5
   6 Cuando se quiere elaborar un documento de varias páginas que contiene
   7 distintas piezas (p.ej. los movimientos de una sonata) o distintas
   8 obras completas que deben ir en páginas separadas, se hace necesario
   9 utilizar los conceptos de libro, parte y pieza.
  10
  11 Para este ejercicio debemos elegir \emph{ocho} piezas ya realizadas
  12 que se insertarán en el texto del documento.  Produciremos, a partir
  13 de un solo documento de LilyPond, dos archivos de salida PDF o
  14 \emph{libros}, cada uno de los cuales tendrá dos partes en páginas
  15 separadas, y cada parte de cada libro contendrá dos partituras con
  16 especificación de la pieza en la cabecera correspondiente.
  17
  18 \bigskip
  19 \parindent=0mm
  20 \fbox{\includegraphics[width=39mm]{outA1}}
  21 \fbox{\includegraphics[width=39mm]{outA2}}
  22 \fbox{\includegraphics[width=39mm]{outB1}}
  23 \fbox{\includegraphics[width=39mm]{outB2}}
  24 \parindent=6mm
  25 \bigskip
  26
  27 Se deberá tener cuidado en que los nombres de variable,
  28 procedentes de distintas piezas, no se confundan al incluirlos en
  29 el mismo texto.
  30
  31 % Aumentar la separación entre sistemas
  32 %\def\betweenLilyPondSystem#1{\vspace{0.2cm}\linebreak}
  33
  34 \subsection{Bloques de partitura: distintas piezas}
  35
  36 Si en un documento aparece más de un bloque \verb+\score+, una pieza
  37 aparecerá a continuación de la otra, en la misma página. Sólo se
  38 imprimen, para cada una, las cabeceras \verb+piece+ y \verb+opus+
  39 (véase el apartado \ref{pieceopus}, pág. \pageref{pieceopus}). Se
  40 pueden volver a definir los títulos de cabecera para cada partitura.
  41
  42 Para imprimir el título de cada partitura, se requiere un bloque
  43 \verb+\paper+ (fuera de todas las partituras) que contenga el
  44 siguiente ajuste:
  45
  46 \begin{verbatim}
  47 \paper{
  48   print-all-headers = ##t
  49 }
  50 \end{verbatim}
  51
  52 En nuestro ejemplo esto no es necesario, pero debe tenerse en cuenta
  53 que las cabeceras de cada partitura deben ir \emph{después} de la
  54 música dentro del bloque \verb+\score+, así:
  55
  56 \begin{verbatim}
  57 \score{ \cumple
  58   \header { piece="Cumpleaños feliz" }
  59 }
  60 \end{verbatim}
  61
  62
  63 \subsection{Elementos de marcado del nivel superior}
  64
  65 Si se escribe un elemento \verb+\markup+ fuera de cualquier partitura,
  66 aparecerá en su lugar correspondiente.  Estos elementos se denominan
  67 ``Marcados de alto nivel'' porque se encuentran en lo alto de la
  68 jerarquía de la sintaxis de un documento, es decir, fuera de cualquier
  69 bloque.  Los elementos de marcado del nivel superior se pueden emplear
  70 para escribir las letras de las estrofas de una canción.  También
  71 puede insertarse una separación para distanciar dos partituras entre
  72 sí, o antes de una partitura para separarla del borde superior:
  73
  74 \begin{verbatim}
  75 \score { ... }
  76 \markup{ \vspace #5 }
  77 \score { ... }
  78 \end{verbatim}
  79
  80 \subsection{Bloques de libro: distintos archivos de salida}
  81
  82 Cuando en un documento aparecen bloques \verb+\book+, se produce un
  83 archivo de salida PDF distinto para cada bloque, con todas las
  84 partituras que contenga.  El primer archivo tiene el mismo nombre del
  85 documento, como es usual, y a partir del segundo libro se añade un
  86 número consecutivo al final del nombre.
  87
  88 Es preciso tener en cuenta la siguiente salvedad: los documentos de
  89 partitura completos, que pueden contener indicaciones de alto nivel
  90 como definiciones de variables, no pueden incluirse mediante la
  91 instrucción \verb+\include+ dentro de un bloque \verb+\book+.  Las
  92 definiciones de variables son instrucciones del nivel sintáctico
  93 superior y por tanto deben ir fuera de cualquier bloque.
  94
  95 \subsection{Bloques de parte: distintas páginas en un libro}
  96
  97 Es sencillo mantener en páginas separadas dos o más conjuntos de
  98 partituras dentro de un libro: tan sólo hay que encerrar cada conjunto
  99 en un bloque \verb+\bookpart+.  Las cabeceras de título de la primera
 100 parte serán las que se impriman al principio del libro.
 101
 102 \subsection{Pie de página}
 103 \label{tagline}
 104
 105 La cabecera \verb+tagline+ contiene las indicaciones que aparecen en
 106 la última página de cada libro.  Si no se especifica una línea de pie,
 107 la línea predeterminada contiene una nota de autopromoción del
 108 programa y la versión del mismo con que se hizo el archivo de salida.
 109
 110 \subsection{Ejemplo}
 111
 112 La siguiente estructura es un ejemplo que resume lo explicado más
 113 arriba.
 114
 115 \begin{verbatim}
 116 musicaUno={...}
 117 musicaDos={...}
 118 ...
 119
 120 \book{                          % primer libro
 121   \bookpart{                      % primera parte
 122     \header{ title = ... }          % cabeceras de este libro y parte
 123     \score{ \músicaUno...             % primera partitura
 124       \header { piece = ... }         % cabeceras de esta partitura
 125     }
 126     \score{ ... }                   % segunda partitura
 127   }                               % fin de la parte y salto de página
 128   \bookpart{ ... }                % segunda parte
 129 }
 130 \book{ ... }                    % segundo libro
 131 \end{verbatim}