Plugin Barre Typographique Enluminée

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

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

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

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

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

À 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.

Notes

[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.

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom