# Quizzman JCK Font Engine – Hướng dẫn sử dụng Composer, Project và xuất font
**Canonical:** https://wiki.quizzman.com/wiki/quizzman-jck-font-engine-huong-dan-su-dung
**Author:** System Legacy  |  **Published:** 2026-07-15  |  **Updated:** 2026-07-17
**Tags:** Công nghệ, JCK Font, Lập trình

> Hướng dẫn SEO dùng JCK Font Engine tại lab.quizzman.com/jck/: IDS Composer, chỉnh slot layout, preview SVG, project, build OTF/TTF/WOFF2 và API health/catalog.

# Quizzman JCK Font Engine – Hướng dẫn sử dụng Composer, Project và xuất font
Hướng dẫn từng bước trên công cụ live **[lab.quizzman.com/jck/](https://lab.quizzman.com/jck/)**. Bài định nghĩa sản phẩm: [JCK Font Engine là gì?](https://wiki.quizzman.com/wiki/quizzman-jck-font-engine-la-gi-tong-hop-glyph-han-nom-tu-ids). About trang công cụ: [about-jck](https://lab.quizzman.com/tool/about-jck).
# Trước khi bắt đầu
Mở [https://lab.quizzman.com/jck/](https://lab.quizzman.com/jck/) (Glyph Synthesis Lab).
Kiểm tra API còn sống: [https://lab.quizzman.com/api/jck/health](https://lab.quizzman.com/api/jck/health) — kỳ vọng `"status":"ok"`.
**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:

**Composer / IDS**: nhập hoặc chọn toán tử cấu trúc (⿰ ⿱ ⿲ ⿳ …) và thành phần.
**Slot controls**: tỉ lệ phân bổ, scale ngang/dọc, gap giữa các bộ.
**Preview SVG**: glyph render realtime + điểm quality.
**Project**: danh sách glyph đã thêm; build batch; tải ZIP.
# Bước 1. Tạo glyph từ IDS
Chọn toán tử cấu trúc phù hợp (ví dụ chữ trái–phải dùng ⿰).
Gán thành phần vào từng slot (bộ trái / phải / trên / dưới…).
Quan sát preview SVG cập nhật ngay khi chỉnh tham số.
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ử:

tăng/giảm **tỉ lệ không gian** giữa các thành phần;
**co giãn** ngang/dọc để khớp khung chữ;
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
Khi preview đạt yêu cầu, thêm glyph vào project.
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).
Dùng preview trong tab Project để đối soát nhanh trước khi build.
# Bước 4. Build và xuất font
Chọn định dạng xuất: **OTF**, **TTF** hoặc **WOFF2** (theo UI hiện có).
Chạy **build** (cần quyền đăng nhập nếu môi trường yêu cầu).
Tải **ZIP**: font + **manifest** (ký tự, codepoint, IDS).
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:

Bảng: Mục đích | URL gợi ý

Health | `GET /api/jck/health`
Catalog | `GET /api/jck/catalog`
Synthesize | `POST /api/jck/...` (gateway `lab.quizzman.com/api/jck`)
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
[ ] Health `ok`
[ ] Preview SVG ổn ở 2–3 cỡ chữ
[ ] Project đủ danh sách ký tự chiến dịch
[ ] ZIP có font + manifest
[ ] Đã test trên trình duyệt / app đích
# Liên kết
Công cụ: [lab.quizzman.com/jck/](https://lab.quizzman.com/jck/)
About SEO: [lab.quizzman.com/tool/about-jck](https://lab.quizzman.com/tool/about-jck)
Bài định nghĩa: [JCK Font Engine là gì?](https://wiki.quizzman.com/wiki/quizzman-jck-font-engine-la-gi-tong-hop-glyph-han-nom-tu-ids)