Extension:VEForAll/fr

L'extension VEForAll (VisualEditor For All) permet à d'autres extensions d'intégrer l'interface de VisualEditor dans les zones de texte pour l'édition par l'utilisateur.

Cette extension n'a pas d'impact direct sur l'interface utilisateur. Elle définit plutôt une fonction JavaScript (nommée " ") qui peut être appelée par d'autres extensions sur leurs zones de texte. Pour le moment,, et  peuvent utiliser VEForAll.

Comme on pouvait s'y attendre, l'extension VisualEditor doit être installée pour que cette extension fonctionne.

Téléchargement
Vous pouvez télécharger le code VEForAll, au format .zip, ici.

Vous pouvez aussi télécharger le code directement via Git depuis le répertoire de code source MediaWiki. À partir d'une ligne de commande, vous pouvez appeler ceci :

Vous pouvez également afficher le code en ligne ici.

Installation
Pour installer cette extension, créez un répertoire "VEForAll" (soit en extrayant le fichier comprimé ou en le téléchargeant via Git), et placez ce répertoire dans le répertoire principal 'extensions' de MediaWiki. Ensuite, dans le fichier LocalSettings.php ajoutez la ligne suivante :



Utiliser VEForAll avec d'autres extensions
VEForAll peut être utilisé actuellement avec les extensions, et  :


 * Pour CommentStreams, vous devez simplement avoir installé VEForAll (et VisualEditor), et les zones de texte pour entrer des commentaires obtiendront automatiquement l'interface VisualEditor.
 * Pour Page Forms, dans la définition du formulaire, ajoutez  à la balise pour toute entrée de zone de texte (y compris l'entrée free text), et l'interface VisualEditor doit alors apparaître à l'affichage de ce formulaire.
 * Pour FlexForm, utilisez  pour définir une zone de texte, par exemple  . You can have as many VE editors on a page as needed and you can even add a menu/button to the VE Editor that will open another VE Editor.

Configuration
Par défaut, la barre d'outils est affichée en bas de la zone de texte. In Page Forms, you can instead display it at the top by adding  to the textarea's tag in the form definition.

You can use the "VEForAllToolbarConfigNormal" and "VEForAllToolbarConfigWide" hooks to customize the display of the VisualEditor toolbar. One or the other hook is called, depending on whether "toolbarOnTop" is set: "Normal" is called if it is not set, and "Wide" if it is.

For example, to add buttons for "Insert > Math formula", "Insert > Images and media", and "Cite" in the normal (toolbar on the bottom) case, add the following to LocalSettings.php, below the inclusion of VEForAll:



Problèmes connus
Avec certains habillages, les gouttes décroissantes peuvent sembler plutôt compressées. Vous pouvez appliquer un petit ajustement CSS pour corriger cela :



Auteurs et crédits
VEForAll is heavily based on the (now-obsolete) VEForPageForm extension by Pierre Boutet and Clément Flipo. Some work to make the code more generic was done by Ike Hecht, Yaron Koren and Cindy Cicalese. Others who contributed to the code include Anysite and Mark Hershberger. VEForAll also includes code from the StructuredDiscussions extension.



Historique des versions

 * 0.1 - - Initial version
 * 0.2 - - Made toolbar configurable; removed dependency on the Math extension; fixed submitting values for "focused" textareas; set VE direction (RTL/LTR) correctly; added "veForAll.targetCreated" hook; many other fixes
 * 0.3 - - Improved support for MW 1.35+; removed support for MW < 1.29; added handling for Page Forms "max height" parameter; added escaping of pipes in table wikitext within Page Forms template fields; bug fixes
 * 0.4 - - Improved support for MW 1.34+; removed support for MW < 1.32; fixes for pipe escaping
 * 0.4.1 - - Fixed support for MW 1.39+; other fixes
 * 0.5 - - Further fix for support for MW 1.39+; removed support for MW < 1.35
 * 0.5.1 - - Fixed Parsoid handling for MW 1.40+; fixed handling of "rowspan" and "colspan" attributes; updated hook handling