2017 wikitext editor/fr

L’éditeur de wikicode 2017 est un mode de l'extension Éditeur Visuel permettant aux utilisateurs d’utiliser les outils et la barre d’outils de l’éditeur visuel lors de la modification du texte wiki du code source (appelé wikicode). On y accède depuis l’éditeur visuel en cliquant sur le bouton de la barre d'outils pour passer au wikicode.

Vous pouvez l’activer pour l'utiliser sur les wikis de la Fondation Wikimedia en tant que fonctionnalité bêta en allant dans vos préférences.

De quoi s’agit-il ?
Dans le cadre d’un des objectifs du Projet annuel 2016-2017, « Maintenir et améliorer progressivement les interfaces actuelles de création et de modération », le département Editing travaille sur un nouvel éditeur de wikicode.

Il est intégré dans l’éditeur visuel pour un meilleur passage de l’un à l’autre. Il a une apparence similaire et de nombreux outils présents dans l’éditeur visuel, dont le service Citoid. Le nouveau mode de modification du wikicode est disponible en tant que fonctionnalité bêta pour les utilisateurs d'ordinateurs de bureau. Le tâche principale sur Phabricator est (le logiciel y est parfois appelé « modern wikitext editor » ou encore « new wikitext editor » (« NWE »)).

Il s’agit d’un nouvel éditeur, pas d’une modification de l’éditeur de wikicode actuel. Le mode de fonctionnalité bêta permet aux utilisateurs de nous donner leurs avis et de prendre un peu de temps, pour éviter une rupture brusque des éditeurs et le dysfonctionnement des gadgets.

Quelles sont les raisons de ce projet ?
En 2010, la Wikimedia Foundation finit le projet Opérabilité (qui aboutit à l’habillage « Vector » actuel, à l’outil de téléversement et à l’outil de modification du contenu) et se pencha ensuite sur les questions soulevées par la communauté dans la Stratégie 2010-2015. Cela a inclus un certain nombre d’améliorations pour les outils de modification, notamment l’éditeur visuel en parallèle des notifications et d’autres améliorations. Cependant, la stratégie n’est pas et n’a jamais été de remplacer le wikicode ; nous estimons les deux systèmes de modification comme importants à long terme pour aider la communauté à continuer à couvrir les projets Wikimedia de succès comme ils le sont actuellement.

Au mois de décembre 2016, nous proposons sur la plupart des wikis Wikimedia trois principaux outils de modification du contenu. Ils sont différents pour les utilisateurs dans leur apparence, leur fonctionnement, leurs performances, ainsi que leur support. L'un est l’éditeur de wikicode pour bureau de la génération 2010 appelé WikiEditor, le second est l’éditeur visuel (dans sa forme bureau ou mobile) et le dernier est l’outil de modification minimaliste de wikicode sur mobile.

Depuis 2010, nous avons beaucoup appris sur la manière dont les utilisateurs, qu’ils soient nouveaux ou expérimentés, utilisent nos logiciels et ce qu'ils voudraient voir changer dans l'éditeur. Notre étude a servi au développement de l’éditeur visuel en terme d’architecture afin de correspondre aux éditeurs en donnant clairement les indications aux nouveaux utilisateurs pour son utilisation tout en mettant de côté les utilisateurs expérimentés qui préfèrent l'éditeur qu'ils connaissaient déjà, WikiEditor. Bien qu’imparfait, nous avons observé une forte préférence des nouveaux utilisateurs pour l’apparence de l’éditeur visuel, le déroulement du travail et par dessus tout l’expérience. Nous avons aussi beaucoup appris en terme de technique, et l’avons construit de manière à pouvoir être utilisé sur une page (comme lorsque vous cliquez sur « $labelhere ») ou à l’intérieur d’un outil (comme dans Flow), et sur bureau ou sur mobile, et d’une manière extensible par d’autres fonctionnalités. We've also learnt a great deal in terms of engineering, and have built it in such a way that it can be used on a page (as when you click "") or inside a tool (as in Flow) and on desktop or mobile, and in a manner which is extensible by other features.

Avoir trois systèmes incohérents entre eux est mauvais. C'est mauvais pour les débutants, parce que ce qu’ils auraient appris sur un outil ne peut pas être appliqué dans d’autres contextes (par exemple en modifiant une page de discussion). C’est mauvais pour les utilisateurs expérimentés, qui doivent répondre à plusieurs questions avant de pouvoir estimer la difficulté de la situation pour le débutant, et ensuite l’aider. C’est aussi mauvais pour les administrateurs, qui ont besoin de définir séparément les besoins de leur communauté pour chaque outil – ou de découvrir qu’ils ne peuvent pas y répondre avec certains outils. It is bad for experienced editors, who must address several questions before they can work out what the situation for the newbie is and so how to help. It is bad for sysops, who need to separately set up what their community needs in each of the editors—or else discover that they cannot get it in some editors. C’est mauvais pour les développeurs de scripts et de gadgets, qui doivent traiter de nombreuses situations différentes (ou les ignorer). C’est mauvais pour les développeurs, qui doivent prendre en compte trois systèmes différents lorsqu’ils veulent corriger ou ajouter une fonctionnalité. Enfin, c’est mauvais pour les donateurs de la Wikimedia Foundation, dont les dons sont dépensés pour soutenir ces multiples axes de travail parallèles. It is bad for developers, who have to take three times as many parts of complexity into account whenever they need to fix something or add a feature. And it is bad for the donors to the Wikimedia Foundation, whose donations are spent supporting these multiple parallel work streams.

Par conséquent, nous travaillons sur un nouvel outil de modification de wikicode. Cela donnera une expérience utilisateur unique, intégrée, cohérente entre modification visuelle et modification du wikicode, et ce à la fois sur bureau et sur mobile. Ce sera une plateforme intégrable dans d’autres outils, afin que l’expérience puisse être aussi proche que possible selon les situations et types de contenu modifiés. Nous donnerons aux utilisateurs la meilleure expérience possible, en limitant les ruptures dans les fonctionnalités existantes. We'll give users as good an experience as we can, while limiting breakage of existing functionality.

Remarquez que la phase actuelle de déploiement est de fournir l’outil comme une fonctionnalité bêta et de recevoir des avis. Une fois seulement que nous aurons atteint les seuils de qualité minimum (dont les tests par les nouveaux utilisateurs et le contentement de l’expérience utilisateur), probablement vers mi-2017, nous commencerons à l’installer par défaut à la place de l’outil de modification du wikicode actuel. Les utilisateurs qui ne l’aiment pas, bien sûr, pourront toujours ne pas l’utiliser tant qu’il est en fonctionnalité bêta et le désactiver en parallèle de l’éditeur visuel une fois qu’il sera sorti pour tout le monde. L’outil de modification du wikicode actuel ne bougera pas, au moins pour les quelques prochaines années. Bien que nous le fassions peut-être décliner, tous ceux qui l’apprécient peuvent le conserver. The current wikitext editor is not going anywhere, at least for the next few years. While we may eventually sunset it, anyone who likes it can keep it.

Première version (fonctionnalité bêta)
L’objectif initial pour le projet était d’avoir les mêmes fonctionnalités que l’outil existant de modification du wikicode, avec les mêmes boutons et aux mêmes endroits que l’éditeur visuel, de manière à avoir une expérience utilisateur cohérente. C’est-à-dire fournir au moins toutes les options de l’outil de modification de wikicode, avec quelques exceptions pour de rares boutons :


 * outils élémentaires (gras, italique, signature, liens et images) ;
 * outils avancés (titres, listes à puces, listes ordonnées, texte en gras, texte en petit, texte en exposant, texte en indice, galeries et tableaux) ;
 * insertion de caractères spéciaux ; et
 * trouver et remplacer.

Toutes ces options ont été achevées en aout 2016, accompagnées par de nombreux outils qui n’étaient pas dans l’outil de modification du wikicode existant (tels que barrer le texte, le soulignement, l’insertion de modèles, etc.) et par des fonctionnalités telles que la transformation automatique en wikicode du texte HTML collé. En particulier, nous avons également intégré l’outil Citoid de mise en forme automatique des références, qui permet d’ajouter des sources à partir d’URL ou de DOI. Il est similaire, mais plus sophistiqué, que les gadgets que certains wikis, comme la Wikipédia en anglais, avaient déjà créés pour leurs propres besoins, et sera disponible dorénavant pour tous les wikis. This is similar to, but more advanced than, the gadgets that a few wikis like the English Wikipedia had written for themselves already, and they will now be available for all wikis.

Nous avons entrepris de vastes tests AQ pour nous assurer que les fonctionnalités fonctionnaient correctement, ainsi qu’une relecture du code et des tests utilisateur structurés. Une fois satisfaits du résultat, et que cela n’était (au moins) pas pire pour les nouveaux utilisateurs, nous avons recherché des commentaires d’utilisateurs expérimentés de tous niveaux via une fonctionnalité bêta. Once we were happy that it is adequately working as intended, and is (at least) no worse for new users, we have sought feedback from experienced users of all levels via a Beta Feature.

Version bêta finale (avant la sortie générale)
L’objectif de la première publication comme fonctionnalité bêta est de recevoir des premiers commentaires sur la qualité du fonctionnement du nouvel outil de modification. Nous espérons que les retours des utilisateurs incluront de nombreuses suggestions. Il existe déjà nombre d’améliorations auxquelles nous pensons. Certaines doivent sans doute être réalisées avant que le nouvel outil de modification du wikicode ne soit publié comme fonctionnalité bêta. Certaines sont techniquement compliquées et ont donc été repoussées. D’autres auraient besoin d’être reformulées dans les commentaires des utilisateurs existants pour être conçues de manière aussi pratique que possible. Some of these are technically difficult and so have been postponed, whilst others would benefit from real-world feedback from existing users to shape the features as usefully as possible.

Pour la première catégorie (challenges importants), nous pensons que nous devrons traiter l'"édition de section", dans laquelle le clic sur éditer va montrer de petites parties de la page à éditer et une architecture totalement dynamique, pour que l'interface puisse s'agrandir ou se réduire plus proprement sur les appareils plus petits, que les utilisateurs ont agrandis, ou pour d'autres motifs d'accessibilié ou de plateforme; ceci nous permettra de fournir la fonctionalité pour les mobiles également en tant qu'exemple bêta, pour s'assurer qu'elle fonctionne sur tous nos éditeurs, et pas seulement que pour le bureau.

Pour la deuxième catégorie (réactions SVP), nous devrons fournir une aide dans l'éditeur pour guider les utilisateurs à travers le processus d'édition dès le premier clic sur éditer et aussi plus tard dans leur futures éditions. À l'heure actuelle, l'éditeur wikitext a un onglet aide avec quelques conseils brefs de wikitext ; dans l'éditeur visuel, nous avons un lien vers le guide de l'utilisateur, que nous pourrions reproduire à cette fin. Comment cela devrait fonctionner, et qu'est-ce qui devrait être souligné, est susceptible d'être quelque chose sur lequel de nombreux membres de nos communautés ont des idées assez claires. Right now the wikitext editor has a "help" tab with some brief wikitext guidance; in the visual editor, we have a link to the user-guide, which we could replicate for this purpose. How this should work, and what it should highlight, is likely to be something on which many members of our communities have expert ideas. Nous devrons également éclaicir comment les gadgets pourraient améliorer l'éditeur, car la nouvelle intégration de l'éditeur est actuellement complexe et confuse. Cela rendrait la conversion de certains gadgets plus difficile qu'elle ne devrait l'être. De nombreuses communautés wiki dépendent de gadgets particuliers pour accélérer leur traitement de texte d'édition, et il est important que nous préservions la possibilité pour les wikis d'expérimenter de manière flexible des améliorations de ce type. This would make converting some gadgets harder than it should be. Many wiki communities depend on particular gadgets to speed up their editing workflow, and it's important that we preserve the ability for wikis to flexibly experiment with improvements like this.

Naturellement, tout changement à cette échelle est susceptible de perturber le flux de travail de certains utilisateurs et soulèvera quelques problèmes avec des «cas limites» qui ne sont pas traités. Nous sommes impatients de découvrir et d'aborder ces questions au cours des semaines et des mois suivant la publication de la fonctionnalité bêta. We look forward to uncovering and addressing these over the weeks and months following the release of the beta feature.

Bonnes pratiques
Parallèlement à cela, il y a d'autres nouvelles fonctionnalités que nous aimerions fournir si possible, mais qui peuvent s'avérer trop coûteuses à développer ou trop lentes pour les utilisateurs, et ne sont donc pas planifiées dès le départ. Une fonctionnalité que nous aimerions proposer est de sauvegarder automatiquement les brouillons en local que les utilisateurs éditent, de sorte que si leur navigateur ou leur ordinateur tombe en panne, ils puissent reprendre plutôt que de devoir redémarrer. Cela permettrait d'éviter aux utilisateurs des événements assez frustrants, même s'ils sont rares, en particulier pour ceux qui ont des ordinateurs avec des connexions réseau pauvres ou anciennes. This would rescue users from quite frustrating, if uncommon, occurrences, particularly people with old computers or poor network connections.

Une fonctionnalité importante qui est souvent discutée est la coloration syntaxique de wikitext pour aider les utilisateurs à identifier d'un simple coup d’œil le contenu sur lequel ils travaillent. Cette fonctionnalité a en fait été créée pour l'éditeur wikitext existant en 2011, mais nous avons dû l'abandonner car la très grande complexité de wikitext signifie que c'était extrêmement lent pour la plupart des utilisateurs. This feature was in fact built for the existing wikitext editor back in 2011, but we had to abandon it because the very high complexity of wikitext means that this was exceedingly slow for most users. Cinq ans plus tard, la plupart des machines des utilisateurs sont un peu plus rapides qu'avant, ce qui aide un peu. En outre, il pourrait être intéressant d'explorer les performances que nous pourrions faire sur une fonctionnalité si nous devions faire quelques simplifications des types de wikitext que nous avons essayé de mettre en évidence. Also, it might be worth exploring how performant we could make a feature doing this if we were to make some simplifications of the kinds of wikitext which we try to highlight.

(Pendant ce temps, la coloration syntaxique est fournie par Remember the dot's syntax highlighter et, qui sont disponibles sur certains wikis sous forme de gadgets). La coloration syntaxique a également été introduite dans l'éditeur wikitext de 2017 en utilisant.

Plus complexe et sujet aux erreurs que la coloration syntaxique, mais peut-être même plus utile, serait une fonctionnalité pour replier les structures wikitext en blocs afin que les utilisateurs puissent facilement ignorer les choses qu'ils ne veulent pas éditer sans avoir à les lire. Par exemple, les longues invocations ou les références d'infobox peuvent être regroupées en blocs jusqu'à ce que vous souhaitiez les éditer. Les technologies que nous avons construites pour l'éditeur visuel sont particulièrement bien adaptées pour fournir ce cas d'utilisation de manière fiable, c'est peut-être quelque chose que nous pourrions envisager de faire. Encore une fois, comme pour la coloration syntaxique, nous pourrions avoir besoin de faire des compromis sur la complexité de wikitext que nous reconnaissons en échange de fournir quelque chose de suffisamment performant pour être utile à la plupart de nos utilisateurs. Again, as with syntax highlighting we might need to compromise on the complexity of wikitext that we recognize in return for providing something performant enough to be useful to most of our users.

Une autre fonctionnalité intéressante que nous pourrions fournir serait d'inviter les utilisateurs lorsqu'ils enregistrent avec deux ou trois boutons à ajouter des résumés d'édition en un clic en fonction de leurs activités récentes. Ce type de fonctionnalité est très populaire sur certains wikis en tant que gadget et il serait bien de le fournir à tous les utilisateurs de tous les wikis, sans que ces wikis aient besoin d'un gourou pour les aider à le configurer et à le maintenir. This kind of feature is quite popular on some wikis as a gadget and it would be nice to provide it to all users on all wikis, without those wikis needing to have a gadget guru on hand to help set it up and maintain it.

Ressources

 * Un début de maquette conçue depuis avril est disponible ici. Pour voir l'éditeur wikitext, cliquez sur l'icône des crochets dans le coin supérieur droit.
 * Une vieille vidéo de démo brute est également disponible depuis mi-mai 2016 sur le lien https://www.youtube.com/watch?v=jgd2ZHOZGBE.
 * Démonstration vidéo de l'éditeur wikitext 2017 de décembre 2016 crédits
 * La version actuelle peut être consultée via les fonctionnalités bêta dans Special:Preferences; Activez l'élément new wikitext editor, allez sur https://www.mediawiki.org/wiki/Project:Sandbox?veaction=editsource (par exemple) et voyez à quoi cela ressemble quand vous changez alternativement de page.

Voir aussi

 * Nouvelles informations concernant les logiciels de modification, juin 2016 (en anglais)
 * Page de commentaires
 * - la fonction bêta pour surligner la syntaxe du wikicode