本文介紹如何使用線上工具 https://lab.quizzman.com/jck/。若想了解產品概念，可參閱〈Quizzman JCK Font Engine 是什麼？〉；工具介紹請參閱 about-jck。

開始之前

開啟：

https://lab.quizzman.com/jck/

（Glyph Synthesis Lab，字形合成實驗室）

檢查 API 是否正常：

https://lab.quizzman.com/api/jck/health

預期回傳：

"status":"ok"

公開使用者可直接：

- 預覽（Preview） - 合成字形（Synthesize）

若需：

- 儲存 Project - 建立字型（Build Font）

通常需要登入 Quizzman ID，並具有相應權限。

介面組成

主要包含以下幾個區域：

Composer／IDS（IDS 編輯器）

輸入或選擇 IDS（Ideographic Description Sequence，漢字描述序列）運算子，例如 ⿰、⿱、⿲、⿳，並配置各個部件。

Slot Controls（區塊控制）

調整：

- 比例（Ratio） - 水平／垂直縮放（Scale） - 部件間距（Gap）

SVG Preview（SVG 即時預覽）

即時顯示合成字形，同時提供 Quality Score（品質評分）。

Project（專案）

管理已建立字形，可批次建置並下載 ZIP。

第一步：建立 IDS 字形

選擇適合的 IDS 結構。

例如：

左右結構：

⿰

上下結構：

⿱

將各部件放入對應 Slot。

例如：

SVG Preview 將立即更新。

觀察：

Quality Score
是否重疊（Overlap）
是否失衡
是否缺少 Coverage

建議依序調整：

Ratio → Scale → Gap

不要一次把所有參數調到極限，以免字形變形。

第二步：微調版面

每個 Slot 都可調整：

空間比例（Ratio）
水平／垂直縮放（Scale）
元件距離（Gap）

目標是：

一般閱讀大小清楚
放大檢視仍保持平衡
各部件不互相碰撞

第三步：加入 Project

當預覽滿意後：

將字形加入 Project。
重複建立其他字形。
在 Project 頁面快速檢查整批結果。

例如：

一課教材
一本字典
一組漢字資料

皆可集中管理。

第四步：Build 並匯出字型

可輸出：

OTF（OpenType Font，OpenType 字型）
TTF（TrueType Font，TrueType 字型）
WOFF2（Web Open Font Format 2，Web 字型格式）

流程如下：

選擇輸出格式。
執行 Build（若需要權限，請先登入）。
下載 ZIP。

ZIP 通常包含：

Font
Manifest（字元、Code Point、IDS 等資訊）

之後可於：

網站
App
編輯器

測試字型是否正常。

若字形異常，可比對 Manifest 與 IDS。

Base Font Merge

JCK Font Engine 可與既有字型合併，例如：

Nom Na Tong
LXGW WenKai

使新生成的 Glyph（字形）與既有 CJK 字型風格保持一致。

可依不同專案選擇：

漢喃字型
現代 CJK 字型

等不同 Profile。

第五步：API 整合

公開 API 包括：

| 功能 | Endpoint | |------|----------| | Health | GET /api/jck/health | | Catalog | GET /api/jck/catalog | | Synthesize | POST /api/jck/... |

完整 API 前綴：

https://lab.quizzman.com/api/jck/

常見整合流程：

批次建立字型
產生 WOFF2
部署至網站

或：

先產生 SVG Preview，

確認後再批次 Build Font。

常見問題

無法 Build？

Build 與 Project 屬於登入功能。

請先登入 Quizzman ID，再重新開啟 /jck/。

網站仍顯示 tofu（□）？

請確認：

font-family 是否設定正確
WOFF2 是否已部署
Manifest 是否包含對應 Unicode Code Point

IDS 沒錯，但字形不好看？

通常可重新調整：

Ratio
Scale
Gap

若 Quality Score 偏低，

通常代表：

元件碰撞（Collision）
版面失衡

「約 87,720 個字元」代表什麼？

這代表目前 Catalog 已匯入約 87,720 個字元。

並不代表每次 Build 都會輸出全部字型。

建置完成檢查清單

[ ] Health API 回傳 ok
[ ] SVG Preview 在不同字級均正常
[ ] Project 已包含所有需要的字形
[ ] ZIP 包含 Font 與 Manifest
[ ] 已於瀏覽器或目標 App 完成測試

Quizzman JCK Font Engine－Composer、Project 與字型匯出使用指南