Metadados

As etiquetas de metadados 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é não serem encontradas mais etiquetas de metadados. As etiquetas de metadados são pares nome/valor onde o nome está à esquerda e o valor à direita separados por dois-pontos. Apenas uma etiqueta de metadados pode aparecer por linha. Consulte o 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 de etiqueta de metadados. Além disso, a segunda linha é considerada o artista/subtítulo da canção, a menos que uma etiqueta de metadados seja definida. O seguinte é um exemplo de uma secção típica de metadados de canção que define o título e o 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...

Etiquetas Suportadas

As seguintes etiquetas são suportadas por 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 subtítulo. Isto também pode ser expresso na segunda linha do conteúdo da canção. Pode especificar vários artistas separando nomes com um ponto e vírgula. - Kim Walker-Smith; Chris Quilala
• Autor: O nome da pessoa que criou o gráfico de acordes. Isto é apresentado na parte inferior do gráfico 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 opcional "m" para indicar menor. - alfabético, por exemplo, Bb ou Em
• Capo: O capo a definir como número de trastes. Isto é tipicamente um inteiro positivo (1 a 11), mas também pode ser definido como um inteiro negativo. - numérico
• Tempo: Os batimentos por minuto (BPM). - numérico
• Assinatura de Tempo: A assinatura de tempo. - tempo numérico sobre compasso, por exemplo, 3/4
• Duração: O comprimento da canção para auto-deslocamento. - segundos ou mm:ss
• Livro: 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 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ção. Consulte Fluxo para obter detalhes sobre como organizar 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 irão activar esta canção para ser aberta no Visualizador de Canções. 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 mais informações sobre navegação por tópico.
• Copyright: ou Rodapé: A informação de copyright da canção. Isto aparecerá na parte inferior do gráfico de acordes e projecção de letras.
• CCLI: O número CCLI da canção. Isto aparecerá na parte inferior do gráfico de acordes e projecção de letras.
• Restrições: Estas são restrições que impedem certas acções de ocorrerem dentro de uma canção. Consulte Restrições para obter detalhes sobre como definir restrições para a sua canção.
• Pitch: A nota ou notas a reproduzir ao utilizar a funcionalidade Pitch Pipe. Isto é definido como uma lista de notas separadas por espaço com oitavas opcionais. - por exemplo, A3 C#4 E5
• Subdivisão: ou Batimento: permite-lhe escolher a subdivisão para a canção. Isto pode ser um valor incluindo: inteiro, metade, quarto, oitavo, shuffle ou décimo sexto. Em alternativa, 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 à tonalidade definida nos controlos deslizantes de transposição. Este número deve ser um inteiro positivo ou negativo.
• Cena: A cena a ser reproduzida quando a canção é carregada pode ser definida introduzindo o nome da cena após os dois-pontos.

Nota: As etiquetas de metadados não são sensíveis a maiúsculas/minúsculas