Qu'est ce donc ?

Une fois que vous saurez que ce nom un peu idiot signifie Yet Another Syntax Highlighter, vous vous douterez de ce que propose ce plugin. Il s'agit donc encore d'un plugin de colorisation syntaxique de fragments de code qui pourraient être glissés dans un billet.

Contrairement à certains de ses compères pour Dotclear2, YASH n'utilise pas GeSHi, ni n'opère la colorisation côté serveur. YASH est principalement un plugin permettant d'intégrer et d'utiliser facilement la librairie Javascript Syntax Highlighter, opérant la colorisation côté client.

Comment ça s'installe ?

L'installation et la configuration de YASH sont quasiment identiques à ce qui est nécessaire pour le plugin commentsWikibar : il suffit d'installer le plugin et d'aller l'activer via son interface d'administration. Il est également possible de contrôler un peu le rendu en fournissant une feuille de style personnalisée.

Quelles sont les possibilités ?

La version de la librairie Javascript Syntax Highlighter embarquée est une version 1.6, en provenance du SVN au 29/05/2008. L'ensemble des scripts core et brushes constitue le fichier yash.js, sous forme minifiée.

Il est donc possible d'avoir la colorisation pour les langages suivants :

  • XML, XSLT, XHTML et HTML,
  • CSS,
  • Javascript,
  • PHP,
  • SQL,
  • Python,
  • Ruby,
  • Java,
  • C++,
  • C#,
  • Delphi,
  • et Visual Basic[1]

Comment l'utilise-t-on ?

Au moment de la rédaction, deux solutions s'offrent à vous. Si vous êtes un adepte du clavier, vous pouvez avoir recours directement à la macro wiki yash.

Vous l'utiliserez de la sorte :

///yash php
<?php
echo 'Hello World !';
?>
///

Vous indiquez donc le langage en guise de paramètre lors de l'appel de la macro. Pour la saisie en XHTML, vous devrez insérer des blocs sous la forme :

<pre class="brush: html">
...
</pre>

Mais si vous êtes plutôt un adepte du clic, le plugin ajoute également un bouton[2] dans la barre de mise en forme de l'éditeur Dotclear.

Et à part ça ?

Rien. J'ai fini. Ou presque.

Les derniers détails scabreux :

  • Il s'agit d'une version beta, mais je pense (j'espère) qu'elle ne devrait pas poser de problèmes particuliers.
  • Le plugin nécessite Dotclear2 RC1, évidemment, mais également un thème tirant pleinement partie des behaviors de présentation.
  • L'archive ZIP (23 Ko) est disponible ici-même et le sera bientôt via plugins.dotaddict.org.

Notes

[1] Ouaip ... Je l'ai laissé. :-p

[2] Une baguette magique, si, si !