From: Francisco Vila <francisco.vila@hispalinux.es>
Date: Thu, 9 Oct 2008 09:13:18 +0000 (+0200)
Subject: Doc-es: Update of Percussion.
X-Git-Tag: release/2.11.62-1~7^2^2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=fd89ccc1a51506ce85f918ec56cd68856f72127c;p=lilypond.git

Doc-es: Update of Percussion.
---

diff --git a/Documentation/es/user/percussion.itely b/Documentation/es/user/percussion.itely
index dda41290ef..40094d28aa 100644
--- a/Documentation/es/user/percussion.itely
+++ b/Documentation/es/user/percussion.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 223846f933f47587fd0403e1a75cc1776990a785
+    Translation of GIT committish: 2881ea603b63e4e335dc1104b0c22c71f373b20d
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -19,20 +19,45 @@
 @node Common notation for percussion
 @subsection Common notation for percussion
 
-La notación rítmica se emplea primordialmente para la percusión y la batería, pero también
-se puede utilizar para mostrar los valores rítmicos una melodía.
+La notación rítmica se emplea primordialmente para la percusión y la
+batería, pero también se puede utilizar para mostrar los valores
+rítmicos una melodía.
 
 @menu
 * References for percussion::
 * Basic percussion notation::
+* Drum rolls::
+* Pitched percussion::
 * Percussion staves::
+* Custom percussion staves::
 * Ghost notes::
 @end menu
 
 @node References for percussion
 @unnumberedsubsubsec References for percussion
 
-@untranslated
+@itemize
+
+@item
+La notación de algunas percusiones se puede hacer sobre una pauta de
+ritmo; esto se estudia en @ref{Showing melody rhythms} y
+@ref{Instantiating new staves}.
+
+@item
+La salida MIDI se trata en una sección aparte; véase @ref{Percussion
+in MIDI}.
+
+@end itemize
+
+@seealso
+
+Referencia de la notación:
+@ref{Showing melody rhythms},
+@ref{Instantiating new staves}.
+@ref{Percussion in MIDI}.
+
+Fragmentos de código:
+@rlsr{Percussion}.
 
 
 @node Basic percussion notation
@@ -41,34 +66,57 @@ se puede utilizar para mostrar los valores rítmicos una melodía.
 @cindex percusión
 @cindex batería
 
-
 Las notas de percusión se pueden escribir en el modo @code{\drummode},
-que es similar al modo estándar para introducir notas.  Cada elemento
-de un set de percusión lleva un nombre completo y un nombre abreviado,
-y los dos se pueden usar en la entrada.  La manera más fácil de
-escribir notas de percusión es utilizar la instrucción @code{\drums},
-que crea el contexto y el modo de entrada apropiados para percusión:
+que es similar al modo estándar para introducir notas.  La manera más
+fácil de escribir notas de percusión es utilizar la instrucción
+@code{\drums}, que crea el contexto y el modo de entrada apropiados
+para percusión:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[quote,verbatim]
 \drums {
-  hihat hh bassdrum bd
+  hihat4 hh bassdrum bd
 }
 @end lilypond
 
 Esto es una abreviatura de
 
-@lilypond[quote,ragged-right,verbatim]
-\new DrumStaff
-\drummode {
-  hihat hh bassdrum bd
+@lilypond[quote,verbatim]
+\new DrumStaff {
+  \drummode {
+    hihat4 hh bassdrum bd
+  }
 }
 @end lilypond
 
+Cada elemento de un set de percusión lleva un nombre completo y un
+nombre abreviado, y los dos se pueden usar en la entrada.  La lista
+completa de nombre de instrumentos de percusión se encuentra en
+@ref{Percussion notes}.
+
+Observe que la notación normal de las notas con altura determinada
+(como @code{cis4}) en un contexto @code{DrumStaff} procuden un mensaje
+de error.  Las claves de percusión se añaden automáticamente al
+contexto @code{DrumStaff}, pero también se pueden usar otras claves.
+
+Hay ciertos detalles respecto a cómo está contemplado el MIDI para los
+instrumentos de percusión; para ver los detalles consulte
+@ref{Percussion in MIDI}.
 
+@seealso
+
+Referencia de la notación:
+@ref{Percussion in MIDI},
+@ref{Percussion notes}.
 
-La lista completa de nombre de instrumentos de percusión se encuentra en el archivo de inicio
+Archivos de inicio:
 @file{ly/@/drumpitch@/-init@/.ly}.
-@c TODO: properly document this.
+
+Fragmentos de código:
+@rlsr{Percussion}.
+
+
+@node Drum rolls
+@unnumberedsubsubsec Drum rolls
 
 Los redobles se indican mediante tres barras cruzadas en la plica.
 Para las negras o notas más largas, las tres barras se muestran
@@ -79,14 +127,13 @@ normales.  Esto se consigue mediante la notación de trémolo,
 @code{:32}, véase @ref{Tremolo repeats}.  He aquí un ejemplo de
 redobles de caja:
 
-@lilypond[quote,ragged-right,verbatim]
-\new DrumStaff
-\drummode {
+@lilypond[quote,verbatim]
+\drums {
   \time 2/4
-  sn16 sn8 sn16 sn8 sn8:32~ |
-  sn8 sn8 sn4:32~ |
-  sn4 sn8 sn16 sn16 |
-  sn4 r4 |
+  sn16 sn8 sn16 sn8 sn8:32 ~
+  sn8 sn8 sn4:32 ~
+  sn4 sn8 sn16 sn16
+  sn4 r4
 }
 @end lilypond
 
@@ -95,65 +142,95 @@ Los golpes de baqueta se pueden indicar mediante la colocación de
 @code{staff-padding} se puede sobreescribir para conseguir una línea
 de base satisfactoria.
 
-@c TODO Add example of sticking
+@lilypond[quote,verbatim]
+\drums {
+  \repeat unfold 2 {
+    sn16 ^"L" sn^"R" sn^"L" sn^"L" sn^"R" sn^"L"  sn^"R" sn^"R"
+  }
+}
+@end lilypond
 
 @seealso
 
-Referencia del programa:
-@rinternals{note-event}.
+Fragmentos de código:
+@rlsr{Percussion}.
+
+
+@node Pitched percussion
+@unnumberedsubsubsec Pitched percussion
+
+Ciertos instrumentos de percusión de altura determinada (p.ej.: el
+xilófono, el vibráfono y los timbales) se escriben usando pentagramas
+normales.  Esto se estudia en otras secciones del manual.
+
+@seealso
+
+@c TODO: possibly link to an alternate section of NR 3.5, if
+@c "percussion in MIDI" gets a separate subsubsection for
+@c pitched percussion sounds.  -gp
+
+Referencia de la notación:
+@ref{Percussion in MIDI}.
+
+Fragmentos de código:
+@rlsr{Percussion}.
+
 
 @node Percussion staves
 @unnumberedsubsubsec Percussion staves
+
 @cindex percusión
 @cindex batería
 
 Una parte de percusión para más de un instrumento, normalmente utiliza
 una pauta de varias líneas donde cada posición dentro de la pauta se
-refiere a un elemento de percusión.
-
-
-Para tipografiar la música, se deben interpretar las notas dentro de
-los contextos @rinternals{DrumStaff} y @rinternals{DrumVoice}
+refiere a un elemento de percusión.  Para tipografiar la música, se
+deben interpretar las notas dentro de los contextos
+@rinternals{DrumStaff} y @rinternals{DrumVoice}.
 
-@lilypond[quote,ragged-right,verbatim]
-up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
-down = \drummode { bassdrum4 snare8 bd r bd sn4 }
-  \new DrumStaff <<
-    \new DrumVoice { \voiceOne \up }
-    \new DrumVoice { \voiceTwo \down }
-  >>
+@lilypond[quote,verbatim]
+up = \drummode {
+  crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat
+}
+down = \drummode {
+  bassdrum4 snare8 bd r bd sn4
+}
+\new DrumStaff <<
+  \new DrumVoice { \voiceOne \up }
+  \new DrumVoice { \voiceTwo \down }
+>>
 @end lilypond
 
 El ejemplo anterior muestra una notación polifónica prolija.  La
 notación polifónica abreviada, descrita en @rlearning{I'm hearing
-Voices}, también se puede usar si las @rinternals{DrumVoice}s se
-instancian primero a mano.  Por ejemplo,
+Voices}, también se puede usar si las voces se instancian primero a
+mano.  Por ejemplo,
 
-@lilypond[quote,ragged-right,fragment,verbatim]
+@lilypond[quote,verbatim]
 \new DrumStaff <<
-  \new DrumVoice = "1" { s1 *2 }
-  \new DrumVoice = "2" { s1 *2 }
+  \new DrumVoice = "1" { s1*2 }
+  \new DrumVoice = "2" { s1*2 }
   \drummode {
     bd4 sn4 bd4 sn4
-    <<
-      { \repeat unfold 16 hh16 }
-      \\
-      { bd4 sn4 bd4 sn4 }
-    >>
+    << {
+      \repeat unfold 16 hh16
+    } \\ {
+      bd4 sn4 bd4 sn4
+    } >>
   }
 >>
 @end lilypond
 
-
 También existen otras posibilidades en lo referente a la disposición.
 Para usarlas, establezca la propiedad @code{drumStyleTable} en el
 contexto @rinternals{DrumVoice}.  Se han predefinido las siguientes
 variables:
 
 @table @code
+
 @item drums-style
 Es la opción por defecto.  Tipografía un típico set de percusión sobre
-una pauta de cinco líneas
+pentagrama:
 
 @lilypond[quote,line-width=10.0\cm]
 nam = \lyricmode {
@@ -267,7 +344,7 @@ mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
 
 @item percussion-style
 Para tipografiar toda clase de percusiones simples sobre pautas de una
-línea.
+línea:
 
 @lilypond[quote,ragged-right]
 nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
@@ -290,10 +367,14 @@ mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
 @end lilypond
 @end table
 
+
+@node Custom percussion staves
+@unnumberedsubsubsec Custom percussion staves
+
 Si no le gusta ninguna de las listas predefinidas, puede definir su
 propia lista al principio de su archivo
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[quote,verbatim]
 #(define mydrums '(
          (bassdrum     default   #f         -1)
          (snare        default   #f         0)
@@ -310,22 +391,192 @@ down = \drummode { bd4 sn bd toml8 toml }
 >>
 @end lilypond
 
+@snippets
+
+@c FIXME: MOVE ALL THESE TO LSR!  -gp
+
+He aquí algunos ejemplos adicionales:
+
+Dos bloques de madera, escritos con wbh (@emph{woodblock-high}, bloque
+alto) y wbl (@emph{woodblock-low} bloque bajo)
+
+@lilypond[quote,verbatim]
+% These lines define the position of the woodblocks in the stave;
+% if you like, you can change it or you can use special note heads
+% for the woodblocks.
+#(define mydrums '((hiwoodblock default #t  3)
+                   (lowoodblock default #t -2)))
+
+woodstaff = {
+  % This defines a staff with only two lines.
+  % It also defines the positions of the two lines.
+  \override Staff.StaffSymbol #'line-positions = #'(-2 3)
+
+  % This is neccessary; if not entered, the barline wuld be too short!
+  \override Staff.BarLine #'bar-size = #3
+}
+
+\new DrumStaff {
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+
+  % with this you load your new drum style table
+  \woodstaff
+
+  \drummode {
+    \time 2/4
+    wbl8 wbl16 wbl wbh8-> wbl |
+    wbl8 wbl16 wbh-> ~ wbh wbl16 r8 |
+  }
+}
+@end lilypond
+
+Observe que en este caso especial se debe alterar la longitud de la
+línea divisoria con @code{\override Staff.BarLine #'bar-size #number}.
+En caso contrario resulta demasiado corta.  También debe definir las
+posiciones de las dos líneas del pentagrama.  Para más información
+sobre estos delicados asuntos, consulte @ref{Staff symbol}.
+
+Una pandereta, escrita mediante @q{tamb} (@emph{tambourine}:
+
+@lilypond[quote,verbatim]
+tambustaff = {
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )
+  \override Staff.BarLine #'bar-size = #3
+  \set DrumStaff.instrumentName = "Tambourine"
+}
+
+\new DrumStaff {
+  \tambustaff
+  % broken
+  % \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+
+  \drummode {
+    \time 6/8
+    \repeat "unfold" 2 { tamb8. tamb16 tamb8 tamb tamb tamb | }
+    tamb4. tamb8 tamb tamb |
+    % the trick with the scaled duration and the shorter rest
+    % is neccessary for the correct ending of the trill-span!
+    tamb2.*5/6 \startTrillSpan s8 \stopTrillSpan |
+  }
+}
+@end lilypond
+
+Música para gong, introducida con @q{tt} (tam-tam):
+
+@lilypond[quote,verbatim]
+#(define mydrums '((tamtam default #t 0)))
+
+tamtamstaff = {
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )
+  \override Staff.BarLine #'bar-size = #3
+  \set DrumStaff.instrumentName = "Tamtam"
+}
+
+\new DrumStaff {
+  \tamtamstaff
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+
+  \drummode {
+    tt 1 \pp \laissezVibrer
+  }
+}
+@end lilypond
+
+Dos campanas, introducidas con @q{cb} (@emph{cowbell}, cencerro) y
+@q{rb} (@emph{ridebell}, campana normal)
+
+@lilypond[quote,verbatim]
+#(define mydrums '((ridebell default #t  3)
+                   (cowbell  default #t -2)))
+
+bellstaff = {
+  \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3)
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+  \override Staff.BarLine #'bar-size = #3
+  \set DrumStaff.instrumentName = "Different Bells"
+}
+
+\new DrumStaff {
+  \bellstaff
+  \drummode {
+    \time 2/4
+    \repeat "unfold" 2 { rb8 rb cb cb16 rb-> ~ |
+                         rb16 rb8 rb16 cb8 cb | }
+  }
+}
+@end lilypond
+
+Aquí un breve ejemplo del maestro Stravinsky (procedende de la
+@q{Historia del soldado})
+
+@lilypond[quote,verbatim]
+#(define mydrums '((bassdrum   default #t  4)
+                   (snare      default #t -4)
+                   (tambourine default #t  0)))
+
+global = {
+  \time 3/8 s4.
+  \time 2/4 s2*2
+  \time 3/8 s4.
+  \time 2/4 s2
+}
+
+drumsA = {
+  \context DrumVoice <<
+    { \global }
+    { \drummode {
+        \autoBeamOff
+        \stemDown sn8 \stemUp tamb s8 |
+        sn4 \stemDown sn4 |
+        \stemUp tamb8 \stemDown sn8 \stemUp sn16 \stemDown sn \stemUp sn8 |
+        \stemDown sn8 \stemUp tamb s8 |
+        \stemUp sn4 s8 \stemUp tamb
+      }
+    }
+  >>
+}
+
+drumsB = {
+  \drummode {
+    s4 bd8 s2*2 s4 bd8 s4 bd8 s8
+  }
+}
+
+\layout {
+  indent = #40
+}
+
+\score {
+  \new StaffGroup <<
+    \new DrumStaff {
+      \set DrumStaff.instrumentName = \markup {
+        \column {
+          "Tambourine"
+          "et"
+          "caisse claire s. timbre"
+        }
+      }
+      \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+      \drumsA
+    }
+
+   \new DrumStaff {
+     \set DrumStaff.instrumentName = "Grosse Caisse"
+     \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+     \drumsB }
+  >>
+}
+@end lilypond
 
 @seealso
 
-Archivos de inicio:
-@file{ly/@/drumpitch@/-init@/.ly}.
+Fragmentos de código:
+@rlsr{Percussion}.
 
 Referencia de funcionamiento interno:
 @rinternals{DrumStaff},
 @rinternals{DrumVoice}.
 
-@knownissues
-
-A causa de que el estándar General MIDI no contiene golpes de aro (rim
-shot), para este propósito se usa el golpe lateral de baqueta
-(sidestick) en su lugar.
-
 
 @c FIXME: check name -gp
 @node Ghost notes
@@ -337,7 +588,6 @@ en @ref{Parentheses}.  Sin embargo, el modo por defecto
 @code{\drummode} no incluye el complemento grabador
 @code{Parenthesis_engraver} que permite esto.
 
-
 @lilypond[quote,ragged-right,verbatim,fragment]
 \new DrumStaff \with {
   \consists "Parenthesis_engraver"
@@ -348,8 +598,8 @@ en @ref{Parentheses}.  Sin embargo, el modo por defecto
     <<
       {
         hh8[ hh] <hh sn> hh16
-        < \parenthesize sn > hh < \parenthesize
-        sn > hh8 <hh sn> hh
+        < \parenthesize sn > hh
+        < \parenthesize sn > hh8 <hh sn> hh
       } \\ {
         bd4 r4 bd8 bd r8 bd
       }
@@ -362,4 +612,7 @@ en @ref{Parentheses}.  Sin embargo, el modo por defecto
 Observe, además, que debe añadir acordes (paréntesis en ángulo @code{<
 >}) alrededor de cada una de las instrucciones @code{\parenthesize}.
 
+@seealso
 
+Fragmentos de código:
+@rlsr{Percussion}.
diff --git a/Documentation/user/percussion.itely b/Documentation/user/percussion.itely
index 14f090c17a..ce45bd7f5e 100644
--- a/Documentation/user/percussion.itely
+++ b/Documentation/user/percussion.itely
@@ -12,7 +12,7 @@
 @section Percussion
 
 @menu
-* Common notation for percussion::  
+* Common notation for percussion::
 @end menu
 
 @node Common notation for percussion
@@ -22,13 +22,13 @@ Rhythmic music is primarily used for percussion and drum notation, but it can
 also be used to show the rhythms of melodies.
 
 @menu
-* References for percussion::   
-* Basic percussion notation::   
-* Drum rolls::                  
-* Pitched percussion::          
-* Percussion staves::           
-* Custom percussion staves::    
-* Ghost notes::                 
+* References for percussion::
+* Basic percussion notation::
+* Drum rolls::
+* Pitched percussion::
+* Percussion staves::
+* Custom percussion staves::
+* Ghost notes::
 @end menu
 
 @node References for percussion
@@ -147,7 +147,7 @@ Snippets: @rlsr{Percussion}.
 @unnumberedsubsubsec Pitched percussion
 
 Certain pitched percussion instruments (e.g. xylophone,
-vibraphone, and timpani) are written using with normal staffs.
+vibraphone, and timpani) are written using normal staves.
 This is covered in other sections of the manual.
 
 @seealso
@@ -396,12 +396,12 @@ woodstaff = {
   % This is neccessary; if not entered, the barline wuld be too short!
   \override Staff.BarLine #'bar-size = #3
 }
- 
+
 \new DrumStaff {
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 
   % with this you load your new drum style table
-  \woodstaff 
+  \woodstaff
 
   \drummode {
     \time 2/4
@@ -411,27 +411,25 @@ woodstaff = {
 }
 @end lilypond
 
-@seealso
-
 Note that in this special case the length of the barline must
 altered with @code{\override Staff.BarLine #'bar-size #number}.
-Otherwise it would be too short. And You have also to define the
-positions of the to stafflines.  For more information about these
+Otherwise it would be too short.  And you have also to define the
+positions of the two stafflines.  For more information about these
 delicate things have a look at @ref{Staff symbol}.
 
 A tambourine, entered with @q{tamb}:
 
 @lilypond[quote,verbatim]
 tambustaff = {
-  \override Staff.StaffSymbol #'line-positions = #'( 0 )   
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )
   \override Staff.BarLine #'bar-size = #3
   \set DrumStaff.instrumentName = "Tambourine"
 }
 
 \new DrumStaff {
-  \tambustaff 
+  \tambustaff
   % broken
-  % \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  % \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 
   \drummode {
     \time 6/8
@@ -442,7 +440,7 @@ tambustaff = {
     tamb2.*5/6 \startTrillSpan s8 \stopTrillSpan |
   }
 }
-@end lilypond 
+@end lilypond
 
 Music for Tam-Tam (entered with @q{tt}):
 
@@ -450,18 +448,18 @@ Music for Tam-Tam (entered with @q{tt}):
 #(define mydrums '((tamtam default #t 0)))
 
 tamtamstaff = {
-  \override Staff.StaffSymbol #'line-positions = #'( 0 )   
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )
   \override Staff.BarLine #'bar-size = #3
   \set DrumStaff.instrumentName = "Tamtam"
 }
 
 \new DrumStaff {
   \tamtamstaff
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 
   \drummode {
-    tt 1 \pp \laissezVibrer 
-  } 
+    tt 1 \pp \laissezVibrer
+  }
 }
 @end lilypond
 
@@ -472,12 +470,12 @@ Two different bells, entered with @q{cb} (cowbell) and @q{rb} (ridebell)
                    (cowbell  default #t -2)))
 
 bellstaff = {
-  \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3)  
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3)
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
   \override Staff.BarLine #'bar-size = #3
   \set DrumStaff.instrumentName = "Different Bells"
 }
- 
+
 \new DrumStaff {
   \bellstaff
   \drummode {
@@ -501,12 +499,12 @@ global = {
   \time 3/8 s4.
   \time 2/4 s2
 }
- 
+
 drumsA = {
   \context DrumVoice <<
     { \global }
     { \drummode {
-        \autoBeamOff 
+        \autoBeamOff
         \stemDown sn8 \stemUp tamb s8 |
         sn4 \stemDown sn4 |
         \stemUp tamb8 \stemDown sn8 \stemUp sn16 \stemDown sn \stemUp sn8 |
@@ -522,12 +520,12 @@ drumsB = {
     s4 bd8 s2*2 s4 bd8 s4 bd8 s8
   }
 }
- 
+
 \layout {
   indent = #40
-} 
+}
 
-\score { 
+\score {
   \new StaffGroup <<
     \new DrumStaff {
       \set DrumStaff.instrumentName = \markup {
@@ -539,13 +537,13 @@ drumsB = {
       }
       \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
       \drumsA
-    } 
+    }
 
    \new DrumStaff {
      \set DrumStaff.instrumentName = "Grosse Caisse"
      \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
      \drumsB }
-  >> 
+  >>
 }
 @end lilypond