s_skaidocsTài liệu

slugify

Có sẵn · tái sử dụng

Tạo slug. Dùng khả năng hiện có, không tạo alias hoặc triển khai engine trùng chức năng.

Phạm vi hỗ trợCó trong thư viện Lingo hoặc helper Skai không đồng nghĩa được phép trong mọi runtime. Chính sách allowlist vẫn áp dụng; không tự mở quyền trong thay đổi tài liệu này.

slugify · thay handleize

Đầu vàostring
Tham sốKhông có
Đầu raslug

slugify đã có trong thư viện; strict profile chưa bật. Ưu tiên một tên chuẩn, không alias Liquid.

VÍ DỤ LINGO / SKAI
{{ "Summer Sale"|slugify }}
KẾT QUẢ MINH HỌA
summer-sale

Trường hợp biên và an toàn

Unicode tiếng Việt và chuyển đ thành d phải chốt qua test trước; không tự cam kết transliteration. Không đảm bảo slug duy nhất. Strict profile chưa bật slugify.

slugify · thay handle

Đầu vàostring
Tham sốKhông có
Đầu raslug

Cùng thiết kế với handleize; không tạo filter handle riêng.

VÍ DỤ LINGO / SKAI
{{ "Summer Sale"|slugify }}
KẾT QUẢ MINH HỌA
summer-sale

Trường hợp biên và an toàn

Unicode tiếng Việt và chuyển đ thành d phải chốt qua test trước; không tự cam kết transliteration. Không đảm bảo slug duy nhất. Strict profile chưa bật slugify.

Tiêu chí nghiệm thu

  • Kiểm thử ví dụ ở trên cùng đầu vào rỗng, Unicode, sai kiểu và giới hạn đầu ra.
  • Khóa hành vi của implementation hiện tại bằng test; không sửa ngữ nghĩa để khớp Liquid.
  • Không I/O, truy vấn hoặc thay đổi dữ liệu từ template; dữ liệu commerce chỉ qua resolver có quyền.
  • Kiểm thử escaping và profile runtime trước khi công bố cho theme.

Nguồn & quyết định chuyển đổi

Tên tham khảo: handleize, handle. Dùng tên/cú pháp Lingo hoặc helper Skai ghi ở đầu trang, không tạo alias tương thích Liquid.

Nguồn tham khảo Haravan · Quy ước đặc tả Skai

Đối chiếu mã nguồn local: skaiplatform/lingo/filters_builtin.go, tags_*.go, security.go và skaiweb/services/theme_engine/functions.go. Badge “Đang phát triển” biểu thị tài liệu dự kiến, không xác nhận engine đã được triển khai.