Documentation/es/user/editorial.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
   2 @c This file is included from notation.itely
   3 @ignore
   4     Translation of GIT committish: 0646758d26f727fc27fc13a87df2362388909e5d
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c \version "2.11.61"
  11
  12 @node Editorial annotations
  13 @section Editorial annotations
  14
  15 @lilypondfile[quote]{editorial-headword.ly}
  16
  17 Esta sección trata de las diversas maneras de modificar el aspecto de
  18 las notas y de aplicar énfasis analítico o educativo.
  19
  20 @menu
  21 * Inside the staff::
  22 * Outside the staff::
  23 @end menu
  24
  25
  26 @node Inside the staff
  27 @subsection Inside the staff
  28
  29 Esta sección trata sobre cómo aplicar énfasis a los elementos situados
  30 dentro del pentagrama.
  31
  32 @menu
  33 * Selecting notation font size::
  34 * Fingering instructions::
  35 * Hidden notes::
  36 * Coloring objects::
  37 * Parentheses::
  38 * Stems::
  39 @end menu
  40
  41 @node Selecting notation font size
  42 @unnumberedsubsubsec Selecting notation font size
  43
  44 @cindex fuente tipográfica (de notación), tamaño
  45 @cindex selección del tamaño de la fuente tipográfica (de notación)
  46 @cindex notación, tamaño de la fuente
  47 @cindex notas, cabezas de
  48 @funindex fontSize
  49 @funindex font-size
  50 @funindex magstep
  51 @funindex \huge
  52 @funindex \large
  53 @funindex \normalsize
  54 @funindex \small
  55 @funindex \tiny
  56 @funindex \teeny
  57 @funindex huge
  58 @funindex large
  59 @funindex normalsize
  60 @funindex small
  61 @funindex tiny
  62 @funindex teeny
  63
  64 Se puede alterar el tamaño de la fuente tipográfica de los elementos
  65 de notación.  Esto no cambia el tamaño de los símbolos variables, como
  66 las barras de corchea o las ligaduras.
  67
  68 @warning{Para los tamaños de tipografía del texto, consulte
  69 @ref{Selecting font and font size}.}
  70
  71 @lilypond[verbatim,quote,relative=2]
  72 \huge
  73 c4.-> d8---3
  74 \large
  75 c4.-> d8---3
  76 \normalsize
  77 c4.-> d8---3
  78 \small
  79 c4.-> d8---3
  80 \tiny
  81 c4.-> d8---3
  82 \teeny
  83 c4.-> d8---3
  84 @end lilypond
  85
  86 Internamente, esto establece un valor para la propiedad
  87 @code{fontSize}.  Esto, a su vez, hace que se establezca el valor de
  88 la propiedad @code{font-size} de todos los objetos de presentación.
  89 El valor de @code{font-size} es un número que indica el tamaño con
  90 relación al tamaño estándar para la altura vigente del pentagrama.
  91 Cada unidad hacia arriba es un incremento de un 12% del tamaño de la
  92 fuente, aproximadamente.  Seis unidades son exactamente un factor de
  93 dos.  La función de Scheme @code{magstep} convierte un número de
  94 tamaño @code{font-size} a un factor de escalado.  La propiedad
  95 @code{font-size} también se puede establecer directamente, de forma
  96 que queden afectados solamente determinados objetos gráficos.
  97
  98 @lilypond[verbatim,quote,relative=2]
  99 \set fontSize = #3
 100 c4.-> d8---3
 101 \override NoteHead #'font-size = #-4
 102 c4.-> d8---3
 103 \override Script #'font-size = #2
 104 c4.-> d8---3
 105 \override Stem #'font-size = #-5
 106 c4.-> d8---3
 107 @end lilypond
 108
 109 @cindex estándar, tamaño de la tipografía (de notación)
 110 @cindex fuente tipográfica (de notación), tamaño estándar de
 111 @funindex font-interface
 112 @funindex font-size
 113
 114 Los cambios en el tamaño de la fuente se obtienen por medio del
 115 escalado del tamaño del diseño que se encuentra más cerca del tamaño
 116 deseado.  El tamaño estándar para la tipografía (para @code{font-size
 117 = #0}), depende de la altura estándar del pentagrama.  Para un
 118 pentagrama de 20 puntos, se selecciona una fuente de 10 puntos.
 119
 120 La propiedad @code{font-size} sólo se puede establecer en objetos
 121 gráficos que utilicesn fuentes tipográficas.  Éstos son los que
 122 contemplan el interfaz de presentación @code{font-interface}.
 123
 124
 125 @predefined
 126 @funindex \teeny
 127 @code{\teeny} (enano),
 128 @funindex \tiny
 129 @code{\tiny} (muy pequeño),
 130 @funindex \small
 131 @code{\small} (pequeño),
 132 @funindex \normalsize
 133 @code{\normalsize} (normal),
 134 @funindex \large
 135 @code{\large} (grande),
 136 @funindex \huge
 137 @code{\huge} (enorme).
 138 @endpredefined
 139
 140
 141 @seealso
 142
 143 Fragmentos de código:
 144 @rlsr{Editorial annotations}.
 145
 146 Referencia de funcionamiento interno:
 147 @rinternals{font-interface}.
 148
 149
 150 @node Fingering instructions
 151 @unnumberedsubsubsec Fingering instructions
 152
 153 @cindex digitación
 154 @cindex cambio de dedo
 155 @funindex font-interface
 156 @funindex font-size
 157
 158 Las instrucciones de digitación se pueden introducir usando
 159 @var{nota}-@var{dígito}:
 160
 161 @lilypond[verbatim,quote,relative=2]
 162 c4-1 d-2 f-4 e-3
 163 @end lilypond
 164
 165 Para los cambios de dedo se pueden usar elementos de marcado de texto.
 166
 167 @lilypond[verbatim,quote,relative=2]
 168 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
 169 @end lilypond
 170
 171 @cindex thumb-script
 172 @funindex \thumb
 173 @funindex thumb
 174
 175 Puede usar la articulación de pulgar para indicar que una nota se debe
 176 tocar con el pulgar (p.ej. en música de cello).
 177
 178 @lilypond[verbatim,quote,relative=2]
 179 <a_\thumb a'-3>2 <b_\thumb b'-3>
 180 @end lilypond
 181
 182 @cindex digitación de acordes
 183 @cindex digitación, instrucciones de, para acordes
 184 @cindex acordes, digitación de
 185
 186 Las digitaciones para los acordes también se pueden añadir a las notas
 187 individuales del acorde escribiéndolas después de las alturas.
 188
 189 @lilypond[verbatim,quote,relative=2]
 190 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 191 @end lilypond
 192
 193 Las indicaciones de digitación se pueden situar manualmente encima o
 194 debajo del pentagrama, véase @ref{Direction
 195 and placement}.
 196
 197 @snippets
 198
 199 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 200 {controlling-the-placement-of-chord-fingerings.ly}
 201
 202 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 203 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 204
 205 @seealso
 206
 207 Referencia de la notación:
 208 @ref{Direction and placement}
 209
 210 Fragmentos de código:
 211 @rlsr{Editorial annotations}.
 212
 213 Referencia de funcionamiento interno:
 214 @rinternals{FingeringEvent},
 215 @rinternals{fingering-event},
 216 @rinternals{Fingering_engraver},
 217 @rinternals{New_fingering_engraver},
 218 @rinternals{Fingering}.
 219
 220
 221 @node Hidden notes
 222 @unnumberedsubsubsec Hidden notes
 223
 224 @cindex ocultas, notas
 225 @cindex invisibles, notas
 226 @cindex transparentes, notas
 227 @cindex notas ocultas
 228 @cindex notas invisibles
 229 @cindex notas transparentes
 230 @funindex \hideNotes
 231 @funindex hideNotes
 232 @funindex \unHideNotes
 233 @funindex unHideNotes
 234
 235 Las notas ocultas (o invisibles, o transparentes) pueden ser de
 236 utilidad en la preparación de ejercicios de teoría o de composición.
 237
 238 @lilypond[verbatim,quote,relative=2]
 239 c4 d
 240 \hideNotes
 241 e4 f
 242 \unHideNotes
 243 g a
 244 \hideNotes
 245 b
 246 \unHideNotes
 247 c
 248 @end lilypond
 249
 250 Los objetos de notación que están anclados a notas invisibles, son a
 251 pesar de ello visibles.
 252
 253 @lilypond[verbatim,quote,relative=2]
 254 c4( d)
 255 \hideNotes
 256 e4(\p f)--
 257 @end lilypond
 258
 259
 260 @predefined
 261 @code{\hideNotes},
 262 @code{\unHideNotes}.
 263 @endpredefined
 264
 265
 266 @seealso
 267
 268 Fragmentos de código:
 269 @rlsr{Editorial annotations}.
 270
 271 Referencia de funcionamiento interno:
 272 @rinternals{Note_spacing_engraver},
 273 @rinternals{NoteSpacing}.
 274
 275
 276 @node Coloring objects
 277 @unnumberedsubsubsec Coloring objects
 278
 279 @cindex coloreados, objetos
 280 @cindex colores
 281 @cindex colorear objects
 282 @cindex coloreadas, notas
 283 @cindex colorear notas
 284 @cindex notas coloreadas
 285 @cindex x11, color de
 286 @cindex x11-color
 287 @cindex colores de x11
 288 @cindex with-color
 289 @funindex color
 290 @funindex \with-color
 291 @funindex with-color
 292 @funindex x11-color
 293
 294 Se pueden asignar colores a los objetos individuales.  Los nombres de
 295 color válidos se encuentran relacionados en la @ref{List of colors}.
 296
 297 @lilypond[verbatim,quote,relative=2]
 298 \override NoteHead #'color = #red
 299 c4 c
 300 \override NoteHead #'color = #(x11-color 'LimeGreen)
 301 d
 302 \override Stem #'color = #blue
 303 e
 304 @end lilypond
 305
 306 Se puede acceder al espectro completo de colores definido para X11
 307 usando la función de Scheme x11-color.  Esta función acepta un único
 308 argumento; éste puede ser un símbolo de la forma @var{'FulanoMengano}
 309 o una cadena de la forma @var{"FulanoMengano"}.  La primera forma es
 310 más rápida de escribir y también más eficiente.  Sin embargo, al usar
 311 la segunda forma es posible acceder a los colores de X11 por medio de
 312 la forma del nombre que tiene varias palabras.
 313
 314 Si @code{x11-color} no entiende el parámetro, el color predeterminado
 315 que se devuelve es el negro.
 316
 317 @lilypond[verbatim,quote,relative=2]
 318 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 319 \set Staff.instrumentName = \markup {
 320   \with-color #(x11-color 'navy) "Clarinet"
 321 }
 322
 323 gis8 a
 324 \override Beam #'color = #(x11-color "medium turquoise")
 325 gis a
 326 \override Accidental #'color = #(x11-color 'DarkRed)
 327 gis a
 328 \override NoteHead #'color = #(x11-color "LimeGreen")
 329 gis a
 330 % this is deliberate nonsense; note that the stems remain black
 331 \override Stem #'color = #(x11-color 'Boggle)
 332 b2 cis
 333 @end lilypond
 334
 335 @cindex rgb-color
 336 @cindex color rgb
 337 @cindex rgb, color
 338 @funindex rgb-color
 339
 340 Se pueden especificar colores RGB exactos utilizando la función de
 341 Scheme @code{rgb-color}.
 342
 343 @lilypond[verbatim,quote,relative=2]
 344 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 345 \set Staff.instrumentName = \markup {
 346   \with-color #(x11-color 'navy) "Clarinet"
 347 }
 348
 349 \override Stem #'color = #(rgb-color 0 0 0)
 350 gis8 a
 351 \override Stem #'color = #(rgb-color 1 1 1)
 352 gis8 a
 353 \override Stem #'color = #(rgb-color 0 0 0.5)
 354 gis4 a
 355 @end lilypond
 356
 357 @seealso
 358
 359 Referencia de la notación:
 360 @ref{List of colors},
 361 @ref{The tweak command}.
 362
 363 Fragmentos de código:
 364 @rlsr{Editorial annotations}.
 365
 366 @cindex x11,  color de
 367 @cindex coloreadas, notas de acorde
 368 @cindex notas coloreadas en acordes
 369 @cindex color en acordes
 370 @funindex x11-color
 371
 372 @knownissues
 373 Un color de X11 no es necesariamente de la misma tonalidad exacta que
 374 un color normal de nombre similar.
 375
 376 No todos los colores de X11 se distinguen entre sí en un navegador
 377 web, es decir, un navegador de web podría no mostrar ninguna
 378 diferencia entre @code{'LimeGreen} (verde lima) y @code{'ForestGreen}
 379 (verde bosque).  Para la web se recomiendan los colores normales (o
 380 sea: @code{#blue}, azul, @code{#green}, verde, @code{#red}, rojo).
 381
 382 Las notas de un acorde no se pueden colorear con @code{\override}; en
 383 su lugar utilice @code{\tweak}.  Consulte @ref{The tweak command} para
 384 ver más detalles.
 385
 386
 387 @node Parentheses
 388 @unnumberedsubsubsec Parentheses
 389
 390 @cindex fantasma, notas
 391 @cindex notas fantasma
 392 @cindex notas entre paréntesis
 393 @cindex paréntesis
 394 @funindex \parenthesize
 395 @funindex parenthesize
 396
 397 Los objetos se pueden encerrar entre paréntesis anteponiendo
 398 @code{\parenthesize} al evento musical.  Si se aplica a un acorde,
 399 encierra cada nota dentro de un par de paréntesis.  También se pueden
 400 poner entre paréntesis las notas individuales de un acorde.
 401
 402 @lilypond[verbatim,quote,relative=2]
 403 c2 \parenthesize d
 404 c2 \parenthesize <c e g>
 405 c2 <c \parenthesize e g>
 406 @end lilypond
 407
 408 Los objetos que no son notas también se pueden poner entre paréntesis.
 409
 410 @lilypond[verbatim,quote,relative=2]
 411 c2-\parenthesize -. d
 412 c2 \parenthesize r
 413 @end lilypond
 414
 415 @seealso
 416
 417 Fragmentos de código:
 418 @rlsr{Editorial annotations}.
 419
 420 Referencia de funciionamiento interno:
 421 @rinternals{Parenthesis_engraver},
 422 @rinternals{ParenthesesItem},
 423 @rinternals{parentheses-interface}.
 424
 425 @knownissues
 426
 427 Al poner un acorde entre paréntesis, se encierra cada una de las notas
 428 individuales entre paréntesis, en vez de un solo paréntesis grande
 429 rodeando al acorde completo.
 430
 431 @node Stems
 432 @unnumberedsubsubsec Stems
 433
 434 @cindex plica
 435 @cindex plica invisible
 436 @cindex invisible, plica
 437
 438 Cuando se encuentra con una nota, se crea automáticamente un objeto
 439 @code{Stem} (plica).  Para las redondas y los silencios, también se
 440 crean pero se hacen invisibles.
 441
 442
 443 @predefined
 444 @funindex \stemUp
 445 @code{\stemUp},
 446 @funindex \stemDown
 447 @code{\stemDown},
 448 @funindex \stemNeutral
 449 @code{\stemNeutral}.
 450 @endpredefined
 451
 452
 453 @snippets
 454
 455 @cindex stem, direction
 456 @cindex stem, up
 457 @cindex stem, down
 458 @cindex stem, neutral
 459
 460 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 461 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 462
 463 @seealso
 464 Referencia de la notación:
 465 @ref{Direction and placement}.
 466
 467 Fragmentos de código:
 468 @rlsr{Editorial annotations}.
 469
 470 Referencia de funcionamiento interno:
 471 @rinternals{Stem_engraver},
 472 @rinternals{Stem},
 473 @rinternals{stem-interface}.
 474
 475
 476 @node Outside the staff
 477 @subsection Outside the staff
 478
 479 Esta sección trata sobre cómo enfatizar elementos que están dentro del
 480 pentagrama, desde fuera del pentagrama.
 481
 482 @menu
 483 * Balloon help::
 484 * Grid lines::
 485 * Analysis brackets::
 486 @end menu
 487
 488 @node Balloon help
 489 @unnumberedsubsubsec Balloon help
 490
 491 @cindex globo
 492 @cindex notación, explicación de
 493 @cindex globo de ayuda
 494 @cindex ayuda, globos de
 495 @funindex \balloonGrobText
 496 @funindex \balloonText
 497 @funindex Balloon_engraver
 498 @funindex balloonGrobText
 499 @funindex balloonText
 500
 501 Los elementos de notación se pueden marcar y nombrar con la ayuda de
 502 un cartel o globo de ayuda rectangular.  El propósito principal de
 503 esta funcionalidad es la explicación de la notación.
 504
 505 @c KEEP LY
 506 @lilypond[verbatim,quote,relative=2]
 507 \new Voice \with { \consists "Balloon_engraver" }
 508 {
 509   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
 510   a8
 511   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
 512   r
 513   <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
 514 }
 515 @end lilypond
 516
 517 Existen dos funciones musicales, @code{balloonGrobText} y
 518 @code{balloonText}; el primero se usa como @code{\once\override} para
 519 adjuntar un texto a cualquier grob, y el último se usa coqmo
 520 @code{\tweak}, normalmente dentro de acordes, para adjuntar un texto a
 521 una nota individual.
 522
 523 Los textos de globo normalmente influyen en el espaciado de las notas,
 524 pero esto puede cambiarse:
 525
 526 @c KEEP LY
 527 @lilypond[verbatim,quote,relative=2]
 528 \new Voice \with { \consists "Balloon_engraver" }
 529 {
 530   \balloonLengthOff
 531   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
 532   a8
 533   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
 534   r
 535   \balloonLengthOn
 536   <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
 537 }
 538 @end lilypond
 539
 540
 541 @predefined
 542 @funindex balloonLengthOn
 543 @funindex balloonLengthOff
 544 @code{\balloonLengthOn},
 545 @funindex \balloonLengthOn
 546 @funindex \balloonLengthOff
 547 @code{\balloonLengthOff}.
 548 @endpredefined
 549
 550
 551 @seealso
 552
 553 Fragmentos de código:
 554 @rlsr{Editorial annotations}.
 555
 556 Referencia de funcionamiento interno:
 557 @rinternals{Balloon_engraver},
 558 @rinternals{BalloonTextItem},
 559 @rinternals{balloon-interface}.
 560
 561
 562 @node Grid lines
 563 @unnumberedsubsubsec Grid lines
 564
 565 @cindex rejilla, líneas de
 566 @cindex líneas de rejilla
 567 @cindex vertical, línea, entre pentagramas
 568 @cindex línea vertical entre pentagramas
 569 @funindex Grid_point_engraver
 570 @funindex Grid_line_span_engraver
 571 @funindex gridInterval
 572
 573 Se pueden dibujar líneas verticales entre los pentagramas
 574 sincronizadas con las notas.
 575
 576 Se debe usar el grabador @code{Grid_point_engraver} para crear los
 577 puntos extremos de las líneas, mientras que el grabador
 578 @code{Grid_line_span_engraver} se debe utilizar para trazar
 579 efectivamente las líneas.  De forma predeterminada, esto centra las
 580 líneas de rejilla horizontalmente debajo y al lado izquierdo de la
 581 cabeza de las notas.  Las líneas de rejilla se extienden a partir de
 582 línea media de los pentagramas.  El intervalo @code{gridInterval} debe
 583 especificar la duración entre las líneas de rejilla.
 584
 585 @lilypond[verbatim,quote]
 586 \layout {
 587   \context {
 588     \Staff
 589     \consists "Grid_point_engraver"
 590     gridInterval = #(ly:make-moment 1 4)
 591   }
 592   \context {
 593     \Score
 594     \consists "Grid_line_span_engraver"
 595   }
 596 }
 597
 598 \score {
 599   \new ChoirStaff <<
 600     \new Staff \relative c'' {
 601       \stemUp
 602       c4. d8 e8 f g4
 603     }
 604     \new Staff \relative c {
 605       \clef bass
 606       \stemDown
 607       c4 g' f e
 608     }
 609   >>
 610 }
 611 @end lilypond
 612
 613 @snippets
 614
 615 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 616 {grid-lines--changing-their-appearance.ly}
 617
 618
 619 @seealso
 620
 621 Fragmentos de código:
 622 @rlsr{Editorial annotations}.
 623
 624 Referencia de funcionamiento interno:
 625 @rinternals{Grid_line_span_engraver},
 626 @rinternals{Grid_point_engraver},
 627 @rinternals{GridLine},
 628 @rinternals{GridPoint},
 629 @rinternals{grid-line-interface},
 630 @rinternals{grid-point-interface}.
 631
 632
 633 @node Analysis brackets
 634 @unnumberedsubsubsec Analysis brackets
 635
 636 @cindex corchetes
 637 @cindex fraseo, corchetes de
 638 @cindex corchetes de fraseo
 639 @cindex musicológico, análisis
 640 @cindex notas, corchetes de agrupación de
 641 @cindex horizontal, corchete
 642 @cindex corchete horizontal
 643 @funindex Horizontal_bracket_engraver
 644 @funindex \startGroup
 645 @funindex startGroup
 646 @funindex \stopGroup
 647 @funindex stopGroup
 648
 649 Los corchetes se usan en análisis musical para indicar la estructura
 650 de las piezas musicales.  Están contemplados los corchetes
 651 horizontales simples.
 652
 653 @lilypond[verbatim,quote]
 654 \layout {
 655   \context {
 656     \Voice
 657     \consists "Horizontal_bracket_engraver"
 658   }
 659 }
 660 \relative c'' {
 661   c2\startGroup
 662   d\stopGroup
 663 }
 664 @end lilypond
 665
 666 Los corchetes de análisis se pueden anidar.
 667
 668 @lilypond[verbatim,quote]
 669 \layout {
 670   \context {
 671     \Voice
 672     \consists "Horizontal_bracket_engraver"
 673   }
 674 }
 675 \relative c'' {
 676   c4\startGroup\startGroup
 677   d4\stopGroup
 678   e4\startGroup
 679   d4\stopGroup\stopGroup
 680 }
 681 @end lilypond
 682
 683 @seealso
 684
 685 Fragmentos de código:
 686 @rlsr{Editorial annotations}.
 687
 688 Referencia de funcionamiento interno:
 689 @rinternals{Horizontal_bracket_engraver},
 690 @rinternals{HorizontalBracket},
 691 @rinternals{horizontal-bracket-interface},
 692 @rinternals{Staff}.