Skip to content

chordpro

Jump to bottom Edit New page
oliverpool edited this page Aug 27, 2018 · 17 revisions

Balises utilisées pour le format chordpro

Voici la liste des balises utilisées pour le format chordpro. Les balises cochées sont celles pour lesquelles il y a consensus.

Metadonnées

  • title t subtitle st : Titres et sous-titre. La première balise title (ou t) désigne le titre principal, les autres balises désignent les autres titres (il n'y a alors pas de différences entre titres et sous-titres).

  • key : Tonalité. La tonalité doit être renseignée dans le format [A-G]([b#][m]), soit par exemple A ou Gbm.

  • tag : Étiquette. Utiliser plusieurs fois cette balise pour plusieurs tags.

    Ou séparer par des ; ou , ? -- oliverpool

  • lang language Code langue (usuellement 2 lettres) représentant la langue principale de la chanson : (fr, en, de, es, it, pt) #124

  • album a : Album.

  • artist by : Artiste. TODO Comment faire pour plusieurs artistes (par exemple, une musique de Jean Boyer chantée par Brassens) ?

    • Plusieurs balises artist : {artist: Georges Brassens} {artist: Jean Boyer}
    • Une balise artiste, interprétée comme le champ by de \beginsong, et configurable dans le fichier .sb (voir la section auteur) : {artist:Paroles et musique de Jean Boyer, chantée par Brassens….
    • Des balises spécifiques : {lyrics:Jean Boyer} {singer:Georges Brassens}.
    • Autre ?

    Ma préférence va à la combinaison des deux premières propositions. -- spalax

    Ok pour les deux premières propositions (soit des balises différentes, soit les artistes sont séparés par de la ponctuation : , ou ;) -- paternal & oliverpool

  • copyright : Champs copyright de songs.

  • cover : Image (fichier présent dans le même répertoire que le fichier de chanson).

  • vcover : Image (fichier présent dans le répertoire <datadir>/img, ou relatif à <datadir>.

La balise cover couvre les deux das de figure : elle est remplacée par vcover par l'interpréteur si nécéssaire -- paternal & oliverpool

  • capo : Entier.

Partition

  • lilypond : Fichier .ly. Le chemin doit être relatif à la chanson ou à un datadir #125

Musique

  • comment c : Équivalent à \textnote
  • guitar_comment gc : Équivalent à \musicnote
  • start_of_chorus soc end_of_chorus eoc : Refrain
  • start_of_tab sot end_of_tab eot : Tablatures. Ces tablatures sont des tablatures ASCII qui seront rendues dans une police à chasse fixe.
  • define : Définition de diagrammes d'accords
    • Format du diagramme <chord> base-fret <base> frets <Low-E> <A> <D> <G> <B> <E>.
  • start_of_bridge sob end_of_bridge eob : Bridge.

Spécifique

  • columns : Nombre de colonnes.

  • # : Commentaire : les lignes commençant par ce symbole sont ignorées.

  • encoding : Encodage du fichier (doit être présent dans les X premières lignes). Je ne suis pas vraiment sûr pour celui-là. Ne pas l'utiliser si on accepte les commentaires (point précédent).

    Plutôt favorable pour utiliser les commentaires, si cela s'avère nécessaire -- paternal & oliverpool

  • meta:<key> : Si l'utilisateur (avancé) a défini une nouvelle clef clef au paquet songs, il peut la définir dans ses chansons en utilisant {meta:clef:Valeur} #220

Ignorée

  • new_song ns : Commencer une nouvelle chanson. Pour le moment, on n'accepte qu'une chanson par fichier. Donc l'analyseur affiche un warning « Balise ignorée », mais il compile normalement.

Liens

Voici les pages décrivant les variantes du format utilisées par d'autres logiciels.

Add a custom footer
Add a custom sidebar
Clone this wiki locally