Đọc/Web/Cải thiện phiên bản máy tính/Tính năng/Mục lục

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

Mục tiêu chính của dự án Cải thiện Phiên bản máy tính là giúp các công cụ thường xuyên sử dụng có thể dễ dàng tiếp cận người đọc và biên tập viên hơn. Một trong những công cụ thiết yếu nhất trong số này chính là mục lục. Tính năng này có hai vai trò quan trọng. Nó cung cấp thông tin về ngữ cảnh của bài viết và giúp định hướng trong bài viết.

Hiện nay, mục lục chỉ có sẵn ở trên đầu trang, giới hạn sự hữu dụng của nó. Chúng tôi dự định sẽ khiến nó có mặt xuyên suốt, cố định trong trang. Mục tiêu của chúng tôi là giúp người đọc và biên tập viên tiếp cận được mục lục một cách dễ dàng hơn. Chúng tôi muốn khiến việc nắm được ngữ cảnh và điều hướng xuyên suốt trang trở nên dễ dàng hơn mà không cần phải cuộn lên đầu trang.

Bối cảnh và Mục tiêu

Chúng tôi muốn giao diện, bao gồm cả các yếu tố điều hướng, có thể được sử dụng dễ dàng. Cho tới nay, chúng tôi đã xây dựng một thanh bên thu gọn được và một thanh đầu trang dính. Giờ chúng tôi đang chuẩn bị xây dựng một mục lục mới.

Hiện tại:

  • Mục lục hiện tại chỉ có ở đầu trang. Rất khó có thể nắm bắt lại được ngữ cảnh và điều hướng trong trang nếu không cuộn ngược lên đầu trang
  • Với những trang có phần mở đầu dài, sẽ không thể thấy được mục lục trừ khi bạn cuộn xuống một chút
  • Người dùng sử dụng mục lục để tạo một mô hình tinh thần của trang. Điều này tương tự như vai trò của phần mở đầu trang. Người dùng tìm hiểu trang chứa những gì, thời lượng có thể là bao nhiêu, phần nào có thể dài nhất, v.v. Điều này sẽ bị mất nếu không có khả năng tham chiếu ToC thường xuyên hơn
  • ToC tạo ra nhiều không gian không sử dụng trong vùng nội dung. Không gian đó có thể được sử dụng để hiển thị nội dung và các chức năng khác

Mục lục mới, cố định sẽ giúp người đọc dễ dàng hơn trong việc

  • Hiểu ngữ cảnh của trang
  • Điều hướng đến các phần khác nhau của trang mà không cần phải cuộn lên đầu trang mỗi khi họ muốn truy cập mục lục

Các trường hợp sử dụng

  • Với tư cách là người đọc hoặc biên tập viên, tôi muốn có khả năng hiểu được ngữ cảnh (nội dung và cấu trúc) về trang tôi sắp đọc
  • Với tư cách là người đọc hoặc biên tập viên, tôi muốn có khả năng tham khảo các phần tiếp theo trong trang ở bất kỳ vị trí nào trong trang để tôi có thể chọn nội dung sẽ đọc tiếp theo
  • Với tư cách là người đọc hoặc biên tập viên, tôi muốn có khả năng biết trang có bao nhiêu phần mà không cần phải cuộn lên hết cỡ

Mô tả và yêu cầu của tính năng

Mục lục sẽ xuất hiện liên tục ở một bên của trang. Nó sẽ chứa tất cả các mục và tiểu mục có sẵn trong các phiên bản trước của mục lục.

Mục lục sẽ chứa các chức năng sau:

  • Các tiểu mục có thể thu gọn được - dành cho người dùng chỉ muốn xem các mục cấp cao nhất
  • In đậm mục - mục hiện có trên trang (mục đang đọc) sẽ được hiển thị dưới dạng in đậm. Người dùng sẽ có thể xác định vị trí của họ trên trang bằng cách chú ý phần in đậm trong mục lục
  • Điều hướng - chọn một phần trong mục lục sẽ điều hướng đến phần thích hợp trong trang
  • Đối với chiều rộng màn hình nhỏ hơn 1000px, mục lục sẽ thu gọn và tiêu đề các mục sẽ được sử dụng làm mục lục
Mục lục hiển thị trên Wikipedia tiếng Anh

Yêu cầu và hướng dẫn thiết kế

Nguyên mẫu

Chức năng mục lục chung: https://en-toc.wmcloud.org/wiki/Moon

Chức năng phần có thể thu gọn: https://di-toc-collapsible-section.web.app/Aretha_Franklin

 
Một nguyên mẫu của mục lục cố định được tạo cho mục đích thử nghiệm người dùng

Thử nghiệm số lượng

Thử nghiệm người dùng với người đọc và biên tập viên

Chúng tôi đã thực hiện một cuộc thử nghiệm người dùng đối với mục lục với người đọc và biên tập viên. Cuộc thử nghiệm diễn ra ở ba địa điểm (Argentina, Ghana, Indonesia) và các ngôn ngữ khác nhau. Những người tham gia được yêu cầu tương tác với các phiên bản khác nhau của mục lục cố định. Nhiệm vụ của họ là đưa ra phản hồi về phiên bản ưa thích của mình. Cuộc thử nghiệm cũng bao gồm một nghiên cứu mở về cách người đọc và biên tập viên xem và sử dụng mục lục.

Tất cả người dùng đều nhận thấy mục lục rất cần thiết cho trải nghiệm đọc. Họ cần nó cho cả mục đích điều hướng lẫn việc nhận biết ngữ cảnh cho trang.

Các quan sát chính:

  • Người thử nghiệm thích khả năng truy cập mục lục liên tục. Trong tất cả các thử nghiệm, nguyên mẫu tốt nhất là nguyên mẫu mục lục luôn xuất hiện trên màn hình.
  • Người thử nghiệm thích có nhiều thông tin hơn. Các nguyên mẫu chứa tất cả các mục và tiểu mục thu được nhiều ý kiến tích cực hơn
  • Người thử nghiệm không muốn mục lục đè vào nội dung. Ngay cả trong trường hợp nó giúp bổ sung cho mục lục chính ở đầu trang
  • Người thử nghiệm thích có được cảm giác nhận biết được vị trí họ đang đọc trong trang. Họ lưu ý rằng những phần thêm vào như việc in đậm tiêu đề hoặc các mục cũng giúp ích cho việc định hướng.

Kết quả của cuộc thử nghiệm được sử dụng để chọn ra nguyên mẫu tốt nhất. Tiếp theo, chúng tôi đã nghiên cứu nó để phù hợp hơn với nhu cầu của những người tham gia. Xem kết quả đầy đủ của cuộc thử nghiệm này.

Thử nghiệm nguyên mẫu với biên tập viên

Vào Tháng 12 năm 2021, chúng tôi đã thực hiện một cuộc thử nghiệm nguyên mẫu với người dùng đã đăng nhập tại 30 wiki khác nhau. Thử nghiệm được thiết kế để thu thập phản hồi về độ khả dụng và chức năng của mục lục. Phần lớn các phản hồi là tích cực. Hầu hết các thành viên cộng đồng thích vị trí và chức năng mới của mục lục và ủng hộ sự thay đổi này.

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

Thử nghiệm số lượng

Chúng tôi sẽ thực hiện một cuộc thử nghiệm A/B về chức năng của phiên bản mục lục hiện tại so với phiên bản mới.

Câu hỏi chính:

  1. Mục lục mới có được sử dụng thường xuyên hơn mục lục trước đó không
  2. Mục lục mới có làm giảm việc người đọc phải cuộn ngược lên đầu trang không
  3. Mục lục mới có làm giảm thời gian mọi người dành để cuộn/cuộn nhanh không (nếu có thể)
  4. Mục lục mới ảnh hưởng như thế nào đến thời gian người đọc dành cho một trang

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