Métadonnées

Les métatags sont un moyen de fournir des informations sur une chanson et sont exprimés dans une section de métadonnées. Les métadonnées sont exprimées dans la première section de la chanson avant la première ligne vide ou jusqu'à ce qu'aucun autre métatag ne soit rencontré. Les métatags sont des paires nom/valeur où le nom se trouve à gauche et la valeur à droite, séparés par deux points. Un seul métatag peut apparaître par ligne. Veuillez consulter le Format de fichier ChordPro pour plus de détails sur la façon d'exprimer les métadonnées au format ChordPro.

OnSong attribue automatiquement la première ligne d'un fichier texte comme titre de la chanson si elle n'est pas au format métatag. De plus, la deuxième ligne est considérée comme l'artiste/la signature de la chanson à moins qu'un métatag ne soit défini. Voici un exemple d'une section de métadonnées de chanson typique qui définit le titre et l'artiste sur les première et deuxième lignes ainsi que la tonalité et le tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Balises de métadonnées

Les balises suivantes sont supportées par OnSong :

• Title : Le titre de la chanson. Cela peut également être exprimé sur la première ligne du contenu de la chanson.
• Artist : Le nom de l'artiste ou toute autre information de signature. Cela peut également être exprimé sur la deuxième ligne du contenu de la chanson. Vous pouvez spécifier plusieurs artistes en séparant les noms par un point-virgule. - Kim Walker-Smith; Chris Quilala
• Author : Le nom de la personne qui a créé la grille d'accords. Cela s'affiche au bas de la grille d'accords et dans la projection des paroles.
• Key : La tonalité de la chanson écrite avec une préférence enharmonique et un « m » optionnel pour indiquer le mineur. - alphabétique, par exemple Bb ou Em
• TransposedKey : La tonalité souhaitée dans laquelle la chanson doit être jouée, qui peut différer de la tonalité dans laquelle la chanson est écrite. - alphabétique, par exemple Bb ou Em
• In : est un synonyme de la balise de métadonnées de tonalité transposée.
• Capo : Le capo à définir comme nombre de frettes. C'est généralement un entier positif (1 à 11) mais peut aussi être un entier négatif. - numérique
• Tempo : Les battements par minute (BPM). - numérique
• Time : La signature temporelle. - numérique unité sur mesure par exemple 3/4
• Duration : La longueur de la chanson pour le défilement automatique. - secondes ou mm:ss
• Book : Le nom du livre ou des livres dans lesquels placer la chanson. Il s'agit d'une liste délimitée par des virgules de noms de livres dans lesquels la chanson sera placée. Si le livre n'existe pas, il sera également créé automatiquement.
• Number : Le numéro de la chanson - numérique. À utiliser pour les hymnes, les années, etc. Vous pouvez trier les chansons par numéro à titre de référence.
• Flow : L'arrangement des sections. - liste des étiquettes de section. Voir Flow pour plus de détails sur l'arrangement du flux d'une chanson.
• MIDI : Les commandes MIDI à envoyer lorsque la chanson est affichée. Voir MIDI Syntax pour savoir comment exprimer les commandes MIDI sous forme de texte dans OnSong.
• MIDI-Index : Les commandes MIDI qui déclencheront l'ouverture de cette chanson dans la Visionneuse de chansons. Voir MIDI Syntax pour savoir comment exprimer les commandes MIDI sous forme de texte dans OnSong.
• Keywords : ou Topic : La liste des balises à utiliser avec la recherche par sujet. Voir Topics pour plus d'informations sur la navigation par sujet.
• Copyright : ou Footer : ou f : Les informations de copyright de la chanson. Cela apparaîtra au bas de la grille d'accords et de la projection des paroles.
• CCLI : Le numéro CCLI de la chanson. Cela apparaîtra au bas de la grille d'accords et de la projection des paroles.
• Restrictions : Ce sont des restrictions qui empêchent certaines actions de se produire dans une chanson. Voir Restrictions pour plus de détails sur la définition des restrictions pour votre chanson.
• Pitch : La note ou les notes à jouer lors de l'utilisation de la fonctionnalité Pitch Pipe. Ceci est défini comme une liste de notes séparées par des espaces avec des octaves optionnelles. - par exemple A3 C#4 E5
• Subdivision : ou Beat : vous permet de choisir la subdivision pour la chanson. Cela peut être une valeur incluant : whole, half, quarter, eighth, shuffle, ou sixteenth. Vous pouvez également utiliser un nombre entier tel que 1, 2, 4, 8 ou 16.
• Transpose : Le nombre de demi-tons pour transposer la chanson. Ceci est utilisé au milieu de la chanson pour moduler la chanson vers le haut ou vers le bas et s'adapte à la tonalité définie dans les curseurs de transposition. Ce nombre doit être un entier positif ou négatif.
• Tuning : L'accordage de l'instrument à assigner à la chanson. Ceux-ci sont spécifiques à l'instrument et seul la guitare est actuellement supportée avec ces valeurs : Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G, ou Open E.
• Scene : La scène à jouer lorsque la chanson est chargée. Cela peut être défini en entrant le nom de la scène après le deux-points.

Balises intégrées

Certaines balises peuvent être utilisées au sein d'une chanson pour affecter la transposition au milieu de la chanson. Celles-ci incluent :

• Capo : peut être utilisé pour appliquer un capo au milieu de la chanson, en modulant la chanson vers le bas pour fournir des accords à jouer avec le capo appliqué. Vous pouvez ajuster la direction de modulation dans Capo Settings. C'est généralement un entier positif (1 à 11) mais peut aussi être un entier négatif pour supprimer un capo précédent. - numérique
• Key : pour définir la tonalité explicitement dans la chanson. Si vous entourez la valeur de crochets lors de l'utilisation d'accords entre crochets, la tonalité résultante sera également transposée. - alphabétique, par exemple Bb ou Em
• Transpose : transpose la chanson du nombre de demi-tons désiré. C'est un entier positif ou négatif. Par exemple, utilisez 2 ou +2 pour transposer la chanson vers le haut d'un ton entier, ou utilisez -3 pour transposer vers le bas de trois demi-tons. - numérique

Balises de section

Certaines balises peuvent être utilisées pour fournir des informations sur chaque section de la chanson. Celles-ci incluent :

• MIDI : Les commandes MIDI à envoyer lorsque la section est sélectionnée. Voir MIDI Syntax pour savoir comment exprimer les commandes MIDI sous forme de texte dans OnSong.
• Scene : La scène à jouer lorsque la section est sélectionnée. Cela peut être défini en entrant le nom de la scène après le deux-points.

Remarque : Les métatags ne sont pas sensibles à la casse