Skip to content

v1.7 — Chế độ Đọc sách: một chương một cột chữ, nhớ vị trí đọc

Choose a tag to compare

@quangpao quangpao released this 05 Nov 09:52
· 13 commits to vi since this release
4786d2a

Thêm chế độ Đọc sách bên cạnh Bảng tra cứu và Theo chương. Nội dung sách không đổi: 785 mục, 36 chương.

Đọc sách

  • Mở trọn một chương trên một cột chữ serif, khổ chữ 19px, dòng giãn 1,9 — dễ đọc hơn bảng tra cứu và hộp chi tiết.
  • Mục lục 36 chương bên trái, đánh dấu chương đang đọc và tự cuộn tới đúng chỗ; trên điện thoại mục lục thu thành drawer.
  • Thanh dưới có chương trước, chương sau và tiến độ đọc trong chương.
  • Chỉnh cỡ chữ bằng A− / A+, đổi nền sáng/tối riêng cho chế độ đọc.
  • Khối Nói dễ hiểu được tách thành ô riêng, nền xanh nhạt, viền trái, chữ to hơn thân bài 6% để dễ nhận ra.

Đọc liền mạch

  • Vị trí đọc và cỡ chữ lưu trên thiết bị: tải lại trang hoặc quay về chế độ đọc thì tiếp tục đúng chỗ cũ.
  • Liên kết từng mục và tham chiếu chéo (mục N) giữ người đọc trong trang sách, hỗ trợ Back/Forward của trình duyệt.
  • Bộ lọc tra cứu được giữ trong phiên khi chuyển qua lại giữa các chế độ.
  • Chỉ dựng chương đang mở, không thêm thư viện ngoài.

Bản offline và CI

  • Bản HTML một file nhận cùng chế độ đọc, mở bằng file:// vẫn chạy.
  • Thêm tools/test-reader.mjs vào CI: kiểm liên kết của 785 mục trong 36 chương, khôi phục vị trí đọc khi số mục đổi, và biên trên/dưới của cỡ chữ.

Đã kiểm

Chín job CI xanh trên commit phát hành. Cổng local sau khi ghép với vi: linter văn phong 0 ERROR / 392 WARN, "Nói dễ hiểu" 785 mục 0 chỗ chưa đạt, cấu trúc pháp luật 464 mục, tách câu 2.819 trường, tham chiếu chéo 741 chỗ, số liệu thống kê và updates.json khớp, test-reader và test-repo-links đạt.

Đã thử trên trình duyệt

Desktop và khung 390px: mở chế độ đọc, chuyển chương, mục lục, A−/A+, nền tối, bấm tham chiếu chéo rồi Back, tải lại để kiểm khôi phục vị trí, cuộn tới đáy chương để kiểm tiến độ 100% và khoảng trống dưới dòng cuối, bản offline bằng file://.

Còn treo

  • Cột chữ 740px tương đương 81 ký tự một dòng: trong ngưỡng đọc được nhưng vẫn rộng hơn mức thoải mái 65–75; có thể siết max-width khoảng 10% nếu thấy mỏi mắt.
  • Tham chiếu (mục N) đôi khi ngắt dòng giữa cụm; thêm white-space: nowrap là gọn.
  • Chữ phụ 11–12px ở trang tra cứu vẫn dùng màu --t3 đạt tương phản 4,38:1, dưới ngưỡng AA 4,5:1.
  • updates.json vẫn dồn toàn bộ 785 mục về "mới trong 7 ngày" do đợt viết lại lịch sử ở PR #9; cần một lượt sửa dữ liệu.