Jump to content

읽기/웹/데스크톱 개선/기능/목차

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

데스크톱 개선의 주 목표는 독자와 편집자들의 자주 사용하는 도구들에 대한 접근성을 높이는 것입니다. 이 도구들 가운데 가장 중요한 것 중 하나는 목차입니다. 이 기능은 2가지 중요한 역할을 합니다. 문맥에 관한 정보를 제공하고 문서 간을 오갈 수 있게 합니다.

현재 목차는 문서 최상단에서만 사용할 수 있는데, 이 경우 유용성이 제한됩니다. 저희는 문서 전반에 걸쳐 목차를 꾸준히 사용할 수 있게 만들 예정입니다. 우리의 목적은 독자와 편집자가 이 목차를 더 쉽게 사용하도록 만드는 것입니다. 우리는 맨 위로 스크롤할 필요 없이 문서 전반에서 문맥을 더 쉽게 얻고 탐색을 더 쉽게 할 수 있게 만들기를 원합니다.

배경 및 목표

우리는 탐색 요소를 포함한 인터페이스를 사용하기 더 쉽게 만들기를 원합니다. 지금까지 저희는 접히는 사이드바고정 헤더를 만들었습니다. 지금 우리는 새로운 목차를 준비하고 있습니다.


  • 현재의 목차는 문서 최상단에서만 사용이 가능합니다. It is difficult to regain context and navigate within the page without having to scroll all the way up
  • For pages with a long lead/intro section, the ToC is not visible until you scroll down a bit
  • Users use the ToC to create a mental model of the page. This is similar to the role of the introduction to the page. Users learn what the page contains, how long may be, what parts may be the longest, etc. This becomes lost without the ability to reference the ToC more frequently
  • The ToC creates a lot of unused space in the content area. That space could be used for displaying content and other functionality

The new, persistent table of contents will make it easier for readers to

  • Understand the context of the page
  • Navigate to different parts of the page without having to scroll to the top of the page every time they want to access the table of contents

사용 사례

  • As a reader or editor, I want the ability to gain context (content and structure) about the page I am about to read
  • As a reader or editor, I want the ability to reference the next few sections in the page at any location in the page so that I can choose what to read next
  • As a reader or editor, I want the ability know how many sections a page has without having to scroll all the way up

기능 설명 및 요건

The table of contents will appear persistently on one side of the page. It will contain all sections and sub-sections available in previous versions of the ToC.

The ToC will contain the following functionality:

  • Collapsible sub-sections - for users that only want to view the highest level of section heading
  • Section bolding - the section currently on the page will be displayed as bold. Users will be able to identify where on the page they are located by noting the bolding within the ToC
  • Navigation - selecting a section within the table of contents will navigate to the appropriate section within the page
  • For screen widths smaller than 1000px, the ToC will collapse and the section titles will be used as a ToC
Table of contents shown on English Wikipedia

디자인 요건 및 지침


General ToC functionality: https://en-toc.wmcloud.org/wiki/Moon

A prototype of the persistent table of contents made for user testing purposes

양적 테스트

독자와 편집자의 사용자 테스트

We performed user testing of the table of contents with readers and editors. The tests took place in three locations (Argentina, Ghana, Indonesia) and different languages. The participants were asked to interact with different versions of a persistent table of contents. Their task was to give feedback on their preferred version. The test also included an open study of the way readers and editors saw and used the table of contents.

All users found the table of contents to be essential to the reading experience. They needed it for both navigational purposes as well as for setting the context for the page.

Main observations:

  • Testers preferred persistent access. Across all tests, the best prototype was the persistent one
  • Testers preferred having more information. Prototypes that contained all sections and subsections gained more positive opinions
  • Testers did not want the ToC to overlap the content. Even in the cases where it was supplementary to the main ToC at the top of the page
  • Testers liked getting a sense of location within the page. They noted that additions like bolding the title or the section helped with their orientation

The results of the test were used to select the best prototype. Next, we worked on it to better fit the needs of the participants. See the full results of this test.

편집자의 프로토타입 테스트

In December 2021, we performed prototype testing with logged-in users across 30 wikis. We designed the test to gather feedback on the usability and functionality of the table of contents. The majority of the feedback was positive. Most community members like the new location and functionality of the table of contents, and support the change.

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

양적 테스트

We will be performing an A/B test of the functionality of the current versus new version of the table of contents.

주요 질문:

  1. Is the new table of contents is used more frequently than the previous table of contents
  2. Does the new table of contents reduce the need to scroll back to the top of the page
  3. Does the new table of contents decrease the time people spend scrolling/scrolling quickly (if possible)
  4. How does the new table of contents affect the time spent on a page


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).