Repository navigation
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.mjssinh,tools/site-pages.mjsghi vàoindex.html,selfcheck.htmlgiữa hai mốc<!-- site-nav:start -->/<!-- site-nav:end -->. Sửa nav tay sẽ bị ghi đè vàsite-pages --checkbáo đỏ. - Bản HTML một tệp nay bắt buộc nhúng hết stylesheet và script:
tools/offline/build.mjsdừng nếu không tìm thấy thẻ cần thay,tools/test-offline.mjschặn mọilink[rel=stylesheet]còn sót. Đã thử phá cả hai (đổi thứ tự thuộc tính trongindex.html, chèn stylesheet vào bản dựng) — cả hai đều đỏ đúng như mong đợi. CLAUDE.mdghi 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 |
| 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 videtails), chưa chạy axe/Lighthouse đầy đủ. - Chữ phụ 11–12 px màu
#6c7267trê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.jsoncò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.