# 預檢

在文件交出去之前，檢查原始碼、建置記錄檔、PDF、參考文獻、無障礙訊號與投稿風險。

編譯成功只能證明 PDF 已經產生。它不能證明每筆引用都已解析、閱讀順序合理、投稿封存檔乾淨，或檔案真的具備它所宣稱的無障礙結構。

預檢把這些問題集中到一次本機審查中。開啟側邊列中的**盾牌**，選擇適合這份文件的檢查，修正問題時可以只執行單一檢查，投稿前則執行全部檢查。

![Oleafly 的預檢面板。選擇你需要的檢查，從各列執行單一檢查，或用底部按鈕執行所有已啟用的檢查。](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![論文送出之前，用預檢執行建置、投稿與無障礙檢查。](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## 六項獨立檢查

### 編譯與版面

讀取最新的建置記錄檔和 PDF，找出建置失敗、未解析的引用與參照、需要重跑的警告、缺少的字符、溢出的方框、被裁切的文字、重複的 PDF 目的地，以及混用的頁面大小。

### 投稿就緒度

將選定的出版設定檔套用到專案。它會檢查較穩定的要求，包括文件類別、摘要與關鍵字、圖片格式、嵌入字型、PDF 限制、圖說、可攜的檔名，以及原始碼封裝中多餘的檔案。

### ATS 就緒度

以和應徵者追蹤系統類似的方式擷取履歷內容。它會回報聯絡資訊欄位、預期的章節，以及可能打亂閱讀順序的版面。

### 無障礙

檢查原始碼和 PDF 中與下列項目相關的訊號：標記、替代文字、語言與標題中繼資料、檢視器設定、標題、表格、連結、閱讀順序、可選取的文字、必要時的書籤，以及非常小的文字。

### 參考文獻與資源檔

找出缺少的檔案、未解析的引用與交互參照、重複的標籤與 DOI、不完整的參考文獻條目，並在專案完整可用時找出未被引用的參考文獻。

### 隱私與匿名審查

找出可能破壞匿名審查的憑證、私密金鑰、敏感檔案、草稿筆記、內部註解、誌謝、作者欄位和身分中繼資料。

## 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 與無障礙：誠實的界線

Oleafly 檢查的是 PDF/UA-1 中能從檔案讀出的部分。發現項目會引用 PDF/UA-1、不同之處的 PDF/UA-2、Matterhorn Protocol 檢查點，以及 WCAG 2.2 的 PDF 技術。

報告涵蓋以下這類機器可讀的訊號：

- 包含真實內容的標記樹；
- 圖與公式上的替代文字；
- 表格中的標題儲存格；
- 標題層級的遞進；
- 文件語言與 XMP 標題；
- 顯示標題的檢視器偏好設定；
- 連結描述與可疑的未標記內容；
- 宣告的 PDF/UA-1 聲明是否有檔案支持。

面板會回報 106 條可由機器檢查的 PDF/UA-1 規則中，有多少條已經驗證。當某條規則無法讀取或不適用時，它也會告訴你。未檢查的規則不會算作通過。

:::caution[預檢不能認證 PDF/UA]
這是子集檢查，不是符合性聲明。Oleafly 無法判斷替代文字是否有意義、閱讀順序對人來說是否合理、色彩對比是否足夠，或文件搭配讀者的輔助科技是否好用。需要正式的符合性結果時，請用 veraPDF 或 PAC 2024 驗證最終檔案，並進行人工審查。
:::

## 從 LaTeX 準備標記式 PDF

LaTeX 的標記功能取決於文件類別、套件、引擎和 TeX Live 版本。在提供準備功能之前，預檢會先檢查實際生效的主文件，以及它載入的前言檔案。

1. 對目前的 PDF 執行**無障礙**，並閱讀發現項目。
2. 開啟**無障礙匯出**。
3. 查看類別與套件的相容性報告。不相容的類別會阻止準備，部分相容或未知的套件則會顯示為警告。
4. 選擇**準備無障礙匯出**，並檢視每一項建議的原始碼變更。
5. 把每個自動產生的替代文字預留位置換成有意義的描述，並在被要求時加上文件標題。
6. 使用 TeX Live 2026，或是在 2025 年 11 月之後更新過的 TeX Live 中的 pdfLaTeX 或 LuaLaTeX 編譯。無障礙數學需要 LuaLaTeX。
7. 再次執行無障礙檢查，查看閱讀檢視，若需要符合性，就在 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`，它會像一般編譯一樣提議安裝，然後再執行一次標記式編譯。你也可以用自己最新的工具鏈編譯準備好的原始碼。

:::note[相容性可能是阻礙]
預檢使用 LaTeX Project 公布的標記狀態資料。不支援的類別會被阻止，部分支援的類別會標示警示，資料中沒有的套件則視為未知，而不是假設安全。`enumitem` 目前被阻止，因為它無法在標記式工作流程中載入。
:::

TinyTeX、套件狀態，以及系統 TeX 的安全界線，請參閱 [LaTeX 引擎與套件](/docs/latex-engines/)。

## 從 Typst 產生 PDF 標準

Typst 專案沒有需要準備的原始碼。Typst 會自己寫出封存用與無障礙的 PDF，所以**無障礙**檢查會顯示 **PDF 標準**，取代**無障礙匯出**。

1. 執行**無障礙**，並修正缺少的替代文字和缺少的文件標題。PDF/UA-1 兩者都需要。
2. 在 **PDF 標準**下，選擇一個**標準**，例如 PDF/UA-1 或 PDF/A-2b。
3. 選擇**匯出 PDF**並儲存檔案。
4. 需要符合性時，在 Oleafly 之外驗證匯出的 PDF。

Typst 0.14 以上版本會為每個 PDF 加上標記，因此不需要另外的標記式編譯。較舊的版本能提供的標準較少，Typst 0.11 則完全沒有，面板會說明適用哪一種情況。要使用較新的版本，請在編譯選單中變更 **Typst 版本（本專案）**。請參閱 [Typst 專案](/docs/typst/#what-each-version-can-do)。

## 實用的最終檢查

1. 編譯你打算投稿的那份原始碼。
2. 執行所有相關的預檢項目。
3. 修正已驗證的發現，並調查建議性的發現。
4. 對照最新的會議或期刊指南，完成每一個需手動確認的項目。
5. 從第一頁到最後一頁讀完最終的 PDF，包括參考文獻和附錄。
6. 從儲存的位置開啟匯出的檔案和原始碼封存檔。
7. 在截止日期前，使用投稿目的地自己的驗證工具。

預檢能減少可以避免的意外。論文能否被接受、是否無障礙，以及科學上是否正確，仍然需要作者、出版單位，以及使用這份文件的人來把關。
