Metadados

Metatags são uma forma de fornecer informações sobre uma canção e são expressas numa secção de metadados. Os metadados são expressos na primeira secção da canção antes da primeira linha em branco ou até que não haja mais metatags. Metatags são pares nome/valor onde o nome está à esquerda e o valor à direita, separados por dois pontos. Apenas um metatag pode aparecer por linha. Consulte Formato de Ficheiro ChordPro para obter detalhes sobre como expressar metadados no formato ChordPro.

OnSong atribui automaticamente a primeira linha de um ficheiro de texto como o título da canção se não estiver no formato metatag. Além disso, a segunda linha é considerada o artista/assinatura da canção a menos que um metatag seja definido. O seguinte é um exemplo de uma secção típica de metadados de canção que define o título e artista como a primeira e segunda linhas, bem como a tonalidade e o tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Metatags

Os seguintes metatags são suportados pelo OnSong:

• Título: O título da canção. Isto também pode ser expresso na primeira linha do conteúdo da canção.
• Artista: O nome do artista ou qualquer outra informação de assinatura. Isto também pode ser expresso na segunda linha do conteúdo da canção. Pode especificar vários artistas separando os nomes com um ponto-e-vírgula. - Kim Walker-Smith; Chris Quilala
• Autor: O nome da pessoa que criou o diagrama de acordes. Isto é exibido na parte inferior do diagrama de acordes e na projecção de letras.
• Tonalidade: A tonalidade da canção escrita como uma tonalidade com preferência enarmónica e um "m" opcional para indicar menor. - alfabético, p.ex. Bb ou Em
• Tonalidade Transposta: A tonalidade desejada em que a canção deve ser tocada, que pode ser diferente da tonalidade em que a canção foi escrita. - alfabético, p.ex. Bb ou Em
• Em: é um pseudónimo para a metatag de tonalidade transposta.
• Capo: O capo a definir como número de trastes. Normalmente é um inteiro positivo (1 a 11), mas também pode ser um inteiro negativo. - numérico
• Tempo: Os batimentos por minuto (BPM). - numérico
• Compasso: A assinatura de tempo. - batimento numérico sobre compasso, p.ex. 3/4
• Duração: O comprimento da canção para deslocamento automático. - segundos ou mm:ss
• Livro: O nome do livro ou livros em que colocar a canção. Esta é uma lista separada por vírgulas de nomes de livros em que a canção será colocada. Se o livro não existir, será automaticamente criado também.
• Número: O número da canção - numérico. Utilize para hinos, anos, etc. Pode ordenar canções pelo número para referência.
• Fluxo: O arranjo de secções. - lista de rótulos de secções. Consulte Fluxo para obter detalhes sobre como arranjar o 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 em OnSong.
• MIDI-Index: Os comandos MIDI que acionarão a abertura desta canção no Visualizador de Canção. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• Palavras-chave: ou Tópico: A lista de etiquetas a utilizar com a pesquisa de tópicos. Consulte Tópicos para obter mais informações sobre navegação por tópico.
• Copyright: ou Rodapé: ou f: A informação de copyright da canção. Isto aparecerá na parte inferior do diagrama de acordes e projecção de letras.
• CCLI: O número CCLI da canção. Isto aparecerá na parte inferior do diagrama de acordes e projecção de letras.
• Restrições: Estas são restrições que impedem certas ações dentro de uma canção. Consulte Restrições para obter detalhes sobre como definir restrições para a sua canção.
• Tom: A nota ou notas a tocar quando utilizar a funcionalidade Tubo de Tom. Isto é definido como uma lista de notas separadas por espaço com oitavas opcionais. - p.ex. A3 C#4 E5
• Subdivisão: ou Batimento: permite-lhe escolher a subdivisão para a canção. Pode ser um valor incluindo: inteira, metade, semínima, colcheia, shuffle ou dezasseis. Alternadamente, pode utilizar um número inteiro como 1, 2, 4, 8 ou 16.
• Transpor: O número de semitons para transpor a canção. Isto é utilizado a meio da canção para modular a canção para cima ou para baixo e adapta-se com a tonalidade definida nos selectores de transposição. Este número deve ser um inteiro positivo ou negativo.
• Afinação: A afinação do instrumento a atribuir à canção. Estas são específicas do instrumento e apenas a guitarra é atualmente suportada com estes valores: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G ou Open E.
• Cena: A cena a ser reproduzida quando a canção é carregada. Isto pode ser definido introduzindo o nome da cena após os dois pontos.

Metatags Inline

Algumas etiquetas podem ser utilizadas dentro de uma canção para efectuar a transposição a meio da canção. Estas incluem:

• Capo: pode ser utilizado para aplicar um capo a meio da canção, modulando a canção para baixo para fornecer acordes a tocar com o capo aplicado. Pode ajustar a direcção da modulação nas Definições de Capo. Normalmente é um inteiro positivo (1 a 11), mas também pode ser um inteiro negativo para remover um capo anterior. - numérico
• Tonalidade: para definir a tonalidade explicitamente na canção. Se rodear o valor com parênteses retos quando utilizar acordes entre parênteses, a tonalidade resultante também será transposta. - alfabético, p.ex. Bb ou Em
• Transpor: transpõe a canção o número desejado de semitons. Isto é um inteiro positivo ou negativo. Por exemplo, utilize 2 ou +2 para transpor a canção para cima uma tonalidade completa, ou utilize -3 para transpor para baixo três semitons. - numérico

Metatags de Secção

Algumas etiquetas podem ser utilizadas para fornecer informações sobre cada secção de canção. Estas incluem:

• MIDI: Os comandos MIDI a enviar quando a secção é seleccionada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• Cena: A cena a ser reproduzida quando a secção é seleccionada. Isto pode ser definido introduzindo o nome da cena após os dois pontos.

Nota: Metatags não são sensíveis a maiúsculas e minúsculas