@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: dc78324e8424699ec17df064941c0c787d4eb91c
+ Translation of GIT committish: 23542761090f167ad42dbff7ef11d44a9c1374ac
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Introduction
@chapter Introduction
la disposición de cada una de las líneas dándoles una especie de firma visual distintiva.
Sin esta firma, todas las líneas parecerían iguales, y se convertirían en
un laberinto. Si un músico aparta la mirada o tiene un lapsus de
-concentración, las lÃneas podráin perder su lugar sobre el papel.
+concentración, las lÃneas podrÃan perder su lugar sobre el papel.
De forma similar, la fuerza visual de unos símbolos pesados sobre gruesas líneas de pentagrama
se sostiene mejor cuando el lector se aleja del papel, por
¿Cómo nos las arreglamos para implementar la tipografía? Si un artesano
necesita más de diez años para convertirse en un auténtico maestro ¿cómo vamos
-a poder nosotros, simples hackers, escibir
+a poder nosotros, simples «hackers», escribir
un programa que les quite el trabajo?
La respuesta es: ¡no podemos! Puesto que la tipografía se fundamenta en el juicio humano
de cosas de forma automática, de tal forma que los ajustes manuales tienden a ser
cada vez menos necesarios.
-Cuando empezamos, escibimos el programa LilyPond completamente en el lenguaje C++;
+Cuando empezamos, escribimos el programa LilyPond completamente en el lenguaje C++;
la funcionalidad del programa quedaba como esculpida en piedra por los desarrolladores.
Este esquema resultó no ser muy satisfactorio por una serie de motivos:
-@itemize @bullet
+@itemize
@item Cuando LilyPond comete fallos,
los usuarios tienen la necesidad de superar las decisiones de formateo. Por
ello el usuario debe tener acceso
@end itemize
Estos problemas se han solucionado integrando un intérprete del lenguaje
-Scheme y reescibiendo parte del código de LilyPond en Scheme.
+Scheme y reescribiendo parte del código de LilyPond en Scheme.
La actual arquitectura de formateo se construye alrededor del concepto de objetos
gráficos, descrita por variables y funciones de Scheme. Esta arquitectura puede
tratar al mismo tiempo con las reglas de formateo, el estilo tipográfico
dentro de los límites de un programa de ordenador? Nuestra solución es trocear el
problema de la notación (por oposición al grabado, esto es, a la tipografía) en
fragmentos digeribles y más fáciles de programar: cada tipo de símbolo se maneja por un
-módulo separado que recibe el nombre de plug-in. Cada plug-in es completamente modular
+módulo separado que recibe el nombre de «plug-in». Cada «plug-in» es completamente modular
e independiente, de forma que puede desarrollarse y mejorarse por separado. Estos
-plug-ins se llaman @code{engraver}s (grabadores), por analogía con los artesanos que
+«plug-ins» se llaman @code{engraver}s (grabadores), por analogía con los artesanos que
traducen las ideas musicales a símbolos gráficos.
En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las cabezas
@seealso
-Referencia del programa: @internalsref{Contexts}.
+Referencia de funcionamiento interno: @rinternals{Contexts}.
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
c'4 d'8
@end lilypond
-A una escala microscópca, dicha sintaxis es fácil de utilizar. A una
+A una escala microscópica, dicha sintaxis es fácil de utilizar. A una
escala mayor, la sintaxis también requiere una estructura. ¿De qué
otra forma podríamos introducir piezas complejas como sinfonías u
óperas? La estructura se forma mediante el concepto de expresiones
se puede empotrar fácilmente dentro de otros formatos basados en texto, como
@LaTeX{}, HTML, o en el caso concreto de este manual, Texinfo. A través de un
programa especial, los fragmentos de entrada se pueden sustituir por imágenes musicales
-dentro de los archivos de salida PDF o HTML resutantes. Esto convierte la tarea de
+dentro de los archivos de salida PDF o HTML resultantes. Esto convierte la tarea de
mezclar música y texto dentro de los documentos, en algo muy sencillo.
@node About this manual
@section About this manual
-El manual se divide en los siguientes capítulos:
-@itemize @bullet
+
+Hay cuatro manuales de LilyPond: el @emph{Manual de aprendizaje}, la
+@emph{Referencia de la notación}, el manual de @emph{Utilización del
+programa} y la @emph{Referencia de funcionamiento interno}.
+
+
+@subheading Learning Manual (LM)
+
+Este libro explica cómo empezar a aprender LilyPond, así como algunos
+conceptos clave en términos sencillos. Se recomienda leer estos
+capítulos de forma secuencial.
+
+@itemize
@item
@ifhtml
El
@end ifhtml
@emph{@ref{Tutorial}}
-da una amable introducción a la tipografía musical. Los usuarios que se acercan
-por primera vez deben comenzar por aquí.
+da una amable introducción a la tipografía musical. Los usuarios que
+se acercan por primera vez deben comenzar por aquí.
@item
-@emph{@ref{Putting it all together}}
-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!
+@emph{@ref{Fundamental concepts}} explica algunos conceptos generales
+sobre el formato de los archivos de entrada de LilyPond. Si no está
+seguro de dónde colocar una instrucción ¡lea este capítulo!
@item
@emph{@ref{Working on LilyPond projects}}
-trata los usos prácticos de LilyPond y cómo evitar ciertos problemas bastante
-comunes.
+trata los usos prácticos de LilyPond y cómo evitar ciertos problemas
+bastante comunes.
@item
@emph{@ref{Tweaking output}}
-muestra la manera de cambiar el grabado por omisión que produce
+muestra la manera de cambiar el grabado predeterminado que produce
LilyPond.
+@end itemize
+
+
+@subheading Notation Reference (NR)
+
+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.
+
+@c we need to completely rewrite this after GDP. -gp
+@ignore
+@itemize @bullet
+
@item
-@emph{@ref{Basic notation}}
+@emph{@r ef{Basic notation}}
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.
@item
-@emph{@ref{Instrument-specific notation}}
+@emph{@r ef{Instrument-specific notation}}
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).
@item
-@emph{@ref{Advanced notation}}
+@emph{@r ef{Advanced notation}}
trata temas agrupados por construcciones de notación. Esta sección proporciona
detalles acerca de cierta notación complicada o poco usual.
@item
-@emph{@ref{Changing defaults}}
+@emph{@r ef{Changing defaults}}
explica cómo hacer un ajuste fino de la presentación.
@item
-@emph{@ref{Non-musical notation}}
+@emph{@r ef{Non-musical notation}}
trata la salida no musical como los títulos, piezas de varios movimientos,
y sobre cómo elegir los instrumentos MIDI.
@item
-@emph{@ref{Spacing issues}}
+@emph{@r ef{Spacing issues}}
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.
@item
-@emph{@ref{Interfaces for programmers}}
+@emph{@r ef{Interfaces for programmers}}
explica cómo crear funciones musicales.
-@item
-@emph{@ref{Running 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.
+@end itemize
-@item
-@emph{@ref{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.
-@item
-@emph{@ref{Converting from other formats}}
-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 @code{.ly}.
+@subsubheading Appendices
+
+Este libro contiene unos útiles cuadros de referencia.
+
+@itemize
@item
@ifhtml
La
@end ifhtml
-@emph{@ref{Literature list}}
+@emph{@r ef{Literature list}}
contiene un conjunto de libros de referencia muy útiles para aquellas personas que desean saber
más sobre notación y grabado.
@item
El
-@emph{@ref{Scheme tutorial}}
+@emph{@r ef{Scheme tutorial}}
presenta una breve introducción a Scheme, el lenguaje de programación
que utilizan las funciones musicales.
@item
-@emph{@ref{Notation manual tables}}
+@emph{@r ef{Notation manual tables}}
son un conjunto de tablas que relacionan los nombres de los acordes, instrumentos MIDI,
nombres de los colores y la tipografía Feta.
@item
-@emph{@ref{Templates}}
+@emph{@r ef{Templates}}
de piezas de LilyPond. Sólo tiene que cortar y pegar una
-plantilla en un archivo de texto, escibir las notas y ¡ya está!
+plantilla en un archivo de texto, escribir las notas y ¡ya está!
@item
La
-@emph{@ref{Cheat sheet}}
-es una referencia manejable de los comandos de LilyPond más comunes.
+@emph{@r ef{Cheat sheet}}
+es una referencia manejable de las instrucciones de LilyPond más comunes.
@item
El
-@emph{@ref{LilyPond command index}}
+@emph{@r ef{LilyPond command index}}
es un índice de todos los @code{\commands} de LilyPond.
@item
El
-@emph{@ref{LilyPond index}}
+@emph{@r ef{LilyPond index}}
es un índice completo.
@end itemize
+@subheading Program usage
-Cuando ya sea un usuario con experiencia podrá usar el manual como referencia:
-hay un índice muy completo@footnote{Si está buscando algo y
-no lo encuentra en el manual, eso se considera un bug (fallo). En este
-caso le rogamos que envíe un informe de fallo.}, pero el documento también
-está disponible en
-@iftex
-una sola página HTML enorme,
-@end iftex
-@ifhtml
-@uref{source/Documentation/user/lilypond.html, una sola página enorme},
-@end ifhtml
-en la que es fácil buscar cualquier cosa utilizando la función de búsqueda de su
-navegador de web.
-@cindex buscar en el manual
-@cindex usar el manual
+Este libro explica la manera de ejecutar el programa y cómo integrar
+la notación de LilyPond con otros programas.
-@c FIXME:
-@c add/integrate glossary, put in list above
-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 también el glosario.
-@iftex
-El glosario explica los términos musicales, e incluye traducciones
-a varios idiomas. Es un docuento aparte, disponible en HTML
-y en PDF.
-@end iftex
-@ifnottex
-El @ref{Top,Glosario de música,,music-glossary} explica los términos musicales e
-incluye traducciones a varios idiomas. También se encuentra disponible en
-PDF.
-@end ifnottex
+@itemize
+
+@item
+@emph{@rprogram{Install}}
+explica cómo instalar LilyPond (incluyendo la compilación, si se desea).
+
+@item
+@emph{@rprogram{Setup}}
+describe cómo debe configurar el sistema para una utilización óptima de LilyPond,
+como por ejemplo el uso de entornos especiales para determinados editores de texto.
+
+@item
+@emph{@rprogram{Running LilyPond}}
+trata sobre cómo ejecutar LilyPond y sus programas de apoyo. Además,
+esta sección explica cómo actualizar las partituras a partir de versiones anteriores
+de LilyPond.
+
+@item
+@emph{@rprogram{LilyPond-book}}
+da los detalles que se encuentran detrás de la creación de
+documentos con ejemplos de música insertados, como este mismo manual.
+
+@item
+@emph{@rprogram{Converting from other formats}}
+explica cómo ejecutar los programas de conversión. Estos programas vienen incluidos
+en el mismo paquete que el propio LilyPond, y convierten una amplia variedad de formatos de
+música al formato @code{.ly}.
+
+@end itemize
+@end ignore
+
+
+@subsubheading Other information
+
+Existen otras fuentes de información que pueden resultar muy útiles.
+
+@itemize
@cindex frase idiomática
@cindex jerga
@cindex terminología
@cindex idiomas extranjeros
@cindex idioma
+@item
+@ifnottex
+El @ref{Top,Glosario de música,,music-glossary} explica los términos musicales e
+incluye traducciones a varios idiomas. También se encuentra disponible en
+PDF.
+@end ifnottex
+@iftex
+El glosario explica los términos musicales, e incluye traducciones
+a varios idiomas. Es un documento aparte, disponible en HTML
+y en PDF.
+@end iftex
+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.
+@cindex snippets (fragmentos de código)
+@cindex LSR
+@item
+Los
+@ifhtml
+@uref{source/input/lsr/collated-files.html,fragmentos de código (snippets)}
+@end ifhtml
+@ifnothtml
+fragmentos de código (snippets)
+@end ifnothtml
+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 @uref{http://lsr.dsi.unimi.it/,Archivo de fragmentos de código (snippets)
+de LilyPond}. Este sitio web también dispone de un manual de LilyPond en el que se pueden realizar búsquedas.
-Este manual no estaría completo sin un cierto número de otros documentos. No
-se encuentran disponibles en una forma lista para la impresión, pero deberían venir incluidos con el
-paquete de documentación para su plataforma informática
-@itemize @bullet
@item
+La
@iftex
-Referencia del programa
+Referencia de funcionamiento interno
@end iftex
@ifnottex
-@ref{Top,Referencia del programa,,lilypond-internals}.
+@ref{Top,Referencia de funcionamiento interno,,lilypond-internals}
@end ifnottex
-
-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.
+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
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 @b{Véase también}, que hace referencia a la documentación
-generada. En el documento HTML, estas subseciones llevan enlaces que se pueden plusar.
-
+generada. En el documento HTML, estas subsecciones llevan enlaces que se pueden pulsar.
-@cindex fragmentos de código
-@item
-@ifnothtml
-Diversos ejemplos de entrada.
-@end ifnothtml
-@ifhtml
-@c Works, but link name is not so nice; so write-out macro
-@c @inputfileref{input/test,Various input examples}.
-@uref{source/input/test/collated-files.html,Diversos ejemplos de entrada}.
-@end ifhtml
+@end itemize
-This collection of files shows various tips and tricks, and is
-available as a big HTML document, with pictures and explanatory texts
-included.
-@item
-@ifnothtml
-Las pruebas de regresión.
-@end ifnothtml
+Cuando ya sea un usuario con experiencia podrá usar el manual como referencia:
+hay un índice muy completo@footnote{Si está buscando algo
+y no lo encuentra en el manual, eso se considera un bug (fallo).
+En este caso le rogamos que envíe un informe de fallo.}, pero el documento también está
+disponible en
+@iftex
+una sola página HTML,
+@end iftex
@ifhtml
-@c Works, but link name is not so nice; so write-out macro
-@c @inputfileref{input/regression,The regression tests}.
-@uref{source/input/regression/collated-files.html,The regression tests}.
+@uref{source/Documentation/user/lilypond-big-page.html,una sola página enorme},
@end ifhtml
-
-Esta colección de archivos sirve para probar todas las funcionalidades de notación y grabado
-de LilyPond en un único archivo. La colección está ahí en primer lugar para ayudarnos
-a depurar los problemas, pero puede ser muy instructiva para ver cómo ponemos al programa a hacer ejercicio.
-El formato es similar al del documento de consejos y trucos.
-@end itemize
-
+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
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, @file{input/@/test/@/bla@/.ly} puede referirse al archivo
-@file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. En los paquetes binarios para
-la plataforma Unix, la documentación y los ejemplos se pueden encontrar normalmente
-en algún lugar dentro de @file{/usr/@/share/@/doc/@/lilypond/}.
-Los archivos de incialización, como por ejemplo @file{scm/@/lily@/.scm}, o
-@file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el directorio
-@file{/usr/@/share/@/lilypond/}.
+ejemplo, @file{input/@/lsr/@/dirname/@/bla@/.ly} puede referirse al archivo
+@file{lilypond@/2.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
+@file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización, como por
+ejemplo @file{scm/@/lily@/.scm}, o @file{ly/@/engraver@/-init@/.ly},
+se encuentran normalmente en el directorio @file{/usr/@/share/@/lilypond/}.
@cindex ajustar la salida
@cindex variables
@cindex propiedades
-@cindex interioridades de lilypond
+@cindex funcionamiento interno de lilypond
@cindex documentación interna
@cindex Scheme
@cindex extender 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
@uref{http://@/www@/.lilypond@/.org/}.
+
+