Métadonnées

Les balises de métadonnées sont un moyen de fournir des informations sur une chanson et s'expriment dans une section de métadonnées. Les métadonnées s'expriment dans la première section de la chanson avant la première ligne vide ou jusqu'à ce qu'aucune autre balise de métadonnées ne soit rencontrée. Les balises de métadonnées sont des paires nom/valeur où le nom est à gauche et la valeur à droite, séparés par un deux-points. Une seule balise de métadonnées 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 de balise de métadonnées. De plus, la deuxième ligne est considérée comme l'artiste/signature de la chanson à moins qu'une balise de métadonnées ne soit définie. 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éé le diagramme d'accords. Ceci s'affiche en bas du diagramme d'accords et dans la projection de paroles.
• Key: La tonalité de la chanson écrite comme une tonalité avec préférence enharmonique et un « m » optionnel pour indiquer mineur. - alphabétique, par ex. Bb ou Em
• TransposedKey: La tonalité souhaitée dans laquelle la chanson doit être jouée, qui peut être différente de la tonalité dans laquelle la chanson est écrite. - alphabétique, par ex. Bb ou Em
• In: est un pseudonyme pour la balise de métadonnées de clé transposée.
• Capo: Le capo à définir comme nombre de frettes. Ceci est généralement un nombre entier positif (1 à 11) mais peut aussi être un nombre entier négatif. - numérique
• Tempo: Les battements par minute (BPM). - numérique
• Time: La signature temporelle. - numérique beat sur mesure par ex. 3/4
• Duration: La longueur de la chanson pour le défilement automatique. - secondes ou mm:ss
• Book: Le nom du ou des livres dans lesquels placer la chanson. Ceci est 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 automatiquement créé également.
• Number: Le numéro de la chanson - numérique. Utilisez 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. Consultez 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. Consultez MIDI Syntax pour savoir comment exprimer les commandes MIDI en tant que texte dans OnSong.
• MIDI-Index: Les commandes MIDI qui déclencheront l'ouverture de cette chanson dans la Visionneuse de chanson. Consultez MIDI Syntax pour savoir comment exprimer les commandes MIDI en tant que texte dans OnSong.
• Keywords: ou Topic: La liste des balises à utiliser avec la recherche par sujet. Consultez Topics pour plus d'informations sur la navigation par sujet.
• Copyright: ou Footer: ou f: Les informations de droits d'auteur de la chanson. Ceci apparaîtra en bas du diagramme d'accords et de la projection de paroles.
• CCLI: Le numéro CCLI de la chanson. Ceci apparaîtra en bas du diagramme d'accords et de la projection de paroles.
• Restrictions: Ce sont des restrictions qui empêchent certaines actions de se produire dans une chanson. Consultez Restrictions pour plus de détails sur la définition des restrictions de 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 facultatifs. - par ex. A3 C#4 E5
• Subdivision: ou Beat: vous permet de choisir la subdivision de la chanson. Ceci peut être une valeur incluant : whole, half, quarter, eighth, shuffle, ou sixteenth. Alternativement, vous pouvez 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 nombre entier positif ou négatif.
• Scene: La scène à jouer lorsque la chanson est chargée. Ceci peut être défini en entrant le nom de la scène après le deux-points.

Balises en ligne

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

• Capo: peut être utilisé pour appliquer un capo au milieu de la chanson, modulant la chanson vers le bas pour fournir des accords à jouer avec le capo appliqué. Vous pouvez ajuster la direction de la modulation dans les Paramètres de capo. Ceci est généralement un nombre entier positif (1 à 11) mais peut aussi être un nombre 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 ex. Bb ou Em
• Transpose: transpose la chanson du nombre de demi-tons souhaité. Ceci est un nombre entier positif ou négatif. Par exemple, utilisez 2 ou +2 pour transposer la chanson vers le haut d'un ton complet, 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 chanson. Celles-ci incluent :

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

Note : Les balises de métadonnées ne sont pas sensibles à la casse