Lecture/Web/Améliorations du bureau/Fonctionnalités/Sommaire

From mediawiki.org
This page is a translated version of the page Reading/Web/Desktop Improvements/Features/Table of contents and the translation is 100% complete.

L'un des principaux objectifs du projet des Améliorations du bureau est de rendre les outils fréquemment utilisés plus accessibles aux lecteurs et aux rédacteurs. Le Sommaire, c'est l'un des plus cruciaux de ces outils. Cette fonctionnalité joue deux rôles importants. Il donne des informations sur le contexte et permet de naviguer à l'intérieur des pages.

Actuellement, le Sommaire est disponible seulement tout en haut de la page et cela limite son utilité. Nous avons en programme de le rendre persistant, toujours disponible sur la page. Notre objectif est de faciliter l'accès des lecteurs et des contributeurs au Sommaire. Nous voulons qu'il soit plus facile de comprendre le contexte du contenu et de naviguer dans la page sans avoir à la faire défiler jusqu'en haut.

Contexte et objectifs

Nous aimerions que l'interface, y compris les éléments de navigation, soit plus facile à utiliser. Jusqu'à présent, nous avons créé une barre latérale repliable et un entête figé. Maintenant, nous sommes en train de préparer un nouveau Sommaire.

Actuellement :

  • L'actuel Sommaire est disponible seulement tout en haut de la page. Il est difficile de se repérer et de naviguer dans la page sans devoir la faire défiler vers le haut
  • Pour les pages qui ont une longue section d'introduction, le Sommaire n'est visible qu'en faisant défiler un peu la page vers le bas
  • Les utilisateurs se servent du Sommaire pour se créer un modèle mental de la page. Il a un rôle similaire à celui de l'introduction par rapport à l'article dans son ensemble. Les utilisateurs apprennent ainsi ce que la page contient, sa longueur, quelles sont les parties les plus longues, etc. Cela se perd sans la possibilité de s'en remettre au Sommaire plus fréquemment.
  • Le Sommaire crée beaucoup d'espace inutilisé dans la zone du contenu. Cet espace pourrait être utilisé pour afficher le contenu et d'autres fonctionnalités.

Avec le nouveau Sommaire fixe, il sera plus facile pour les lecteurs de

  • Comprendre le contexte de la page
  • Consulter différentes sections de la page sans à avoir à faire défiler la page vers le haut chaque fois qu'ils veulent accéder au Sommaire.

Cas d'utilisation

  • En tant que lecteur ou rédacteur, je veux être en mesure de comprendre le contexte (contenu et structure) de la page que je vais lire
  • En tant que lecteur ou rédacteur, je veux avoir la possibilité de consulter les sections suivantes à n'importe quel endroit de la page, afin de pouvoir choisir ce que je vais lire ensuite
  • En tant que lecteur ou éditeur, je veux avoir la possibilité de savoir combien de sections a une page, sans avoir à la faire défiler jusqu'en haut

Description et prérequis de la fonctionnalité

Le Sommaire apparaitra fixé à côté de la page. Il contiendra toutes les sections et les sous-sections disponibles dans les précédentes versions du Sommaire.

Le Sommaire contiendra les fonctionnalités suivantes :

  • Sous-sections repliables - pour les utilisateurs qui ne souhaitent voir que les niveaux les plus élevé de l'intitulé de la section
  • Section en gras - la section de la page en train d'être consultée s'affichera en gras Les utilisateurs pourront identifier à quel endroit de la page ils se trouvent en notant les caractères en gras dans le Sommaire
  • Navigation - en sélectionnant une section dans le Sommaire on naviguera vers la section appropriée de la page
  • Pour les largeurs d'écran inférieures à 1000px, le Sommaire sera plié par défaut et les titres des sections remplaceront le Sommaire.
Le Sommaire affiché sur la Wikipédia en anglais

Prérequis et recommandations visuelles

Prototype

Fonctionnement général du Sommaire : https://en-toc.wmcloud.org/wiki/Moon

Fonctionnement de la section repliable : https://di-toc-collapsible-sections.web.app/Aretha_Franklin

Un prototype du Sommaire fixe réalisé pour des tests utilisateur

Évaluation qualitative

Tests utilisateur avec des lecteurs et des contributeurs

Nous avons effectué des tests utilisateur du Sommaire avec des lecteurs et des rédacteurs. Les tests ont eu lieu à trois endroits différents (Argentine, Ghana, Indonesie) et en différentes langues. Les participants ont été invités à interagir avec des versions différentes du Sommaire fixe. Ils devaient donner leur avis sur la version qu'ils préféraient. Le test incluait également une étude ouverte sur la façon dont les lecteurs et les rédacteurs voyaient et utilisaient le sommaire.

Tous les utilisateurs ont convenu que le Sommaire est essentiel à l'expérience de lecture. Ils en avaient besoin à la fois pour la navigation et pour donner du contexte sur la page.

Les principales observations :

  • Les participants au test ont préféré l'accès permanent. Dans tous les test, le meilleur prototype était celui fixé
  • Les participants au test ont préféré avoir plus d'information. Les prototypes qui présentaient toutes les sections et sous-sections ont reçu plus d'avis favorables
  • Les participants au test ont rejeté la proposition du sommaire se superposant au contenu. Même dans les cas où il s'agissait d'un complément au Sommaire principale en haut de la page
  • Les participants au test ont apprécié de pouvoir se repérer dans la page. Ils ont noté que des ajouts tels que le gras du titre ou de la section les aidaient à s'orienter

Les résultats du test ont été utilisé pour déterminer quel était le meilleur prototype. Après, nous avons peaufiné le prototype pour le faire correspondre au mieux aux nécessités des participants. Voir les résultats complets de ce test.

Test du prototype avec des contributeurs

En mai 2021, nous avons effecté des tests de prototype avec des utilisateurs connectés de 30 wikis. Le test a été conçu pour recueillir des commentaires sur l'utilisabilité et le fonctionnement du sommaire. La majorité des commentaires a été positive. La plupart des membres de la communauté apprécie le nouvel emplacement et le fonctionnement du Sommaire, et approuve le changement.

Summary of Results of the Prototype testing
Topic Feedback Next steps
ToC The majority of the feedback we received was positive, with only 23 of the tested 236 users reporting a negative experience with the ToC (110 were explicitly positive, and 38 were neutral and did not prefer either the new or old versions) Continue with proposed overall design for ToC
Expanded sections People leaned towards having the ability to expand sections when necessary. We have changed the design to allow for expanding sections when possible/enough space is available on the page, and collapsing them for pages with longer ToC's, thus optimizing for seeing the highest number of sections possible
ToC on Talk Pages The majority of people who tested the ToC on talk pages agreed that the ToC should take the form it does on article pages and reported a positive experience with the new ToC. Users also suggested a number of customizations and ideas for the ToC on talk pages, such as including the number of replies for each topic, or the number of people participating in a given discussion
  • Continue with the current version for talk pages for the first A/B test of the feature
  • Begin requirements and testing for the configurations necessary for talk pages in the future (see this Phabricator ticket for future plans)
Lower resolution solutions The majority of users preferred the presented solution for lower resolutions. However, a large number of people also expressed concerns around their ability to navigate the article with the proposed solution that presented sections as collapsible We are continuing discussions for the optimal lower resolution solution for the table of contents and have explored a few more options. Progress can be tracked in this ticket
Main menu access A large number of users were unhappy with the proposal to display the ToC or the sidebar at a time and expressed the need to have access to the main menu alongside the ToC. We have restored persistent access to the sidebar. The sidebar and ToC can now both appear at a time. See our Page Tools page for more details on our plans for the main menu in the future
Magic words Most users suggested that the usage of magic words should continue where relevant We will continue respecting all magic words that do not move the location of the table of contents across the page

Évaluation quantitative

Nous allons effectuer un test A/B du fonctionnement de la version actuelle par rapport à la nouvelle version du sommaire.

Questions clés :

  1. Le nouveau sommaire est-il utilisé plus fréquemment que le précédent ?
  2. Le nouveau sommaire réduit la nécessité de faire défiler la page vers le haut ?
  3. Le nouveau sommaire réduit le temps que le personnes passent à faire défiler la page, ça se fait plus rapidement ?
  4. Comment le nouveau sommaire affecte-t-il le temps qu'on passe sur la page ?

FAQ

The table of contents feature is still in active development.

Why doesn't the table of contents doesn't work well on my mobile device or when I resize the browser?

Users on mobile and resized browsers account for a small fraction of page traffic, so because of this we prioritized building the feature for the majority of our users first. For narrow screens we plan to make the table of contents available as a sticky interface element that's accessible from anywhere in the page. This is being built as part of https://phabricator.wikimedia.org/T306660 with a current release date of early August 2022.

Note what is displayed to mobile devices differs from what you see when you resize your browser. On mobile devices, the site is currently presented as a zoomed out version of the desktop site.

Why can't I collapse the table of contents?

The feature is still in development. We plan to make it possible to collapse the table of contents. This will be handled in https://phabricator.wikimedia.org/T307901.

Why doesn't it appear when I complete an edit?

The feature is still in development. This will be fixed in https://phabricator.wikimedia.org/T307251 with a planned timeline of end of August 2022.

How can I get the old table of contents?

We intentionally do not add the old table of contents to the article in addition to the new sidebar location. This is because it increases the overall size of HTML that is shipped to clients, increases the storage requirement for our parser cache, and requires additional CSS to render. It's a trade off we've taken to reduce the work involved maintaining the code and keeping the site optimized.

Users can restore the old table of contents position with the following JavaScript code:

document.querySelector('mw\\3Atocplace,meta[property="mw:PageProp/toc"]').replaceWith( document.getElementById('mw-panel-toc') )

How do magic words work with this feature?

The __TOC__ magic word will not work in Vector 2022 as the table of contents is always in the sidebar and this cannot be changed. However magic words relating to presence of table of contents will continue to work i.e. an article can disable the default table of contents and apply its own if necessary.

All magic words will continue to work for other skins which render the table of contents within the article.

I can't see the table of contents when the sidebar is open on tablet/mobile device

This is a known problem for now. The sidebar should be closed by default unless you opened it, so this issue should only impact logged in users who have opened the sidebar. On the long term, we plan to reduce the size of this menu, and make the sidebar overlay content. Details and a prototype of how that will look can be found in phab:T302073. This change is planned in the latter part of 2022, and further information can be found on Reading/Web/Desktop_Improvements/Features/Page_tools (October-December).