Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.

{{tag>Logiciel}}

====== custombuttons : ajout de boutons personnalisés à la barre d'outils ======

Un plugin pour ajouter des boutons personnalisés à la barre d'outils, pour raccourcir les blocs de code couramment utilisés.

L'arrière-plan convivial permet d'ajouter deux types de boutons de raccourci :
  * Blocs de texte simples : utile pour obtenir un raccourci d'URL, les adresses e-mail et les balises wiki généralement compliquées que vous utilisez souvent.
  * Wiki Format blocks : utilisé lorsque les balises que vous souhaitez raccourcir ont une partie d'ouverture et de fermeture et que l'utilisateur doit ajouter quelque chose au milieu. ex:<code - ><file bash bash.sh></file></code>


===== Pré-requis =====

===== Installation =====

Recherchez et installez le plug-in **custombuttons** en utilisant le gestionnaire d'extensions.

===== Configuration =====

===== Utilisation =====

==== Exemples ====

  * Pour **ajouter un bouton**, vous devez vous connecter en tant qu'administrateur et cliquer sur le bouton "Administrer".
    * Bouton de raccourci pour une URL couramment utilisée{{ logiciel:internet:dokuwiki:plugins:custombuttons:custombuttons-01.png?400 |}}
    * Bouton de raccourci pour ajouter un script bash{{ logiciel:internet:dokuwiki:plugins:custombuttons:custombuttons-02.png?400 |}}
  * **Suppression** : Cliquez simplement sur un bouton radio, puis cliquez sur «Supprimer».{{ logiciel:internet:dokuwiki:plugins:custombuttons:custombuttons-03.png?400 |}}
  * **Utilisation des boutons** : Après avoir correctement inséré certains boutons, vous devriez pouvoir les voir dans la barre d'outils d'édition, comme ceci :{{ logiciel:internet:dokuwiki:plugins:custombuttons:custombuttons-04.png?400 |}}
  * **Codes multilignes** : Si vous voulez un raccourci pour un modèle multiligne couramment utilisé (par exemple, une table), vous pouvez utiliser «\n» dans le champ de code pour indiquer le changement de ligne. Exemple :<code - >Label: 3x3 Table
Code: ^ header1  ^ header2  ^ header3  ^\n|  valueA1  |  valueA2  |  valueA3  |\n|  valueB1  |  valueB2  |  valueB3  |</code>

==== Problèmes et solutions ====
  ??? Les icônes de texte sont trop petites pour être lues
!!! Certaines versions de dokuwiki redimensionnent les icônes à une taille de 16×16.

Il suffit de commenter le redimensionnement de la largeur dans /lib/scripts/edit.js (vers la ligne 40) :
<code - >
 ...
    // create the icon and add it to the button
    $ico.attr('src', icon);
    //Disable resizing icons
   // $ico.attr('width', 16);
   $ico.attr('height', 16);
    $btn.append($ico);
 ...
</code>
Si vous utilisez un modèle dokuwiki (comme vector par exemple) ayant un fichier **user.js**, copiez la fonction du fichier **edit.js** qui gère le bouton de la barre d'outils et collez-la dans le fichier **user.js** et désactivez l'icône localement dans le fichier user.js.

N'oubliez pas d'activer l'option de modèle **user-script overwrite**. 

===== Désinstallation =====

===== Voir aussi =====

  * **(en)** [[https://www.dokuwiki.org/plugin:custombuttons]]

----
//Basé sur << [[https://www.dokuwiki.org/plugin:custombuttons|CustomButtons Plugin]] >> par Constantinos (ConX) Xanthopoulos.//