De quoi je parle ?

Imaginez que vous rédigiez un devoir d'Histoire par exemple, avec un stylo et une feuille de papier. Ce devoir est constitué de paragraphes, eux-mêmes rassemblés en phrase.

Et dans chaque phrase, on peut distinguer plusieurs catégories, plusieurs groupes de mots. Par exemple, les dates (1941, 1515, 1993), et les noms propres (De Gaulle, Delacroix).

Voici un exemple de tel texte :

De Gaulle was a man, who lived at least one month in London between 1941 and 1993.

Delacroix was a painter, but he has no link at all with 1515 (yes this example is stupid).

Et bien, maintenant, tentez d'imaginer que votre feuille se mette à colorer ces différents types, ou catégories, d'une couleur différentes pour chaque unités de sens (ou catégories) :

• les dates en vert,
• les noms propres en mauve.

Voici le même morceau de texte, mais un peu coloré :

De Gaulle was a man, who lived at least one month in London between 1941 and 1993.

Delacroix was a painter, but he has no link at all with 1515 (yes this example is stupid).

C'est ce qu'on appelle de la coloration catégoricale (ou syntaxique).

Imaginez bien qu'un outil qui serait conçu pour colorer automatiquement vos devoirs d'Histoire n'aurait pas un immense dictionnaire fixé à l'avance, associant à chaque mot sa couleur, mais plutôt une description :

• les noms propres sont des mots commençant par une majuscule.
• les dates sont de la forme i, ii ou iii ou iiii, avec i un chiffre entre 0 et 9 (éventuellement un - devant);

Pourquoi syntaxique ?

Bien sûr, cela fait quelques années que je ne rédige plus de devoir d'Histoire, donc, me diriez-vous, quel rapport avec ce que je fais ?

Et bien voilà le détail de l'analogie précédente :

• le devoir que je rédige est un morceau de code (aussi appelé programme) que j'écrit,
• le stylo plume et la feuille de papier forment un éditeur de code,
• la famille devoirs d'Histoire est un langage informatique,
• les dates et les noms propres sont des catégories ou des éléments propres à ce langage.

Par exemple, un tel *langage* peut être :
* le langage que j'utilise pour générer cette page web, appelé ``reStructuredText``.
* ou le langage de la page elle même : ``HTML``.

<dt>Par exemple, un tel <em>langage</em> peut être :</dt>
<dd><ul class="first last simple">
<li>le langage que j’utilise pour générer cette page web, appelé <tt class="docutils literal"><span class="pre">reStructuredText</span></tt>.</li>
<li>ou le langage de la page elle même : <tt class="docutils literal"><span class="pre">HTML</span></tt>.</li>

Définir une telle syntaxe

En général, on utilise une notion venue de nos cours de langages formels : les expressions régulières (ou rationelles), aussi raccourci en regexp.

Par exemple, on peut définir :

• les dates comme : [-?][0-9][0-9]*. Le [-?] signifie qu'on peut mettre zéro ou un symbole -. Le [0-9] signifie un intervale: un symbole entre 0 et 9 : un chiffre. Le [0-9]* signifie donc zéro ou un ou plus d'un chiffre (autant qu'on veut).
• les noms propres comme [A-Z][a-zA-Z-']*. On impose de commencer par une majuscule, et ensuite on prend n'importe quelle lettre, avec un tiret -, ou un '.

Bien sûr, ces deux définitions sommaires réalisent :

• des faux positifs, en colorant les mots de début de phrase par exemple;
• des faux négatifs, en oubliant de colorer les noms propres qui contiennent des symboles spéciaux (ç ou é notamment).

Pour plus de détail, je vous renvoie à cette page wikipédia.

Un fichier .nanorc

Tout ce dont aura besoin Nano pour colorer un certain type de fichiers est un fichier de configuration, avec comme extension .nanorc (mais ce n'est qu'une convention).

Pour l'exemple des devoir d'histoire, laissez moi vous montrer comment concevoir un tel fichier histoire.nanorc. Le fichier complet est ici NanoSyntax/histoire.nanorc.

Il faut d'abord définir quelle syntaxe on explique :

syntax "histoire" "\.histoire$"

Le premier mot donne le nom de la syntaxe, et le second définit l'extension de nos devoirs d'Histoire.

Ensuite, on définit les dates comme expliqué plus haut :

color brightgreen "[0-9][0-9]*"
color brigthgreen "-[0-9][0-9]*"

On définit enfin les noms propres :

color brightmagenta "[A-Z][A-Za-z]*"

Quel résultat ?

L'image suivante montre le résultat :

On a donc obtenu exactement ce qu'on voulait.

Il faut bien retenir la syntaxe des .nanorc :

color une_couleur une_regexp

Les couleurs disponibles sont blue, red, green, yellow, black, magenta, cyan, white (white) (traditionnelement les 8 couleurs ANSI, notamment utilisées dans les terminaux UNIX et Linux, cf. ANSIColors-balises ou sa version plus récente ansicolortags).

On peut les préfixer du mot bright pour indiquer une couleur plus claire.

On peut aussi colorer le fond, en indiquant une seconde couleur :

color couleur_texte,couleur_fond une_regexp

On peut aussi utiliser la commande icolor pour capturer sans tenir compte de la casse.

Les regexps utilisées suivent la syntaxe des Perl regexps, un standard dans le monde Unix (aussi utilisée par Bash pour les filtres de fichiers, ou par grep pour le motif de recherche).

Une autre syntaxe possible est :

color ma_couleur start=regexp1 end=regexp2

Pour savoir comment charger ce fichier histoire.nanorc au démarrage de GNU/Nano, la suite est utile.

Comment utiliser ces fichiers .nanorc

Pour les utiliser, il faut éditer le fichier $HOME/.nanorc, qui doit contenir des lignes de la forme include "path/to/lang.nanorc".

Il est conseillé de créer un dossier $HOME/.nano/ d'y mettre les fichiers de coloration, et de rajouter une ligne dans son $HOME.nanorc pour inclure chaque fichier rajouté (ou alors d'utiliser NanoSyntax/.nanorc).

Ainsi, dans notre exemple pour les devoirs d'Histoire, on peut copier le fichier histoire.nanorc dans $HOME/.nano. Ensuite, il suffit de rajouter les deux lignes suivantes à son fichier $HOME/.nanorc :

## Pour les devoirs d'Histoire
include "~/.nano/histoire.nanorc"

Fichier jouet

Le fichier exemple histoire.nanorc est là NanoSyntax/histoire.nanorc.

Sources des différents fichiers

Seuls ocaml.nanorc, reST.nanorc, .nanorc, python.nanorc ont été modifiés par moi (ils sont sous licence GPL3, voir LICENSE.html pour plus d'infos).

Pour les autres, certains viennent des fichiers installés avec le paquet nano. D'autres viennent d'une collection de .nanorc trouvée sur doc.ubuntu-fr.org. Le fichier octave.lang viens du Wiki officiel pour GNU/Octave ici wiki.octave.org/Nano. Certains fichiers sont aussi trouvables sur le dépot github scopatz/nanorc.