#20 Cifras (ChordPro)

O PenPage renderiza ChordPro — um formato de texto simples para folhas de cifras. Escreva os acordes entre colchetes dentro da letra, e o PenPage empilha cada acorde de forma organizada acima da sílaba a que ele pertence.

Como usar: Crie um bloco de código e defina a linguagem como chordpro. Uma cifra formatada aparece abaixo do código-fonte.

1. Acordes acima da letra

Coloque um acorde entre colchetes [ ] logo antes da sílaba em que o acorde muda:

[C]Twinkle twinkle [G]little star
[F]How I [C]wonder [G]what you [C]are

Os acordes se alinham acima das palavras — sem precisar de espaçamento manual.

2. Informações da música (diretivas)

Adicione detalhes da música com linhas {directive: value}:

{title: Amazing Grace}
{key: G}
{tempo: 90}
{capo: 2}

[G]Amazing [G7]grace, how [C]sweet the [G]sound
  • {title:} — o título da música (também vira o nome da página)
  • {key:} {tempo:} {capo:} {artist:} {album:} {time:} — exibidos como informações rotuladas
  • {comment:} — uma linha de nota (por exemplo, uma introdução ou um lembrete)

3. Seções (verso / refrão / ponte)

Envolva um refrão ou uma ponte e ele se destaca com uma barra colorida:

{start_of_chorus}
[C]This is the [G]chorus you all [Am]sing to[F]gether
{end_of_chorus}

Formas abreviadas também funcionam: {soc}/{eoc} para refrão, {sov}/{eov} para verso, {sob}/{eob} para ponte.

4. Ferramentas de leitura

Acima de cada cifra renderizada há uma pequena barra de ferramentas. Essas ferramentas só mudam o que você vê — sua nota nunca é modificada:

  • ♭ / ♯ Transpor — desloca cada acorde meio tom para cima ou para baixo. O rótulo {key:} acompanha a mudança. Toque em ↺ para voltar ao tom original.
  • N Números de Nashville — mostra os acordes como números relativos ao tom (no tom de C: C→1, F→4, G→5, Am→6m). Assim, qualquer cantor pode acompanhar a música no seu próprio tom. Toque em N novamente, ou transponha, para voltar.
  • ▶ Rolagem automática (em páginas compartilhadas e públicas) — role a cifra sem usar as mãos enquanto você toca; arraste o controle deslizante para ajustar a velocidade.

Ótimo para praticar, tocar em grupo e compartilhar uma música que todos podem tocar em qualquer tom.