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 balises délimitées par des accolades. Ces informations peuvent être divisées logiquement en balises de métadonnées et balises en ligne.

Balises de métadonnées

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

{title: Amazing Grace}
{key: G}

OnSong supporte les balises ChordPro suivantes :

• {title: ...} ou {t: ...} Le titre de la chanson.
• {subtitle: ...}, {st: ...} ou {su: ...} Le nom de l'artiste ou toute autre information de signature. 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 signature. 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: ...} ou {k: ...} ou {ok: ...} La tonalité de la chanson écrite comme une tonalité avec préférence enharmonique et un « m » facultatif pour indiquer mineur. - alphabétique, par ex. Bb ou Em
• {capo: ...} Le capo à définir comme nombre de frettes - numérique
• {tempo: ...} Les battements par minute (BPM) - numérique
• {time: ...} La signature de temps - temps numérique 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 lequel placer la chanson. Il s'agit d'une liste délimitée par des virgules de noms de livres dans laquelle 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 numéro à titre de référence.
• {flow: ...} L'arrangement des sections - liste des étiquettes de section. Voir Flux pour plus de détails sur l'arrangement du flux d'une chanson.
• {midi: ...} Les commandes MIDI à envoyer lors de la visualisation de la chanson. Voir Syntaxe MIDI 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 Lecteur de chanson. Voir Syntaxe MIDI pour savoir comment exprimer les commandes MIDI sous forme de texte dans OnSong.
• {pitch: ...} Les notes à jouer lors de l'utilisation de la fonction Tuyau de hauteur.
• {keywords: ...} ou {topic: ...} La liste des balises à utiliser avec la recherche par sujet. Voir Sujets pour plus d'informations sur la navigation par sujet.
• {copyright: ...} ou {footer: ...} ou {f: ...} Spécifie le texte du pied de page des droits d'auteur à afficher en bas de la page ou dans la projection de paroles.
• {ccli: ...} Le numéro CCLI de la chanson.
• {restrictions: ...} La gestion des droits pour la liste délimitée par des virgules de restrictions de la chanson. Voir 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.

Balises en ligne

Ces balises 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. Voir Définition des accords pour plus d'informations.
• {comment: ...} ou {c: ...} Définit un commentaire et s'affiche 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 s'affiche comme une instruction musicale.
• {start_of_verse: ..} ou {sov} Déclare le début d'une section de couplet avec une étiquette de section facultative.
• {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 facultative.
• {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 facultative.
• {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 facultative.
• {end_of_part} ou {eop} Déclare la fin d'une partie.
• {start_of_tab} ou {sot} Déclare le début de la tablature que OnSong rend dans une police monospace.
• {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.

Balises de formatage

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

• {textsize: ...} Définit la taille des paroles comme une 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 comme une 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 d'accord commun, mais pas d'un format standard. Cela signifie que différents fournisseurs peuvent l'implémenter de différentes manières et avec différentes extensions de fichier. OnSong supporte les extensions de fichier suivantes lors de l'importation de fichiers au format ChordPro :

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