]> git.donarmstrong.com Git - lilypond.git/commitdiff
Resolve conflict
authorFrancisco Vila <francisco.vila@hispalinux.es>
Fri, 3 Oct 2008 18:12:41 +0000 (20:12 +0200)
committerFrancisco Vila <francisco.vila@hispalinux.es>
Fri, 3 Oct 2008 18:12:41 +0000 (20:12 +0200)
1  2 
Documentation/es/index.html.in
Documentation/es/user/rhythms.itely
Documentation/es/user/staff.itely
Documentation/es/user/text.itely

Simple merge
Simple merge
index 7ab1e01aff2744cda8b07405b8a74a36042489a0,d417ad26bf2c5f740912941674eedad261c00438..bc88c2b5d84fb581a05b217a788de82c812a5209
@@@ -22,17 -27,121 +27,122 @@@ indicaciones de interpretación especí
  @node Displaying staves
  @subsection Displaying staves
  
+ Esta sección describe los distintos métodos de creación de pentagramas
+ y grupos de ellos, que se indican al comienzo de cada línea con una
+ llave o un corchete.
  @menu
- * System start delimiters::     
- * Staff symbol::                
- * Hiding staves::               
+ * Instantiating new staves::
+ * Grouping staves::
+ * Nested staff groups::
  @end menu
  
- @node System start delimiters
- @unnumberedsubsubsec System start delimiters
+ @node Instantiating new staves
+ @unnumberedsubsubsec Instantiating new staves
+ @cindex nuevo pentagrama
+ @cindex pauta
+ @cindex pentagrama, iniciar
+ @cindex pentagrama, instanciar
+ @cindex pentagrama, nuevo
+ @cindex pentagrama único
+ @cindex percusión, pauta de
+ @cindex pauta de percusión
+ @cindex Gregoriano, canto, pauta de transcripción de
+ @cindex rítmica, pauta
+ @cindex tablatura, pauta de
+ Las @notation{pautas} y los @notation{pentagramas} o pautas de cinco
+ líneas se crean con las instrucciones @code{\new} o @code{\context}.
+ Para ver más detalles, consulte @ref{Creating contexts}.
+ El contexto básico de pentagrama es @code{Staff}:
+ @lilypond[verbatim,quote,relative=2]
+ \new Staff { c4 d e f }
+ @end lilypond
+ @code{DrumStaff} crea una pauta de cinco líneas preparada para un
+ conjunto de batería típico.  Utiliza distintos nombres para cada
+ instrumento.  Los nombres de instrumento se fijan utilizando la
+ instrucción @code{\drummode}.  Para ver más detalles, consulte
+ @ref{Percussion staves}.
+ @lilypond[verbatim,quote]
+ \new DrumStaff {
+   \drummode { cymc hh ss tomh }
+ }
+ @end lilypond
+ @c FIXME: remove when mentioned in NR 2.8
+ @code{GregorianTranscriptionStaff} crea una pauta para la notación
+ moderna de canto Gregoriano.  No muestra líneas divisorias.
+ @lilypond[verbatim,quote,relative=2]
+ \new GregorianTranscriptionStaff { c4 d e f }
+ @end lilypond
+ @code{RhythmicStaff} crea una pauta de una sola línea que sólo muestra
+ las duraciones de la entrada.  Se preservan las duraciones reales.
+ Para ver más detalles, consulte @ref{Showing melody rhythms}.
+ @lilypond[verbatim,quote,relative=2]
+ \new RhythmicStaff { c4 d e f }
+ @end lilypond
+ @code{TabStaff} crea una tablatura con seis cuerdas en la afinación
+ estándar de guitarra.  Para ver más detalles, consulte @ref{Default
+ tablatures}.
+ @lilypond[verbatim,quote,relative=2]
+ \new TabStaff { c4 d e f }
+ @end lilypond
+ Existen dos contextos de pauta específicos para la notación de música
+ antigua: @code{MensuralStaff} y @code{VaticanaStaff}.  Se describen en
+ @ref{Pre-defined contexts}.
+ Se pueden definir contextos nuevos de pentagrama único.  Para ver más
+ detalles, consulte @ref{Defining new contexts}.
+ @seealso
+ Glosario musical:
+ @rglos{staff},
+ @rglos{staves}.
+ Referencia de la notación:
+ @ref{Creating contexts},
+ @ref{Percussion staves},
+ @ref{Showing melody rhythms},
+ @ref{Default tablatures},
+ @ref{Pre-defined contexts},
+ @ref{Staff symbol},
+ @ref{Gregorian chant contexts},
+ @ref{Mensural contexts},
+ @ref{Defining new contexts}.
+ Fragmentos de código:
+ @rlsr{Staff notation}.
+ Referencia de funcionamiento interno:
+ @rinternals{Staff},
+ @rinternals{DrumStaff},
+ @rinternals{GregorianTranscriptionStaff},
+ @rinternals{RhythmicStaff},
+ @rinternals{TabStaff},
+ @rinternals{MensuralStaff},
+ @rinternals{VaticanaStaff},
+ @rinternals{StaffSymbol}.
++
+ @node Grouping staves
+ @unnumberedsubsubsec Grouping staves
  
  @cindex comienzo del sistema
- @cindex Pentagramas, varios
+ @cindex pentagramas, varios
  @cindex corchete vertical
  @cindex llave vertical
  @cindex pentagramas de piano
index 070cb5e7c24a2e837e452ceea48caafad3458f4e,072dfdaf01ee1dd3e3babbd30992181e59948dab..4a13ad21735116da3689965c7814c7318d06c996
@@@ -48,8 -47,9 +47,9 @@@ partitura
  * Separate text::
  @end menu
  
  @node Text scripts
 -@subsubsection Text scripts
 +@unnumberedsubsubsec Text scripts
  
  @cindex Texto, inscripciones de
  @cindex texto, elementos no vacíos de
@@@ -455,34 -467,700 +467,700 @@@ confusión
  
  
  @node Selecting font and font size
 -@subsubsection Selecting font and font size
 +@unnumberedsubsubsec Selecting font and font size
  
- @untranslated
+ @cindex fuente tipográfica, cambiar
+ @funindex \italic
+ @funindex \bold
+ @funindex \underline
+ Está contemplado de forma básica el cambio de la fuente tipográfica en
+ el modo de marcado:
+ @lilypond[quote,verbatim,relative=2]
+ {
+   d1^\markup {
+     \bold { Più mosso }
+     \italic { non troppo \underline Vivo }
+   }
+   r2 r4 r8
+   d,_\markup { \italic quasi \smallCaps Tromba }
+   f1 d2 r
+ }
+ @end lilypond
+ @cindex fuente tipográfica, tamaño de
+ @cindex texto, tamaño de
+ @funindex \fontsize
+ @funindex \smaller
+ @funindex \larger
+ @funindex \bigger
+ @funindex \magnify
+ El tamaño de los caracteres también se puede alterar de distintas
+ maneras:
+ @itemize
+ @item
+ el tamaño de la tipografía se puede definir a un valor absoluto,
+ @item
+ las instrucciones predefinidas permiten seleccionar fácilmente los
+ tamaños estándar,
+ @item
+ el tamaño de la tipografía también se puede cambiar de forma relativa
+ respecto de su valor anterior.
+ @end itemize
+ @noindent
+ El ejemplo siguiente ejemplifica estos tres métodos:
+ @lilypond[quote,verbatim,relative=2]
+ {
+   f1^\markup { \fontsize #5 Sinfonia }
+   a,_\markup {
+     \tiny espressivo
+     \large e
+     \normalsize intenso
+   }
+   bes^\markup { (con
+     \larger grande
+     \smaller emozione
+     \magnify #0.6 { e sentimento } )
+   }
+   d c2 r8 c bes a g1
+ }
+ @end lilypond
+ @cindex subíndice
+ @cindex superíndice
+ @funindex \super
+ @funindex \sub
+ El texto se puede imprimir como subíndice o como superíndice.  De
+ forma predeterminada se imprimen en un tamaño menor, pero también se
+ puede usar un tamaño normal:
+ @lilypond[quote,verbatim]
+ \markup {
+   \column {
+     \line { 1 \super st movement }
+     \line { 1 \normal-size-super st movement
+       \sub { (part two) }  }
+   }
+ }
+ @end lilypond
+ @cindex fuente tipográfica, familias de
+ El modo de marcado ofrece una manera fácil de elegir familias de
+ tipografía alternativas.  A no ser que se especifique de otro modo, se
+ selecciona automáticamente la fuente predeterminada con serifa, de
+ tipo romano: en la última línea del ejemplo siguiente, no hay
+ diferencia entre la primera y la segunda palabra.
+ @lilypond[quote,verbatim]
+ \markup {
+   \column {
+     \line { Act \number 1 }
+     \line { \sans { Scene I. } }
+     \line { \typewriter { Verona. An open place. } }
+     \line { Enter \roman Valentine and Proteus. }
+   }
+ }
+ @end lilypond
+ @noindent
+ Algunas de estas familias, usadas para elementos específicos como
+ números o matices, no ofrecen todos los caracteres, como se explica en
+ @ref{New dynamic marks} y @ref{Manual repeat marks}.
+ @c \concat is actually documented in Align (it is not
+ @c a font-switching command). But we need it here. -vv
+ Si se usan dentro de una palabra, algunas instrucciones de cambio de
+ tipografía o de formateo pueden producir un espacio vacío no deseado.
+ Esto se puede solucionar concatenando en uno solo los distintos
+ elementos de texto:
+ @lilypond[quote,verbatim]
+ \markup {
+   \column {
+     \line {
+       \concat { 1 \super st }
+       movement
+     }
+     \line {
+       \concat { \dynamic p , }
+       \italic { con dolce espressione }
+     }
+   }
+ }
+ @end lilypond
+ Se puede encontrar una lista exhaustiva de instrucciones de cambio de
+ tipografía, de tamaño y relativas a las familias tipográficas en
+ @ref{Font}.
+ También es posible definir conjuntos personalizados de fuentes, tal y
+ como se explica en @ref{Fonts}.
+ @predefined
+ @funindex \teeny
+ @funindex \tiny
+ @funindex \small
+ @funindex \normalsize
+ @funindex \large
+ @funindex \huge
+ @code{\teeny},
+ @code{\tiny},
+ @code{\small},
+ @code{\normalsize},
+ @code{\large},
+ @code{\huge}.
+ @seealso
+ Referencia de la notación:
+ @ref{Font},
+ @ref{New dynamic marks},
+ @ref{Manual repeat marks},
+ @ref{Fonts}.
+ Fragmentos de código:
+ @rlsr{Text}.
+ Referencia de funcionamiento interno:
+ @rinternals{TextScript}.
+ Archivos de inicio:
+ @file{scm/@/define@/-markup@/-commands@/.scm}.
  
  @node Text alignment
 -@subsubsection Text alignment
 +@unnumberedsubsubsec Text alignment
  
- @untranslated
+ @cindex texto alineación de
+ @cindex alinear texto
+ Esta subsección trata sobre cómo colocar texto en el modo de marcado,
+ dentro de un bloque @code{\markup} block.  Los objetos de marcado
+ también se pueden mover como un todo, usando la sintaxis que se
+ describe en @rlearning{Moving objects}.
+ @c Padding commands should be mentioned on this page, but
+ @c most of these require \box to be more clearly illustrated. -vv
+ @cindex texto, alineación horizontal
+ @cindex horizontal, alineación de texto
+ @funindex \left-align
+ @funindex \center-align
+ @funindex \right-align
+ Los objetos de marcado se pueden alinear de distintas maneras.  De
+ foma predeterminada, una indicación de texto se alinea sobre el borde
+ izquierdo: en el ejemplo siguiente, no existe diferencia entre los
+ marcados primero y segundo.
+ @lilypond[quote,verbatim,fragment,relative=1]
+ a1-\markup { poco }
+ e'
+ a,-\markup { \left-align poco }
+ e'
+ a,-\markup { \center-align { poco } }
+ e'
+ a,-\markup { \right-align poco }
+ @end lilypond
+ @funindex \halign
+ Se puede realizar un ajuste fino de la alineación horizontal usando un
+ valor numérico:
+ @lilypond[quote,verbatim,fragment,relative=1]
+ a1-\markup { \halign #-1 poco }
+ e'
+ a,-\markup { \halign #0 poco }
+ e'
+ a,-\markup { \halign #0.5 poco }
+ e'
+ a,-\markup { \halign #2 poco }
+ @end lilypond
+ @noindent
+ Ciertos objetos pueden poseer sus propios procedimientos de
+ alineación, y por tanto no resultan afectados por estas instrucciones.
+ Es posible mover estos objetos de marcado como un todo, como se
+ muestra por ejemplo en @ref{Text marks},
+ @cindex texto, alineación vertical
+ @cindex vertical, alineación de texto
+ @funindex \raise
+ @funindex \lower
+ La alineación vertical es un poco más compleja.  Como se ha dicho más
+ arriba, los objetos de marcado se pueden mover como un todo; sin
+ embargo, también es posible mover elementos específicos dentro de un
+ bloque de marcado.  En este caso, el elemento a mover se debe preceder
+ de un @emph{punto de anclaje}, que puede ser otro elemento de marcado
+ o un objeto invisible.  El ejemplo siguiente ejemplifica estas dos
+ posibilidades; el último marcado en este ejemplo no tiene punto de
+ anclaje y por ello no resulta movido.
+ @lilypond[quote,verbatim,fragment,relative=1]
+ d2^\markup {
+   Acte I
+   \raise #2 { Scène 1 }
+ }
+ a'
+ g_\markup {
+   \null
+   \lower #4 \bold { Très modéré }
+ }
+ a
+ d,^\markup {
+   \raise #4 \italic { Une forêt. }
+ }
+ a'4 a g2 a
+ @end lilypond
+ @funindex \general-align
+ @funindex \translate
+ @funindex \translate-scaled
+ Algunas instrucciones pueden afcetar tanto a la alineación horizontal
+ como a la vertical de los objetos de texto en el modo de marcado.
+ Cualquier objeto afectado por estas instrucciones se deben preceder de
+ un punto de anclaje:
+ @lilypond[quote,verbatim,fragment,relative=1]
+ d2^\markup {
+   Acte I
+   \translate #'(-1 . 2) "Scène 1"
+ }
+ a'
+ g_\markup {
+   \null
+   \general-align #Y #3.2 \bold "Très modéré"
+ }
+ a
+ d,^\markup {
+   \null
+   \translate-scaled #'(-1 . 2) \teeny "Une forêt."
+ }
+ a'4 a g2 a
+ @end lilypond
+ @funindex \column
+ @funindex \center-column
+ @cindex varias líneas, marcado de
+ @cindex texto de varias líneas
+ @cindex columnas, texto en
+ Un objeto de marcado puede incluir varias líneas de texto.  En el
+ ejemplo siguiente, cada elemento o expresión se sitúa en su propia
+ línea, ya sea alineada por la izquierda o centrada:
+ @lilypond[quote,verbatim]
+ \markup {
+   \column {
+     a
+     "b c"
+     \line { d e f }
+   }
+   \hspace #10
+   \center-column {
+     a
+     "b c"
+     \line { d e f }
+   }
+ }
+ @end lilypond
+ @funindex \fill-line
+ @cindex centrar texto en la página
+ De forma similar, una lista de elementos o expresiones se puede
+ repartir de forma que rellene por completo el ancho de la línea
+ horizontal (si hay un solo elemento, se centra en el papel).  A su
+ vez, estas expresiones pueden incluir texto de varias líneas o
+ cualquier otra expresión de marcado:
+ @lilypond[quote,verbatim]
+ \markup {
+   \fill-line {
+     \line { William S. Gilbert }
+     \center-column {
+       \huge \smallCaps "The Mikado"
+       or
+       \smallCaps "The Town of Titipu"
+     }
+     \line { Sir Arthur Sullivan }
+   }
+ }
+ \markup {
+   \fill-line { 1885 }
+ }
+ @end lilypond
+ @funindex \wordwrap
+ @funindex \justify
+ @cindex ajuste de línea, texto con
+ @cindex justificado, texto
+ Las indicaciones de texto largas se pueden también ajustar
+ automáticamente según un ancho de línea dado.  Estarán alineados por
+ la izquierda o justificados, como se muestra en el ejemplo siguiente.
+ @lilypond[quote,verbatim]
+ \markup {
+   \column {
+     \line  \smallCaps { La vida breve }
+     \line \bold { Acto I }
+     \wordwrap \italic {
+       (La escena representa el corral de una casa de
+       gitanos en el Albaicín de Granada. Al fondo una
+       puerta por la que se ve el negro interior de
+       una Fragua, iluminado por los rojos resplandores
+       del fuego.)
+     }
+     \hspace #0
+     \line \bold { Acto II }
+     \override #'(line-width . 50)
+     \justify \italic {
+       (Calle de Granada. Fachada de la casa de Carmela
+       y su hermano Manuel con grandes ventanas abiertas
+       a través de las que se ve el patio
+       donde se celebra una alegre fiesta.)
+     }
+   }
+ }
+ @end lilypond
+ Hay una lista exhaustiva de instrucciones de alineación de texto en
+ @ref{Align}.
+ @seealso
+ Manual de aprendizaje:
+ @rlearning{Moving objects}.
+ Referencia de la notación:
+ @ref{Align},
+ @ref{Text marks}.
+ Fragmentos de código:
+ @rlsr{Text}.
+ Referencia de funcionamiento interno:
+ @rinternals{TextScript}.
+ Archivos de inicio:
+ @file{scm/@/define@/-markup@/-commands@/.scm}.
  
  @node Graphic notation inside markup
 -@subsubsection Graphic notation inside markup
 +@unnumberedsubsubsec Graphic notation inside markup
  
- @untranslated
+ @cindex gráficos, insertar
+ @cindex dibujar objetos gráficos
+ Se puede añadir diversos objetos gráficos a una partitura, utilizando
+ instrucciones de marcado específicas.
+ @funindex \box
+ @funindex \circle
+ @funindex \rounded-box
+ @funindex \bracket
+ @funindex \hbracket
+ @cindex decorar texto
+ @cindex enmarcar texto
+ Ciertas instrucciones de marcado permiten decorar los elementos de
+ texto con gráficos, como se muestra en el ejemplo siguiente.
+ @lilypond[quote,verbatim]
+ \markup \fill-line {
+   \center-column {
+     \circle Jack
+     \box "in the box"
+     \null
+     \line {
+       Erik Satie
+       \hspace #3
+       \bracket "1866 - 1925"
+     }
+     \null
+     \rounded-box \bold Prelude
+   }
+ }
+ @end lilypond
+ @funindex \pad-markup
+ @funindex \pad-x
+ @funindex \pad-to-box
+ @funindex \pad-around
+ @cindex relleno alrededor del texto
+ @cindex texto, relleno de
+ Algunas instrucciones pueden requerir que se aumente el relleno
+ alrededor del texto: esto se puede conseguir con algunas instrucciones
+ específicas descritas exhaustivamente en @ref{Align}.
+ @lilypond[quote,verbatim]
+ \markup \fill-line {
+   \center-column {
+     \box "Charles Ives (1874 - 1954)"
+     \null
+     \box \pad-markup #2 "THE UNANSWERED QUESTION"
+     \box \pad-x #8 "A Cosmic Landscape"
+     \null
+   }
+ }
+ \markup \column {
+   \line {
+     \hspace #10
+     \box \pad-to-box #'(-5 . 20) #'(0 . 5)
+       \bold "Largo to Presto"
+   }
+   \pad-around #3
+       "String quartet keeps very even time,
+ Flute quartet keeps very uneven time."
+ }
+ @end lilypond
+ @funindex \combine
+ @funindex \draw-circle
+ @funindex \filled-box
+ @funindex \triangle
+ @funindex \draw-line
+ @funindex \arrow-head
+ @cindex gráfica, notación
+ @cindex símbolos no musicales
+ Se pueden imprimir otros símbolos o elementos gráficos sin que se
+ requiera ningún otro texto.  De igual manera que en el caso de las
+ expresiones de marcado, dichos objetos se pueden combinar entre sí:
+ @lilypond[quote,verbatim]
+ \markup {
+   \combine
+     \draw-circle #4 #0.4 ##f
+     \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
+   \hspace #5
+   \center-column {
+     \triangle ##t
+     \combine
+       \draw-line #'(0 . 4)
+       \arrow-head #Y #DOWN ##f
+   }
+ }
+ @end lilypond
+ @funindex \epsfile
+ @funindex \postscript
+ @cindex insertar gráficos
+ @cindex imágenes, insertar
+ @cindex gráficos, insertar
+ @cindex PostScript
+ Entre las funcionalidades gráficas avanzadas se encuentran la
+ posibilidad de incluir archivos de imagen externos convertidos al
+ formato de PostScript Encapsulado (@emph{eps}), y la inclusión directa
+ de gráficos dentro del archivo de entrada, usando código PostScript
+ nativo.  En tal caso puede ser de utilidad la especificación explícita
+ del tamaño del dibujo, como se ejemplifica a continuación:
+ @lilypond[quote,verbatim,fragment,relative=1]
+ c1^\markup {
+   \combine
+     \epsfile #X #10 #"./context-example.eps"
+     \with-dimensions #'(0 . 6) #'(0 . 10)
+     \postscript #"
+       -2 3 translate
+       2.7 2 scale
+       newpath
+       2 -1 moveto
+       4 -2 4 1 1 arct
+       4 2 3 3 1 arct
+       0 4 0 3 1 arct
+       0 0 1 -1 1 arct
+       closepath
+       stroke"
+   }
+ c
+ @end lilypond
+ Hay una lista exhaustiva de instrucciones específicas de gráficos en
+ @ref{Graphic}.
+ @seealso
+ Referencia de la notación:
+ @ref{Graphic},
+ @ref{Editorial annotations}.
+ Fragmentos de código:
+ @rlsr{Text}.
+ Referencia de funcionamiento interno:
+ @rinternals{TextScript}.
+ Archivos de inicio:
+ @file{scm/@/define@/-markup@/-commands@/.scm},
+ @file{scm/@/stencil@/.scm}.
  
  @node Music notation inside markup
 -@subsubsection Music notation inside markup
 +@unnumberedsubsubsec Music notation inside markup
  
- @untranslated
+ Se pueden añadir a la partitura diversos elementos de notación
+ musical, dentro de un objeto de marcado.
+ Las notas y las alteraciones se pueden escribir utilizando
+ instrucciones específicas:
+ @lilypond[quote,verbatim,fragment,relative=2]
+ a2 a^\markup {
+   \note #"4" #1
+   =
+   \note-by-number #1 #1 #1.5
+ }
+ b1_\markup {
+   \natural \semiflat \flat
+   \sesquiflat \doubleflat
+ }
+ \glissando
+ a1_\markup {
+   \natural \semisharp \sharp
+   \sesquisharp \doublesharp
+ }
+ \glissando b
+ @end lilypond
+ Otros objetos de notación se pueden también imprimir en el modo de
+ marcado:
+ @lilypond[quote,verbatim,fragment,relative=1]
+ g1 bes
+ ees-\markup {
+   \finger 4
+   \tied-lyric #"~"
+   \finger 1
+ }
+ fis_\markup { \dynamic rf }
+ bes^\markup {
+   \beam #8 #0.1 #0.5
+ }
+ cis
+ d-\markup {
+   \markalphabet #8
+   \markletter #8
+ }
+ @end lilypond
+ De forma más general, cualquier símbolo musical disponible se puede
+ incluir por separado dentro de un objeto de marcado, como se
+ ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
+ y sus nombres en @ref{The Feta font}.
+ @lilypond[quote,verbatim,fragment,relative=2]
+ c2
+ c'^\markup { \musicglyph #"eight" }
+ c,4
+ c,8._\markup { \musicglyph #"clefs.G_change" }
+ c16
+ c2^\markup { \musicglyph #"timesig.neomensural94" }
+ @end lilypond
+ @c TODO: add \lookup here? -vv
+ @noindent
+ Otra forma de imprimir glifos que no son de texto se encuentra
+ descrita en @ref{Fonts explained}.
+ El modo de marcado también contempla diagramas para instrumentos
+ específicos:
+ @lilypond[quote,verbatim,fragment,relative=2]
+ c1^\markup {
+   \fret-diagram-terse #"x;x;o;2;3;2;"
+ }
+ c^\markup {
+   \harp-pedal #"^-v|--ov^"
+ }
+ c
+ c^\markup {
+   \combine
+     \musicglyph #"accordion.accDiscant"
+     \combine
+       \raise #0.5 \musicglyph #"accordion.accDot"
+       \raise #1.5 \musicglyph #"accordion.accDot"
+ }
+ @end lilypond
+ @c The accordion diagram is actually taken from a snippet.
+ @noindent
+ Dichos diagramas se encuentran documentados es @ref{Instrument
+ Specific Markup}.
+ Incluso una partitura completa se puede incluir dentro de un objeto de
+ marcado.  En tal caso, el bloque anidado @code{\score} debe contener
+ un bloque @code{\layout}, como se muestra aquí:
+ @lilypond[quote,verbatim,fragment,relative=1]
+ c4 d^\markup {
+   \score {
+     \relative { c4 d e f }
+     \layout { }
+   }
+ }
+ e f |
+ c d e f
+ @end lilypond
+ Hay una lista exhaustiva de instrucciones relacionadas con la notación
+ musical en @ref{Music}.
+ @seealso
+ Referencia de la notación:
+ @ref{Music},
+ @ref{The Feta font},
+ @ref{Fonts explained}.
+ Fragmentos de código:
+ @rlsr{Text}.
+ Referencia de funcionamiento interno:
+ @rinternals{TextScript}.
+ Archivos de inicio:
+ @file{scm/@/define@/-markup@/-commands@/.scm},
+ @file{scm/@/fret@/-diagrams@/.scm},
+ @file{scm/@/harp@/-pedals@/.scm}.
  
  @node Multi-page markup
 -@subsubsection Multi-page markup
 +@unnumberedsubsubsec Multi-page markup
  
- Así como @code{\markup} se utiliza para introducir un bloque de texto
- no divisible en líneas, se puede usar @code{\markuplines} en el nivel
- más alto del código para introducir líneas de texto que pueden abarcar
- varias páginas:
+ Aunque los objetos de marcado estándar no se pueden dividir, una
+ sintaxis específica permita introducir líneas de texto que pueden
+ repartirse sobre varias páginas:
  
- @verbatim
+ @c KEEP LY
+ @lilypond[quote,verbatim]
  \markuplines {
    \justified-lines {
      Un texto muy largo de líneas justificadas.
@@@ -520,130 -1211,194 +1211,191 @@@ Archivos de inicio
  @node Fonts
  @subsection Fonts
  
+ Esta sección presenta la forma en que se manejan las fuentes
+ tipográficas, y cómo se pueden cambiar en las partituras.
  @menu
- * Entire document fonts::       
- * Single entry fonts::          
+ * Fonts explained::
+ * Single entry fonts::
+ * Entire document fonts::
  @end menu
  
- @node Entire document fonts
- @unnumberedsubsubsec Entire document fonts
 +
- También es posible cambiar la familia predeterminada de la fuente
- tipográfica para todo el documento.  Se hace llamando a la función
- @code{make-pango-font-tree} desde dentro del bloque @code{\paper}.
- Esta función toma los nombres de las familias de fuente que se quieren
- usar para el texto en tipo romano, sans-serif y monoespaciado.  Por
- ejemplo:
+ @node Fonts explained
 -@subsubsection Fonts explained
++@unnumberedsubsubsec Fonts explained
  
- @cindex fuente, establecer la familia de
  @cindex Pango
+ @cindex fuentes tipográficas, explicación
+ @funindex font-interface
  
+ Las fuentes tipográficas se manejan a través de distintas bibliotecas.
+ FontConfig se utiliza para detectar las tipografías disponibles en el
+ sistema; las tipografías seleccionadas se trazan utilizando Pango.
+ Las tipografías de notación musical se pueden describir como un
+ conjunto de glifos específicos, ordenados en varias familias.  La
+ siguiente sintaxis permite usar directamente varias tipografías
+ @code{feta} de LilyPond distintas a las de texto en el modo de
+ marcado:
+ @lilypond[quote,verbatim,fragment,relative=2]
+ a1^\markup {
+   \vcenter {
+     \override #'(font-encoding . fetaBraces)
+     \lookup #"brace120"
+     \override #'(font-encoding . fetaNumber)
+     \column { 1 3 }
+     \override #'(font-encoding . fetaDynamic)
+     sf
+     \override #'(font-encoding . fetaMusic)
+     \lookup #"noteheads.s0petrucci"
+   }
+ }
+ @end lilypond
  
- @lilypond[verbatim]
- \paper  {
-   myStaffSize = #20
+ @noindent
+ Una sintaxis más simple pero más limitada se describe en @ref{Music
+ notation inside markup}.
+ Están disponibles tres familias de tipografías de texto: la tipografía
+ @emph{romana} (con serifa), que de forma predeterminada es New Century
+ Schoolbook, la fuente @emph{sans} y la fuente monoespaciada @emph{de
+ máquina de escribir}.  Estas dos últimas familias vienen determinadas
+ por la instalación de Pango.
+ Cada familia puede incluir distintas formas y series.  El ejemplo
+ siguiente muestra la posibilidad de seleccionar familias, formas,
+ series y tamaños alternativos:
+ @lilypond[quote,verbatim,fragment,relative=2]
+   \override Score.RehearsalMark #'font-family = #'typewriter
+   \mark \markup "Ouverture"
+   \key d \major
+   \override  Voice.TextScript #'font-shape = #'italic
+   \override  Voice.TextScript #'font-series = #'bold
+   d''2.^\markup "Allegro"
+   r4
+ @end lilypond
  
-   #(define fonts
-     (make-pango-font-tree "Times New Roman"
-                           "Nimbus Sans"
-                           "Luxi Mono"
-                            (/ myStaffSize 20)))
- }
+ @noindent
+ Se puede usar una sintaxis similar en el modo de marcado, aunque en
+ este caso es preferible usar la sintaxis sencilla que se explica en
+ @ref{Selecting font and font size}:
  
- {
-   c'^\markup { roman: foo \sans bla \typewriter bar }
+ @lilypond[quote,verbatim]
+ \markup {
+   \column {
+     \line {
+       \override #'(font-shape . italic)
+       \override #'(font-size . 4)
+       Idomeneo,
+     }
+     \line {
+       \override #'(font-family . typewriter)
+       {
+         \override #'(font-series . bold)
+         re
+         di
+       }
+       \override #'(font-family . sans)
+       Creta
+     }
+   }
  }
  @end lilypond
  
- @c we don't do Helvetica / Courier, since GS incorrectly loads
- @c Apple TTF fonts
+ @ignore
+ @c FIXME: This needs an example -vv
  
- @node Single entry fonts
- @unnumberedsubsubsec Single entry fonts
+ The size of the font may be set with the @code{font-size}
+ property.  The resulting size is taken relative to the
+ @code{text-font-size} as defined in the @code{\paper} block.
+ @end ignore
  
- @cindex fuente, selección
- @cindex fuente, ampliación
- @funindex font-interface
 -Aunque es fácil alternar entre las tipografías preconfiguradas,
 -también es posible usar otras, como se explica en las siguientes
 -secciones: @ref{Single entry fonts} y @ref{Entire document fonts}.
 -
+ @seealso
  
- Mediante el ajusta de las propiedades de objeto descritas a
- continuación, podemos elegir una fuente de entre las familias
- preconfiguradas.  LilyPond contempla de forma predeterminada las
- fuentes de música «Feta».  Las fuentes del texto se eligen a través de
- Pango/FontConfig.  La fuente de tipo serif predeterminada es New
- Century Schoolbook, y las fuentes de tipo sans y máquina de escribir a
- lo que tenga por predeterminado la instalación de Pango.
+ Referencia de la notación:
+ @ref{The Feta font},
+ @ref{Music notation inside markup},
+ @ref{Selecting font and font size},
+ @ref{Font}.
  
  
- @itemize
- @item @code{font-encoding}
- es un símbolo que establece la presentación de los glifos.  Sólo se
- debería ajustar para seleccionar distintos tipos de fuente que no sean
- para texto, p. ej.:
- @code{fetaBraces} para las llaves de los pentagramas de piano,
- @code{fetaMusic} es la fuente estándar para música, incluidos los
- glifos de la música antigua, @code{fetaDynamic} para los matices
- dinámicos y @code{fetaNumber} para los números.
- @item @code{font-family}
- es un símbolo que indica la clase general del tipo.  Están
- contempladas @code{roman} (Computer Modern), @code{sans} y
- @code{typewriter}.
- @item @code{font-shape}
- es un símbolo que indica la forma de la fuente.  Están disponibles
- normalmente varias formas de tipografía para cada una de las familas
- de fuente.  se puede elegir entre @code{italic} (cursiva), @code{caps}
- (versalitas) y @code{upright} (recta).
- @item @code{font-series}
- es un símbolo que indica la serie de la tipografía.  En general
- existen varias series de fuente para cada familia y forma de una
- tipografía.  Se puede elegir entre @code{medium} (normal) y
- @code{bold} (negrita).
+ @node Single entry fonts
 -@subsubsection Single entry fonts
++@unnumberedsubsubsec Single entry fonts
  
- @end itemize
+ Se puede usar en una partitura cualquier fuente tipográfica que esté
+ instalada en el sistema operativo y reconocida por parte de
+ FontConfig, usando la siguiente sintaxis:
  
- Las fuentes que se eligen de esta manera provienen de una hoja de
- estilos predefinida.  Si quiere usar una tipografía de fuera de la
- hoja de estilos establezca el valor de la propiedad @code{font-name}:
+ @lilypond[quote,verbatim,fragment,relative=1]
+ \override Staff.TimeSignature #'font-name = #"Charter"
+ \override Staff.TimeSignature #'font-size = #2
+ \time 3/4
  
- @lilypond[fragment,verbatim]
- {
-   \override Staff.TimeSignature #'font-name = #"Charter"
-   \override Staff.TimeSignature #'font-size = #2
-   \time 3/4
-   c'1_\markup {
-     \override #'(font-name . "Vera Bold")
-       { This text is in Vera Bold }
-   }
+ c1_\markup {
+   \override #'(font-name . "Vera Bold")
+     { Vera Bold }
  }
  @end lilypond
  
- @noindent
- Se puede usar cualquier fuente, en la medida en que esté disponible
para Pango/FontConfig.  Para obtener una lista completa de todas las
- fuentes dispoonibles, ejecute la instrucción
+ @funindex show-available-fonts
La instrucción siguiente presenta una lista de todas las tipografías
+ disponibles en el sistema operativo:
  
  @example
- lilypond -dshow-available-fonts blabla
+ lilypond -dshow-available-fonts x
  @end example
  
- (el último argumento puede ser blabla o cualquier otra cosa, pero debe
- estar presente).
+ @noindent
+ El último argumento de la instrucción puede ser cualquiera, pero debe
+ estar presente.
+ @seealso
+ Referencia de la notación:
+ @ref{Fonts explained},
+ @ref{Entire document fonts}.
+ Fragmentos de código:
+ @rlsr{Text}.
+ Archivos de inicio:
+ @file{lily/@/font@/-config@/-scheme@/.cc}.
+ @node Entire document fonts
 -@subsubsection Entire document fonts
++@unnumberedsubsubsec Entire document fonts
  
+ Se puede cambiar la familia predeterminada de la fuente tipográfica
+ para todo el documento.  En este caso se debe usar la siguiente
+ sintaxis, proporcionando tres familias de fuente que se usarán
+ respectivamente como tipografías @emph{romana}, @emph{sans-serif} y
+ @emph{monoespaciada}, como se explica en @ref{Fonts explained}.
  
- El tamaño de la fuente se puede ajustar con la propiedad
- @code{font-size}.  El tamaño que resulta se considera en relación al
- tamaño @code{text-font-size} tal y como está definido en el bloque
- @code{\paper}.
+ @cindex fuente, establecer la familia de
+ @funindex make-pango-font-tree
  
- @cindex fuente, tamaño de
- @cindex fuente, ampliación de la
+ @lilypond[verbatim,quote]
+ \paper  {
+   myStaffSize = #20
+   #(define fonts
+     (make-pango-font-tree "Times New Roman"
+                           "Nimbus Sans"
+                           "Luxi Mono"
+                            (/ myStaffSize 20)))
+ }
+ \relative c'{
+   c1-\markup {
+     roman,
+     \sans sans,
+     \typewriter typewriter. }
+ }
+ @end lilypond
+ @c we don't do Helvetica / Courier, since GS incorrectly loads
+ @c Apple TTF fonts
  
  @seealso