Introducción al marcado de texto

Se usa un bloque \markup para tipografiar texto con una sintaxis ampliable que se denomina “modo de marcado”. Tales bloques se pueden emplear en cualquier parte, como se explica en Panorámica de los objetos de texto.

La sintaxis del marcado es similar a la sintaxis usual de LilyPond: una expresión \markup se encierra entre llaves { … }. Una sola palabra se considera como una expresión mínima, y por tanto no necesita estar encerrada entre llaves.

A diferencia de las indicaciones de “texto entrecomillado” simples, los bloques \markup pueden contener expresiones anidadas o instrucciones de marcado, que se introducen utilizando el carácter de barra invertida \ . Estas instrucciones sólo afectan a la expresión que sigue inmediatamente.

\relative {
  a'1-\markup intenso
  a2^\markup { poco \italic più forte  }
  c e1
  d2_\markup { \italic "string. assai" }
  e
  b1^\markup { \bold { molto \italic  agitato } }
  c
}

[image of music]

Un bloque \markup puede contener también cadenas de texto entre comillas. Dichas cadenas se tratan como expresiones de texto mínimas, y por tanto cualquier instrucción de marcado o carácter especial (como \#) se imprimen literalmente sin afectar al formateo del texto. Se puede hacer que se impriman las propias comillas si se les antepone una barra invertida.

\relative {
  a'1^"\italic markup..."
  a_\markup { \italic "... prints \"italic\" letters!" }
  a a
}

[image of music]

Para que se traten como una expresión distinta, es necesario que las listas de palabras estén encerradas entre comillas o precedidas de una instrucción. La forma en que están definidas las expresiones de marcado afecta a cómo se apilan, se centran y se alinean estas expresiones; en el ejemplo siguiente, la segunda expresión \markup se trata igual que la primera:

\relative c'' {
  c1^\markup { \center-column { a bbb c } }
  c1^\markup { \center-column { a { bbb c } } }
  c1^\markup { \center-column { a \line { bbb c } } }
  c1^\markup { \center-column { a "bbb c" } }
}

[image of music]

Los marcados se pueden almacenar dentro de variables. Estas variables se pueden adjuntar directamente a las notas:

allegro = \markup { \bold \large Allegro }

{
  d''8.^\allegro
  d'16 d'4 r2
}

[image of music]

Se puede encontrar una lista exhaustiva de las instrucciones específicas de \markup en Instrucciones de marcado de texto. The inner workings of these commands, and how to implement new ones, is explained in Funciones de marcado.

Véase también

Referencia de la notación: Panorámica de los objetos de texto, Instrucciones de marcado de texto.

Manual de extensión: Funciones de marcado.

Fragmentos de código: Text.

Archivos de inicio: scm/markup.scm.

Advertencias y problemas conocidos

Los mensajes de error de sintaxis para el modo de marcado a menudo producen confusión.


Referencia de la notación de GNU LilyPond v2.25.21 (rama de desarrollo).