@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: f24b56a3274da3642348d075502ced7a2a84ecb5
+ Translation of GIT committish: 46e1b0a15ecf324b3272645224f3a2b3068dce73
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.61"
+@c \version "2.12.0"
@node General input and output
@chapter General input and output
@funindex \score
-Ub bloque @code{\score} debe contener una expresión musical única
+Un bloque @code{\score} debe contener una expresión musical única
delimitada por un par de llaves:
@example
pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
fuera de la expresión musical única dentro del bloque @code{\score}.
-@seealso
+@seealso
Manual de aprendizaje:
@rlearning{Working on input files},
@rlearning{Music expressions explained},
@funindex \book
@funindex \bookpart
-Un archivo @code{.ly} puede contener cualquier número de expresions
+Un archivo @code{.ly} puede contener cualquier número de expresiones
del nivel superior, donde una expresión del nivel superior es una de
las siguientes posibilidades:
decir, varios bloques @code{\score}) en un solo documento. Si hay
varias partituras @code{\score}, se crea un solo archivo de salida
para cada bloque @code{\book}, en el que se concatenan todos los
-movimientos correspondientes. La únca razón para especificar
+movimientos correspondientes. La única razón para especificar
explícitamente bloques @code{\book} en un archivo de entrada
@code{.ly} es si queremos crear varios archivos de salida a partir de
un único archivo de entrada. Una excepción se da dentro de los
documentos de lilypond-book, en los que tenemos que escribir
explícitamente un bloque @code{\book} si queremos tener más de una
única partitura @code{\score} o marcado @code{\markup} en el mismo
-ejemplo. Se puede cmbiar este comportamiento estableciendo el valor
+ejemplo. Se puede cambiar este comportamiento estableciendo el valor
de la variable @code{toplevel-book-handler} en el nivel superior. El
@emph{handler} predeterminado se define en el archivo de inicio
@file{../scm/@/lily@/.scm}.
@end example
Se puede cambiar este comportamiento estableciendo el valor de la
-bariable @code{toplevel-music-handler} en el nivel más alto. El
+variable @code{toplevel-music-handler} en el nivel más alto. El
@emph{handler} predeterminado se define en el archivo de inicio
@file{../scm/@/lily@/.scm}.
@end itemize
-@seealso
+@cindex espacios en blanco
+Por lo general se ignoran los espacios entre elementos del flujo de
+entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
+legibilidad. Sin embargo, los espacios se deben utilizar siempre para
+evitar errores, en las siguientes situaciones:
+
+@itemize
+@item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
+@item A continuación de las instrucciones y variables, es decir, todos los elementos
+que comienzan con un signo @code{\} de barra invertida.
+@item A continuación de todo elemento que se deba interpretar como expresión
+de Scheme, es decir, todo elemento que comience por un signo @code{#}.
+@item Para separar los elementode de una expresión de Scheme.
+@item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
+@code{\override} y @code{\set}. Concretamente, hay que usar espacios
+alrededor del punto y el signo igual en instrucciones como
+@code{\override Score . LyricText #'font-size = #5} y antes y después
+de la instrucción completa.
+
+@end itemize
+
+@seealso
Manual de aprendizaje:
@rlearning{How LilyPond input files work}.
@funindex copyright
@item copyright
Aviso de Copyright, centrado en la parte inferior de la primera
-página. Para insertar el símbolo de copyright symbol, consulte
+página. Para insertar el símbolo de copyright, consulte
@ref{Text encoding}.
@funindex tagline
@subsection Custom titles
Una opción más avanzada es cambiar las definiciones de las variables
-siguientes dentro del bloque @code{\paper} block. El archivo de
+siguientes dentro del bloque @code{\paper}. El archivo de
inicio @file{ly/titling-init.ly} ofrece un listado de la disposición
predeterminada.
sin especificar, se usará el encabezamiento de las páginas impares.
De forma predeterminada, los encabezamientos se definen de tal forma
-que el número de página está en el borde exterior, y el isntrumento
+que el número de página está en el borde exterior, y el instrumento
está centrado.
@funindex oddFooterMarkup
páginas, el medidor puede ser "00", es decir, un número de dos
dígitos.
-@predefined
+@predefined
@funindex \label
-@code{\label}
+@code{\label},
@funindex \page-ref
-@code{\page-ref}
+@code{\page-ref}.
+@endpredefined
+
@node Table of contents
@subsection Table of contents
del elemento de índice, dentro de la definición @code{tocItemMarkup}.
También se pueden definir nuevas instrucciones y elementos de
-marcado para crear índices generales más eleborados:
+marcado para crear índices generales más elaborados:
@itemize
@item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
@item luego defina una función de música cuyo propósito es añadir un elemento al índice general
}
@end lilypond
-@seealso
+@seealso
Archivos de inicio:
@file{ly/@/toc@/-init@/.ly}.
-@predefined
+@predefined
@funindex \table-of-contents
-@code{\table-of-contents}
+@code{\table-of-contents},
@funindex \tocItem
-@code{\tocItem}
+@code{\tocItem}.
+@endpredefined
@node Working with input files
la partitura, véase @ref{Different editions from one source}.
Los archivos que están en el directorio de trabajo actual se pueden
-referenciar simplemente especificando el nombre depués de la
+referenciar simplemente especificando el nombre después de la
instrucción @code{\include}. Los archivos en otros lugares se pueden
incluir proporcionando una referencia de ruta completa o una ruta
relativa (pero utilice la barra inclinada normal del UNIX, /, no la
@end example
Los archivos de inclusión también pueden contener enunciados
-@code{\include} a su vez. Estos enunciados @code{\include} de segundo
-nivel no se interpretan hasta que se incorporan al archivo principal,
-por lo que los nombres de archivo que especifican deben ser relativos
-al directorio que contiene el archivo principal, no al directorio que
-contiene el archivo incluido.
+@code{\include} a su vez. De forma predeterminada, estos enunciados
+@code{\include} de segundo nivel no se interpretan hasta que se
+incorporan al archivo principal, por lo que los nombres de archivo que
+especifican deben ser relativos al directorio que contiene el archivo
+principal, no al directorio que contiene el archivo incluido. Sin
+embargo, este comportamiento se puede modificar pasando la opción
+@code{-drelative-includes} en la línea de órdenes (o mediante la
+adición de @code{#(ly:set-option 'relative-includes #t)} al principio
+del archivo principal de entrada). Con el valor de
+@code{relative-includes} establecido, la ruta de cada instrucción
+@code{\include} se considera relativa al archivo que contiene dicha
+instrucción. Este comportamiento es el recomendado y se convertirá en
+el comportamiento predeterminado en una versión futura de lilypond.
También se pueden incluir archivos de un directorio que está en una
ruta de búsqueda especificada como opción al invocar a LilyPond desde
Los archivos que se incluyen en muchas partituras se pueden poner en
el directorio de LilyPond @file{../ly} (la localización de este
-directorio depende de la instalación: véase @rlearning{Other sources
-of information}). Estos archivos se pueden incluir sencillamente por
-su nombre en un enunciado @code{\include}. De esta forma se incluyen
-los archivos dependientes del idioma como @file{english.ly}.
+directorio depende de la instalación: véase
+@rlearning{Other sources of information}). Estos archivos se pueden
+incluir sencillamente por su nombre en un enunciado @code{\include}.
+De esta forma se incluyen los archivos dependientes del idioma como
+@file{espanol.ly}.
LilyPond incluye de forma predeterminada ciertos archivos cuando se
inicia el programa. Estas inclusiones no son visibles para el
Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
@rlearning{Scores and parts}.
-@seealso
+@seealso
Manual de aprendizaje:
@rlearning{Other sources of information},
@rlearning{Scores and parts}.
+
@knownissues
Si un archivo incluido recibe un nombre igual al de uno de los
pueden reutilizar en distintas partes de la partitura, véase
@rlearning{Organizing pieces with variables}. Por ejemplo, una
partitura vocal @notation{a cappella} con frecuencia incluye una
-reducción de piano de las partes para ensayar que ees idéntica a la
+reducción de piano de las partes para ensayar que es idéntica a la
música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
puede combinar sobre un solo pentagrama la música de dos variables,
véase @ref{Automatic part combining}. He aquí un ejemplo:
@funindex \keepWithTag
@funindex \removeWithTag
@cindex etiqueta
-@cindex manetener música etiquetada
+@cindex mantener música etiquetada
@cindex quitar música etiquetada
La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
-con el nombre @var{parteA}. Las expresiones etoiquetadas de esta
+con el nombre @var{parteA}. Las expresiones etiquetadas de esta
manera se pueden seleccionar o filtrar más tarde por su nombre, usando
bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
#'@var{nombre}}. El resultado de la aplicación de estos filtros a la
}
@end lilypond
-El flitrado con etiquetas se puede aplicar a articulaciones, textos,
+El filtrado con etiquetas se puede aplicar a articulaciones, textos,
etc. anteponiendo
@example
etiquetadas excepto la que se nombra, y el segundo filtro elimina
incluso esa sección etiquetada.
-@seealso
+@seealso
Manual de aprendizaje:
@rlearning{Organizing pieces with variables}.
@ref{Automatic part combining},
@ref{Including LilyPond files}.
+
@ignore
@c This warning is more general than this placement implies.
@c Rests are not merged whether or not they come from tagged sections.
@c Should be deleted? -td
+
@knownissues
Multiple rests are not merged if you create a score with more
biblioteca Pango para representar y disponer tipográficamente textos
multilingües.
-Lilypond no realiza ninguna conversión en la codificación de la
+LilyPond no realiza ninguna conversión en la codificación de la
entrada. Esto significa que cualquier text, ya sea el título, la
letra de la canción o una instrucción musical que contenga caracteres
distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
\addlyrics { \portuguese }
@end lilypond
-Para introducir un caracter aislado para el que se conoce la secuencia
-de escape de Unicode pero no está disponible en el editor que se está
-usando, use @code{\char ##xhhhh} dentro de un bloque @code{\markup},
-donde @code{hhhh} es el código hexadecimal del carácter en cuestión.
-Por ejemplo, @code{\char ##x03BE} inserta el carácter Unicode U+03BE,
-que tiene el nombre Unicode @qq{Letra griega Xi pequeña}. Se puede
-sustituir cualquier código hexadecimal Unicode, y si todos los
-caracteres especiales se escriben en este formato no es necesario
-guardar el archivo de entrada en formato UTF-8. Por supuesto, debe
-estar instalada y estar disponible para Lilypond una fuente
-tipográfica que contenga codificados todos estos caracteres.
-
-El ejemplo siguiente muestra caracteres codificados en UTF-8 que se
-usan en cuatro lugares: en una llamada de ensayo, como texto de
+Para introducir un carácter aislado para el que se conoce el punto de
+código Unicode pero no está disponible en el editor que se está
+usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
+un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
+del carácter en cuestión y @code{dddd} es su valor decimal
+correspondiente. Pueden omitirse los ceros iniciales, pero es
+costumbre indicar los cuatro caracteres en la representación
+hexadecimal (observe que @emph{no} debe utilizarse la codificación
+UTF-8 del punto de código Unicode después de @code{\char}, pues la
+codificación UTF-8 contiene bits adicionales que indican el número de
+octetos.)
+
+Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
+insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
+@qq{Letra griega Xi pequeña}.
+
+Se puede escribir de esta forma cualquier punto de código Unicode, y
+si todos los caracteres especiales se escriben en este formato no es
+necesario guardar el archivo de entrada en formato UTF-8. Por
+supuesto, debe estar instalada y estar disponible para LilyPond una
+fuente tipográfica que contenga codificados todos estos caracteres.
+
+El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
+en cuatro lugares: en una llamada de ensayo, como texto de
articulación, en la letra y como texto independiente bajo la
partitura:
}
\addlyrics { O \markup { \concat{ Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008" \char ##x00A9 }
+\markup { "Copyright 2008--2009" \char ##x00A9 }
@end lilypond
Para escribir el símbolo de copyright en la nota de créditos, utilice:
@funindex showLastLength
Al escribir o copiar música, normalmente sólo es interesante de ver y
-corregir la música cercana al final (donde estams añadiendo las
+corregir la música cercana al final (donde estamos añadiendo las
notas). Para acelerar este proceso de corrección, es posible saltar
la composición tipográfica de todos excepto unos pocos de los últimos
compases. Esto se consigue poniendo
@noindent
en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
-cinco compases (suponniendo un compás de 4/4) de cada una de las
+cinco compases (suponiendo un compás de 4/4) de cada una de las
partituras @code{\score} del archivo de entrada. Para piezas largas,
el tipografiado de únicamente una parte pequeña es con frecuencia un
orden de magnitud más rápido que el de la obra completa. Si estamos
El MIDI (Musical Instrument Digital Interface, Interfase Digital para
Instrumentos Musicales) es un estándar para interconectar y controlar
instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
-una serie de notas dentro de un conjunto de pistas. No es un archivoo
+una serie de notas dentro de un conjunto de pistas. No es un archivo
de sonidos reales; se necesita un programa reproductor especial para
traducir la serie de notas en sonidos de verdad.
Más abajo se describe una forma alternativa de especificar el tempo
MIDI inicial o global, véase @ref{MIDI block}.
+Debido a ciertas limitaciones de Windows, la extensión predeterminada
+para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
+operativos utilizan la extensión @code{.midi}. Si prefiere una
+extensión diferente, inserte la siguiente línea en el nivel jerárquico
+superior del archivo de entrada, antes del inicio de cualquier bloque
+@code{\book}, @code{\bookpart} o @code{\score}:
+
+@example
+#(ly:set-option 'midi-extension "midi")
+@end example
+
+La línea anterior establece la extensión predeterminada para los
+archivos MIDI a @code{.midi}.
+
+De forma alternativa, esta opción se puede también proporcionar en la
+línea de órdenes:
+
+@example
+lilypond … -dmidi-extension=midi archivoLily.ly
+@end example
+
+
@unnumberedsubsubsec Instrument names
@cindex instrumento, nombres de
@example
\new Staff @{
- \set Staff.midiInstrument = "glockenspiel"
+ \set Staff.midiInstrument = #"glockenspiel"
@var{...notes...}
@}
@end example
@example
-\new Staff \with @{midiInstrument = "cello"@} @{
+\new Staff \with @{midiInstrument = #"cello"@} @{
@var{...notes...}
@}
@end example
nota, por lo que los crescendi y decrescendi no pueden afectar al
volumen de una sola nota.
-No todos los repoductores de MIDI manejar adecuadamente los cambios de
+No todos los reproductores de MIDI manejar adecuadamente los cambios de
tempo de la salida MIDI. Entre los reproductores que se sabe que
funcionan se encuentran el Reproductor de Medios de MS Windows y
@uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
@code{\midi} se deja vacío, pero puede contener reorganizaciones de
contextos, definiciones de contexto nuevas o código para fijar valores
de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
-tempo inicial exportado alarchivo MIDI sin hacer que se imprima una
+tempo inicial exportado al archivo MIDI sin hacer que se imprima una
indicación de tempo:
@example
@itemize
@item Alturas
-@item Cuartos de tono (véase @ref{Accidentals}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
+@item Microtonos (véase @ref{Accidentals}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
@item Acordes escritos como nombres de acorde
@item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
@item Trémolos escritos sin @q{@code{:}[@var{número}]}
@itemize
@item Duraciones escritas como anotaciones, p.ej. el swing
-@item Cambios de tempo escritos como anotacioens sin marca de tempo
+@item Cambios de tempo escritos como anotaciones sin marca de tempo
@item Staccato y otras articulaciones y ornamentos
@item Ligaduras de expresión y de fraseo
@item Crescendi y decrescendi sobre una nota única
@item Trémolos introducidos con @q{@code{:}[@var{número}]}
@item Bajo cifrado
+@item Acordes microtonales
@end itemize
@notation{fffff}. El conjunto de indicaciones dinámicas y las
fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
@rlearning{Other sources of information}. Este conjunto de fracciones
-se puede cmbiar o extender proporcionando una función que toma como
+se puede cambiar o extender proporcionando una función que toma como
argumento una indicación dinámica y devuelve la fracción requerida, y
estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
función.
Por ejemplo, si se requiere una indicación dinámica
@notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
-predeterminado sobre el voumen MIDI, pues no está incluida en el
+predeterminado sobre el volumen MIDI, pues no está incluida en el
conjunto predeterminado. De igual manera, si se define una indicación
dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
incluida en el conjunto predeterminado. El ejemplo siguiente muestra
\score {
\new Staff {
- \set Staff.midiInstrument = "cello"
+ \set Staff.midiInstrument = #"cello"
\set Score.dynamicAbsoluteVolumeFunction = #myDynamics
\new Voice {
\relative c'' {
procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
como único argumento y devuelva un par de fracciones que dan los
volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
-sustitución se hace de la misma forma que mostramos para reestablecer
+sustitución se hace de la misma forma que mostramos para restablecer
la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
al comienzo de esta sección. El ecualizador predeterminado,
@notation{default-instrument-equalizer}, en @file{../scm/midi.scm},
instrumentos de percusión de altura determinada, como el xilófono,
marimba, vibráfono, timbales, etc., se tratan como instrumentos
@qq{normales} y la música para estos instrumentos se debe introducir
-en contestos de @code{Staff} normales, no en un contexto
+en contextos de @code{Staff} normales, no en un contexto
@code{DrumStaff}, para obtener la salida MIDI correcta.
Ciertos sonidos de altura indeterminada que están incluidos en el
las alturas normales adecuadas.
Muchos instrumentos de percusión no están incluidos dentro del
-estándar General MIDI standard, p.ej. las castañuelas. El método más
+estándar General MIDI, p.ej. las castañuelas. El método más
fácil (aunque no satisfactorio) de producir una salida MIDI al
escribir para estos instrumentos es sustituirlos por el sonido más
parecido del conjunto estándar.
projects / lilypond.git / blobdiff