Quizzman JCK Font Engine – Hướng dẫn sử dụng Composer, Project và xuất font

JCK Font Engine

• Công cụ: lab.quizzman.com/jck/
• About: about-jck

Hướng dẫn từng bước trên công cụ live lab.quizzman.com/jck/. Bài định nghĩa sản phẩm: JCK Font Engine là gì?. About trang công cụ: about-jck.

Trước khi bắt đầu

1. Mở https://lab.quizzman.com/jck/ (Glyph Synthesis Lab).
2. Kiểm tra API còn sống: https://lab.quizzman.com/api/jck/health — kỳ vọng "status":"ok".
3. Preview / synthesize công khai có thể dùng ngay. Lưu project / build font thường cần đăng nhập Quizzman ID và quyền phù hợp.

Giao diện gồm những gì?

Thường gặp các vùng chính:

1. Composer / IDS: nhập hoặc chọn toán tử cấu trúc (⿰ ⿱ ⿲ ⿳ …) và thành phần.
2. Slot controls: tỉ lệ phân bổ, scale ngang/dọc, gap giữa các bộ.
3. Preview SVG: glyph render realtime + điểm quality.
4. Project: danh sách glyph đã thêm; build batch; tải ZIP.

Bước 1. Tạo glyph từ IDS

1. Chọn toán tử cấu trúc phù hợp (ví dụ chữ trái–phải dùng ⿰).
2. Gán thành phần vào từng slot (bộ trái / phải / trên / dưới…).
3. Quan sát preview SVG cập nhật ngay khi chỉnh tham số.
4. Xem quality score để phát hiện lệch cân bằng, overlap, thiếu coverage.

Mẹo: chỉnh lần lượt ratio → scale → gap; đừng kéo hết biên cùng lúc nếu glyph bị méo.

Bước 2. Tinh chỉnh bố cục

Với mỗi slot, thử:

1. tăng/giảm tỉ lệ không gian giữa các thành phần;
2. co giãn ngang/dọc để khớp khung chữ;
3. chỉnh khoảng cách (âm/dương) khi hai bộ quá sát hoặc quá thưa.

Mục tiêu: glyph ổn định khi nhìn ở cỡ chữ đọc thông thường và khi phóng lớn.

Bước 3. Thêm vào Project

1. Khi preview đạt yêu cầu, thêm glyph vào project.
2. Lặp lại với các chữ khác cùng bộ nội dung (ví dụ một bài học / một mục từ điển).
3. Dùng preview trong tab Project để đối soát nhanh trước khi build.

Bước 4. Build và xuất font

1. Chọn định dạng xuất: OTF, TTF hoặc WOFF2 (theo UI hiện có).
2. Chạy build (cần quyền đăng nhập nếu môi trường yêu cầu).
3. Tải ZIP: font + manifest (ký tự, codepoint, IDS).
4. Kiểm tra font trên web / app / editor đích; đối chiếu manifest nếu có chữ lệch IDS.

Base font merge (Nom Na Tong / LXGW WenKai) giúp glyph mới hòa style với bộ CJK sẵn có — chọn profile phù hợp dự án Hán-Nôm hoặc CJK hiện đại.

Bước 5. Dùng API (tích hợp)

Các endpoint công khai hữu ích:

Prefix đầy đủ: https://lab.quizzman.com/api/jck/.

Luồng tích hợp phổ biến: prebuild font theo chiến dịch nội dung → embed WOFF2 trên web; hoặc synthesize SVG cho preview rồi mới batch build.

FAQ nhanh

Không đăng nhập được build? Projects/build thuộc luồng authenticated; thử đăng nhập tại Quizzman ID rồi mở lại /jck/.

Chữ vẫn bị tofu ở website? Kiểm tra file font đã embed đúng font-family, WOFF2 đã deploy, và manifest đủ codepoint.

IDS “đúng” nhưng glyph xấu? Quay lại chỉnh ratio/scale/gap; quality score thấp thường báo collision hoặc mất cân bằng.

~87.720 ký tự nghĩa là gì? Đây là kích thước catalog import hiện tại trên health API — không đồng nghĩa đã xuất cả bộ trong một file font mỗi lần build.

Checklist bàn giao

1. [ ] Health ok
2. [ ] Preview SVG ổn ở 2–3 cỡ chữ
3. [ ] Project đủ danh sách ký tự chiến dịch
4. [ ] ZIP có font + manifest
5. [ ] Đã test trên trình duyệt / app đích

Liên kết

1. Công cụ: lab.quizzman.com/jck/
2. About SEO: lab.quizzman.com/tool/about-jck
3. Bài định nghĩa: JCK Font Engine là gì?