Skip to content

v1.9 — Bảy trang cùng một giao diện, tải về ở mọi trang

Latest

Choose a tag to compare

@quangpao quangpao released this 07 Nov 07:13
e25fd89

v1.9 — Bảy trang cùng một giao diện, tải về ở mọi trang

Bản này không sửa nội dung: 36 chương, 785 mục giữ nguyên từng chữ so với v1.8. Toàn bộ thay đổi nằm ở giao diện web và ở bộ sinh trang.

Một nav cho cả bảy trang

Năm trang tra cứu và trang tự kiểm tra trước đây có nav, cỡ chữ và bảng màu riêng; trang chủ thì không có nút tải sách. Nay cả bảy trang dùng chung nav của trang chủ:

  • Nav có đủ Đọc sách · Theo tình huống · Pháp luật · Tải về · GitHub, tô đậm đúng trang đang mở.
  • Màn hình nhỏ: Menu dạng details/summary, mở bằng Enter, đóng bằng Esc (trả tiêu điểm về Menu) hoặc bấm ra ngoài; mỗi dòng cao 44 px.
  • Nav là HTML sinh sẵn, không cần JavaScript để hiện.

Chữ và lề khớp trang chủ

Đo trong trình duyệt trên cả bảy trang: chữ nội dung 15 px/1,65, đoạn dẫn 16 px/1,9, H1 38 px Georgia, H2 30 px Georgia, lề 48/28/18 px theo bề rộng màn hình. Trước đây các trang phụ dùng H1 44 px, H2 27 px, chữ 16/28, lề 24 hoặc 37 px. Bố cục 7 trang × 3 bề rộng (320/375/768 px) = 21 trường hợp, không trường hợp nào tràn ngang.

Nền tối vẫn theo cài đặt hệ điều hành, giữ nguyên khi chuyển trang; chữ trong menu nền tối 8,02:1, nút đổi nền 13,09:1.

Bộ sinh và cổng kiểm

  • Nav do tools/lib/site-nav.mjs sinh, tools/site-pages.mjs ghi vào index.html, selfcheck.html giữa hai mốc <!-- site-nav:start --> / <!-- site-nav:end -->. Sửa nav tay sẽ bị ghi đè và site-pages --check báo đỏ.
  • Bản HTML một tệp nay bắt buộc nhúng hết stylesheet và script: tools/offline/build.mjs dừng nếu không tìm thấy thẻ cần thay, tools/test-offline.mjs chặn mọi link[rel=stylesheet] còn sót. Đã thử phá cả hai (đổi thứ tự thuộc tính trong index.html, chèn stylesheet vào bản dựng) — cả hai đều đỏ đúng như mong đợi.
  • CLAUDE.md ghi lại các mốc sinh nav và ba tệp dùng chung, để lần sau không sửa tay đoạn được sinh.

Bản tải về

Tệp Dung lượng Kiểm
EPUB 1,97 MB epubcheck 5.4.0 trong CI: 0 lỗi
PDF 12,97 MB dựng bằng typst 0.15.1, bookmark theo chương
HTML 5,29 MB một tệp, không stylesheet/script ngoài — mở bằng file:// vẫn dùng được
Anki 0,32 MB 785 thẻ, GUID giữ nguyên nên không sinh thẻ trùng

Còn tồn, không chặn bản này

  • Giao diện mới đo bằng Chromium; chưa chạy Safari và Firefox thật (marker của summary, hành vi details), chưa chạy axe/Lighthouse đầy đủ.
  • Chữ phụ 11–12 px màu #6c7267 trên nền giấy đạt 4,38:1, dưới ngưỡng AA 4,5:1 — có từ trước.
  • Menu điện thoại là <div> trong nav chính, không phải landmark riêng (đổi để hết hai landmark lồng nhau).
  • Ba câu ở bìa và trang giới thiệu PDF bị dính chữ do thẻ <br> trong README (từ v1.7); bìa PDF vẫn dùng ảnh chia sẻ 1200×630; updates.json còn dồn mục về nhóm "mới trong 7 ngày".

Ghi công

Nội dung dựa trên HowToLiveLonger của eternity4719, giấy phép CC BY 4.0. Bản Việt hoá và mở rộng do quangpao biên soạn.