預檢
在文件交出去之前,檢查原始碼、建置記錄檔、PDF、參考文獻、無障礙訊號與投稿風險。
編譯成功只能證明 PDF 已經產生。它不能證明每筆引用都已解析、閱讀順序合理、投稿封存檔乾淨,或檔案真的具備它所宣稱的無障礙結構。
預檢把這些問題集中到一次本機審查中。開啟側邊列中的盾牌,選擇適合這份文件的檢查,修正問題時可以只執行單一檢查,投稿前則執行全部檢查。


六項獨立檢查
標題為「六項獨立檢查」的段落編譯與版面
標題為「編譯與版面」的段落讀取最新的建置記錄檔和 PDF,找出建置失敗、未解析的引用與參照、需要重跑的警告、缺少的字符、溢出的方框、被裁切的文字、重複的 PDF 目的地,以及混用的頁面大小。
投稿就緒度
標題為「投稿就緒度」的段落將選定的出版設定檔套用到專案。它會檢查較穩定的要求,包括文件類別、摘要與關鍵字、圖片格式、嵌入字型、PDF 限制、圖說、可攜的檔名,以及原始碼封裝中多餘的檔案。
ATS 就緒度
標題為「ATS 就緒度」的段落以和應徵者追蹤系統類似的方式擷取履歷內容。它會回報聯絡資訊欄位、預期的章節,以及可能打亂閱讀順序的版面。
無障礙
標題為「無障礙」的段落檢查原始碼和 PDF 中與下列項目相關的訊號:標記、替代文字、語言與標題中繼資料、檢視器設定、標題、表格、連結、閱讀順序、可選取的文字、必要時的書籤,以及非常小的文字。
參考文獻與資源檔
標題為「參考文獻與資源檔」的段落找出缺少的檔案、未解析的引用與交互參照、重複的標籤與 DOI、不完整的參考文獻條目,並在專案完整可用時找出未被引用的參考文獻。
隱私與匿名審查
標題為「隱私與匿名審查」的段落找出可能破壞匿名審查的憑證、私密金鑰、敏感檔案、草稿筆記、內部註解、誌謝、作者欄位和身分中繼資料。
Typst 專案
標題為「Typst 專案」的段落Typst 原始碼有自己的一組檢查。它們直接讀取你的 .typ 檔案,因此 LaTeX 規則不會對 Typst 語法觸發。
- 參考文獻與資源檔會找出沒有對應標籤或參考文獻條目的
@參照與引用、重複的標籤、對不到任何專案檔案的圖片或#include路徑、不在專案中的#bibliography檔案,以及引用了來源卻從未呼叫#bibliography的文件。引用金鑰可以放在.bib檔案或 Hayagriva.yml檔案中。 - 無障礙會標示沒有
alt文字的圖片(不論alt設在圖片上,或設在包住圖片的 figure 上)、空白的標題,以及沒有透過#set document(title: ...)或範本設定標題的文件。 - 投稿就緒度會檢查專案是否匯入了符合所選設定檔的範本、範本是否取得摘要與關鍵字,以及是否殘留
#lorem文字、預留位置或 TODO 備註。它也會檢查圖說、圖片大小和檔名。 - 隱私與匿名審查會找出傳給範本的作者姓名、電子郵件和所屬單位、誌謝,以及本機檔案路徑。
每項發現都會標出檔案與行號,其詳細資訊會顯示 Typst 的修正方式,例如 #image("chart.png", alt: "Bar chart of yearly sales")。
看確定程度,不只看顏色
標題為「看確定程度,不只看顏色」的段落每個結果都會說明 Oleafly 是如何得出的:
- 已驗證表示應用程式在原始碼、記錄檔、專案或 PDF 中觀察到直接的證據。
- 建議性表示有文件記載的啟發式規則發現了值得人工檢查的地方。
- 需手動表示這項檢查無法單靠檔案安全地判定。
缺少輸入絕不會被當成通過。在有最新的 PDF 之前,只依據原始碼得到的發現都只算部分結果。
選擇出版設定檔
標題為「選擇出版設定檔」的段落請使用最符合投稿目的地的一般出版、arXiv、IEEE、ACM、期刊或學位論文設定檔。設定檔涵蓋的是夠穩定、可以自動檢查的要求。在 Typst 專案中,設定檔也會預期使用相符的 Typst 範本,而發現項目會列出它接受的範本。
接著再開啟最新的投稿須知。頁數限制、邊界、檔案大小上限、匿名化規則和命名慣例變動得太頻繁,通用的設定檔無法替你決定。
看看另一位讀者收到什麼
標題為「看看另一位讀者收到什麼」的段落在預檢面板中選擇螢幕閱讀器,會開啟閱讀器看到的內容,逐頁擷取 PDF 的文字。可用它找出橫跨整頁被讀成一行的雙欄論文、缺少的圖示字型電話號碼、位置不對的圖說,或沒有可選取文字的頁面。
對履歷來說,解析器擷取到的內容會顯示 ATS 模擬所能還原的姓名、電子郵件、電話、連結和標準章節。
這些檢視提供的是證據,不能取代用你的對象實際使用的投稿入口網站、螢幕閱讀器或解析器所做的測試。
PDF/UA 與無障礙:誠實的界線
標題為「PDF/UA 與無障礙:誠實的界線」的段落Oleafly 檢查的是 PDF/UA-1 中能從檔案讀出的部分。發現項目會引用 PDF/UA-1、不同之處的 PDF/UA-2、Matterhorn Protocol 檢查點,以及 WCAG 2.2 的 PDF 技術。
報告涵蓋以下這類機器可讀的訊號:
- 包含真實內容的標記樹;
- 圖與公式上的替代文字;
- 表格中的標題儲存格;
- 標題層級的遞進;
- 文件語言與 XMP 標題;
- 顯示標題的檢視器偏好設定;
- 連結描述與可疑的未標記內容;
- 宣告的 PDF/UA-1 聲明是否有檔案支持。
面板會回報 106 條可由機器檢查的 PDF/UA-1 規則中,有多少條已經驗證。當某條規則無法讀取或不適用時,它也會告訴你。未檢查的規則不會算作通過。
從 LaTeX 準備標記式 PDF
標題為「從 LaTeX 準備標記式 PDF」的段落LaTeX 的標記功能取決於文件類別、套件、引擎和 TeX Live 版本。在提供準備功能之前,預檢會先檢查實際生效的主文件,以及它載入的前言檔案。
- 對目前的 PDF 執行無障礙,並閱讀發現項目。
- 開啟無障礙匯出。
- 查看類別與套件的相容性報告。不相容的類別會阻止準備,部分相容或未知的套件則會顯示為警告。
- 選擇準備無障礙匯出,並檢視每一項建議的原始碼變更。
- 把每個自動產生的替代文字預留位置換成有意義的描述,並在被要求時加上文件標題。
- 使用 TeX Live 2026,或是在 2025 年 11 月之後更新過的 TeX Live 中的 pdfLaTeX 或 LuaLaTeX 編譯。無障礙數學需要 LuaLaTeX。
- 再次執行無障礙檢查,查看閱讀檢視,若需要符合性,就在 Oleafly 之外驗證最終的 PDF。
準備功能可以新增或更新含有語言、PDF/UA-2 目標和標記設定的 \DocumentMetadata;宣告第一列為表格標題列;為缺少替代文字的圖加上可見的預留位置;並在所選引擎需要時加入 unicode-math。套用之前,它會先顯示這些變更。
\DocumentMetadata 這一行會放在版本檢查之內。早於 2025 年 11 月的 LaTeX(例如內建引擎所用的)會略過它,改為建置未加標記的文件而不是失敗,PDF 也不會宣稱符合 PDF/UA。預檢接著會回報這個 LaTeX 版本太舊,因此略過了標記,並指出這次建置所用的 LaTeX。
內建的 Tectonic 引擎無法建立標記樹。編譯標記式輸出並驗證會使用可用的系統 TeX 發行版,或 Oleafly 管理的 TinyTeX,而且一律執行 LuaLaTeX,即使在 Tectonic 專案中也是如此。如果標記式編譯因缺少檔案而停止,例如 TinyTeX 上的 tagpdf-base.sty,它會像一般編譯一樣提議安裝,然後再執行一次標記式編譯。你也可以用自己最新的工具鏈編譯準備好的原始碼。
TinyTeX、套件狀態,以及系統 TeX 的安全界線,請參閱 LaTeX 引擎與套件。
從 Typst 產生 PDF 標準
標題為「從 Typst 產生 PDF 標準」的段落Typst 專案沒有需要準備的原始碼。Typst 會自己寫出封存用與無障礙的 PDF,所以無障礙檢查會顯示 PDF 標準,取代無障礙匯出。
- 執行無障礙,並修正缺少的替代文字和缺少的文件標題。PDF/UA-1 兩者都需要。
- 在 PDF 標準下,選擇一個標準,例如 PDF/UA-1 或 PDF/A-2b。
- 選擇匯出 PDF並儲存檔案。
- 需要符合性時,在 Oleafly 之外驗證匯出的 PDF。
Typst 0.14 以上版本會為每個 PDF 加上標記,因此不需要另外的標記式編譯。較舊的版本能提供的標準較少,Typst 0.11 則完全沒有,面板會說明適用哪一種情況。要使用較新的版本,請在編譯選單中變更 Typst 版本(本專案)。請參閱 Typst 專案。
實用的最終檢查
標題為「實用的最終檢查」的段落- 編譯你打算投稿的那份原始碼。
- 執行所有相關的預檢項目。
- 修正已驗證的發現,並調查建議性的發現。
- 對照最新的會議或期刊指南,完成每一個需手動確認的項目。
- 從第一頁到最後一頁讀完最終的 PDF,包括參考文獻和附錄。
- 從儲存的位置開啟匯出的檔案和原始碼封存檔。
- 在截止日期前,使用投稿目的地自己的驗證工具。
預檢能減少可以避免的意外。論文能否被接受、是否無障礙,以及科學上是否正確,仍然需要作者、出版單位,以及使用這份文件的人來把關。