1.6 Sobre el presente manual

El manual se divide en cuatro libros.

Learning manual

Este libro explica cómo empezar el aprendizaje de LilyPond, así como algunos conceptos clave en términos sencillos.

• El Tutorial da una amable introducción a la tipografía musical. Los usuarios que se acercan por primera vez deben comenzar por aquí.
• Juntándolo todo explica algunos conceptos generales sobre el formato de los archivos de entrada de LilyPond. Si no está seguro de dónde colocar un comando ¡lea este capítulo!
• Trabajar en proyectos de LilyPond trata los usos prácticos de LilyPond y cómo evitar ciertos problemas bastante comunes.
• Trucar la salida muestra la manera de cambiar el grabado por omisión que produce LilyPond.

Notation reference

Este libro explica todas las instrucciones de LilyPond que producen notación impresa. Da por supuesto que el lector está familiarizado con los conceptos del manual de aprendizaje.

• Notación básica trata ciertos temas agrupados según las construcciones de notación. Esta sección proporciona detalles sobre notación básica que probablemente serán de utilidad en casi cualquier proyecto de notación.
• Notación específica de instrumentos también trata los temas agrupados por construcciones de notación. Esta sección proporciona detalles sobre notación especial que solamente será útil para ciertos grupos de instrumentos (o voces).
• Notación avanzada trata temas agrupados por construcciones de notación. Esta sección proporciona detalles acerca de cierta notación complicada o poco usual.
• Cambiar los valores por omisión explica cómo hacer un ajuste fino de la presentación.
• Notación no musical trata la salida no musical como los títulos, piezas de varios movimientos, y sobre cómo elegir los instrumentos MIDI.
• Problemas de espaciado trata asuntos que afectan a la salida global, como la elección del tamaño del papel o la especificación de los saltos de página.
• Interfaces para programadores explica cómo crear funciones musicales.

Program usage

Este libro explica la manera de ejecutar el programa y cómo integrar la notación de LilyPond con otros programas.

• Ejecutar LilyPond muestra la manera de ejecutar LilyPond y sus programas asistentes. Además, esta sección explica cómo actualizar los archivos de entrada de versiones de LilyPond anteriores.
• LilyPond-book da los detalles que se encuentran detrás de la creación de documentos con ejemplos de música insertados, como este manual.
• Conversión desde otros formatos explica cómo ejecutar los programas de conversión. Estos programas se proporcionan con el paquete LilyPond, y convierten una amplia variedad de formatos de música al formato .ly.

Appendices

Este libro contiene unos útiles cuadros de referencia.

• La Lista bibliográfica contiene un conjunto de libros de referencia muy útiles para aquellas personas que desean saber más sobre notación y grabado.
• El Tutorial de Scheme presenta una breve introducción a Scheme, el lenguaje de programación que utilizan las funciones musicales.
• Tablas del manual sobre notación son un conjunto de tablas que relacionan los nombres de los acordes, instrumentos MIDI, nombres de los colores y la tipografía Feta.
• Plantillas de piezas de LilyPond. Sólo tiene que cortar y pegar una plantilla en un archivo de texto, escibir las notas y ¡ya está!
• La Hoja de referencia rápida es una referencia manejable de los comandos de LilyPond más comunes.
• El Índice de comandos de LilyPond es un índice de todos los \commands de LilyPond.
• El Índice de LilyPond es un índice completo.

Other information

Existen otras fuentes de información que pueden resultar muy útiles.

• El Glosario de música explica los términos musicales e incluye traducciones a varios idiomas. También se encuentra disponible en PDF. Si no está familiarizado con la notación o la terminología musicales (sobre todo si no es un anglófono nativo), le recomendamos que consulte el glosario.

• Los fragmentos de código (snippets) son una enorme colección de pequeños ejemplos que ejemplifican toda clase de consejos, trucos y funcionalidades especiales de LilyPond. La mayor parte de estos fragmentos de código también se pueden encontrar en el Archivo de fragmentos de código (snippets) de LilyPond. Este sitio web también dispone de un manual de LilyPond en el que se peuden realizar búsquedas.
• La referencia del programa es un conjunto de páginas HTML con una tupida red de enlaces cruzados, que documentan al detalle el meollo de todas y cada una de las clases, objetos y funciones de LilyPond. Se produce directamente a partir de las definiciones de formateo que se utilizan.

  Casi toda la funcionalidad de formateo que se emplea internamente, se encuentra disponible para el usuario de forma directa. Por ejemplo, todas las variables que controlan los valores de grosor, distancias, etc., se pueden cambiar dentro de los archivos de entrada. Hay un enorme número de opciones de formateo, y todas ellas se describen en este documento. Cada sección del manual de notación tiene una subsección Véase también, que hace referencia a la documentación generada. En el documento HTML, estas subsecciones llevan enlaces que se pueden plusar.

Cuando ya sea un usuario con experiencia podrá usar el manual como referencia: hay un índice muy completo¹, pero el documento también está disponible en una sola página enorme, en la que es fácil buscar cualquier cosa utilizando la función de búsqueda de su navegador de web.

En todos los documentos HTML que tienen fragmentos de música incrustados, la entrada de LilyPond que se utilizó para producir dicha imagen se puede ver pulsando con el ratón sobre la imagen.

La localización exacta de los archivos de documentación que hemos mencionado puede variar de un sistema a otro. En ocasiones este manual hace referencia a archivos de inicialización y de ejemplo. A lo largo del manual, nos referimos a archivos de entrada por su ruta relativa respecto de directorio de nivel más alto de los archivos de código fuente. Por ejemplo, input/lsr/dirname/bla.ly puede referirse al archivo lilypond2.x.y/input/lsr/dirname/bla.ly. En los paquetes binarios para la plataforma Unix, normalmente la documentación y los ejemplos se encuentran en algún lugar dentro de /usr/share/doc/lilypond/. Los archivos de incialización, como por ejemplo scm/lily.scm, o ly/engraver-init.ly, se encuentran normalmente en el directorio /usr/share/lilypond/.

Por último, este y el resto de los manuales están disponibles en línea tanto como archivos PDF como HTML en el sitio web, que encontrará en http://www.lilypond.org/.

Otros idiomas: English, français, deutsch.