3.2.3 Crear metadatos en los archivos de salida
Además de mostrarse en la salida impresa, las variables de
encabezamiento de \header se usan para establecer los
metadatos para los archivos de salida. Por ejemplo, con los
archivos PDF, estos metadatos pueden mostrarse por parte de los
lectores de documentos como propiedades del PDF. Para cada
tipo de archivo de salida, solamente se consultan las definiciones
de \header de los bloques que definen archivos separados de
ese tipo, y los bloques más altos en la jerarquía de bloques. Por
tanto, para los archivos PDF, solo afectan a los metadatos de PDF
de cada documento las definiciones de \header de los
niveles de \book y de nivel superior, mientras que para
archivos MIDI, se usan todas las cabeceras que están por encima o
al nivel de \score.
Por ejemplo, si se
establece la propiedad title del bloque header como
‘Sinfonía núm. 1’, el documento PDF llevará también este
título, y lo usará como el nombre de la secuencia del archivo MIDI.
\header {
title = "Sinfonía núm. 1"
}
Si quiere fijar el título de la salida impresa con un texto pero
quiere que la propiedad de título del PDF tenga un texto
diferente, puede usar pdftitle como se muestra a
continuación.
\header {
title = "Sinfonía núm. 1"
pdftitle = "Sinfonía núm. 1 de Beethoven"
}
Todas las variables title, subject,
keywords, subtitle, composer,
arranger, poet, author y copyright
establecen propiedades del PDF y pueden hacerse preceder de
‘pdf’ para fijar una propiedad del archivo PDF a un valor
distinto del de la salida impresa.
La propiedad de PDF Creator se fija automáticamente a
‘LilyPond’ más la versión actual de LilyPond, y las variables
CreationDate y ModDate se fijan a la fecha y hora
actuales. Se puede sobreescribir ModDate mediante el
establecimiento de un valor para la variable de cabecera
moddate (o pdfmoddate) a una cadena de fecha de PDF
válida.
La variable title establece también el nombre de la
secuencia para el archivo MIDI. Se puede usar la variable
midititle para fijar el nombre de la secuencia
independientemente del valor usado para la salida impresa.