====== Installation du module GeSHi ======

| **Note:** Je n'utilise plus le module GeSHi, je lui préfère le module **CKEditor CodeSnippet** |

===== Installation du module Libraries =====

Si ce n'est pas encore fait, ce module est nécessaire pour le module GeSHi.

  * Aller sur [[https://www.drupal.org/project/libraries]]
  * Copier le lien vers le fichier **.zip** ou **.tar.gz** de la version pour Drupal 8 (même si elle est encore en alpha lors de l'écriture de ces lignes)
  * Coller ce lien dans la page **Manage > Extend > Install new module** dans le champ **Install from a URL**
  * Cliquer sur **Install**
  * Une fois l'installation terminée, revenir à la liste des modules et **activer** le module **Libraries**

===== Installation du module GeSHi =====

  * Aller sur [[https://www.drupal.org/project/geshifilter]]
  * Copier le lien vers le fichier **.zip** ou **.tar.gz** de la version stable pour Drupal 8
  * Coller ce lien dans la page **Manage > Extend > Install new module** dans le champ **Install from a URL**
  * Cliquer sur **Install**
  * Une fois l'installation terminée, revenir à la liste des modules et **activer** le module **GeSHi Filter**

===== Installation de la librairie GeSHi =====

Le module que nous venons d'installer nécessite la présence de la **librairie GeSHi**.

  * Aller sur [[https://github.com/GeSHi/geshi-1.0]] et télécharger le fichier **geshi-1.0-master.zip**
  * Uploader ce fichier sur le serveur et le décompresser quelque part
  * L'archive contient un dossier **src**
    * Copier le **contenu** du dossier **src** vers **/var/www/drupal/libraries/geshi**
    * Le chemin vers **geshi.php** doit être **/var/www/drupal/libraries/geshi/geshi.php**

===== Configuration du filtre =====

  * Aller dans le menu **Manage > Configuration > Content authoring > Geshifilter**
  * Il doit y avoir un bloc intitulé **GeSHi library version 1.0.9.0 detected**
  * Il y a de nombreuses options de configuration disponibles pour ce module

==== Sélection des langages disponibles ====

  * L'onglet **Languages** permet d'activer ou désactiver les langages que l'on compte utiliser sur le site.
  * N'activer que les langages nécessaires, afin d'éviter de surcharger le module.

===== Activation du filtre dans les formats de textes =====

  * Aller dans le menu **Manage > Configuration > Content authoring > Text formats and editors**
  * Pour chaque format de texte pour lequel on compte utiliser le filtre
    * Cliquer sur le bouton **Configure** à droite du format
    * Dans la partie **Enabled filters**
      * Cocher la case **GeSHi filter**
    * Dans la partie **Filter processing order**
      * Positionner **GeSHi** en dernier
    * Cliquer sur **Save configuration**