ChordPro

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

Le format ChordPro permet d'exprimer les informations sur les chansons dans des balises délimitées par des accolades. Ces informations peuvent être logiquement divisées 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 de métadonnées de la chanson. Dans les balises suivantes, trois points (...) représentent le texte que vous fournissez, qui se trouve entre les deux-points et l'accolade de fermeture. Par exemple :

{title: Amazing Grace}
{key: G}

OnSong prend en charge 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 sous-titre. 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 sous-titre. 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. Ceci s'affiche au bas de la grille d'accords et dans la projection des paroles.
• {key: ...} ou {k: ...} ou {ok: ...} La tonalité de la chanson écrite comme une tonalité avec préférence enharmonique et un « m » optionnel pour indiquer mineur. - alphabétique, par exemple 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 temporelle - numérique temps sur mesure, par exemple 3/4
• {duration: ...} La durée de la chanson pour le défilement automatique - secondes ou mm:ss
• {book: ...} Le nom du ou des livres pour classer la chanson. Il s'agit d'une liste séparé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éé.
• {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. Consultez Flux 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 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 la Visionneuse de chanson. Consultez 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 Diapason.
• {keywords: ...} ou {topic: ...} La liste des étiquettes à utiliser avec la recherche par sujet. Consultez Sujets pour plus d'informations sur la navigation par sujet.
• {copyright: ...} ou {footer: ...} Spécifie le texte de pied de page de copyright à afficher au bas de la page ou dans la projection des paroles.
• {ccli: ...} Le numéro CCLI de la chanson.
• {restrictions: ...} La gestion des droits pour la liste séparé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.

Balises en ligne

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

• {define: ...} est utilisé pour définir des diagrammes d'accords personnalisés. Consultez Définition des accords 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 de la tablature que OnSong affiche dans une police à largeur fixe.
• {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 par défaut et la taille des paroles et des accords dans la grille 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 supportée 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 supportée 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 couramment acceptée, mais pas d'un format standard. Cela signifie que différents fournisseurs peuvent l'implémenter de différentes manières et avec des extensions de fichier différentes. OnSong prend en charge les extensions de fichier suivantes lors de l'importation de fichiers au format ChordPro :

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