ChordPro

Le format de fichier ChordPro est un format courant utilisé dans d'autres applications logicielles. OnSong comprend ce format nativement. OnSong reconnaît les fichiers avec les extensions de fichier suivantes : .chordpro, .chopro, .cho, .crd, .pro

Le format ChordPro permet d'exprimer les informations de chanson dans des étiquettes délimitées par des accolades. Ces informations peuvent être logiquement divisées en étiquettes de métadonnées et étiquettes intégrées.

Étiquettes de métadonnées

Ce sont des étiquettes ChordPro que vous utiliseriez dans la portion de métadonnées de la chanson. Dans les étiquettes suivantes, trois points (...) représentent le texte que vous fournissez, qui va entre les deux points et l'accolade fermante. Par exemple :

{title: Amazing Grace}
{key: G}

OnSong prend en charge les étiquettes ChordPro suivantes :

• {title: ...} ou {t: ...} Le titre de la chanson.
• {subtitle: ...}, {st: ...} ou {su: ...} Le nom de l'artiste ou toute autre information de présentation. Vous pouvez spécifier plusieurs artistes en séparant les noms par un point-virgule. - Kim Walker-Smith; Chris Quilala
• {album: ...} Le nom de l'album où se trouve la chanson.
• {artist: ...} ou {a: ...} Le nom de l'artiste ou toute autre information de présentation. 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 est affiché au bas du diagramme d'accords et dans la projection des paroles.
• {key: ...} ou {k: ...} ou {ok: ...} La tonalité de la chanson écrite en tant que tonalité avec préférence enharmonique et un « m » optionnel pour indiquer le mineur. - alphanumérique, ex. Bb ou Em
• {capo: ...} Le capo à définir comme nombre de frettes - numérique
• {tempo: ...} Le nombre de battements par minute (BPM) - numérique
• {time: ...} La signature temporelle - battement numérique sur mesure 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 pour 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 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 le 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 quand la chanson est affichée. Consultez 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 le Song Viewer. Consultez MIDI Syntax pour savoir comment exprimer les commandes MIDI sous forme de texte dans OnSong.
• {pitch: ...} Les notes à jouer lors de l'utilisation de la fonction Pitch Pipe.
• {keywords: ...} ou {topic: ...} La liste des étiquettes à utiliser avec la recherche par sujet. Consultez Topics pour plus d'informations sur la navigation par sujet.
• {copyright: ...} ou {footer: ...} ou {f: ...} Spécifie le texte du pied de page de copyright à afficher au bas de la page ou de la projection des paroles.
• {ccli: ...} Le numéro CCLI de la chanson.
• {restrictions: ...} La gestion des droits pour la liste délimitée par des virgules des restrictions de la chanson. Consultez Restrictions pour plus de détails sur la définition des restrictions pour votre chanson.
• {composer: ...} Les personnes qui ont écrit la musique de la chanson. Cette liste doit être séparée par des points-virgules pour les valeurs distinctes.
• {lyricist: ...} Les personnes qui ont écrit les paroles de la chanson. Cette liste doit être séparée par des points-virgules pour les valeurs distinctes.

Étiquettes intégrées

Ces étiquettes sont utilisées dans le contenu de la chanson et peuvent être utilisées pour définir des sections ou pour formater des parties de la chanson.

• {define: ...} est utilisé pour définir des diagrammes d'accords personnalisés. Consultez Defining Chords pour plus d'informations.
• {comment: ...} ou {c: ...} Définit un commentaire et apparaît comme une instruction musicale.
• {comment_bold: ...} ou {cb: ...} Définit le texte à afficher en gras.
• {comment_italic: ...} ou {ci: ...} Définit le texte à afficher en italique.
• {guitar_comment: ...} ou {gc: ...} Définit un commentaire qui apparaît comme une instruction musicale.
• {start_of_verse: ..} ou {sov} Déclare le début d'une section de couplet avec une étiquette de section optionnelle.
• {end_of_verse} ou {eov} Déclare la fin d'une section de couplet.
• {start_of_chorus: ...} ou {soc} Déclare le début d'une section de refrain avec une étiquette de section optionnelle.
• {end_of_chorus} ou {eoc} Déclare la fin d'une section de refrain.
• {start_of_bridge: ...} ou {sob} Déclare le début d'une section de pont avec une étiquette de section optionnelle.
• {end_of_bridge} ou {eob} Déclare la fin d'une section de pont.
• {start_of_part: ..} ou {sop} Déclare le début d'une partie avec une étiquette de section optionnelle.
• {end_of_part} ou {eop} Déclare la fin d'une partie.
• {start_of_tab} ou {sot} Déclare le début d'une tablature que OnSong affiche avec une police monospaced.
• {end_of_tab} ou {eot} Déclare la fin d'une section de tablature.
• {new_page} ou {np} Ceci est utilisé pour déclarer une nouvelle page.
• {new_physical_page} ou {npp} Ceci est utilisé pour déclarer une nouvelle page.

Étiquettes de formatage

Les étiquettes suivantes sont utilisées pour définir la police et la taille par défaut des paroles et des accords dans le diagramme d'accords.

• {textsize: ...} Définit la taille des paroles en tant que valeur numérique en points.
• {textfont: ...} Définit le nom de la police à utiliser pour les paroles. Doit être prise en charge sur la plateforme.
• {chordsize: ...} Définit la taille des accords en tant que valeur numérique en points.
• {chordfont: ...} Définit le nom de la police à utiliser pour les accords. Doit être prise en charge sur la plateforme.

Extensions de fichier prises en charge

Le format de fichier ChordPro est unique en ce sens qu'il s'agit d'une syntaxe communément acceptée, mais pas d'un format standard. Cela signifie que divers fournisseurs peuvent l'implémenter de différentes manières et avec différentes extensions de fichier. OnSong prend en charge les extensions de fichier suivantes lors de l'importation de fichiers au format ChordPro :

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