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 canção sejam expressas em marcas delimitadas por chavetas. Estas informações podem ser logicamente divididas em marcas de metadados e marcas inline.

Marcas de Metadados

Estas são marcas ChordPro que utilizaria na porção de metadados da canção. Nas marcas seguintes, três pontos (...) representam o texto que fornece, que fica entre os dois-pontos e a chaveta de encerramento. Por exemplo:

{title: Amazing Grace}
{key: G}

OnSong suporta as seguintes marcas ChordPro:

• {title: ...} ou {t: ...} O título da canção.
• {subtitle: ...}, {st: ...} ou {su: ...} O nome do artista ou qualquer outra informação de subtítulo. Pode especificar vários artistas separando os nomes com um ponto-e-vírgula. - Kim Walker-Smith; Chris Quilala
• {album: ...} O nome do álbum onde a canção está localizada.
• {artist: ...} ou {a: ...} O nome do artista ou qualquer outra informação de subtítulo. Pode especificar vários 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. É exibido na parte inferior do diagrama de acordes e na projeção de letra.
• {key: ...} ou {k: ...} ou {ok: ...} A tonalidade da canção 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 para definir como número de trastes - numérico
• {tempo: ...} Os batimentos por minuto (BPM) - numérico
• {time: ...} A assinatura de compasso - numérico batimento sobre compasso p.ex. 3/4
• {duration: ...} O comprimento da canção para autoscroll - segundos ou mm:ss
• {book: ...} O nome do livro ou livros onde colocar a canção. Esta é uma lista delimitada por vírgulas de nomes de livros onde a canção será colocada. Se o livro não existir, será criado automaticamente.
• {number: ...} O número da canção - numérico, utilize para hinos, anos, etc. Pode ordenar canções pelo número para referência.
• {flow: ...} O arranjo de secções - lista de rótulos de secção. Veja Fluxo para detalhes sobre como organizar o fluxo de uma canção.
• {midi: ...} Os comandos MIDI a enviar quando a canção é visualizada. Veja Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {midi-index: ...} Os comandos MIDI que acionarão a abertura desta canção no Visualizador de Canção. Veja Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {pitch: ...} As notas a tocar quando utilizar a funcionalidade Tubo de Tom.
• {keywords: ...} ou {topic: ...} A lista de marcas para utilizar com pesquisa de tópico. Veja Tópicos para mais informações sobre navegação por tópico.
• {copyright: ...} ou {footer: ...} ou {f: ...} Especifica o texto de rodapé de copyright a aparecer na parte inferior da página ou projeção de letra.
• {ccli: ...} O número CCLI da canção.
• {restrictions: ...} A gestão de direitos da canção com lista delimitada por vírgulas de restrições. Veja Restrições para detalhes sobre como definir restrições para a sua canção.
• {composer: ...} Os indivíduos que escreveram a música da canção. Esta lista deve ser separada com ponto-e-vírgulas para valores separados.
• {lyricist: ...} Os indivíduos que escreveram a letra da canção. Esta lista deve ser separada com ponto-e-vírgulas para valores separados.

Marcas Inline

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

• {define: ...} é utilizado para definir diagramas de acordes personalizados. Veja Definir 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 como 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 final 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 final 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 final 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 final de uma parte.
• {start_of_tab} ou {sot} Declara o início de tabuladura que OnSong renderiza com uma fonte monoespacial.
• {end_of_tab} ou {eot} Declara o final de uma secção de tabuladura.
• {new_page} ou {np} Isto é utilizado para declarar uma nova página.
• {new_physical_page} ou {npp} Isto é utilizado para declarar uma nova página.

Marcas de Formatação

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

• {textsize: ...} Define o tamanho da letra como um valor numérico em pontos.
• {textfont: ...} Define o nome do tipo de letra a utilizar para letra. Deve 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. Deve 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 padrão. Isto significa que vários fornecedores podem implementá-lo de diferentes formas e com diferentes extensões de ficheiro. OnSong suporta as seguintes extensões de ficheiro ao importar ficheiros formatados em ChordPro:

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