INTRW / Coloration syntaxique pour SPIP

Définition

La coloration syntaxique est le fait de mettre en valeur la syntaxe d’un texte (souvent du code source) en utilisant des couleurs différentes pour les différents types de mots (mots clefs, variable, commentaires, etc.)

Sources :
– Coloration syntaxique
– colorisation syntaxique ou colorisation syntaxique

La coloration syntaxique est principalement une fonction des éditeurs de texte (et IDE) pour développeur mais il est aussi utile de coloriser des exemples de code pour de la documentation et des présentations.

Général

Pour obtenir des exemples de code source colorisés pour nos sites web, il y a trois manières principales de procéder.

Le travail peut soit être fait :
– côté serveur avec par exemple geshi.org
– côté client avec par exemple SyntaxHighlighter - Alex Gorbatchev (sur code.google.com)
– ou par vous même en générant du html qui est ensuite inclue directement dans le document principal . (par exemple avec pygments)
– Il ne faut pas oublier nos éditeurs de texte et IDE qui permettent souvent d’exporter sous différentes forme le code colorisé. (Possible avec Scite et je suis sûr beaucoup d’autres)

SPIP

Revenons à SPIP, de gentils contributeurs ont créé des plugins pour avoir la coloration dans les articles SPIP.

D’abord, le plugin Coloration Code basé sur geshi :
– La fiche officielle sur plugins.spip.net
– Plus d’explications sur spip-contrib.net
Il a l’avantage d’avoir un mode SPIP

Maintenant un plugin qui utilise la bibliothèque javascript SyntaxHighlighter :
– Plugin SPIP pour SyntaxHighlighter

pygmentize

Notes sur l’utilisation de pygments.

Usage de la ligne de commande pygments :
Générer la feuille de style ...

pygmentize -f html -S colorful -a .syntax

Générer le code html ...

pygmentize -o test.html test.py

Note : Generate HTML syntax-highlighted listings for any file using pygments « ActiveState Code

Sémantique

Et pour que tout cela ai du sens :
– Mettez du code dans vos pages web