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: 17d84cfa9ddb152b05d1e17ab72109fb4eefa684
   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 Fragmentos de código:
 143 @rlsr{Editorial annotations}.
 144
 145 Referencia de funcionamiento interno:
 146 @rinternals{font-interface}.
 147
 148
 149 @node Fingering instructions
 150 @unnumberedsubsubsec Fingering instructions
 151
 152 @cindex digitación
 153 @cindex cambio de dedo
 154 @funindex font-interface
 155 @funindex font-size
 156
 157 Las instrucciones de digitación se pueden introducir usando
 158 @var{nota}-@var{dígito}:
 159
 160 @lilypond[verbatim,quote,relative=2]
 161 c4-1 d-2 f-4 e-3
 162 @end lilypond
 163
 164 Para los cambios de dedo se pueden usar elementos de marcado de texto.
 165
 166 @lilypond[verbatim,quote,relative=2]
 167 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
 168 @end lilypond
 169
 170 @cindex thumb-script
 171 @funindex \thumb
 172 @funindex thumb
 173
 174 Puede usar la articulación de pulgar para indicar que una nota se debe
 175 tocar con el pulgar (p.ej. en música de cello).
 176
 177 @lilypond[verbatim,quote,relative=2]
 178 <a_\thumb a'-3>2 <b_\thumb b'-3>
 179 @end lilypond
 180
 181 @cindex digitación de acordes
 182 @cindex digitación, instrucciones de, para acordes
 183 @cindex acordes, digitación de
 184
 185 Las digitaciones para los acordes también se pueden añadir a las notas
 186 individuales del acorde escribiéndolas después de las alturas.
 187
 188 @lilypond[verbatim,quote,relative=2]
 189 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 190 @end lilypond
 191
 192 Las indicaciones de digitación se pueden situar manualmente encima o
 193 debajo del pentagrama, véase @ref{Direction
 194 and placement}.
 195
 196 @snippets
 197
 198 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 199 {controlling-the-placement-of-chord-fingerings.ly}
 200
 201 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 202 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 203
 204 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 205 {avoiding-collisions-of-chord-fingering-with-beams.ly}
 206
 207
 208 @seealso
 209 Referencia de la notación:
 210 @ref{Direction and placement}.
 211
 212 Fragmentos de código:
 213 @rlsr{Editorial annotations}.
 214
 215 Referencia de funcionamiento interno:
 216 @rinternals{FingeringEvent},
 217 @rinternals{fingering-event},
 218 @rinternals{Fingering_engraver},
 219 @rinternals{New_fingering_engraver},
 220 @rinternals{Fingering}.
 221
 222
 223 @node Hidden notes
 224 @unnumberedsubsubsec Hidden notes
 225
 226 @cindex ocultas, notas
 227 @cindex invisibles, notas
 228 @cindex transparentes, notas
 229 @cindex notas ocultas
 230 @cindex notas invisibles
 231 @cindex notas transparentes
 232 @funindex \hideNotes
 233 @funindex hideNotes
 234 @funindex \unHideNotes
 235 @funindex unHideNotes
 236
 237 Las notas ocultas (o invisibles, o transparentes) pueden ser de
 238 utilidad en la preparación de ejercicios de teoría o de composición.
 239
 240 @lilypond[verbatim,quote,relative=2]
 241 c4 d
 242 \hideNotes
 243 e4 f
 244 \unHideNotes
 245 g a
 246 \hideNotes
 247 b
 248 \unHideNotes
 249 c
 250 @end lilypond
 251
 252 Los objetos de notación que están anclados a notas invisibles, son a
 253 pesar de ello visibles.
 254
 255 @lilypond[verbatim,quote,relative=2]
 256 c4( d)
 257 \hideNotes
 258 e4(\p f)--
 259 @end lilypond
 260
 261
 262 @predefined
 263 @code{\hideNotes},
 264 @code{\unHideNotes}.
 265 @endpredefined
 266
 267
 268 @seealso
 269 Fragmentos de código:
 270 @rlsr{Editorial annotations}.
 271
 272 Referencia de funcionamiento interno:
 273 @rinternals{Note_spacing_engraver},
 274 @rinternals{NoteSpacing}.
 275
 276
 277 @node Coloring objects
 278 @unnumberedsubsubsec Coloring objects
 279
 280 @cindex coloreados, objetos
 281 @cindex colores
 282 @cindex colorear objects
 283 @cindex coloreadas, notas
 284 @cindex colorear notas
 285 @cindex notas coloreadas
 286 @cindex x11, color de
 287 @cindex x11-color
 288 @cindex colores de x11
 289 @cindex with-color
 290 @funindex color
 291 @funindex \with-color
 292 @funindex with-color
 293 @funindex x11-color
 294
 295 Se pueden asignar colores a los objetos individuales.  Los nombres de
 296 color válidos se encuentran relacionados en la @ref{List of colors}.
 297
 298 @lilypond[verbatim,quote,relative=2]
 299 \override NoteHead #'color = #red
 300 c4 c
 301 \override NoteHead #'color = #(x11-color 'LimeGreen)
 302 d
 303 \override Stem #'color = #blue
 304 e
 305 @end lilypond
 306
 307 Se puede acceder al espectro completo de colores definido para X11
 308 usando la función de Scheme x11-color.  Esta función acepta un único
 309 argumento; éste puede ser un símbolo de la forma @var{'FulanoMengano}
 310 o una cadena de la forma @var{"FulanoMengano"}.  La primera forma es
 311 más rápida de escribir y también más eficiente.  Sin embargo, al usar
 312 la segunda forma es posible acceder a los colores de X11 por medio de
 313 la forma del nombre que tiene varias palabras.
 314
 315 Si @code{x11-color} no entiende el parámetro, el color predeterminado
 316 que se devuelve es el negro.
 317
 318 @lilypond[verbatim,quote,relative=2]
 319 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 320 \set Staff.instrumentName = \markup {
 321   \with-color #(x11-color 'navy) "Clarinet"
 322 }
 323
 324 gis8 a
 325 \override Beam #'color = #(x11-color "medium turquoise")
 326 gis a
 327 \override Accidental #'color = #(x11-color 'DarkRed)
 328 gis a
 329 \override NoteHead #'color = #(x11-color "LimeGreen")
 330 gis a
 331 % this is deliberate nonsense; note that the stems remain black
 332 \override Stem #'color = #(x11-color 'Boggle)
 333 b2 cis
 334 @end lilypond
 335
 336 @cindex rgb-color
 337 @cindex color rgb
 338 @cindex rgb, color
 339 @funindex rgb-color
 340
 341 Se pueden especificar colores RGB exactos utilizando la función de
 342 Scheme @code{rgb-color}.
 343
 344 @lilypond[verbatim,quote,relative=2]
 345 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 346 \set Staff.instrumentName = \markup {
 347   \with-color #(x11-color 'navy) "Clarinet"
 348 }
 349
 350 \override Stem #'color = #(rgb-color 0 0 0)
 351 gis8 a
 352 \override Stem #'color = #(rgb-color 1 1 1)
 353 gis8 a
 354 \override Stem #'color = #(rgb-color 0 0 0.5)
 355 gis4 a
 356 @end lilypond
 357
 358
 359 @seealso
 360 Referencia de la notación:
 361 @ref{List of colors},
 362 @ref{The tweak command}.
 363
 364 Fragmentos de código:
 365 @rlsr{Editorial annotations}.
 366
 367
 368 @cindex x11,  color de
 369 @cindex coloreadas, notas de acorde
 370 @cindex notas coloreadas en acordes
 371 @cindex color en acordes
 372 @funindex x11-color
 373
 374 @knownissues
 375 Un color de X11 no es necesariamente de la misma tonalidad exacta que
 376 un color normal de nombre similar.
 377
 378 No todos los colores de X11 se distinguen entre sí en un navegador
 379 web, es decir, un navegador de web podría no mostrar ninguna
 380 diferencia entre @code{'LimeGreen} (verde lima) y @code{'ForestGreen}
 381 (verde bosque).  Para la web se recomiendan los colores normales (o
 382 sea: @code{#blue}, azul, @code{#green}, verde, @code{#red}, rojo).
 383
 384 Las notas de un acorde no se pueden colorear con @code{\override}; en
 385 su lugar utilice @code{\tweak}.  Consulte @ref{The tweak command} para
 386 ver más detalles.
 387
 388
 389 @node Parentheses
 390 @unnumberedsubsubsec Parentheses
 391
 392 @cindex fantasma, notas
 393 @cindex notas fantasma
 394 @cindex notas entre paréntesis
 395 @cindex paréntesis
 396 @funindex \parenthesize
 397 @funindex parenthesize
 398
 399 Los objetos se pueden encerrar entre paréntesis anteponiendo
 400 @code{\parenthesize} al evento musical.  Si se aplica a un acorde,
 401 encierra cada nota dentro de un par de paréntesis.  También se pueden
 402 poner entre paréntesis las notas individuales de un acorde.
 403
 404 @lilypond[verbatim,quote,relative=2]
 405 c2 \parenthesize d
 406 c2 \parenthesize <c e g>
 407 c2 <c \parenthesize e g>
 408 @end lilypond
 409
 410 Los objetos que no son notas también se pueden poner entre paréntesis.
 411
 412 @lilypond[verbatim,quote,relative=2]
 413 c2-\parenthesize -. d
 414 c2 \parenthesize r
 415 @end lilypond
 416
 417
 418 @seealso
 419 Fragmentos de código:
 420 @rlsr{Editorial annotations}.
 421
 422 Referencia de funciionamiento interno:
 423 @rinternals{Parenthesis_engraver},
 424 @rinternals{ParenthesesItem},
 425 @rinternals{parentheses-interface}.
 426
 427
 428 @knownissues
 429
 430 Al poner un acorde entre paréntesis, se encierra cada una de las notas
 431 individuales entre paréntesis, en vez de un solo paréntesis grande
 432 rodeando al acorde completo.
 433
 434 @node Stems
 435 @unnumberedsubsubsec Stems
 436
 437 @cindex plica
 438 @cindex plica invisible
 439 @cindex invisible, plica
 440
 441 Cuando se encuentra con una nota, se crea automáticamente un objeto
 442 @code{Stem} (plica).  Para las redondas y los silencios, también se
 443 crean pero se hacen invisibles.
 444
 445
 446 @predefined
 447 @funindex \stemUp
 448 @code{\stemUp},
 449 @funindex \stemDown
 450 @code{\stemDown},
 451 @funindex \stemNeutral
 452 @code{\stemNeutral}.
 453 @endpredefined
 454
 455
 456 @snippets
 457
 458 @cindex stem, direction
 459 @cindex stem, up
 460 @cindex stem, down
 461 @cindex stem, neutral
 462
 463 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 464 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 465
 466
 467 @seealso
 468 Referencia de la notación:
 469 @ref{Direction and placement}.
 470
 471 Fragmentos de código:
 472 @rlsr{Editorial annotations}.
 473
 474 Referencia de funcionamiento interno:
 475 @rinternals{Stem_engraver},
 476 @rinternals{Stem},
 477 @rinternals{stem-interface}.
 478
 479
 480 @node Outside the staff
 481 @subsection Outside the staff
 482
 483 Esta sección trata sobre cómo enfatizar elementos que están dentro del
 484 pentagrama, desde fuera del pentagrama.
 485
 486 @menu
 487 * Balloon help::
 488 * Grid lines::
 489 * Analysis brackets::
 490 @end menu
 491
 492 @node Balloon help
 493 @unnumberedsubsubsec Balloon help
 494
 495 @cindex globo
 496 @cindex notación, explicación de
 497 @cindex globo de ayuda
 498 @cindex ayuda, globos de
 499 @funindex \balloonGrobText
 500 @funindex \balloonText
 501 @funindex Balloon_engraver
 502 @funindex balloonGrobText
 503 @funindex balloonText
 504
 505 Los elementos de notación se pueden marcar y nombrar con la ayuda de
 506 un cartel o globo de ayuda rectangular.  El propósito principal de
 507 esta funcionalidad es la explicación de la notación.
 508
 509 @c KEEP LY
 510 @lilypond[verbatim,quote,relative=2]
 511 \new Voice \with { \consists "Balloon_engraver" }
 512 {
 513   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
 514   a8
 515   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
 516   r
 517   <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
 518 }
 519 @end lilypond
 520
 521 Existen dos funciones musicales, @code{balloonGrobText} y
 522 @code{balloonText}; el primero se usa como @code{\once\override} para
 523 adjuntar un texto a cualquier grob, y el último se usa coqmo
 524 @code{\tweak}, normalmente dentro de acordes, para adjuntar un texto a
 525 una nota individual.
 526
 527 Los textos de globo normalmente influyen en el espaciado de las notas,
 528 pero esto puede cambiarse:
 529
 530 @c KEEP LY
 531 @lilypond[verbatim,quote,relative=2]
 532 \new Voice \with { \consists "Balloon_engraver" }
 533 {
 534   \balloonLengthOff
 535   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
 536   a8
 537   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
 538   r
 539   \balloonLengthOn
 540   <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
 541 }
 542 @end lilypond
 543
 544
 545 @predefined
 546 @funindex balloonLengthOn
 547 @funindex \balloonLengthOn
 548 @code{\balloonLengthOn},
 549 @funindex \balloonLengthOff
 550 @funindex balloonLengthOff
 551 @code{\balloonLengthOff}.
 552 @endpredefined
 553
 554
 555 @seealso
 556 Fragmentos de código:
 557 @rlsr{Editorial annotations}.
 558
 559 Referencia de funcionamiento interno:
 560 @rinternals{Balloon_engraver},
 561 @rinternals{BalloonTextItem},
 562 @rinternals{balloon-interface}.
 563
 564
 565 @node Grid lines
 566 @unnumberedsubsubsec Grid lines
 567
 568 @cindex rejilla, líneas de
 569 @cindex líneas de rejilla
 570 @cindex vertical, línea, entre pentagramas
 571 @cindex línea vertical entre pentagramas
 572 @funindex Grid_point_engraver
 573 @funindex Grid_line_span_engraver
 574 @funindex gridInterval
 575
 576 Se pueden dibujar líneas verticales entre los pentagramas
 577 sincronizadas con las notas.
 578
 579 Se debe usar el grabador @code{Grid_point_engraver} para crear los
 580 puntos extremos de las líneas, mientras que el grabador
 581 @code{Grid_line_span_engraver} se debe utilizar para trazar
 582 efectivamente las líneas.  De forma predeterminada, esto centra las
 583 líneas de rejilla horizontalmente debajo y al lado izquierdo de la
 584 cabeza de las notas.  Las líneas de rejilla se extienden a partir de
 585 línea media de los pentagramas.  El intervalo @code{gridInterval} debe
 586 especificar la duración entre las líneas de rejilla.
 587
 588 @lilypond[verbatim,quote]
 589 \layout {
 590   \context {
 591     \Staff
 592     \consists "Grid_point_engraver"
 593     gridInterval = #(ly:make-moment 1 4)
 594   }
 595   \context {
 596     \Score
 597     \consists "Grid_line_span_engraver"
 598   }
 599 }
 600
 601 \score {
 602   \new ChoirStaff <<
 603     \new Staff \relative c'' {
 604       \stemUp
 605       c4. d8 e8 f g4
 606     }
 607     \new Staff \relative c {
 608       \clef bass
 609       \stemDown
 610       c4 g' f e
 611     }
 612   >>
 613 }
 614 @end lilypond
 615
 616 @snippets
 617
 618 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 619 {grid-lines--changing-their-appearance.ly}
 620
 621
 622 @seealso
 623 Fragmentos de código:
 624 @rlsr{Editorial annotations}.
 625
 626 Referencia de funcionamiento interno:
 627 @rinternals{Grid_line_span_engraver},
 628 @rinternals{Grid_point_engraver},
 629 @rinternals{GridLine},
 630 @rinternals{GridPoint},
 631 @rinternals{grid-line-interface},
 632 @rinternals{grid-point-interface}.
 633
 634
 635 @node Analysis brackets
 636 @unnumberedsubsubsec Analysis brackets
 637
 638 @cindex corchetes
 639 @cindex fraseo, corchetes de
 640 @cindex corchetes de fraseo
 641 @cindex musicológico, análisis
 642 @cindex notas, corchetes de agrupación de
 643 @cindex horizontal, corchete
 644 @cindex corchete horizontal
 645 @funindex Horizontal_bracket_engraver
 646 @funindex \startGroup
 647 @funindex startGroup
 648 @funindex \stopGroup
 649 @funindex stopGroup
 650
 651 Los corchetes se usan en análisis musical para indicar la estructura
 652 de las piezas musicales.  Están contemplados los corchetes
 653 horizontales simples.
 654
 655 @lilypond[verbatim,quote]
 656 \layout {
 657   \context {
 658     \Voice
 659     \consists "Horizontal_bracket_engraver"
 660   }
 661 }
 662 \relative c'' {
 663   c2\startGroup
 664   d\stopGroup
 665 }
 666 @end lilypond
 667
 668 Los corchetes de análisis se pueden anidar.
 669
 670 @lilypond[verbatim,quote]
 671 \layout {
 672   \context {
 673     \Voice
 674     \consists "Horizontal_bracket_engraver"
 675   }
 676 }
 677 \relative c'' {
 678   c4\startGroup\startGroup
 679   d4\stopGroup
 680   e4\startGroup
 681   d4\stopGroup\stopGroup
 682 }
 683 @end lilypond
 684
 685
 686 @seealso
 687 Fragmentos de código:
 688 @rlsr{Editorial annotations}.
 689
 690 Referencia de funcionamiento interno:
 691 @rinternals{Horizontal_bracket_engraver},
 692 @rinternals{HorizontalBracket},
 693 @rinternals{horizontal-bracket-interface},
 694 @rinternals{Staff}.