ChordPro

O formato de ficheiro ChordPro é um formato comum utilizado em outras 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 chavetas. Esta informação pode ser logicamente dividida em etiquetas de metadados e etiquetas inline.

Etiquetas de Metadados

Estas são etiquetas ChordPro que utilizaria na secção de metadados da música. Nas etiquetas seguintes, três pontos (...) representam o texto que fornece, que fica entre os dois pontos e a chaveta de fecho. 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 vários 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 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 música escrita como uma tonalidade com preferência enarmónica e um "m" opcional para indicar menor. - alfabético, por exemplo, Bb ou Em
• {capo: ...} O capotraste a definir 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 exemplo, 3/4
• {duration: ...} A duração da música para deslocamento automático - segundos ou mm:ss
• {book: ...} O nome do livro ou livros para colocar a música. Esta é uma lista delimitada por vírgulas de nomes de livros nos quais a música será colocada. Se o livro não existir, será criado automaticamente.
• {number: ...} O número da música - numérico, utilizar para hinos, anos, etc. Pode ordenar músicas pelo número para 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 música.
• {midi: ...} Os comandos MIDI a enviar quando a música é visualizada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {midi-index: ...} Os comandos MIDI que irão desencadear a abertura desta música no Visualizador de Músicas. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {pitch: ...} As notas a reproduzir ao utilizar a funcionalidade Diapasão.
• {keywords: ...} ou {topic: ...} A lista de etiquetas a utilizar com a pesquisa de tópicos. Consulte Tópicos para obter mais informações sobre a procura por tópico.
• {copyright: ...} ou {footer: ...} ou {f: ...} Especifica texto de rodapé de direitos de autor a aparecer na parte inferior da página ou projeção de letras.
• {ccli: ...} O número CCLI da música.
• {restrictions: ...} A gestão de direitos da lista delimitada por vírgulas de restrições da música. Consulte Restrições para obter detalhes sobre a definição de restrições para a sua música.
• {composer: ...} Os indivíduos que escreveram a música. Esta lista deve ser separada com ponto-e-vírgula para valores separados.
• {lyricist: ...} Os indivíduos que escreveram as letras da música. Esta lista deve ser separada com ponto-e-vírgula para valores separados.

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. 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 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 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 de uma tablatura que OnSong renderiza numa fonte monoespacial.
• {end_of_tab} ou {eot} Declara o fim de uma secção de tablatura.
• {new_page} ou {np} É utilizado para declarar uma página nova.
• {new_physical_page} ou {npp} É utilizado para declarar uma página nova.

Etiquetas de Formatação

As etiquetas seguintes são utilizadas para definir o tipo de letra e tamanho padrão 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 na medida em que é uma sintaxe comummente acordada, mas não um formato padrão. Isto significa que vários fornecedores podem implementá-lo de formas diferentes e com extensões de ficheiro diferentes. OnSong suporta as seguintes extensões de ficheiro ao importar ficheiros formatados em ChordPro:

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