參考資料

概覽

參考資料用來回答精確問題：要使用哪個符號、哪個值、哪種支援層級、哪一項條款。本頁彙整 NextPDF 已驗證的介面範圍：模組參考、支援對照表、API 介面、錯誤參考、標準一致性，以及本專案發布的各項政策。這裡不說明如何達成目標；如需操作步驟，請改用指南或 Cookbook（範例指南）。

逐一介紹 nextpdf/core 引擎的各項模組。

列出繪製器對各項功能的支援狀態：已驗證、已宣稱、部分支援，或不支援。

頁面	用途
CSS 支援對照表	HTML 管線中各項 Cascading Style Sheets（CSS）功能的支援層級。
不支援的 CSS 功能與替代做法	哪些功能不屬於支援範圍，以及可改用的替代做法。
字型與文字系統支援對照表	字型技術與書寫系統的支援情形。
CJK 直書支援	中文、日文與韓文文字的直書 writing-mode 支援。
複雜書寫系統字形塑形支援	針對需要字形塑形的書寫系統提供字形塑形支援。

精確列出符號、允許的值與服務合約。

頁面	用途
列舉參考	每個公開列舉及其允許的值。
TSA 設定	預設的 Time-Stamping Authority（TSA）及其變更方式。
Connect REST API 參考	NextPDF Connect 的 REST endpoint，取自 OpenAPI 3.1 文件。
Connect API 探索器	同一份合約的互動式探索器。

套件層級的 Application Programming Interface（API）參考資料放在各套件所在的位置，也就是「指南」分頁中的 Connect API 參考、整合 API 索引與 Python SDK API 參考資料。

引擎拋出的每一種例外都會依領域分類，並附上結構化情境與復原指引。

頁面	用途
錯誤參考	例外模型：`NextPdfException` 基底類別與情境合約。
核心與一般錯誤	文件生命週期與一般引擎失敗。
繪製與 I/O 錯誤	HTML、字型、寫入器與讀取器的失敗。
安全性與簽署錯誤	加密、簽署與 PKI 的失敗。
執行階段與支援錯誤	HTTP、韌性與可觀測性的失敗。
Accelerator 錯誤	選用加速 sidecar 的失敗。
合規錯誤	驗證與一致性工具的失敗。

NextPDF Core 鎖定的各項標準設定檔；每一項都明確界定其邊界：引擎產出的是意圖符合規範的輸出，一致性則由外部驗證器判定。

說明核心引擎的工程立場，並界定各項聲明的邊界。

詞彙表：本文件所使用的術語會在此各自定義一次，並於各處加上連結。

每個 API 項目都必須回答同一組固定問題：

問題	必填答案
我要呼叫什麼？	具完整限定名稱的符號、endpoint、command-line interface（CLI）指令或組態鍵。
接受哪些輸入？	包含型別、是否必填、預設值與可接受值的參數表格。
預設會發生什麼？	省略選填輸入時會採取的行為。
會回傳什麼？	回傳型別、回應內容、檔案輸出、stream 或副作用。
可能在哪裡失敗？	例外、驗證錯誤、HTTP 狀態碼或維運層級的失敗模式。
我要怎麼安全地使用它？	安全性、worker 安全性、大小限制、路徑、逾時與密鑰處理等注意事項。

API 與行為參考頁面皆以原始碼為依據。公開 API 文件根據套件原始碼、組態檔、測試與範例撰寫而成。只有當應用程式開發者必須理解內部輔助類別的行為，才能設定或操作該套件時，才會為這些類別撰寫文件。

參考頁面優先使用表格，而非密集段落。每一列都應能獨立理解，因為後續的 Extensible Localization Interchange File Format（XLIFF）段落切分會依區塊拆分內容。