Bang URL Routes gan about, contact, blog toi file HTML trong pages
URL Routes

DINHDANH Creator · Bài D02 · Trung bình

Tab "Đường dẫn" (Routes)
gắn URL thân thiện với file HTML

Thay vì để khách truy cập file HTML dài dòng, bạn tạo URL ngắn gọn như /lien-he trỏ đến đúng trang tương ứng. Bài này đi đúng 5 bước hướng dẫn có sẵn trong hệ thống - làm theo là không sai.

Mục tiêu bài học: Tạo được route mới đúng 5 bước, hiểu vì sao thiếu route gây lỗi truy cập, và biết cách kiểm tra/sửa khi route không hoạt động.

Thời lượng đọc: khoảng 12-15 phút

Điều kiện trước: Đã có file HTML trong project (bài D01) cần gắn URL.

Bài trước / sau: ← D01 (Tab Thư mục) · → D03 (Thư viện & Fonts)

Nhãn UI chính sẽ gặp: Đường dẫn · Đường dẫn URL · Thêm Route · Lưu · Route Path · Target File · Type · Status

1. Sơ đồ 5 bước chuẩn (theo hướng dẫn hệ thống)

Bước 1
Nhấn nút "Thêm Route" để tạo route mới
Bước 2
Nhập tên route (chỉ chữ, số, dấu gạch ngang - và gạch dưới _)
Bước 3
Chọn file HTML từ danh sách dropdown
Bước 4
Bật/tắt route bằng cách click vào nút toggle màu xanh/xám
Bước 5
Nhấn "Lưu" để lưu routes vào kho file của dự án (routes.json)

Ghi nhớ: Đây đúng 5 câu hướng dẫn hiển thị ngay trong tab "Đường dẫn" của Creator (mục "Hướng dẫn sử dụng:") - không cần nhớ, mở tab lên là thấy lại.

2. Thuật ngữ trong bài

Thuật ngữNghĩaNơi thấy trên UI
Đường dẫn (Routes)Tên tab quản lý URL tùy chỉnh của appTab trên cùng của Creator
Route PathĐoạn URL bạn tự đặt (vd. about, blog/ten-bai)Cột trong bảng route
Target FileFile HTML thực tế mà route trỏ đếnDropdown khi tạo/sửa route
StatusTrạng thái bật/tắt của route (toggle xanh = bật)Cột trong bảng route
routes.jsonFile lưu toàn bộ cấu hình route trên hệ thốngLưu ngầm khi nhấn "Lưu"

3. Chi tiết từng bước

Tab Code mo routes.json hien anh xa path sang file
routes.json

Ví dụ minh họa (đúng theo mẫu trong UI)

Route:lien-he
File:contact.html
URL truy cập:/tên-link-của-bạn/lien-he

Bước 1-3: Nhấn "Thêm Route", nhập tên route (chỉ chữ/số/-/_ - không dấu tiếng Việt, không khoảng trắng), chọn file HTML tương ứng ở dropdown Target File.

Bước 4: Toggle Status sang xanh để route hoạt động ngay; để xám nếu muốn tạo trước, kích hoạt sau.

Bước 5: Nhấn "Lưu" - bắt buộc, nếu không route sẽ không được ghi vào routes.json và mất khi rời tab.

Khi chưa có route nào

Tab hiện thông báo: "Chưa có route nào. Nhấn "Thêm Route" để tạo." - đây là điểm bắt đầu bình thường cho project mới, không phải lỗi.

4. Vấn đề thường gặp

Tình huốngNguyên nhân & cách sửa
Truy cập URL báo lỗi/không mở được trangKiểm tra file HTML tương ứng có tồn tại không - "Route cần file HTML tương ứng, nếu file không có thì route sẽ lỗi"
Route đã thêm nhưng vẫn không hoạt động trên live"Kiểm tra file HTML có tồn tại, route đã lưu chưa" - cần cả hai điều kiện: file tồn tại VÀ đã nhấn "Lưu"
Menu/nút trong trang dẫn tới link 404Chưa tạo route cho trang đó - thêm route mới trỏ đúng file, sau đó cập nhật lại link trong menu
Nhập route có dấu tiếng Việt hoặc khoảng trắngHệ thống chỉ chấp nhận chữ, số, - và _ - đổi thành không dấu (vd. lien-he thay vì liên hệ)
Route bị tắt (toggle xám) dù đã tạoBật toggle Status sang xanh rồi nhấn "Lưu" lại

5. So sánh với công cụ nổi tiếng

Công cụĐiểm giốngKhác biệt
WordPress (Permalinks)Cùng khái niệm URL đẹp trỏ tới nội dungWordPress tự sinh permalink theo bài viết; Creator để bạn map tay từng route → file HTML tĩnh
WebflowCó bảng quản lý trang/URL riêngWebflow gắn route theo CMS Collection; Creator gắn route theo từng file HTML cụ thể
LinktreeKhông có bảng route - chỉ 1 trang duy nhấtCreator hỗ trợ nhiều route/nhiều trang, phù hợp website đa trang thay vì biolink 1 trang

6. Giới hạn kỹ thuật

Làm được

  • Tạo nhiều route trỏ tới các file HTML khác nhau
  • Bật/tắt route mà không cần xóa
  • Dùng route dạng nhiều cấp như blog/ten-bai

Không làm được

  • Dùng dấu tiếng Việt có dấu hoặc khoảng trắng trong tên route
  • Route hoạt động nếu chưa nhấn "Lưu" - thay đổi chỉ tồn tại tạm trên UI
  • Route hoạt động nếu file HTML đích đã bị xóa (mềm hoặc vĩnh viễn) khỏi Thư mục

7. Lời khuyên sử dụng thông minh

  • Luôn tạo file HTML xong trước, rồi mới thêm route trỏ tới - tránh route "treo" không có file.
  • Dùng tên route ngắn, không dấu, dễ nhớ - thân thiện cho SEO và người dùng gõ tay.
  • Sau khi thêm/sửa nhiều route, kiểm tra lại bằng cách mở thử từng URL trên "Bản nháp chưa công bố" trước khi Lưu thay đổi lên live.
  • Nếu làm website nhiều trang (bài B04), lập danh sách route cần thiết trước khi bắt đầu để tránh quên trang nào.

8. Checklist tự kiểm

  1. Bạn tạo được một route mới đúng đủ 5 bước chưa?
  2. Bạn thử mở URL vừa tạo để kiểm tra hoạt động chưa?
  3. Bạn giải thích được vì sao route lỗi khi thiếu file hoặc chưa Lưu chưa?
  4. Bạn biết cách tắt tạm một route mà không cần xóa chưa?

Bài tiếp theo

D03 - Libraries & Fonts: bật Bootstrap, icon, chart

Bạn sẽ học cách bật thư viện CDN có sẵn (Bootstrap, Font Awesome, Chart.js) bằng vài click, thay vì tự gắn thẻ script/link thủ công.

DINHDANH Creator · Bộ hướng dẫn người dùng · D02