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 La instrucción de marcado \verb+\vspace+ está disponible a partir de
  81 LilyPond versión 2.13.6.
  82
  83 \subsection{Bloques de libro: distintos archivos de salida}
  84
  85 Cuando en un documento aparecen bloques \verb+\book+, se produce un
  86 archivo de salida PDF distinto para cada bloque, con todas las
  87 partituras que contenga.  El primer archivo tiene el mismo nombre del
  88 documento, como es usual, y a partir del segundo libro se añade un
  89 número consecutivo al final del nombre.
  90
  91 Es preciso tener en cuenta la siguiente salvedad: los documentos de
  92 partitura completos, que pueden contener indicaciones de alto nivel
  93 como definiciones de variables, no pueden incluirse mediante la
  94 instrucción \verb+\include+ dentro de un bloque \verb+\book+.  Las
  95 definiciones de variables son instrucciones del nivel sintáctico
  96 superior y por tanto deben ir fuera de cualquier bloque.
  97
  98 \subsection{Bloques de parte: distintas páginas en un libro}
  99
 100 Es sencillo mantener en páginas separadas dos o más conjuntos de
 101 partituras dentro de un libro: tan sólo hay que encerrar cada conjunto
 102 en un bloque \verb+\bookpart+.  Las cabeceras de título de la primera
 103 parte serán las que se impriman al principio del libro.
 104
 105 \subsection{Pie de página}
 106 \label{tagline}
 107
 108 La cabecera \verb+tagline+ contiene las indicaciones que aparecen en
 109 la última página de cada libro.  Si no se especifica una línea de pie,
 110 la línea predeterminada contiene una nota de autopromoción del
 111 programa y la versión del mismo con que se hizo el archivo de salida.
 112
 113 \subsection{Ejemplo}
 114
 115 La siguiente estructura es un ejemplo que resume lo explicado más
 116 arriba.
 117
 118 \begin{verbatim}
 119 musicaUno={...}
 120 musicaDos={...}
 121 ...
 122
 123 \book{                          % primer libro
 124   \bookpart{                      % primera parte
 125     \header{ title = ... }          % cabeceras de este libro y parte
 126     \score{ \músicaUno...             % primera partitura
 127       \header { piece = ... }         % cabeceras de esta partitura
 128     }
 129     \score{ ... }                   % segunda partitura
 130   }                               % fin de la parte y salto de página
 131   \bookpart{ ... }                % segunda parte
 132 }
 133 \book{ ... }                    % segundo libro
 134 \end{verbatim}