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