阿拉伯文字排版工作流程
- 保留用戶準確的 Unicode 文字。在渲染前與用戶確認不確定的拼寫。切勿反轉文字、替換字母、標準化標記或套用單獨的整形器。
- 對於 Kufic，區分現代 Kufi 字型與方形/歷史 Kufic；不清楚時請參考。Diwani 僅支援無標音的 PNG/輪廓 SVG，不支援 harakat、PDF 或類似半島電視台的合成徽章。請閱讀 [capabilities]（capabilities.json）。為目的選擇一個真正實現的風格。僅閱讀對應的
references/styles/<style>.md。對於方形 Kufic，請閱讀 [手動網格工作流程]（docs/square-kufic.md）：使用標記的單元和精確的原始碼範圍，切勿將通用字型像素化或將迷宮標記為阿拉伯文。任意文字的方形 Kufic 渲染仍然不可用。其他僅供參考的傳統需要手動創作；明確提供一個支援的替代方案。 - 使用環境中已安裝的
arabic-calligraphyCLI，或按照 [安裝說明]（docs/installation.md）安裝此目錄：python -m pip install .。原生依賴是強制性的。安裝可能需要網路；渲染則不需要。 - 渲染：
arabic-calligraphy render --text "العلم نور" --style naskh --output artwork.svg。將副檔名改為 PNG。使用poster生成藝術作品，使用certificate生成結構化證書。使用document --input examples/documents/report.md --output report.pdf生成新的 PDF。請閱讀 [PDF 佈局]（references/pdf-layout.md）了解限制。 - 檢查實際輸出是否有字符碰撞、裁剪、拼寫、閱讀順序和視覺層次的問題。報告缺失的覆蓋範圍或溢出；不要隱藏錯誤。單獨檢查可選擇的 PDF 文字與其外觀。
- 手動網格研究使用
arabic-calligraphy grid --input examples/square-kufic/allah-study.json --output study.svg。將來源映射與實際圖像進行比對，報告幾何發現，並將 JSON 與圖像一起交付。即使通過檢查，也不代表驗證了阿拉伯文或真實性；切勿聲稱基礎研究是緊湊的徽章。 - 如果捆綁的渲染器無法運行，請報告缺失的依賴項。切勿用圖像生成、手寫 SVG 或其他系統字型取代它並聲稱此技巧渲染了它。交付實際檔案及其能力分類。字型工作流程是基於字型的近似；手動網格研究是明確未經審查的創作。兩者都沒有獨立真實性認證。對於儀式、宗教或歷史真實性，請請求人工書法審閱。
現有 PDF：保留原件。此套件創建新文件；它不實現在提供的 PDF 中任意替換文字。僅在需要時參閱 [排版]（references/typography.md）和 [海報指導]（references/posters.md）。