Coloration Code

Basé sur le moteur Geshi, ce plu­gin per­met de colo­ri­ser du code source pour dif­fé­rents lan­ga­ges (dont HTML, PHP, SPIP...).

Il suf­fit de met­tre le code entre <code class="lan­gage">...</code> ou avec un cadre <cadre class="lan­gage">...</cadre>.
Ce qui per­met d’obte­nir ce genre de pré­sen­ta­tion :
avec <cadre class='html4strict'>

<head>
  <title>Plugins SPIP</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
  <script src="prive/javascript/jquery.js" type="text/javascript"></script>
  <script src="prive/javascript/jquery.form.js" type="text/javascript"></script>
  <script src="prive/javascript/ajaxCallback.js" type="text/javascript"></script>
  <!-- insert_head -->
  <link rel='stylesheet' href="prive/spip_style.css" type="text/css" />
  <link rel='stylesheet' href="http://plugins.spip.net/spip.php?page=css&amp;id_rubrique=1" type="text/css" />
  <link rel='stylesheet' href='http://plugins.spip.net/prive/spip_admin.css' type='text/css' />
</head>

avec <code class='html4strict sans_telechargement'>

<head>
  <title>Plugins SPIP</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
  <script src="prive/javascript/jquery.js" type="text/javascript"></script>
  <script src="prive/javascript/jquery.form.js" type="text/javascript"></script>
  <script src="prive/javascript/ajaxCallback.js" type="text/javascript"></script>
  <!-- insert_head -->
  <link rel='stylesheet' href="prive/spip_style.css" type="text/css" />
  <link rel='stylesheet' href="https://plugins.spip.net/spip.php?page=css&amp;id_rubrique=1" type="text/css" />
  <link rel='stylesheet' href='https://plugins.spip.net/prive/spip_admin.css' type='text/css' />
</head>

Les lan­ga­ges susceptibles d’être colorisés sont ceux four­nis dans https://zone.spip.org/trac/spip-zon... dont la classe sup­ple­men­taire : « spip ». Attention : pour coloriser du HTML ou du XHTML la « classe » doit être : "html4s­trict".

Par défaut, si le code colorisé fait plus d’une ligne, il est mis en cache sous forme tex­tuelle et pro­posé au télé­char­ge­ment par un lien Télécharger placé sous le bloc colorisé .
Ce fonc­tion­ne­ment est contrôlé glo­ba­le­ment par une cons­tante (par défaut définie à «true») : PLUGIN_COLORATION_CODE_TELECHARGE. Il peut être forcé loca­le­ment en rajou­tant la classe « sans_tele­char­ge­ment » dans un sens ou « char­ge­ment » dans l’autre ; par exemple : <code class="php sans_tele­char­ge­ment">.

Vous pou­vez aussi uti­li­ser le fil­tre |coloration_code_color dans un sque­lette avec : #TEXTE**|coloration_code_color{spip, code}
Le filtre colorise #TEXTE avec le lan­guage «spip» et en for­mat «code» ; par exem­ple avec un squelette nommé lecode.html, l’url d’appel depuis un arti­cle serait :

  1. <a href="#URL_SITE_SPIP/spip.php?page=lecode&id_article=#ENV{id_article}" title="voir le code de article" class="spip_in">Voir le code de l'article</a>

Coloration SPIP avec Coloration Code > 0.7.0

La version 0.7.0 de Coloration Code améliore grandement la coloration du code des squelettes SPIP. Cependant, elle nécessite, pour cette coloration là, une version de PCRE (ecrire/?exec=info pour la connaitre) au moins supérieure à 7.6. Pour sûr la version 8.12 de PCRE sur un PHP 5.3.5 fonctionne sans problème.

Cette version propose 2 types de coloration du code SPIP :

  • “spip” fait appel à une coloration utilisant des expressions régulières complexes et colorie bien mieux que les versions précédentes du plugin
  • “spip3” fait appel au phraseur et décompilateur de SPIP pour générer le code à colorier. De ce fait, la coloration est très précise mais certaines informations sont perdues car le code source est reconstruit : des espaces, sauts de lignes, changements de casse ou de syntaxe peuvent se produire. Le code généré est par contre toujours valide.

Coloration biblatex

Si vous souhaitez colorer du code de fichier .bib utilisant les nouveaux champs et types proposés par

[biblatex->http://www.ctan.org/biblatex], deux solutions s'offrent à vous:
- utiliser <code>biblatex

comme valeur l’attribut lang.
-  utiliser bibtex comme valeur l’attribut lang en ayant mis la ligne suivant dans votre fichier mes_options : define('_INTERDIRE_COMPACTE_HEAD_ECRIRE', 1);

updated on 2 October 2019

Discussion

19 discussions

  • 4

    Bof, bof, :) Comme dit si bien la documentation, ce ne sont que les les quelques cas pris en charge par SPIP qui sont colorisés ...alors que la bibliothèque Geshi permet bien plus :o
    Je continue à creuser :D

    • il suffit de mettre le nom du code dans la class du cadre?
      comme ceci, exemple d’un cadre code ou

      x = 1
      if x == 1:
          # indented four spaces
          print("x is 1.")
      package main
       
      import "fmt"
       
      func main() {
          fmt.Println("hello world")
      }
          #include <iostream>
          using namespace std;
          int main() 
          {
              cout << "Hello, World!";
              return 0;
          }
      if [[ ! -e "${archive_path}" ]]; then
              echo "dl paquet  ${dl_url}" >&2
              curl -fsSL "${curl_header[@]}" ${dl_url} -o ${archive_path} \
                  && log_success "paquet ${prefix} téléchargé" \
                  || log_error   "erreur lors du téléchargement ${prefix} ${repo} ${api_url}"
      fi

      Il vous faudrait la coloration pour quel langage?

    • bizarre dans la prévisualisation ça semble fonctionner :)

    • Comme mentionne la documentation du plugin :

      Les lan­ga­ges susceptibles d’être colorisés sont ceux four­nis dans https://zone.spip.net/trac/spip-zone/browser/_plugins_/coloration_code/branches/v0.6/geshi/geshi dont la classe sup­plemen­taire :

      Effectivement, il y a tous les langages supportés par GeSHi (j’avais cru, à la lecture, qu’une sélection avait été faite mais la bibliothèque/lib est visiblement complète)
      Au fait, pour le C++ c’est “cpp”

      Par contre, ça n’a pas l’air de fonctionner pour tous, comme le montrent tes exemples (j’avais, pour ma part, testé “go” et “python” aussi, ainsi que “sql”/“plsql”/“postgresql” qui n’ont pas fonctionné alors “mysql” et “spip” oui)

    • Bon, entre temps j’ai trouvé... GeSHi est bien appliqué (et en regardant le source de la page, “c++” est magiquement reconnu...) Par contre, il y ici (toujours dans le code source de la page) un appel à “plugins/gribouille2/css/geshi.css” qui associe les classes générées par GeSHi aux classes englobantes suivantes : “spip_spip” ; “spip_php” ; “spip_xml” ; “spip_css” ; “spip_bash”
      Donc, ce qui semble fonctionner chez moi doit provenir d’un plugin qui défini les CSS qui vont bien (sachant que le plugin lui-même ne propose que la numérotation dans l’espace privé...) Mystère résolu...

    Reply to this message

  • 1

    Hello,

    merci pour ce chouette plugin !

    Question: je suis sur un site multilingue, cependant les cadres affichent “Télécharger” quelle que soit la langue... je voulais voir si je pouvais faire une modification moi même, mais pas moyen de trouver la chaîne de caractère “Télécharger” dans le plugin, je suis confus ^^

    Merci !

    Sam.

    • Je m’empresse de répondre moi-même à mon énorme erreur: mais non, le texte change bien en fonction de la langue, tout est par-fait ! (erreur de cache).

      Merci encore pour ce beau travail !

    Reply to this message

  • Merci pour ce plugin,
    Je me demandais si ce ne serait pas intéressant d’ajouter une option start pour pouvoir citer du code en le localisant (ligne).

    <cadre class='php' start=385>
    // la fameuse ligne 385
    // la ligne 386
    //...

    Accessoirement, y’a-t-il un moyen d’échapper une ligne ? dans l’exemple dessus j’ai fermé le cadre 2 fois (puisque j’ai un cadre dans un cadre) et le intérieur ferme le cadre extérieur.
    Merci

    Reply to this message

  • Laurent Bloch

    Bonjour,

    La colorisation fonctionne correctement, mais le cadre du programme apparaît avec une marge gauche encombrante qui contient le texte “[code]”, je souhaiterais retirer cette marge ; cf. par exemple ici :
    https://www.laurentbloch.net/MySpip3/Knuth-Morris-Pratt-en-style

    J’ai regardé le fichier coloration_code.css, j’y ai vu des choses de 40px et 43px de large qui pourraient être ça, mais c’est trop mystérieux pour que j’y touche.

    J’utilise le squelette Escal, cela peut venir de là.

    Merci de toute indication !

    Reply to this message

  • J’aurais voulu ajouter une classe au code généré, pour pouvoir l’afficher au milieu du texte (en display:inline) dans certains cas précis.
    Y a-t’il un moyen de le faire ?
    J’ai testé code class=“html4strict inline”, mais le dernier attribut n’est pas pris en compte.

    Reply to this message

  • Bonjour

    Juste une petite remarque : le plugin en version 0.6.6 supprime toutes les lignes vides du texte mis entre les balises <cadre>...</cadre>
    C’est dommage, vu que ça enlève les lignes vide du code source que je veux afficher (et donc rend le code moins lisible)

    En commentant les lignes suivantes :

    $code = preg_replace("/^(\r\n|\n|\r)/m", "", $code);
    $code = preg_replace("/(\r\n|\n|\r)$/m", "", $code);

    de coloration_code_fonctions.php, on supprime le problème.
    À l’origine, ces lignes sont là pour enlever les lignes superflues en début de texte et en fin de texte. Mais ce n’est pas ce qu’elles font, en fait...
    (Peut-être que ceci est déjà corrigé dans la version 0.7 que je n’ai pas testé)

    Merci !!

    Reply to this message

  • Bonjour,

    Je rencontre le soucis suivant : j’ai imposé overflow:auto dans les pages de style pour spip_cadre et spip_code. Cela marche bien tant que je ne tente pas de coloriser. Mais dès que j’ajoute class=“un langage quelconque”, le scrolling horizontal ne se fait plus : il est remplacé par un passage à la ligne...

    Quelqu’un a-t-il déjà résolu ce problème ?

    Merci d’avance

    Reply to this message

  • 2 problèmes :

    je n’ai pas les numéros de ligne avec ie9 (serveur easyphp-5.3.4, win7) mais sur autre serveur (lamp ubuntu) oui

    et quand on copie le code avec numéro de ligne depuis poste en win xp , on a des #
    _

    Reply to this message

  • 2

    Je cherche a utiliser la fonction Highlighting Special Lines “Extra” de GeSHi.

    Je ne pense pas que cette fonction soit présente dans le plugin Coloration Code 2 pour spip. Si je me trompe comment faut-il la déclarer au cas par cas.
    ex :

    <..cadre class="SPIP" highlight="3">
    Mon code ici
    avec ma
    ligne 3
    en surbrillance
    <../cadre>

    Sinon je me doute que la modification va se faire dans le fichier coloration_code.php du plugin mais je ne vois pas trop comment.

    Une aide serait la bienvenue.

    Merci par avance.

    • Je me reponds à moi même, j’ai rajouté dans la function coloration_code_color :

      $geshi->set_highlight_lines_extra_style('background-color: #000000;');
              if(preg_match('/hightlight|\d/', $toHighlight, $out)){
      $geshi->highlight_lines_extra($out);

      Je ne suis pas expert des expressions régulières mais cela marche comme cela.

    • Bon juste au dessus ca marchait pour les lignes jusqu’à 9.

      J’ai amélioré un peu mon code pour pouvoir faire :

      1. <cadre class="php" highlight=1,2,8>

      Je détaille sur cet article les modifications apportées.

    Reply to this message

  • Compatible avec SPIP3.0-dev de ce que j’en ai vu ( pour le class=’spip’). Depuis il y a une nouvelle version de geshi ( GeSHi-1.0.8.10) qui semble apporter de nouveaux languages mais bon pas nécessaire d’en faire une nouvelle version je pense.

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom