
DINHDANH Creator · Bài T08 · Thuật ngữ
- vì sao có file vẫn 404
File HTML nằm trên đĩa ≠ URL khách gõ được. Route là cầu nối trong routes.json; thiếu route hoặc URL tương đối với base tag là nguồn 404 kinh điển.
Mục tiêu: Làm đúng 5 bước UI tab Đường dẫn; hiểu slug lồng; absolute URL; phân biệt Lưu routes vs Lưu thay đổi.
Thời lượng: 11-13 phút · Trước: D02 · Sau: T09
UI: tab Đường dẫn · Thêm Route · Route Path · Target File · toggle xanh/xám · Lưu
1. Sơ đồ
https://site/{url}/blog/hello-worldblog/hello-world → file blog-detail.html (ví dụ)2. Ví dụ routes.json (logic)
CMS manifest có thể khai báo slug list/detail - route phải khớp sau khi publish bài (G04/T05).
3. Thuật ngữ
| Thuật ngữ | Nghĩa |
|---|---|
| Route Path | Slug: chữ, số, - _; lồng tag/slug |
| Target File | File HTML trên kho file của dự án (dropdown tab Đường dẫn) |
| generateSlug() | Helper tạo slug từ tiêu đề bài |
| URL tuyệt đối | Bắt buộc khi điều hướng - base tag phá URL tương đối |
| addRoute / removeRoute | API thay cho sửa routes.json tay (T04) |
4. Năm bước đúng nhãn UI

- Nhấn "Thêm Route".
- Nhập Route Path (chỉ chữ, số, gạch ngang, gạch dưới).
- Chọn Target File từ dropdown.
- Bật route - toggle xanh (xám = tắt).
- Nhấn "Lưu" tab Đường dẫn → ghi routes.json.
Không nhầm: Lưu tab Đường dẫn ≠ Lưu thay đổi toolbar Creator. Cần cả hai nếu đang trên đĩa ảo nháp (T01).
5. So sánh · Giới hạn · Bảo mật
- Next.js file-based routing: path file ≈ URL; DINHDANH tách file ↔ route.
- WordPress permalinks: rewrite ≈ routes.json.
Giới hạn: slug trùng → route sau ghi đè; không route wildcard tùy ý nếu UI không hỗ trợ.
Bảo mật: đừng route trang admin slug dễ đoán mà thiếu auth (T07). Route /cms thường do CMS bootstrap.
6. Luồng CMS publish → route
- Biên tập đăng bài Đã xuất bản trong /cms - slug vd.
hello-world. - CMS/manifest khai báo detail pattern
blog/{slug}→ route cầnblog/hello-world. - AI hoặc addRoute tạo route trỏ
blog-detail.html(hoặc file trong manifest). - Tab Đường dẫn → toggle xanh → Lưu → Lưu thay đổi Creator.
- Mở URL public - không mở trực tiếp file path trên server.
7. Sự cố · Checklist
| Sự cố | Xử lý |
|---|---|
| 404 dù có HTML trong Thư mục | Thêm Route + Lưu; toggle bật |
| Link nội bộ gãy | Absolute URL từ site_url |
| Sửa routes không thấy live | Quên Lưu tab Đường dẫn; rồi Lưu thay đổi Creator |
| Xóa bài CMS URL chết | Xóa route tương ứng (X04) |
- Sau AI tạo trang mới bạn kiểm tab Đường dẫn?
- Bạn nhấn Lưu tab Đường dẫn (không chỉ Lưu thay đổi)?
- Link trong HTML dùng URL tuyệt đối?
Tiếp: T09 - Không gian xem (4 chế độ)
Điều hướng nội bộ (cùng ngôn ngữ)