Bang URL Routes anh xa path sang file HTML
UI Routes

DINHDANH Creator · Bài T08 · Thuật ngữ

Routes vs file path
- 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ơ đồ

Khách mở: https://site/{url}/blog/hello-world
→ tra routes.json
→ route blog/hello-world → file blog-detail.html (ví dụ)
→ render HTML + inject client
Có blog-detail.html trong Thư mục nhưng không có route → 404
Route tắt (toggle xám) → 404 hoặc ẩn

2. Ví dụ routes.json (logic)

{ "blog": "blog-list.html",
  "blog/hello-world": "blog-detail.html",
  "shop": "products.html",
  "contact": "contact.html" }

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 PathSlug: chữ, số, - _; lồng tag/slug
Target FileFile 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 đốiBắt buộc khi điều hướng - base tag phá URL tương đối
addRoute / removeRouteAPI thay cho sửa routes.json tay (T04)

4. Năm bước đúng nhãn UI

routes.json mo trong tab Code
routes.json
  1. Nhấn "Thêm Route".
  2. Nhập Route Path (chỉ chữ, số, gạch ngang, gạch dưới).
  3. Chọn Target File từ dropdown.
  4. Bật route - toggle xanh (xám = tắt).
  5. 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

  1. Biên tập đăng bài Đã xuất bản trong /cms - slug vd. hello-world.
  2. CMS/manifest khai báo detail pattern blog/{slug} → route cần blog/hello-world.
  3. AI hoặc addRoute tạo route trỏ blog-detail.html (hoặc file trong manifest).
  4. Tab Đường dẫn → toggle xanh → Lưu → Lưu thay đổi Creator.
  5. 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ụcThêm Route + Lưu; toggle bật
Link nội bộ gãyAbsolute URL từ site_url
Sửa routes không thấy liveQuên Lưu tab Đường dẫn; rồi Lưu thay đổi Creator
Xóa bài CMS URL chếtXóa route tương ứng (X04)
  1. Sau AI tạo trang mới bạn kiểm tab Đường dẫn?
  2. Bạn nhấn Lưu tab Đường dẫn (không chỉ Lưu thay đổi)?
  3. Link trong HTML dùng URL tuyệt đối?

Tiếp: T09 - Không gian xem (4 chế độ)