]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/user/introduction.itely
Merge branch 'lilypond/translation' of /home/lilycvs/git/lily/ into lilypond/translation
[lilypond.git] / Documentation / es / user / introduction.itely
index d4f5b870945c7f4ec02a035c0202754b42175aab..91bf8e9b32a0690271c95e820a26e2500b9acc41 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: f5a2aec5313027cb9b89a917b52230b2a7f31df7
+    Translation of GIT committish: 32fe8d89d5c4fe9c73c1daf200cd23c7e8f2d3fc
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -29,7 +29,7 @@ término deriva del proceso tradicional de la impresión musical.  Hace sólo un
 décadas, la música impresa se hacía estampando la música
 sobre planchas de zinc o estaño de forma invertida como en un espejo.  Después la plancha se
 entintaba y las depresiones causadas por los cortes y estampados retenían
-la tinta.  Al presionra una hoja de papel sobre la plancha se formaba una imagen.  El
+la tinta.  Al presionar una hoja de papel sobre la plancha, se formaba una imagen.  El
 estampado y cortado se hacía completamente a mano.  Cualquier corrección era
 muy fastidiosa de realizar, si es que era posible hacerla siquiera, así que el grabado tenía que quedar
 perfecto a la primera.  El grabado era una habilidad altamente especializada; un artesano necesitaba
@@ -39,8 +39,8 @@ ser un auténtico experto.
 
 Hoy en día, toda la música impresa nueva se produce con ordenadores.  Esto
 tiene unas ventajas evidentes: las copias son más baratas de producir y el trabajo editorial
-se puede repartir por correo elecrónico.  Desgraciadamente la penetrante utilización de
-ordenadores trambién ha hecho disminuir la calidad gráfica de las partituras.
+se puede repartir por correo electrónico.  Desgraciadamente la penetrante utilización de
+ordenadores también ha hecho disminuir la calidad gráfica de las partituras.
 Las impresiones de ordenador tienen un aspecto insulso y mecánico, lo que hace que sea desagradable tocar a partir de ellas.
 
 @c introduce illustrating aspects of engraving, font...
@@ -171,8 +171,8 @@ music = {
 @cindex ritmos regulares
 @cindex espaciado regular
 
-Cada compás de este fragmento solamente utiliza notas que se tocan a ritmo 
-constante.  El espaciado debería reflejarlo.  Desgraciadamente el ojo
+Cada uno de los dos compases de este fragmento tiene solamente notas de duración constante.
+El espaciado debería reflejarlo.  Desgraciadamente el ojo
 nos engaña un poco; no solamente percibe la distancia entre las
 cabezas de las notas, sino que tiene también en cuenta la distancia entre
 las plicas.  Como resultado, las notas de una combinación plica arriba/@/plica abajo
@@ -222,13 +222,13 @@ que tanto nos gusta contemplar y de las que tanto nos gusta tocar.
 @section Automated engraving
 
 ¿Cómo nos las arreglamos para implementar la tipografía? Si un artesano
-necesita má de diez años para convertirse en un auténtico maestro ¿cómo vamos
+necesita más de diez años para convertirse en un auténtico maestro ¿cómo vamos
 a poder nosotros, simples hackers, escibir
 un programa que les quite el trabajo?
 
 La respuesta es: ¡no podemos!  Puesto que la tipografía se fundamenta en el juicio humano
-sobre la apariencia, las personas nunca se pueden sustituir completamente.
-Sinm embargo, gran parte del trabajo más duro y repetitivo se peude automatizar.
+sobre la apariencia, nunca se puede sustituir completamente a las personas.
+Sin embargo, se puede automatizar gran parte del trabajo más duro y repetitivo.
 Si LilyPond resuelve la mayoría de las situaciones comunes de forma correcta,
 esto ya será una tremenda mejoría sobre los programas existentes.
 El resto de los casos se podrán afinar a mano.  Con el transcurso
@@ -244,8 +244,8 @@ Este esquema resultó no ser muy satisfactorio por una serie de motivos:
 @item Cuando LilyPond comete fallos,
 los usuarios tienen la necesidad de superar las decisiones de formateo.  Por
 ello el usuario debe tener acceso
-al motor de formateo.  De aquí que las reglas y valores establecidos no pueden
-quedar fijados por nosotros durante la compilación sino que los usuarios deben poder
+al motor de formateo.  De aquí que no podamos dejar establecidas las reglas y valores
+durante la compilación, sino que los usuarios deben poder
 acceder a ellos durante la ejecución del programa.
 
 @item El grabado de música es cosa de juicio visual y por ello es cuestión de gustos.
@@ -368,11 +368,11 @@ Sin embargo esto sólo se puede hacer una vez que se ha decidido @emph{qué} sí
 han de imprimirse, o dicho de otro modo: qué notación utilizar.
 
 La notación musical común es un sistema de registro de música que ha venido
-evolucionando desde hace 1000 años.  La forma que se usa en nuestros días data de
+evolucionando desde hace mil años.  La forma que se usa en nuestros días data de
 los primeros tiempos del Renacimiento.  Aunque la forma básica (es decir: puntos
 sobre una pauta de cinco líneas) no ha cambiado, los detalles continúan evolucionando 
 para expresar todas las innovaciones de la notación contemporánea.
-Por tanto abarca unos 500 años de música.  Sus aplicaciones se extienden sobre un
+Por tanto abarca unos quinientos años de música.  Sus aplicaciones se extienden sobre un
 amplio rango que abarca desde melodías monofónicas hasta monstruosos contrapuntos
 para gran orquesta.
 
@@ -540,7 +540,7 @@ es el contexto de notación de más alto nivel.
 
 @seealso
 
-Program reference: @internalsref{Contexts}.
+Referencia del programa: @internalsref{Contexts}.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
@@ -662,7 +662,7 @@ aplicación más sencilla es imprimir notas.
 @end lilypond
 
 @noindent
-Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de canción.
+Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de acordes (lead sheet).
 
 @lilypond[quote,ragged-right]
 <<
@@ -673,7 +673,7 @@ Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de canci
 @end lilypond
 
 También se pueden imprimir notación polifónica y música para piano.  El ejemplo
-siguiente combina varias otras construcciones exóticas.
+siguiente combina algunas otras construcciones exóticas.
 
 @lilypondfile[quote,ragged-right]{screech-boink.ly}
 
@@ -696,7 +696,13 @@ 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:
+El manual se divide en cuatro libros.
+
+@subsubheading Learning manual
+
+Este libro explica cómo empezar el aprendizaje de LilyPond, así como algunos
+conceptos clave en términos sencillos.
+
 @itemize @bullet
 
 @item
@@ -722,6 +728,16 @@ comunes.
 muestra la manera de cambiar el grabado por omisión que produce
 LilyPond.
 
+@end itemize
+
+@subsubheading 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.
+
+@itemize @bullet
+
 @item
 @emph{@ref{Basic notation}}
 trata ciertos temas agrupados según las construcciones de notación.  Esta sección proporciona
@@ -732,7 +748,7 @@ proyecto de notación.
 @emph{@ref{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 vocales).
+grupos de instrumentos (o voces).
 
 @item
 @emph{@ref{Advanced notation}}
@@ -745,7 +761,7 @@ explica cómo hacer un ajuste fino de la presentación.
 
 @item
 @emph{@ref{Non-musical notation}}
-trata la salida no musical como los títulos, varios movimientos,
+trata la salida no musical como los títulos, piezas de varios movimientos,
 y sobre cómo elegir los instrumentos MIDI.
 
 @item
@@ -755,24 +771,43 @@ tamaño del papel o la especificación de los saltos de página.
 
 @item
 @emph{@ref{Interfaces for programmers}}
-explains how to create music functions.
+explica cómo crear funciones musicales.
+
+@end itemize
+
+
+@subsubheading Program usage
+
+Este libro explica la manera de ejecutar el programa y cómo integrar
+la notación de LilyPond con otros programas.
+
+@itemize @bullet
 
 @item
-@emph{@ref{Running LilyPond}}
+@emph{@rprogram{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.
 
 @item
-@emph{@ref{LilyPond-book}} da los detalles que se encuentran detrás de la creación de
+@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 manual.
 
 @item
-@emph{@ref{Converting from other formats}}
+@emph{@rprogram{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}.
 
+@end itemize
+
+
+@subsubheading Appendices
+
+Este libro contiene unos útiles cuadros de referencia.
+
+@itemize @bullet
 @item
 @ifhtml
 La
@@ -795,7 +830,7 @@ nombres de los colores y la tipografía Feta.
 @item
 @emph{@ref{Templates}}
 de piezas de LilyPond.  Sólo tiene que cortar y pegar una
-plantilla en un archivo de texto, escibir las notas y ¡ha terminado!
+plantilla en un archivo de texto, escibir las notas y ¡ya está!
 
 @item
 La
@@ -815,61 +850,58 @@ es un índice completo.
 @end itemize
 
 
-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
-
-@c FIXME:
-@c add/integrate glossary, put in list above
-Si no está familiarizado con la notación o con la terminología musicales
-(sobre todo si es un hablante de inglés no 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,Music glossary,,music-glossary} explica los términos musicales e
-incluye traducciones a varios idiomas.  También se encuentra disponible en
-PDF.
-@end ifnottex
+@subsubheading Other information
+
+Existen otras fuentes de información que pueden resultar muy útiles.
+
+@itemize @bullet
 @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 docuento 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
+@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 peuden 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
 @end iftex
 @ifnottex
-@ref{Top,Program reference,,lilypond-internals}.
+@ref{Top,referencia del programa,,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
@@ -877,40 +909,25 @@ los valores de grosor, distancias, etc., se pueden cambiar dentro de los archivo
 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 plusar.
 
+@end itemize
 
-@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
-
-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
-The regression tests.
-@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
@@ -920,13 +937,13 @@ La localización exacta de los archivos de documentación que hemos mencionado p
 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 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/}.
 
 @cindex ajustar la salida
 @cindex variables
@@ -937,7 +954,8 @@ Los archivos de incialización, como por ejemplo @file{scm/@/lily@/.scm}, o
 @cindex extender lilypond
 @cindex índice
 
-Por último, este y el resto de los manuales, están disponibles en línea tanto como archivos
+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/}.
 
+