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 la fonction JavaScript   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, de Github.

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 compressé 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  . Vous pouvez avoir autant d'éditeurs VE sur une page que nécessaire et vous pouvez même ajouter un menu/bouton à l'éditeur VE qui ouvrira un autre éditeur VE.

Configuration
Par défaut, la barre d'outils est affichée en bas de la zone de texte. Dans Page Forms, vous pouvez plutôt l'afficher en haut en ajoutant  à la balise de la zone de texte dans la définition du formulaire.

Vous pouvez utiliser les accroches VEForAllToolbarConfigNormal et VEForAllToolbarConfigWide pour personnaliser l'affichage de la barre d'outils VisualEditor. L'une ou l'autre des accroches est appelée, selon que toolbarOnTop est initialisé : Normal est appelé s'il n'est pas initialisé, et Wide s'il l'est.

Par exemple, pour ajouter des boutons « Insérer &rarr; formule mathématique », « Insérer &rarr; Images et médias » , et « Citer » dans le cas normal (barre d'outils en bas), ajoutez ce qui suit à LocalSettings.php, en dessous de l'inclusion de VEForAll :



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



Auteurs et crédits
VEForAll est fortement basé sur l'extension (maintenant obsolète) VEForPageForm par Pierre Boutet et Clément Flipo. Un certain travail pour rendre le code plus générique a été effectué par Ike Hecht, Yaron Koren et Cindy Cicalese. D'autres personnes ont contribué au code tel Anysite et Mark Hershberger. VEForAll inclut également le code de l'extension StructuredDiscussions.



Historique des versions

 * 0.1 - - version initiale
 * 0.2 - - Rendre configurable la barre d'outils; suppression des dépendances avec l'extension Math; correction des valeurs soumises pour les zones de texte qui ont le focus; définir correctement la direction VE (RTL/LTR); ajout de l'accroche veForAll.targetCreated; et plusieurs autres corrections
 * 0.3 - - Amélioration de la prise en charge de MW 1.35+; suppression de la prise in charge des versions MW < 1.29; prise en charge ajoutée du paramètre max height de Page Forms; échappement ajouté des barres verticales '|' dans le wikicode du tableau, dans les champs de modèle Page Forms; corrections des bogues
 * 0.4 - - Amélioration du support pour MW 1.34+; suppression du support pour MW < 1.32; correction de l'échappement des caractères '|'
 * 0.4.1 - - support corrigé pour MW 1.39+; autres corrections
 * 0.5 - - Correction supplémentaire de l'aide pour MW 1.39+; suppression du support pour MW < v 1.35
 * 0.5.1 - - Correction de la gestion de Parsoid pour MW 1.40 MW+; correction de la gestion des attributs rowspan et colspan; mise à jour de la gestion des accroches