# 文件分析

列出 LaTeX、Typst 或 Markdown 文件的標題、圖片、表格、方程式、標籤、引用和待辦事項，並複製其投稿中繼資料。

投稿之前，先看看文件裡實際有什麼會很有幫助。每張圖片都有說明嗎？每個被引用的鍵都在參考文獻中嗎？**文件分析** 把這一切列在同一個對話方塊中，每個項目都連回它在原始碼中的那一行。

請用編輯器工具列最右端的 **文件分析** 按鈕開啟它，或從 ⌘K 面板執行 **文件分析**。它適用於 LaTeX、Typst 和 Markdown 專案，並從主檔案開始讀取文件，所以用 `\input` 帶入的 LaTeX 章節，或用 `#include` 帶入的 Typst 檔案也會被計算在內。

## 每個分頁列出什麼

**總覽** 會顯示下面每個清單的數量。按一下數量可以開啟該分頁。

- **標題**，依層級縮排。
- **圖片** 和 **表格**，各附有說明（或 **無圖說**）、標籤，以及沒有編號時的 **未編號**。
- **方程式**：只列出行間公式，不含行內數學式。
- **標籤**：每個標籤，以及它標記的對象：標題、圖片、表格、方程式或其他。
- **引用**：每個被引用的鍵，以及它被引用的次數。不在參考文獻中的鍵會標示為 **不在參考文獻中**，總覽會顯示有多少個。
- **待辦事項**：原始碼中的 `TODO`、`FIXME` 和 `XXX` 註記。在 LaTeX 中，`\todo`、`\missingfigure` 以及 fixme 套件的註記也會計入。

按一下某一列，就會關閉對話方塊並跳到那一行。灰色的列無法追溯到原始碼。

## 編號與頁碼

編號從何而來，取決於引擎：

- **LaTeX**：圖片、表格、方程式和標題的編號及其頁碼，來自上一次編譯，適用於有標籤的項目。頁尾會告訴你它們是否為最新。如果你在那之後編輯過，請再編譯一次來更新。
- **Typst**：對話方塊開啟時會請 Typst 讀取文件，使用專案的 Typst 版本和所選的建置變體，所以編號和頁碼與目前的原始碼相符。如果 Typst 無法編譯文件，總覽會改為列出錯誤，每個錯誤都連到它所在的行。只會列出前 5,000 個元素。頁尾會指出所用的 Typst 版本。
- **Markdown**：項目依原始碼順序列出，沒有編號或頁碼。

**重新整理** 會重新讀取文件，而不關閉對話方塊。

## 投稿中繼資料

總覽也會顯示 Oleafly 找到的 **標題**、**作者**、**關鍵字**、**日期** 和 **摘要**。任何缺少的項目會顯示 **未設定**。

- 在 LaTeX 中，它們來自 `\title`、`\author`、`\date`、`abstract` 環境，以及 `\keywords` 命令或 `keywords` 或 `IEEEkeywords` 環境。
- 在 Typst 中，它們來自文件所套用範本的引數，或 `#set document(...)`。摘要也可以來自名為「Abstract」的標題。
- 在 Markdown 中，它們來自 front matter：`title`、`author` 或 `authors`、`date`、`keywords` 和 `abstract`。

**複製投稿中繼資料** 會把標題、作者、關鍵字和摘要以帶標籤的行放到剪貼簿上，可以直接貼到投稿表單中。如果這些項目都沒有設定，這個按鈕就會停用。

## 相關頁面

- [預檢](/docs/preflight/)：投稿前對原始碼、記錄檔和 PDF 進行更深入的檢查
- [引用與參考文獻](/docs/citations/)：加入文件分析回報為缺少的鍵
- [文件設定](/docs/document-settings/)：編輯器工具列上的另一個文件工具
