apuntes-24-book.tex

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