Format texte des chansons

"Le chansonnier" affiche et imprime des chansons mises en forme avec des colonnes, les accords au-dessus du texte, des diagrammes d'accord ... mais de manière interne les chansons sont stoquées sous un simple format texte.
Ce format texte des chansons est visible à deux endroits:

Ce format texte à été conçu pour être simple à comprendre et pour pouvoir être modifié manuellment dans un éditeur de texte. Le but de ce document est de détailler ce format.

Vue d'ensemble du format texte

Une chanson standard ressemble à ceci:

sections du format texte des chansons

Le format texte des chansons est composé des sections suivantes (toujours dans cet ordre); chaque section sera décrites en détail plus bas.

  1. Les propriétés de la chanson: les proipriétés sont uniquement visibles dans les fichiers '.sng'. Elles encodent les données relatives à la chanson.
    Elles ne son pas affichées dans l'écran d'édition des chansons, car, dans l'application même, elles sont affichées (et modifiées) dans la boîte de dialogue d'édition des données de chansons.
    Format d'une propriété:
    {nomPropriété: valeurPropriété}
  2. Les commentaires (facultatif). Les commentaires sont des lignes commençant par le caractère '#'.
    Format:
    # ceci est un commentaire
    # ...
  3. Les définitions d'accord (facultatif).
    Certaines définitions d'accord peuvent être faites pour l'ensemble de la chanson. C'est utile quand un doigté spécial ou un accord rare est utilisé dans tout la chanson. Dans ce case, la définition de l'accord peut être faite au niveau global dans la section "définition d'accords" et être utilisée partout dans la chanson sans devoir réécrire chaque fois le doigté de l'accord.
    Format:
    {accords}
    nom-de-l-accord=position-de-l-accord
    ...
  4. Les blocs: Les blocs forment le corps du texte de la chanson. Is sont affichés comme des surface rectangulaires insécable contenant du texte et ocasionellement des accords. Les blocs peuvent aussi avoir une étiquette. Quant vois transcrivez une chanson, vous créez, en général, un bloc par couplet et un bloc pour le refrain.
    Les blocs sont de deux types:
     

Les propriétés de la chanson

Les propriétés de la chanson contiennet des données à propose da la chanson. Ces données sont utilisées pour construire l'en-tête de la chanson (La partie affichant le titre, l'interprète, l'année de création, les auteurs... ) quand celle-ci est affichée.
Le format d'un propriété est::

{nomPropriété: valeurPropriété}
Où le nom de la propriété doit être un des élément de la liste décrite ci-dessous.

Le propriétés disponibles sont:

Dans les données du "Chansonnier", les noms d'auteur et les tritres des chansons peuvent définir un 'préfixe'. (Comme 'The' pour 'The Beatles'). Les préfixes (tout comme les prénoms des auteurs) sont ignorés lors du tri alphabétique (Ainsi le groupe 'The Beatles' apparais à la letter 'B' et non 'T'). Ils sont parfois affichés devant le nom d'auteur, parfois après en fonction du contexte. Malheureusement, quand un nom d'auteur est écrit dans du texte, le programme ne peut déduire quelle partie du nom est le préfixe (ou le prénom) et quelle partie est le nom lui-même. C'est pouquoi, quand vous écrivez un nom d'auteur dans les propriétés, le préfixe (ou prénom) doit être explicitement placé entre crochet. La même rêgle s'applique au tritre des chansosns (si vous voulez définir de préfixes dans ce cas aussi).

N.B.: Si vous éditez le text des chansons dans l'application "Le Chansonnier" même, vouis ne verrez pas apparaître les propriétés. Dans l'application elles sont gérées dans la boîte de dialogue d'édition des données de chansons . Les propriétés apparaissent uniquement si vous exportez les textes des chansons dans des fichiers au format ".sng".

Exemple de propriététes de chansons:

{Titre: [A] hard day's night}
{Interprète: [The] Beatles}
{Langue: en}
{Année: 1964}
{Paroles: [John] Lennon, [Paul] Mc Cartney}
{Musique: [John] Lennon, [Paul] Mc Cartney}

Les commentaires de la chanson

Les commentaires qui sont dans le texte de la chanson ne sont pas visible dans le reste de l'application.
Tout ligne démarrant avec le caractère '#' est un commentaire.

Exemple de commentaire:

# -----------------------------------
#
# Transcrite pour raison d'étude seulement
# par O. Berlanger :-)
#
# -----------------------------------

Les définitions d'accord

La section des définitions d'accord est un moyen de définir des positions d'accords par défaut pour l'ensemble de la chanson. Utilisez les quand vous devez définir un doigté spécial pour un accord dans une chanson ou pour définir des accords spéciaux qui ne sont pas définis par défaut dans le système.
La solution alternative (à une définition globale) est de définir les positions des accords a chaque occurence de ces accords dans le texte de la chanson.
Notez bien que cette section de définition d'accord nes pas visible quand la chanson est affichée. Elle est uniquement là pour définir des valeurs par défaut. Le fait que les diagrammes d'accords soient affichées et l'ensemble effectif des diagrammes affichés n'est pas controllé par cette section.

Le format des définitions d'accord est:

{accords}
nomAccord1=position1
nomAccord2=position2
...
Allez au chapitre Definition des accords pour une description de ce qu'est effectivement un nom d'accord et une position.

Exemple de définition d'accords:

{accords}
RE/DO=x30232
SOL7M/SI=x20032
SOLm7M/SIb=x10032
RE5=x00235

Le bloc de texte et d'accords

Le bloc de texte et d'accords est le bloc le plus courrament utilisé pour encoder les chansons. Une chanson typique est représentée avec un bloc par couplet et un bloc pour le reafrain. Dans ce schéma usuel, les couplets ont l'étiquette "1.", "2.", "3." ... et le refrain simplement "Ref.".

Ce bloc peut contenir des accords, les noms des accords sont insérés dans le texte entre crochets. Quand un bloc est affiché, le nom de l'accord est affiché au-dessus de la ligne de texte. La poisition de l'accord est calculée pour qu'il apparaisse juste au-dessus de l'endroit du texte où étaient insérés les crochets.
Allez au chapitre Definition des accords savoir comment nommer effectivement les accords.

N.B.: Un bloc ne peut pas contenir plus d'une ligne blanche consécutive. Si il en contient deux (ou plus), le programme coupe le bloc en deux en creéant un nouveau bloc (sans étiquette).

Exemple de bloc de texte et d'accords:

{blck: Ref.}
When I'm [SIm]home,
Everything [MIm]seems to be all [SIm]right,
When I'm [SOL=320033]home,
[MIm]Feeling you holding me [DO]tight, [RE]tight, yeah.

Le bloc préformatté

Le bloc préformatté est un moyen pour introduire de petites tablatures dans un carnet de chant. Il est particulièrement utilisé pour afficher de petites introduction ou des transtions.
Sachez que l'application n'essaye en aucaun cas d'interpréter le contenu de cest bloc. Donc, même s'ils contiennent des accords, ceux-ci ne seront pas affichés en gras ni traduit ou transposés avec le reste de la chanson.

Exemple de bloc préformatté:

{tab: Intro.}
      Si                Mi                La               Ré
 Mi|-----------------|--0---0---0---0---|-0---0---0---0--|-2----|
 Si|--4---4---4---4--|--0---0---0---0---|-2---2---2---2--|-3----|
Sol|--4---4---4---4--|--1---1---1---1---|-2---2---2---2--|-2----|
 Ré|--4---4---4---4--|--2---0---2---2---|-2---2---2---2--|-0----|
 La|--2---0---x---x--|----------4---2---|-0---0---0---0--|------|
 Mi|----------4---2--|------------------|-----3---2---0--|------|

La définition d'un accord

Les accords sont le point central de cette application. Il nécessitent donc une définition intelligente permettant au système de les détecter, de les traduires (dans de style angails: "A", "B", "C" ou français "Do", "Ré", "Mi"), de les transposer et de générer des diagramms de position.
Chaque accord est composé de deux parties:

Le nom de l'accord

Le nom d'un accord est lui-même composé de plusieur parties (apparaissant toujours dans l'ordre ci-après et où le nom de la note est la seule partie obligatoire):

  1. Le nom de la note de base de l'accord: c'est un des noms suivants: "A", "B", "C", "D", "E", "F", "G", "DO", "RE", "MI", "FA", "SOL", "LA", "SI".
    Le programme accepte les nom tant en majuscules que minuscules, mais ils seront toujours affichés en majuscules.
  2. L'alteration: dièse "#" ou bémol "b".
  3. Le chiffre de l'accord: c'est une suite de chiffres et lettres donnant le 'type' de l'accord (comme 'mineur', 'quatrième augmentée' ...).
    En fait, vous pouvez chiffrer les accords comme vous le voulez car le programme n'essaye pas d'interpréter cette partie du nom. La seule conséquence résulant de l'utilisation de 'chiffres' atypiques est que le programme ne pourra pas proposer de position par défaut pour cet accord. Vous serez alors obligés d'en proposer une vous-même.
  4. La basses: le caractère barre oblique '/' suivi du nom de la note basse et acessoirement d'une altération.
Un nom d'accord où tous ces éléments apparaissent est, par exemple: SOL#m7/SIb

La position de l'accord

Dans les cas simple, le nom de l'accord suffit car le pogramme connait le doigté de beaucoup d'accords. Mais si vous voulez utiliser des accords 'exotiques' ou des doigtés spéciaux pour des accords connus, ou simplement deux doigtés différents pour le même accord dans une chanson, alors vous devez spécifier la position des accords.
La poistion d'un accord set composée des éléments suivants (toujours dans cet ordre):

  1. le caractère égal '='.
  2. Six chiffres ou lettres dénotant la position des doigts sur les six cordes. Le premier caractère est pour la corde 'Mi' basse, le second pour la corde 'La' et ainsi de suite...
    Les valeur possibles pour ces caractères (chiffre ou lettres) sont:
  3. Après ces chiffres viennent des indications a propos des barrés: le caractère barre verticale '|' seul dénote un grand barré à travers tout le manche.
    Le caractère barre verticale '|' suivi d'un chiffre ou d'une lettre dénote un petit barré (un doigt presse différentes cordes mais pas toutes) dans la case correspondante.

 
 

Exemples de positions d'accords

C chord

DO=030210

L'accord somple de DO majeur.
Remarquez que, comme c'est la position par défaut pour cet accord,
vous n'êtes pas obligés d'ajouter la position.

SOL=355433|

L'accord de SOL utilisant un grand barré à la case 3.

G barre chord
C13 chord

DO13=x32355|5

L'accord DO13 est un exemeple d'utilisation du petit barré.
(le petit doigt presse deux cordes à la case 5).