diff --git a/Définition-de-notre-variante-du-format-Chordpro.md b/Définition-de-notre-variante-du-format-Chordpro.md new file mode 100644 index 0000000..dc520ee --- /dev/null +++ b/Définition-de-notre-variante-du-format-Chordpro.md @@ -0,0 +1,60 @@ +# 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. + +## 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. + +## 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é. TODO : Dans quel format doit être indiquée la tonalité ? +- [ ] ``tag`` : Étiquette. Utiliser plusieurs fois cette balise pour plusieurs tags. + +- [ ] ``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](/patacrep/patacrep-doc/blob/405c25f6c0242424f8967668945790b6c89803ee/song.rst#index)) : ``{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 + +- [ ] ``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 `/img`, ou relatif à ``. +- [ ] ``capo`` : Entier. + +## Partition + +- [ ] ``lilypond`` : Fichier `.ly`. + +## 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. TODO Quel est le format de ces tablatures ? +- [ ] ``define`` : Définition de diagrammes d'accords + - Format du diagramme `` base-fret frets ``. +- [ ] ``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). +- [ ] ``meta:`` : 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}`` + +## Liens + +Voici les pages décrivant les variantes du format utilisées par d'autres logiciels. + +- http://tenbyten.com/software/songsgen/help/HtmlHelp/files_reference.htm +- http://www.vromans.org/johan/projects/Chordii/chordpro/index.html +- http://home.online.no/~oeborger/skript/choprodirectives.html +- http://linkesoft.com/songbook/manual.html#chordproformat +- http://linkesoft.com/songbook/chordproformat.html +- http://onsongapp.com/manual/index.php?topic=ChordPro%20Format