Plugin Barre Typographique Enluminée

All contributions published for previous SPIP versions

La Barre Typographique Enluminée (BTE) se propose d’améliorer l’accès aux raccourcis typographiques de SPIP et d’en ajouter.

La barre typographique de SPIP ne permet pas d’accéder à toutes les options de raccourcis typographiques de SPIP. D’autre part, certains fonctionnalités typographiques ne sont pas nativement disponibles dans SPIP. La Barre Typographique Enluminée (BTE) est une tentative pour répondre à ces 2 besoins.

Attention : ce plugin n’est plus et ne sera plus maintenu : il est désormais remplacé par 2 plugins : Plugin Barre Typographique V2 et Plugin Enluminures typographiques pour SPIP 1.9.2 qui à eux deux sont fonctionnellement équivalents.

Avertissement

Attention : Il ne faut pas confondre la BTE avec la Barre Typo Ecologique. Cette dernière a été conçue pour ne par forker [1] inc/texte.php de SPIP. La BTE avec SPIP 1.9.2 ne forke plus inc/texte.php.

Installation

Comme tout plugin, la BTE s’installe en prenant l’archive de la BTE sur la zone et en en mettant le contenu [2] dans le dossier plugins/ de SPIP (à créer au besoin).

Le rendu sur le site public utilisera la feuille de style du plugin pour le rendu des éléments supplémentaires sous réserve que le squelette utilise la balise #INSERT_HEAD (ce qui est le cas des squelettes par défaut de la dist/).

Présentation

Au chargement, la BTE se présente ainsi :

BTE au chargement de la page d'édition
BTE au chargement de la page d’édition

De nombreuses options de la BTE sont masquées au chargement et apparaissent en cliquant sur le bouton associé :

BTE déployée avec toutes ses options
BTE déployée avec toutes ses options

La BTE dispose d’un éditeur de tableau plus ergonomique :

Editeur de tableaux de la BTE
Editeur de tableaux de la BTE

Cerise sur le gâteau, un mode prévisualisation est disponible qui permet de voir au fur et à mesure de la frappe le résultat de la transformation des raccourcis typographiques en HTML :

Prévisualisation en temps réel avec la BTE
Prévisualisation en temps réel avec la BTE

À noter : ce résultat est différent de celui qui sera obtenu sur le site public : la prévisualisation ne concerne que la transformation en HTML, pas le rendu final qui peut de toute manière changer selon le squelette utilisé [3].

Fonctionnalités clefs

  • gestion des bulles d’aides et de la langue sur les liens
  • gestion des ancres : création et liens vers une ancre
  • recherche dans le texte
  • rechercher/remplacer (à la demande ou sur tout le texte)
  • changer la casse (passer un texte tout en majuscule ou tout en minuscule)
    s’applique à la sélection ou à tout le texte
  • quelques caractères spécieux en plus
  • un éditeur de tableau ergonomique (pour modifier un tableau, il faut d’abord le sélectionner entièrement.

Raccourcis supplémentaires

  • acronymes
  • des flèches, copyright, registered, trade mark
  • des niveaux de titre supplémentaires
  • mise en exposant
  • petites capitales
  • centré, aligné à droite
  • mise en évidence (un gras en couleur)
  • encadrement du texte

Remarque : le traitements des raccourcis de caractères est fait pour tous les champs de SPIP (en particulier #TITRE), alors que ce n’est pas le cas nativement dans SPIP (essayez de faire un italique dans un titre !).

Personnalisation

Il est possible de personnaliser le html produit par les différents niveaux de titre. Dans config/mes_options.php (ou ecrire/mes_options.php avant SPIP 1.9.2) :

$GLOBALS['barre_typo_pas_de_fausses_puces'] = true;

$GLOBALS['debut_intertitre'] = '<h2 class="spip">';
$GLOBALS['fin_intertitre'] = '</h2>';
$GLOBALS['debut_intertitre_2'] = '<h3 class="spip">';
$GLOBALS['fin_intertitre_2'] = '</h3>';
$GLOBALS['debut_intertitre_3'] = '<h4 class="spip">';
$GLOBALS['fin_intertitre_3'] = '</h4>';
$GLOBALS['debut_intertitre_4'] = '<h5 class="spip">';
$GLOBALS['fin_intertitre_4'] = '</h5>';
$GLOBALS['debut_intertitre_5'] = '<h6 class="spip">';
$GLOBALS['fin_intertitre_5'] = '</h6>';

La première option permet de spécifier que les “-” en début de ligne seront transformés en “-*” ce qui au final donnera de vraies listes à puces.
Le comportement par défaut du plugin est donc identique à celui de SPIP.

Les autres options permettent de spécifier le HTML générés par les différents niveaux de titre. Ici, on commence à H2 au lieu du H3 natif de SPIP.
Là encore, le plugin ne change rien au comportement par défaut de SPIP qui génère donc bien un H3 pour {{{

Màj du 10 mars 2007 : il n’est plus nécessaire de modifier sa feuille de style : les styles de la BTE sont par défaut intégrés dans vos squelettes si ceux-ci utilisent la balise #INSERT_HEAD (c’est le cas de la dist/).
Pour désactiver cette insertion, dans mes_options.php :

$GLOBALS['BarreTypoEnrichie_Preserve_Header'] = true;

2e mise à jour du 10 mars 2007 : utilisation possible du plugin cfg qui permet de configurer tout ce qui précède sans toucher au mes_options ! URL de config en bas du descriptif du plugin dans la page d’installation des plugins.

Footnotes

[1Fork : terme désignant une modification d’un logiciel libre qui n’est plus compatible avec la branche principale du dit logiciel

[2Attention, il faut que ce contenu soit au final dans au moins un sous dossier !

[3Le propre de SPIP étant de séparer contenu de présentation, un même site pourra voir son apparence changer au cours du temps. C’est le cas en particulier de SPIP contrib.

Avertissement important : si vous utilisez les raccourcis typographiques supplémentaires de ce plugin et que vous cessez d’utiliser le plugin, ces raccourcis resteront dans votre texte et le pollueront. Il n’y a pas de procédure de désinstallation.

L’essayer, c’est l’adopter à vie !

Et pour les plus aventureux, il est possible d’en suivre les évolutions : Historique des révisions sur la zone voire d’y participer.

updated on 29 September 2018

Discussion

23 discussions

  • 1

    Juste pour dire un grand MERCI pour cette contrib.
    Pour moi il manque seulement le souligné, mais bon ...
    On tous les cas ça me rend un grand service, voila c’est dit.
    MKO.

    • Avec grand plaisir !

      Pour le souligné, c’est définitivement non. Pour 2 raisons :

      • l’une typographique : le souligné coupe le jambage des lettres et rallenti la lecture (en souligné, dans pas mal de polices, q et g ont le même aspect, le souligné passant sur la partie horizontale du bas du g).
      • l’autre propre au web : seuls les liens doivent être soulignés dans une page web

    Reply to this message

  • 3

    “ne par forker” Kessako ?

    Je viens de passer en 1.9.2 et le plugin barre typographique enrichie ne fonctionnait plus. J’ai remis mes titres normalement... Va falloir recommencer la mise en page... Si j’avais su. Mais bon, ça semble bien foutu et riche en possibilités. Pour éviter les chipos, prévoir la compatibilité simultanée avec spip 1.9.3 etc.

    • Tu es sûr d’avoir bien pris la dernière version disponible sur la zone ?

      Et d’avoir enlever le plugin jquery qu’il ne faut plus mettre en place en 1.9.2 ?

    • Tu peux récupérer la partie tes tags par la procédure suivante

      dans le fichier mes_options.php sous le répertoire config copie les fonctions du fichier typo_enrichie.php

      change le nom de   function BarreTypoEnrichie_pre_propre($texte) {.......} 
      en    function avant_propre($texte){...           }
      
      et celui de function BarreTypoEnrichie_post_propre($texte) {..} en  function apres_propre($texte) {..}
      
      
      je n'ai pas gardé  function BarreTypoEnrichie_post_typo($texte) , function BarreTypoEnrichie_nettoyer_raccourcis_typo($texte) et function BarreTypoEnrichie_header_prive($texte)  mais c'est à voir..

      rajoute end ébut de fichier :

      function ereg_remplace($cherche_tableau, $remplace_tableau, $texte) {
              global $flag_pcre;
      
              if ($flag_pcre) return preg_replace($cherche_tableau, $remplace_tableau, $texte);
      
              $n = count($cherche_tableau);
      
              for ($i = 0; $i < $n; $i++) {
                      $texte = ereg_replace(substr($cherche_tableau[$i], 1, -1), $remplace_tableau[$i], $texte);
              }
              return $texte;
      }
      
       

      Chez moi cela marche .. tu peux rajouter tes propres raccourcis ou en enlever.. mais bon tu n’auras plus la barre typo enrichis

    • « ne par forker » Kessako ?

      Tu as lu la note de bas de page associée ?

    Reply to this message

  • 1
    Stéphane

    Y’a t’il des choses particulières à faire lorsqu’on passe de la BT enrichie (1.9.1) à la BTE (1.9.2) comme modifier les css ?

    merci et merci pour cet outil

    • J’ai fait une mise à jour de l’article. En version 1.5 de la BTE, ce n’est plus forcément nécessaire de modifier sa feuille de style.

    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