SPIP - Contrib

SPIP - Contrib

[ar] [en] [es] [fr] [it]

101 visiteurs en ce moment

fontsizeup fontsizedown
[101 commentaires]

Plugin Barre Typographique V2

samedi 23 juin 2007, par bill, Joseph, RealET

3 votes

Le plugin Barre Typographique V2 vient remplacer la barre typographique standard de SPIP et en y ajoutant différents outils d’aide à la rédaction. Ce plugin ne modifie pas les raccourcis standard de SPIP.

La barre typographique de SPIP propose un nombre limité d’outils d’aide à la rédaction permettant d’insérer les raccourcis typographiques de SPIP dans un texte. La Barre Typographique V2 vise à fournir un nombre plus importants d’outils pour l’insertion des raccourcis standard de SPIP dans un texte.

Barre Typographique V2 et Barre Typographique Enluminée

Le plugin Barre Typographique Enluminée fournit à la fois des fonctionnalités supplémentaires à la barre typographique standard et ajoute de nouveaux raccourcis typographiques. Ces nouveaux raccourcis typographiques sont dépendants du plugin. Ainsi, si vous supprimez le plugin, ces raccourcis ne seront plus traités par SPIP et viendront polluer vos textes. Aucune procédure de désinstallation automatique de ces raccourcis n’est pour le moment disponible [1].

La Barre Typographique Enluminée a été scindée en deux plugins :

Pour obtenir les mêmes fonctionnalités que la Barre Typographique Enluminée (aide à la rédaction et nouveaux raccourcis typographiques), il faut installer à la fois la Barre Typographique V2 et le plugin Enluminures Typographiques. Pour disposer uniquement des outils d’aide à la rédaction sans la création de nouveaux raccourcis, il faut installer uniquement la Barre Typographique V2.

Pour information, la Barre Typographique Enluminée ne sera désormais plus maintenue au profit des deux nouveaux plugins.

Installation de la Barre Typographique V2

Ce plugin s’installe selon la procédure standard d’installation d’un plugin. L’archive zip du plugin est disponible sur SPIP-Zone.

Fonctionnalités ajoutées par la Barre Typographique V2

Les améliorations de la Barre Typographique (par rapport à celle standard de SPIP) sont les suivantes :

  • Mode prévisualisation intégré : c’est un aperçu de la traduction visuelle des raccourcis typographique (telle qu’on l’obtient quand on enregistre l’article).
    Ce n’est pas un aperçu de ce que ça donne dans le site [2].
  • Zone de saisie des liens améliorée.
  • Zone de gestion des ancres.
  • Zone de rechercher/remplacer.
  • Un peu plus de caractères spéciaux.
  • Passer la sélection en majuscules ou en minuscules (avec gestion des accents !).
  • Saisie de tableaux dans un assistant (et ensuite, modification possible avec ce dernier en ayant au préalable sélectionné le contenu du tableau)
  • Insertion d’images et de documents depuis l’intégralité du site facilitée.
  • Statistiques (nombre de mots, de caractères et de signes) sur le texte ou une sélection du texte.

La Barre Typographie V2 pliée :
La Barre Typo V2 pliée

La Barre Typographie V2 dépliée :
La Barre Typo V2 dépliée

Mode Prévisualitation

Icône Prévisualisation de la barre typo V2 Pour activer le mode prévisualisation, il faut cliquer sur l’icône en forme d’oeil. Un cadre rouge apparaitra alors sous le texte dans lequel s’affichera le texte en cours de rédaction mis en forme. Il permet de voir au fur et à mesure de la frappe le résultat de la transformation des raccourcis typographiques en HTML.

Exemple Prévisualisation Barre Typo V2

La prévisualisation est réactualisée à chaque action et au cours de la frappe si aucune touche n’est pressée pendant un délai d’une seconde. Comme le texte est envoyé au serveur pour que celui traîte les raccourcis de SPIP puis renvoyé au navigateur, si le réseau est saturé, la réactualisation peut prendre quelques secondes.

À 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]. Sur certains sites, en raison de problèmes de charset non encore identifiés, il se peut que les accents ne soient pas affichés correctement dans la prévisualisation. Néanmoins, ils restent affichés correctement dans les squelettes finaux. Cela n’affecte que le mode prévisualisation.

Saisie d’un lien

Icône Lien Pour afficher la zone de saisie d’un lien, cliquez sur l’icône lien. Remplissez d’abord le champs Adresse. Vous pouvez utilisez la notation abrégée de SPIP. Par exemple, 45 pour faire un lien sur l’article 45, rub21 pour faire un lien sur la rubrique 21, etc. Au besoin, saisissez une bulle d’aide qui sera affichée au survol de la souris et éventuellement un paramètre de langue à ajouter au lien (pour les liens internes).

Exemple saisie d'un lien avant

Après avoir rempli les champs, sélectionnez le texte à transformer en lien et cliquez sur OK.

Exemple saisie d'un lien après

Gestion des ancres

Icône Ancre de la barre typo V2 Une ancre est un point dans une page sur lequel on souhaitera faire pointer un lien. Cliquez sur l’icône représentant une flèche rouge pointée vers le bas pour afficher la zone de gestion des ancres.

Pour créer une ancre, remplissez le champs Nom de l’ancre, puis sélectionnez le mot devant lequel vous souhaitez placer l’ancre et cliquez sur OK.

Pour faire un lien pointant sur une ancre placée dans l’article, remplissez le champs Ancre cible et au besoin le champs Bulle d’aide, puis sélectionnez le texte à transformer en lien et cliquez sur OK.

Exemple de Gestion des Ancres

Rechercher/Remplacer

Icône Chercher/Remplacer de la barre typo V2 Cliquez sur cet icône pour afficher la zône Rechercher/Remplacer. Pour effectuer une recherche, remplissez le champs Chercher et cliquez sur le bouton du même nom. Pour effectuer un remplacement, remplissez les champs Chercher et Remplacer puis cliquez sur le bouton Remplacer.

Caractères spéciaux

Icône Caractères spéciaux de la barre typo V2 Cliquez sur l’icône en forme de clavier pour afficher la zone Caractères spéciaux. Les guillemets sont insérés de part et d’autre du texte sélectionné. Les lettres non usuelles (majuscules accentuées, æ et œ, €) sont insérées là où le curseur est positionné.

Passer en Majuscules ou en Minuscules

Icône Minuscules de la barre typo V2 Icône Majuscules de la barre typo V2 Ces deux boutons permettent de passer la sélection en majuscules ou en minuscules. Ils sont disponibles dans la zone Rechercher/Remplacer et dans la zone Caractères Spéciaux [4].

Note : les minuscules accentuées (éèà etc.) sont transformées en majuscules accentuées (ÉÈÀ etc.) et inversement.

Saisie de tableaux

Icône Tableau de la barre typo V2 La BTE dispose d’un éditeur de tableau. Positionnez le curseur là où vous souhaitez insérer un tableau, puis cliquez sur l’icône de l’éditeur du tableau. Une pop-up apparaît vous permettant de rentrer les informations de votre tableau.

Editeur de tableaux de la BT2

Les croix rouges permettent de supprimer les lignes ou colonnes correspondantes. Les autres icônes permettent d’insérer une ligne ou une colonne avant celle considérée.

Vous pouvez rééditez un tableau en le sélectionnant avant de cliquer sur l’icône de l’éditeur. Attention : vous devez sélectionner tout le tableau, sinon vous risquez d’obtenir un résultat inattendu.

Insertion d’images et/ou de documents

Icône Galerie de la barre typo V2 Positionnez le curseul là où vous soihaitez insérer une image ou un document puis cliquez sur l’icône galerie. Une pop-up apparaît vous permettant de parcourir l’arborescence du site. Choisissez le document ou l’image que vous souhaitez insérer puis cliquez sur left, center ou right.

Statistiques (nombre de mots, de caractères et de signes)

Icône Statistiques de la barre typo V2Cliquez sur le symbole Somme pour afficher les statistiques sur le texte en cours de rédaction. Les statistiques sont réactualisée au cours de la frappe comme pour le mode prévisualisation. Elles sont calculées à partir du texte brut, après suppression des informations de mise en forme.

Si l’on sélectionne une partie du texte, seule la sélection est prise en compte pour le calcul des statistiques. Une fois le texte déselectioné, les statistiques se réactualiseront sur l’ensemble du texte.

Exemple de statistiques BT2

Note : comme pour la prévisualisation, le texte est envoyé au serveur pour traitement et calcul avant que le résultat ne soit renvoyé au navigateur. En cas de ralentissement réseau, les statistiques peuvent mettre quelques secondes avant de se réactualiser.

Origine des différentes contributions

La BT2 intègre plusieurs contributions développées par les uns et les autres. Pour information, voici une copie du champ <auteur> du plugin :

  • Jacques
  • Extensibilité : Bill (Stephane LAURENT - spipcarto@gmail.com) : des pipelines pour rajouter des boutons et la possibilité de rajouter des traitements dans pre_propre
  • Prévisualisation : http://www.spip-contrib.net/Previsu...
  • Editeur de tableaux : Christian Quentin à partir du travail de Courcy dans l’article pour l’éditeur de tableau
    Le code initial de Courcy a a été en grande partie ré-écrit pour :
    • générer une syntaxe de tableau SPIP et non HTML (l’éditeur de couleur de cellules disparait donc aussi)
    • pour permettre de créer mais aussi de modifier un tableau existant
    • pour intégrer les éléments HTML titre et résumé de tableau
  • Galerie de documents : SCRIPT ORIGINAL POUR SPIP 1.7.2
  • Statistiques : Joseph à partir d’une contribution de François Schreuer.
  • Adaptation SPIP 1.9.2 par Coyote (28 mars 2007)

Pipelines

La BT2 fournie plusieurs pipelines permettant ainsi à d’autres plugins de venir rajouter des fonctionnalités à la barre. C’est le cas notamment du plugin Enluminures Typographiques. Pour les développeurs de plugin souhaitant rajouter des boutons à la BT2, il est conseillé de regarder le fichier typo_options.php pour prendre connaissance des différents pipelines disponibles et le fichier inc/barre.php pour voir où ils s’insèrent dans la barre..

Notes

[1] L’éventualité future d’une telle procédure n’est pas à exclure (cf. discussions sur la liste spip-zone). Mais rien ne garantie qu’elle verra effectivement le jour.

[2] Et c’est bien ainsi, car le site pourra changer de squelette et donc d’apparence dans le temps

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

[4] Par rapport à la Barre Typographique Enluminée, le comportement de ces deux fonctions a légèrement changé. Si l’on cliquait sur un des deux boutons en l’absence de texte sélectionné, avec la BTE tout le texte était passé en majuscules ou en minuscules. Avec la BT2, s’il n’y a pas de texte sélectionné, il ne se passe rien. Pour passer tout le texte en majuscules ou en minuscules, il faut d’abord sélectionner tout le texte.

Retour en haut de la page

101 Messages de forum

Voir toute la discussion

Pages 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |...

  • Répondre à ce message

    17 mai 20:45 , par Pierrot40

    Je suis comme dubois : il manque des icônes dans la barre et les mofifs ne gilcot ne fonctionnent pas . J’utilise SPIP 2.0.7 et j’ai téléchargé le fichier marqué ici plugin pour spip2. Peut-on savoir s’il y a une mise à jour existante ou prévue pour ce plugin ou à défaut pouvez-vous signaler que ce plugin ne fonctionne pas avec spip2 (dès le début de sa présentation et non quelque part dans l’article) Dans tous les cas, Merci.

  • Répondre à ce message

    21 avril 10:50

    Pour répondre et ajouter un détail à "superyms" je remarque aussi que la fenetre de selection des articles "lien_spip.php" ne liste pas les sous-rubriques avec leurs articles associés. Pour ma part quelque soit l’article selectionné il selectionne l’id numéro 5.

    Dommage.

  • Répondre à ce message

    1er avril 11:43 , par Eric Luyckx

    Bonjour sur un site en SPIP 1.9.2. ; j’ai un bug sporadique avec le plugin enluminures typo le remplacement de {2{…}} ou {3{…}} en <h4> …etc ne fonctionne pas de manière systématique

    avec des résultats où le soustitre commence par 2 et où tout ce qui suit est en italique (y compris les boutons de gestion ’modifier cet article’ etc)

    je précise que ce bug est (en tout cas) cohérent entre l’affichage dans la partie ’admin’ et sur le site

    merci d’avance

  • Répondre à ce message

    4 février 10:45 , par superyms

    bon personne pour me répondre ou m’orienter ?

    je crois que c’est dans le dossier exec du plugin, le fichier liens_spip.php, je crois que c’est pas compatible ave SPIP 2, en terme de functions sql utilisées ? je me trompe peut etre !

    j’ai vérifier ce problème existe sous tous les navigateurs
    - sous opera et firefox, j’obtiens toujours le resultat : art3
    - sous ie7, en cliquant aucun resultat ne s’affiche et en plus la pop des liens donne accès à la page naviguer.php au lieu de se fermer.

    @+

  • Répondre à ce message

    3 février 17:23 , par superyms

    Bonjour,

    Je viens de tester ce plugin avec SPIP 2.0.3 [13596], plusieurs autres plugins sont également installés (CFG, Couteau suisse, Spip bonux et Médiathèque) en local soup wampserver 2.0f.

    J’ai remarqué que la fonction lien dans Spip, ouvrait bien la fenetre en listant les rubriques et articles existants (ce qui est très bien), mais quel que soit mon choix, il est systématiquement ajouté l’article 3, art3 ! J’ai désactivé l’ensemble des plugins et j’ai le même souci qui se répète !

    Si quelqu’un sait que fichier retoiuché ou la maniulation à faire je suis preneur.

    Autre chose, en activant les blocs dépaliants dans couteau suisse et balancer toute la sauce dans CFG (barre typo v2) je vois un bouton qu idonneria accès à l’utilisation des blocs dépliants (SUPER IDEE C’EST POUR QUAND ?)

    Voilà e tmerci pour tout !

  • Répondre à ce message

    2 février 13:41 , par Patrice Vanneufville

    Dans ce cas, il vaut mieux utiliser les différents pipelines offerts par la barre. Le Plugin Enluminures typographiques pour 1.9.2 et suivantes est un exemple qui le fait et dont tu peux étudier le code... En suite tu pourras proposer ton plugin à la communauté !

  • Répondre à ce message

    2 février 13:25 , par mmmx

    Je voudrais partager la modification del plugin pour inclure raccourcis typo d’équations (latex).

    Je ajoutée une fonction et trois lignes modifiées dans ces du plugin dans un seul file.

    Convient-il ajouter le file modifié à le vôtre plugin ou en faire un plugin que s’appuie à le vôtre ?

    Et comme se fait le surcharge ?

    Salue

  • Répondre à ce message

    2 février 12:17 , par gilcot

    bonjour Sylvain.

    le comportement que tu décris est tout à fait normal et n’a rien d’inergonomique (il ne faut pas confondre ergonomie avec habitude —et l’expérience montre que les usagers qui ont pris de très mauvaises habitudes n’aiment pas les choses ergonomiques qui vont à l’encontre de leurs habitudes—) qu’il faille saisir le texte du lien après avoir rentré son adresse est lié au contraintes des systèmes d’exploitation et des interfaces web... en effet, dès que tu clic dans une zone de saisie (input), elle a le focus et te fait perdre la sélection.. :( (ça n’a donc rien à voir avec le plugin : essaye de sélectionner un bout de texte dans une page contenant un formulaire, puis active un champ quelconque de ce formulaire pour constater que ta sélection est perdue... ) maintenant, l’approche native de spip est de faire d’essayer de sauvegarder la sélection (je crois) et d’ouvrir une autre fenêtre (ou pop-up, chaque fenêtre gérant sa sélection...) ; mais cette méthode ne permet hélas pas d’implémenter de façon fiable [1] les plus de ce plugin : info-bulle et langue...
    ce que les/tes utilisateurs doivent retenir (le principe est le même pour tous) est qu’il faut faire la sélection du texte en avant-dernier, la dernière étape étant le clic sul OK. (il es bien entendu possible d’améliorer l’interface en l’indiquant clairement juste avant le bouton, ou alors, se passer de la sélection en proposant un champ pour saisir le texte du lien..)

    la foncion qui s’occupe de cela est afficher_gestion_liendans le fichier barre_XX.php dans le rêpertoire inc du plugin. celui de spip sont les lignes 68 à 70 dans ecrire/inc/borre.php</php>... je note entre autre que les deux font appel à une sous-routine <code>barre_demande (pour ce pluging, consulter javascript/spip_barre.js) voilà. bonne chance pour tes modifications :)

  • Répondre à ce message

    2 février 11:14 , par gilcot

    Bonjoul Dubois. as-tu vérifié que tout le dossier img_pack est transféré et que les fichiers sont en lecture ? pense aussi à vider le cache (normalement, ça ne devrait pas influer, mais parfois ça aide)

    à tout hasard, je joins mon fichier modifier (et on attend toujours la confirmation des auteurs qui maitrisent bien mieux le fonctionnement et les arcanes du plugin)

  • Répondre à ce message

    31 janvier 18:54 , par dubois

    j’ai fait les modifs citées mais cela n’a pas rajouté les icônes manquantes.

Pages 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |...

Répondre à cet article

Retour en haut de la page

Ça discute par ici