Mi natural y Fa natural}, independientemente de la armadura de la tonalidad.
Para ver más información acerca de la distinción entre
el contenido musical y la presentación de ese contenido, consulte
-@ref{Accidentals and key signatures}.
+@rlearning{Accidentals and key signatures}.
@lilypond[fragment,quote,ragged-right,verbatim,relative]
\key d \major
Las alteraciones accidentales y las armaduras son una frecuente causa de confusión para los nuevos usuarios,
porque las notas sin alteración pueden llevar signos de becuadro en función de la armadura.
-Para ver más información, consulte @ref{Accidentals} o @ref{Accidentals and key signatures}.
+Para ver más información, consulte @ref{Accidentals} o @rlearning{Accidentals and key signatures}.
@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
\key g \major
una forma un poco fuerte de hacer desaparecer objetos, porque afectará
al pentagrama completo. Este método también influye en el espaciado, lo que podría ser
deseable o no. Un método más
-sofisticado de borrar objetos se muestra en @ref{Common tweaks}.
+sofisticado de borrar objetos se muestra en @rlearning{Common tweaks}.
El ejemplo siguiente muestra una aplicación práctica. Las líneas divisorias y las indicaciones
de compás están normalmente sincronizadas en toda la partitura. Esto se hace
Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero realmente esto no significa
mucho. El archivo de inicialización (véase
-@ref{Default files})
+@rlearning{Default files})
@file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
@example
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
música al formato @code{.ly}.
@end itemize
-
+@end ignore
@subsubheading Other information
@ref{\NAME\,,,lilypond-big-page}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning-big-page}
+@end macro
+
@end ifset
@ref{\NAME\,,,lilypond}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning}
+@end macro
+
@end ifclear
@ref{\NAME\,,,lilypond}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning}
+@end macro
+
@c to get decent quotes in `foo'
@macro q{TEXT}
@xml
@ref{\NAME\,,,lilypond}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning}
+@end macro
+
@c to get decent quotes in `foo'
@macro q{TEXT}
`\TEXT\'
Sin embargo, toda esta flexibilidad puede hacer que las cosas se vuelvan confusas para
los nuevos usuarios. Esta sección le va a explicar parte de esta estructura, pero
puede obviar ciertos detalles en aras de la simplicidad. Para ver una
-descripción completa del formato de entrada, consulte @ref{File structure}.
+descripción completa del formato de entrada, consulte @ruser{File structure}.
Casi todos los ejemplos del presente manual con pequeños fragmentos de código. Por ejemplo
@code{manoderechadelpiano}, o @code{fulanomengano} --. Puede
usar el nombre de variable que desee. Para ver más
detalles, consulte
-@ref{Saving typing with identifiers and functions}.
+@ruser{Saving typing with identifiers and functions}.
Para ver una definición completa
-del formato de entrada, consulte @ref{File structure}.
+del formato de entrada, consulte @ruser{File structure}.
@node Score is a single musical expression
@section Score is a single musical expression
-En la sección anterior, @ref{How LilyPond files work},
+En la sección anterior, @ruser{How LilyPond files work},
pudimos ver la organización general de los archivos de entrada
de LilyPond. Pero parece que nos saltamos la parte más importante:
¿cómo averiguamos qué escribir después de
@noindent
Quizá encuentre útil dar un repaso a
-@ref{Music expressions explained}. En esta sección, vimos
+@ruser{Music expressions explained}. En esta sección, vimos
cómo elaborar grandes expresiones musicales a partir de pequeñas
piezas -- comenzábamos con notas, luego acordes, etc. --. Ahora
partiremos de una gran expresión musical y
@noindent
Recuerde que puede usar casi cualquier nombre que se le antoje. Las
limitaciones impuestas a los nombres de identificador se detallan en
-@ref{File structure}.
+@ruser{File structure}.
Cuando escriba una sección @code{\score} o cuando la esté
leyendo, hágalo despacio y con cuidado. Comience por
@end lilypond
Se puede encontrar una información más profunda sobre cómo preparar particellas y partituras
-en el manual de notación; consulte @ref{Orchestral music}.
+en el manual de notación; consulte @ruser{Orchestral music}.
El establecimiento de variables en tiempo de ejecución (@q{propiedades}) se trata en
-@ref{Changing context properties on the fly}.
+@ruser{Changing context properties on the fly}.
Cortando y pegando todo lo que se encuentra dentro de la sección @qq{ly snippet} (fragmento de tipo ly), tendrá una
plantilla inicial para sus experimentos. Si le agrada esta forma de aprender,
probablemente quiera imprimir o añadir a sus favoritos la dirección de la
-@ref{Cheat sheet}, que es una relación en forma de tabla de las instrucciones más comunes
+@ruser{Cheat sheet}, que es una relación en forma de tabla de las instrucciones más comunes
de manera que sirvan de referencia rápida.
@end ifhtml
@quotation
@table @asis
@item Introducir alturas y duraciones
-véase @ref{Pitches} y @ref{Durations}.
+véase @ruser{Pitches} y @ruser{Durations}.
@item Silencios
-véase @ref{Rests}.
+véase @ruser{Rests}.
@item Indicaciones de compás y otras instrucciones de tiempo
-véase @ref{Time signature}.
+véase @ruser{Time signature}.
@item Claves
-véase @ref{Clef}.
+véase @ruser{Clef}.
@end table
@end quotation
@end itemize
Hay más trucos para elaborar archivos de entrada en
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
@node How to read the tutorial
@subsection How to read the tutorial
-Como vimos en @ref{Working on text files}, la entrada de LilyPond debe estar
+Como vimos en @ruser{Working on text files}, la entrada de LilyPond debe estar
rodeada de llaves @{ @} o de @code{\relative c'' @{ ... @}}. Durante el
resto del presente manual, la mayor parte de los ejemplos omitirán las llaves.
@node Relative note names
@subsection Relative note names
-Como hemos visto en @ref{Simple notation}, LilyPond calcula la altura de
+Como hemos visto en @ruser{Simple notation}, LilyPond calcula la altura de
cada nota de forma relativa respecto de la nota anterior@footnote{Existe otra forma de
-introducir las alturas, @ref{Absolute note names}, pero en la práctica el modo
+introducir las alturas, @ruser{Absolute note names}, pero en la práctica el modo
relativo es mucho más cómodo y seguro de utilizar.}. Si no se añade ninguna marca de octava
(@code{'} y @code{,}), se supone que cada altura se encuentra dentro de una
cuarta desde la nota anterior.
@quotation
@table @asis
@item Octavas relativas
-ver @ref{Relative octaves}.
+ver @ruser{Relative octaves}.
@item Comprobación de octava
-ver @ref{Octave check}.
+ver @ruser{Octave check}.
@end table
@end quotation
añadiendo @samp{isis} o @samp{eses}@footnote{Esta sintaxis
derivó de las convenciones de las lenguas nórdicas y germánicas para nombrar las notas
como el alemán y el holandés. Para utilizar otros nombres para las alteraciones accidentales, vea
-@ref{Note names in other languages}.}
+@ruser{Note names in other languages}.}
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
cis1 ees fisis, aeses
Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo
al teclear, pero la ventaja es que la transposición es más fácil, y las
alteraciones se pueden imprimir siguiendo varias convenciones distintas. Consulte
-@ref{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
+@ruser{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
de acuerdo a reglas diferentes.
@moreinfo
@quotation
@table @asis
@item Alteraciones accidentales
-ver @ref{Accidentals} y @ref{Automatic accidentals}.
+ver @ruser{Accidentals} y @ruser{Automatic accidentals}.
@item Armadura de la tonalidad
-ver @ref{Key signature}.
+ver @ruser{Key signature}.
@end table
@end quotation
@quotation
@table @asis
@item Ligaduras de unión
-ver @ref{Ties}.
+ver @ruser{Ties}.
@item Ligaduras de expresión
-ver @ref{Slurs}.
+ver @ruser{Slurs}.
@item Ligaduras de fraseo
-ver @ref{Phrasing slurs}.
+ver @ruser{Phrasing slurs}.
@end table
@end quotation
@quotation
@table @asis
@item Articulaciones
-ver @ref{Articulations}.
+ver @ruser{Articulations}.
@item Digitaciones
-ver @ref{Fingering instructions}.
+ver @ruser{Fingering instructions}.
@item Matices
-ver @ref{Dynamics}.
+ver @ruser{Dynamics}.
@end table
@end quotation
@quotation
@table @asis
@item Barras automáticas
-ver @ref{Automatic beams}.
+ver @ruser{Automatic beams}.
@item Barras manuales
-ver @ref{Manual beams}.
+ver @ruser{Manual beams}.
@end table
@end quotation
@quotation
@table @asis
@item Notas de adorno
-ver @ref{Grace notes},
+ver @ruser{Grace notes},
@item Grupos especiales
-ver @ref{Tuplets},
+ver @ruser{Tuplets},
@item Anacrusas
-ver @ref{Partial measures}.
+ver @ruser{Partial measures}.
@end table
@end quotation
@node Multiple staves
@subsection Multiple staves
-Como ya hemos visto en @ref{Music expressions explained}, los archivos de entrada para LilyPond
+Como ya hemos visto en @ruser{Music expressions explained}, los archivos de entrada para LilyPond
se construyen a base de expresiones musicales. Si la partitura comienza con
expresiones musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo
es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita.
Las indicaciones de compás escritas en un pentagrama afectan al
resto de ellos@footnote{Este comportamiento se puede cambiar si uno lo desea; consulte
-@ref{Polymetric notation} para ver más detalles.}. En cambio,
+@ruser{Polymetric notation} para ver más detalles.}. En cambio,
la armadura de la tonalidad de un pentagrama @emph{no} afecta a los otros
pentagramas.
@cindex salto de pentagrama, establecimiento manual
@cindex voz de pentagrama cruzado, establecimiento manual
La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de
-este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ref{Multiple staves},
+este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ruser{Multiple staves},
pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoStaff}:
@example
@moreinfo
@quotation
-Ver @ref{Piano music}.
+Ver @ruser{Piano music}.
@end quotation
@node Combining notes into chords
@moreinfo
@quotation
-Ver @ref{Basic polyphony}.
+Ver @ruser{Basic polyphony}.
@end quotation
@moreinfo
@quotation
Otras posibilidades como poner varios versos debajo de una melodía, se
-discuten en @ref{Vocal music}.
+discuten en @ruser{Vocal music}.
@end quotation
@moreinfo
@quotation
Puede ver una lista completa de los modificadores y otras opciones de presentación
-en @ref{Chords}.
+en @ruser{Chords}.
@end quotation
La información sobre el título, autor, número de Opus y similares se escriben
en el bloque @code{\header}. Éste se encuentra fuera de la expresión musical
principal; el bloque @code{\header} normalmente se sitúa por debajo del
-@ref{Version number}.
+@ruser{Version number}.
@example
\version "2.11.23"
@end example
Cuando se procesa el archivo, el título y el autor se imprimen por encima
-de la música. Puede obtener más información sobre los títulos en @ref{Creating
+de la música. Puede obtener más información sobre los títulos en @ruser{Creating
titles}.
@subsection After the tutorial
Después de terminar el tutorial, quizá debería probar a escribir una o dos
-piezas. Comience con una de las @ref{Templates} y añada algunas
+piezas. Comience con una de las @ruser{Templates} y añada algunas
notas. Si necesita un tipo de notación que no ha sido tratada en el
tutorial, eche un vistazo a la Referencia de Notación, empezando por
-@ref{Basic notation}. Si quiere escribir música para un conjunto
+@ruser{Basic notation}. Si quiere escribir música para un conjunto
instrumental que no está cubierto por ninguna plantilla,
-consulte @ref{Extending the templates}.
+consulte @ruser{Extending the templates}.
Una vez que ha escrito algunas piezas cortas, lea el resto del
Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por
@node How to read the manual
@subsection How to read the manual
-Como ya vimos en @ref{How to read the tutorial}, muchos ejemplos del
+Como ya vimos en @ruser{How to read the tutorial}, muchos ejemplos del
tutorial omitían el @code{\relative c'' @{ ... @}} alrededor del ejemplo
mostrado.
exacta que LilyPond usó para generar este manual.
Para informarse sobre la estructura que tiene el resto del manual, consulte
-@ref{About this manual}.
+@ruser{About this manual}.
siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
del comando, omita el @code{\once}. Para detener este truco, use
@code{\revert} (revertir). Todo esto se explica en profundidad en
-@ref{The \override command}.
+@ruser{The \override command}.
@lilypond[quote,fragment,ragged-right,verbatim,relative=3]
% temporary code to break this example:
@seealso
-En el presente manual: @ref{The \override command}, @ref{Common tweaks}.
+En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
@node Fixing overlapping notation
@section Fixing overlapping notation
-En @ref{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
+En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
El mismo mecanismo se puede usar para mover otros tipos de
objetos; simplemente sustituya @code{TextScript} con el nombre de
otro objeto.
Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
final de la página relevante dentro de la documentación. Por ejemplo, al
-final de @ref{Dynamics}, vemos
+final de @ruser{Dynamics}, vemos
@quotation
@seealso
maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
@cindex extra-offset (desplazamiento adicional)
Al investigar asuntos relacionados con la presentación, la herramienta
@code{annotate-spacing} (anotar el espaciado) no tiene precio.
Este comando imprime los valores de algunos comandos de espaciado;
-consulte @ref{Displaying spacing} para ver más detalles. A partir de
+consulte @ruser{Displaying spacing} para ver más detalles. A partir de
la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
Aparte de los márgenes, existen otras opciones para ahorrar espacio:
@item
Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
-@ref{Changing horizontal spacing} para ver más detalles.
+@ruser{Changing horizontal spacing} para ver más detalles.
@lilypond[verbatim,quote]
\score {
comandos como
@code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
-de esto, consulte el @ref{Scheme tutorial} e
-@ref{Interfaces for programmers}.
+de esto, consulte el @ruser{Scheme tutorial} e
+@ruser{Interfaces for programmers}.
Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
@code{convert-ly} requiere que declare
qué versión de LilyPond utilizó.
-@item @strong{Incluya comprobaciones}: @ref{Bar check}, @ref{Octave check} y
-@ref{Barnumber check}. Si
+@item @strong{Incluya comprobaciones}: @ruser{Bar check}, @ruser{Octave check} y
+@ruser{Barnumber check}. Si
incluye comprobaciones de vez en cuando, en caso de que cometa un error podrá localizarlo mucho más rápidamente.
¿Con qué frecuencia es @q{de vez en cuando}? Depende de la complejidad
de la música. Para una música muy sencilla, quizá tan sólo una o dos veces. Para
si reelabora la música más tarde.
@item @strong{Separe los trucos} de las definiciones musicales. Consulte
-@ref{Saving typing with identifiers and functions} y
-@ref{Style sheets}.
+@ruser{Saving typing with identifiers and functions} y
+@ruser{Style sheets}.
@end itemize
la práctica de escribir un compás por línea de texto), y
compruebe cada sistema cuando lo haya terminado. Puede usar el comando
@code{showLastLength} para acelerar el proceso -- ver
-@ref{Skipping corrected music} -- .
+@ruser{Skipping corrected music} -- .
@item Defina @code{mBreak = @{ \break @}} e inserte @code{\mBreak}
dentro del archivo de entrada donde el manuscrito tenga un saldo de línea. De esta forma
@end example
@item @strong{Separe los trucos de las definiciones musicales}. Ya se mencionó
-en @ref{General suggestions}, pero para proyectos
+en @ruser{General suggestions}, pero para proyectos
grandes es vital. Quizá tengamos que cambiar la
definición de @code{fthenp}, pero en ese caso sólo lo tendremos que
hacer una vez, y aún podremos evitar tocar nada
@end lilypond
La utilización de identificadores también es una buena forma de reducir el trabajo si
-la sintaxis de entrada de LilyPond cambia (ver @ref{Updating old files}). Si
+la sintaxis de entrada de LilyPond cambia (ver @ruser{Updating old files}). Si
tiene una sola definición (como p.ej. @code{\dolce}) para todos sus
-archivos (ver @ref{Style sheets}), y después la sintaxis se modifica, sólo tendrá
+archivos (ver @ruser{Style sheets}), y después la sintaxis se modifica, sólo tendrá
que actualizar su definición @code{\dolce} única,
en lugar de tener que hacer cambios en cada uno de los archivos @code{.ly}.
@section Style sheets
La salida que produce LilyPond se puede modificar profundamente; consulte
-@ref{Tweaking output} para leer detalles sobre este asunto. Pero ¿qué ocurre si tiene muchos
+@ruser{Tweaking output} para leer detalles sobre este asunto. Pero ¿qué ocurre si tiene muchos
archivos a los que les quiere aplicar sus propios trucos? O ¿qué ocurre si, sencillamente,
quiere separar los trucos de la propia música? Todo esto
es bastante fácil de conseguir.
Veamos un ejemplo. No se preocupe si no entiende
las partes que tienen todos los @code{#()}. Esto se explicará en
-@ref{Advanced tweaks with Scheme}.
+@ruser{Advanced tweaks with Scheme}.
@lilypond[quote,verbatim,ragged-right]
mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@end lilypond
Existen varios problemas con la salida que se superpone; los arreglaremos utilizando
-las técnicas descritas en @ref{Moving objects}. Pero también haremos algo respecto a
+las técnicas descritas en @ruser{Moving objects}. Pero también haremos algo respecto a
las definiciones @code{mpdolce} y @code{tempoMark}. Éstas producen la salida que
deseamos, pero quizá las querríamos utilizar en otra pieza.
Podríamos simplemente copiarlas y pegarlas al principio de cada archivo,
parte del @code{bajo} hasta que encuentre la línea del problema.
Otra técnica de depuración muy útil es la construcción de
-@ref{Minimal examples}.
+@ruser{Minimal examples}.
@node Minimal examples
projects / lilypond.git / commitdiff