Created Définition de notre variante du format Chordpro (markdown)

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 `<datadir>/img`, ou relatif à `<datadir>`.
+- [ ] ``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 ``<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).
+- [ ] ``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}``
+
+## 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