ChordPro

O formato de ficheiro ChordPro é um formato comum utilizado noutras aplicações de software. OnSong compreende este formato nativamente. OnSong reconhece ficheiros com as seguintes extensões de ficheiro: .chordpro, .chopro, .cho, .crd, .pro

O formato ChordPro permite que as informações da música sejam expressas em etiquetas delimitadas por parênteses curvos. Esta informação pode ser logicamente dividida em etiquetas de metadados e etiquetas inline.

Etiquetas de Metadados

Estas são etiquetas ChordPro que você utilizaria na secção de metadados da música. Nas etiquetas seguintes, três pontos (...) representam o texto que você fornece, que fica entre o sinal de dois pontos e a parêntese curva de encerramento. Por exemplo:

{title: Amazing Grace}
{key: G}

OnSong suporta as seguintes etiquetas ChordPro:

• {title: ...} ou {t: ...} O título da música.
• {subtitle: ...}, {st: ...} ou {su: ...} O nome do artista ou qualquer outra informação de rodapé. Pode especificar múltiplos artistas separando os nomes com um ponto e vírgula. - Kim Walker-Smith; Chris Quilala
• {album: ...} O nome do álbum onde a música está localizada.
• {artist: ...} ou {a: ...} O nome do artista ou qualquer outra informação de rodapé. Pode especificar múltiplos artistas separando os nomes com um ponto e vírgula. - Kim Walker-Smith; Chris Quilala
• {author: ...} O nome da pessoa que criou o diagrama de acordes. Isto é apresentado na parte inferior do diagrama de acordes e na projecção de letras.
• {key: ...} ou {k: ...} ou {ok: ...} A tonalidade da música escrita como uma tonalidade com preferência enarmónica e um opcional "m" para indicar menor. - alfabético, p. ex. Bb ou Em
• {capo: ...} O capotraste a definir como número de trastos - numérico
• {tempo: ...} Os batimentos por minuto (BPM) - numérico
• {time: ...} A assinatura de compasso - batimento numérico sobre compasso, p. ex. 3/4
• {duration: ...} O comprimento da música para deslocamento automático - segundos ou mm:ss
• {book: ...} O nome do livro ou livros em que colocar a música. Esta é uma lista de nomes de livros delimitada por vírgula em que a música será colocada. Se o livro não existir, será criado automaticamente.
• {number: ...} O número da música - numérico, utilize para hinos, anos, etc. Pode ordenar músicas pelo número para referência.
• {flow: ...} O arranjo de secções - lista de rótulos de secção. Ver Fluxo para detalhes sobre como arranjar o fluxo de uma música.
• {midi: ...} Os comandos MIDI a enviar quando a música é visualizada. Ver Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {midi-index: ...} Os comandos MIDI que acionarão a abertura desta música no Visualizador de Música. Ver Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {pitch: ...} As notas a tocar ao utilizar a funcionalidade Tubo de Afinação.
• {keywords: ...} ou {topic: ...} A lista de etiquetas a utilizar com a pesquisa de tópicos. Ver Tópicos para mais informações sobre como procurar por tópico.
• {copyright: ...} ou {footer: ...} Especifica texto de rodapé de direitos de autor a aparecer na parte inferior da página ou na projecção de letras.
• {ccli: ...} O número CCLI da música.
• {restrictions: ...} A gestão de direitos para a lista de restrições delimitada por vírgula da música. Ver Restrições para detalhes sobre como definir restrições para a sua música.

Etiquetas Inline

Estas etiquetas são utilizadas dentro do conteúdo da música e podem ser utilizadas para definir secções ou para formatar partes da música.

• {define: ...} é utilizado para definir diagramas de acordes personalizados. Ver Definição de Acordes para mais informações.
• {comment: ...} ou {c: ...} Define um comentário e aparece como uma instrução musical.
• {comment_bold: ...} ou {cb: ...} Define texto a aparecer em negrito.
• {comment_italic: ...} ou {ci: ...} Define texto a aparecer em itálico.
• {guitar_comment: ...} ou {gc: ...} Define um comentário que aparece como uma instrução musical.
• {start_of_verse: ..} ou {sov} Declara o início de uma secção de verso com um rótulo de secção opcional.
• {end_of_verse} ou {eov} Declara o fim de uma secção de verso.
• {start_of_chorus: ...} ou {soc} Declara o início de uma secção de refrão com um rótulo de secção opcional.
• {end_of_chorus} ou {eoc} Declara o fim de uma secção de refrão.
• {start_of_bridge: ...} ou {sob} Declara o início de uma secção de ponte com um rótulo de secção opcional.
• {end_of_bridge} ou {eob} Declara o fim de uma secção de ponte.
• {start_of_part: ..} ou {sop} Declara o início de uma parte com um rótulo de secção opcional.
• {end_of_part} ou {eop} Declara o fim de uma parte.
• {start_of_tab} ou {sot} Declara o início de uma tablatura que OnSong apresenta numa fonte monoespaçada.
• {end_of_tab} ou {eot} Declara o fim de uma secção de tablatura.
• {new_page} ou {np} É utilizado para declarar uma nova página.
• {new_physical_page} ou {npp} É utilizado para declarar uma nova página.

Etiquetas de Formatação

As etiquetas seguintes são utilizadas para definir o tipo de letra e tamanho predefinidos para letras e acordes no diagrama de acordes.

• {textsize: ...} Define o tamanho das letras como um valor numérico em pontos.
• {textfont: ...} Define o nome do tipo de letra a utilizar para letras. Tem de ser suportado na plataforma.
• {chordsize: ...} Define o tamanho dos acordes como um valor numérico em pontos.
• {chordfont: ...} Define o nome do tipo de letra a utilizar para acordes. Tem de ser suportado na plataforma.

Extensões de Ficheiro Suportadas

O formato de ficheiro ChordPro é único em que é uma sintaxe comummente acordada, mas não um formato normalizado. Isto significa que vários fornecedores podem implementá-lo de diferentes maneiras e com diferentes extensões de ficheiro. OnSong suporta as seguintes extensões de ficheiro ao importar ficheiros em formato ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm