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 etiquetas delimitadas por chavetas. Esta informação pode ser logicamente dividida em etiquetas de metadados e etiquetas em linha.

Etiquetas de Metadados

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

{title: Amazing Grace}
{key: G}

OnSong suporta as seguintes etiquetas ChordPro:

• {title: ...} ou {t: ...} O título da canção.
• {subtitle: ...}, {st: ...} ou {su: ...} O nome do artista ou qualquer outra informação de rodapé. 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 se encontra.
• {artist: ...} ou {a: ...} O nome do artista ou qualquer outra informação de rodapé. 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. Isto é apresentado na parte inferior do diagrama de acordes e na projeção de letras.
• {key: ...} ou {k: ...} ou {ok: ...} A tonalidade da canção escrita como uma tonalidade com preferência enarmónica e um "m" opcional para indicar menor. - alfabético, por ex. Bb ou Em
• {capo: ...} O capotraste definido como número de trastes - numérico
• {tempo: ...} Os batimentos por minuto (BPM) - numérico
• {time: ...} A assinatura de compasso - batimento numérico sobre compasso, por ex. 3/4
• {duration: ...} O comprimento da canção para deslocamento automático - 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 nos quais a canção será colocada. Se o livro não existir, será criado automaticamente.
• {number: ...} O número da canção - numérico, use para hinos, anos, etc. Pode ordenar as canções pelo número como referência.
• {flow: ...} O arranjo de secções - lista de etiquetas de secção. Consulte Fluxo para obter detalhes sobre o arranjo do fluxo de uma canção.
• {midi: ...} Os comandos MIDI a enviar quando a canção é visualizada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto no OnSong.
• {midi-index: ...} Os comandos MIDI que acionarão a abertura desta canção no Visualizador de Canções. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto no OnSong.
• {pitch: ...} As notas a tocar ao utilizar a funcionalidade Diapasão.
• {keywords: ...} ou {topic: ...} A lista de etiquetas a utilizar com a pesquisa por tópico. Consulte Tópicos para obter mais informações sobre navegação por tópico.
• {copyright: ...} ou {footer: ...} Especifica o texto do rodapé de direitos de autor a aparecer na parte inferior da página ou na projeção de letras.
• {ccli: ...} O número CCLI da canção.
• {restrictions: ...} A gestão de direitos para a lista de restrições delimitada por vírgulas da canção. Consulte Restrições para obter detalhes sobre como definir restrições para a sua canção.

Etiquetas em Linha

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

• {define: ...} é utilizado para definir diagramas de acordes personalizados. Consulte Definir Acordes para obter 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 uma etiqueta 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 uma etiqueta 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 uma etiqueta 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 uma etiqueta de secção opcional.
• {end_of_part} ou {eop} Declara o fim de uma parte.
• {start_of_tab} ou {sot} Declara o início da tabulação, que OnSong renderiza com uma fonte de espaçamento fixo.
• {end_of_tab} ou {eot} Declara o fim de uma secção de tabulação.
• {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.

Etiquetas de Formatação

As seguintes etiquetas 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. 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 no sentido em que é uma sintaxe comummente acordada, mas não um formato normalizado. Isto significa que vários fornecedores podem implementá-lo de formas diferentes 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