# PDF 預覽與每一個控制項

閱讀、搜尋、瀏覽、檢查並儲存編譯後的文件。

編譯文件後，選擇 **PDF 檢視**或 **版面配置 → 僅預覽**，就能專心閱讀。想讓原始碼和頁面並排時，請使用分割檢視。預覽顯示的是編譯後的結果，不能直接編輯稿件文字。

![LLaMA 的純 PDF 檢視，論文上方有縮放、頁面導覽、搜尋與匯出控制項](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-pdf-preview-dark-window-v2.png)

## 記錄檔

選擇**記錄檔**即可查看編譯輸出。再選一次，就會切換回 PDF。找出第一個可處理的錯誤，前往對應的原始檔修正，然後重新編譯。請參閱[閱讀記錄檔](/docs/compiling/#reading-the-logs)。

要從空白的記錄檔開始，請選擇**複製記錄檔**旁邊的**清除**。記錄檔和其中的錯誤會保持隱藏，直到下一次編譯寫出新的記錄檔。你的建置檔案會留在原處，而編譯執行期間這個按鈕無法使用。

編譯無法執行時，預覽會在可行的情況下提供修正方式。`latexmk` 建置缺少 TeX 檔案時，會顯示**尋找並安裝**。Tectonic 建置需要 Tectonic 做不到的功能時，會顯示**選擇引擎**，點選後會開啟[引擎對話框](/docs/latex-engines/#when-tectonic-isnt-enough)。Typst 專案固定使用了這台電腦沒有的版本時，會顯示帶有該版本號的**下載 Typst**，以及改用預設版本的**使用 Typst**。請參閱[固定版本不存在時](/docs/typst/#when-a-pinned-version-is-missing)。

在沒有可用 TeX 發行版的電腦上，以系統 TeX 編譯的 LaTeX 專案（自動、pdfLaTeX、XeLaTeX、LuaLaTeX、upLaTeX 或 pLaTeX）會顯示**下載並使用 TinyTeX** 和**使用 Tectonic**。在共用專案中，第二個按鈕會顯示為**讓所有人使用 Tectonic**，因為它會變更每位共同作者的編譯器，而 TinyTeX 只會變更你的電腦。如果你無法變更共用專案的設定，就只會出現**下載並使用 TinyTeX**，訊息會請你安裝 TinyTeX，以便在你的電腦上編譯該專案。當某個套件需要 XeLaTeX 或 LuaLaTeX，而自動選了另一個編譯器時，預覽會提供**使用 XeLaTeX** 或**使用 LuaLaTeX**。當缺少 upLaTeX 或 pLaTeX 時，如果 Oleafly 可以把它加入你的 TeX 發行版，就會提供**安裝日文支援（約 450 MB）**。

## 建置時間

記錄檔旁邊的時間，是已完成編譯所花的時間。可用它來比較同一個專案的多次建置，不要把它當成應用程式各個部分的效能量測。

## 文件大綱

選擇**文件大綱**即可開啟 PDF 的導覽樹。展開項目，再選取標題就能跳到該位置。大綱來自 PDF 本身，沒有 PDF 書籤的文件，即使原始碼裡有標題，也可能沒有任何項目。用**關閉文件大綱**可關閉此面板。

## 搜尋 PDF

![搜尋 PDF 會在右上角開啟搜尋欄位。符合的內容會在 LLaMA 中醒目標示，計數旁有上一個與下一個結果的控制項。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-pdf-search-dark-window-v2.png)

選擇**搜尋 PDF**，在**搜尋 PDF 文字**中輸入字詞，再查看醒目標示的結果。用**上一個搜尋結果**和**下一個搜尋結果**在符合項目之間移動。選擇**關閉 PDF 搜尋**即可回到閱讀。

試著在 [LaTeX 練習文件](/docs/writing/latex/)中搜尋 `estimate`。搜尋使用的是 PDF 的文字層，純由圖片構成的掃描頁沒有可搜尋的文字。

## 全螢幕預覽

選擇**全螢幕預覽**，即可在沒有周圍編輯器窗格的情況下閱讀。選擇**結束全螢幕**或按 Esc 可返回。這適合用來檢查簡報，或把頁面放大來看。

## 放映

選擇**放映**（簡報圖示），可把編譯後的 PDF 當作投影片放映，例如 Beamer、Touying 或 Polylux 簡報。你可以選擇**從頭放映**、**從這一頁放映**，或**以簡報者檢視放映**，後者會在你的螢幕上加上下一張投影片、計時器和講者備忘稿。[放映投影片](/docs/present-slides/)說明了按鍵、單螢幕與雙螢幕的視窗配置，以及講者備忘稿。

## 在瀏覽器中開啟

當 Quarto 文件建置出網頁時，預覽會顯示該網頁而不是 PDF。選擇**在瀏覽器中開啟**（地球圖示），即可在你自己的瀏覽器中開啟它。請參閱 [Quarto](/docs/engines/#quarto)。

## 隱藏工具列

在全螢幕模式下，選擇**隱藏工具列**可讓頁面有更多空間。用浮動的**顯示工具列**控制項可把工具列叫回來。

## 縮小

選擇**縮小**，預覽比例會縮小一級。這只會改變頁面在螢幕上看起來的大小，不會改變 PDF 的紙張尺寸。

## 放大

選擇**放大**可放大預覽，用來檢查公式、圖表標籤和表格中的小字。支援的比例範圍是 40% 到 400%。

## 縮放比例

![預覽工具列：大綱、搜尋、全螢幕、縮放控制項、頁碼、頁面配置、閱讀控制項與匯出。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-pdf-preview-dark-window-v2.png#view=1230,44,689,49)

開啟百分比選單，可選擇固定的縮放預設值。選單中也有「符合寬度」、「符合高度」和「重設為 100%」。要在不同修訂版本之間比較同一頁時，請選擇固定值。

## 符合寬度

選擇**符合寬度**，讓頁面配合可用的預覽寬度。在分割版面中閱讀段落文字時很適合使用。大幅調整窗格大小後，請再套用一次。

## 符合高度

選擇**符合高度**可看到頁面的完整高度。用它來檢查邊界、頁尾位置和頁面的版面平衡。

## 重設為 100%

從縮放選單選擇**重設為 100%**，可回到標準比例。這會重設檢視器的比例，不會改變原始碼的字型大小。

## 觸控板與滑鼠縮放

在觸控板上雙指開合，或按住 Ctrl 並滾動滑鼠滾輪，即可縮放。一般滾動則是在文件中移動。⌘=、⌘- 和 ⌘0（Windows 與 Linux 上為 Ctrl）會[縮放整個應用程式](/docs/settings/appearance/#zoom)，包含 PDF，即使焦點在 PDF 上也一樣。只想縮放 PDF 時，請使用工具列、雙指開合，或 Ctrl 加滾輪。

放大後的頁面依然清晰。你正在看的那一部分會以完整解析度重新繪製，把視窗移到像素密度不同的螢幕時，預覽也會重新繪製。

## 上一頁

選擇**上一頁**可往前翻。在雙頁版面中，導覽會以一個跨頁為單位前進。已在開頭時，這個按鈕無法使用。

## 頁碼

點選頁碼欄位，輸入頁碼後按 Enter。計數器也會隨著你的捲動位置更新。可用它回到審閱意見中提到的那一頁。

## 下一頁

選擇**下一頁**可往後翻。到達文件結尾時，這個按鈕會變成無法使用。

## 單頁檢視

對於多頁的 PDF，選擇**單頁檢視**可讀取單欄的頁面。你可以連續捲動整份文件。只有一頁的文件不需要切換版面，所以這個控制項會隱藏。

## 雙頁檢視

選擇**雙頁檢視**可並排顯示對頁。檢查論文、書籍或報告跨頁的版面平衡時很有用。想要較窄的閱讀欄位時，請回到單頁檢視。

## 反轉 PDF 預覽顏色

選擇**反轉 PDF 預覽顏色**可切換成深色的閱讀檢視。再選一次同一個控制項即可還原顏色。匯出的 PDF 仍保有原本的顏色，這只是顯示設定。

## 閱讀檢視

選擇**閱讀檢視**，即可以無障礙的閱讀方式呈現 PDF 的文字。想依文件的閱讀順序閱讀，而不只是依賴點陣化的頁面時，可以使用它。結束閱讀檢視即可回到一般的頁面顯示。閱讀順序的品質取決於 PDF 提供的結構。

## 順時針旋轉

選擇**順時針旋轉**，顯示畫面會旋轉 90 度。重複操作即可回到原本的方向。用它來檢視橫向頁面或旋轉過的圖表。檢視器的旋轉不會改寫文件的原始碼。

## 下載 PDF

選擇**下載 PDF**可儲存目前顯示的 PDF。分享之前，請先確認是否出現預覽已過期的提示：顯示的結果可能來自上一次成功的建置。圖片專案則提供**下載圖片**。

## 將 PDF 儲存到專案

選擇儲存圖示（**將 PDF 儲存到專案**）即可開啟它的選單。第一個項目的名稱相同。它會詢問檔名，並把編譯後 PDF 的副本儲存到專案樹中，放在你的其他檔案旁邊。檔名預設為專案標題，這和**下載 PDF** 相同。圖片專案則改為提供**將圖片儲存到專案**，它不經過選單，直接儲存成 PNG。只需要專案外的副本時，請使用**下載 PDF**。

工具列較窄時，這兩個項目都會收進**更多預覽控制項**。

## 編譯時同步 PDF

開啟**編譯時同步 PDF**（位於同一個選單中**將 PDF 儲存到專案**的下方），就能讓專案資料夾中的 PDF 保持最新。每次成功編譯後，Oleafly 都會更新一個以專案標題命名的 PDF，不論主檔案叫什麼名稱。標題會以**下載 PDF** 為檔案命名的方式變成檔名，所以 `Thesis: Final Draft` 會變成 `Thesis_Final_Draft.pdf`。這個開關會隨專案一起儲存。

- 這個 PDF 是一般的專案檔案，所以[雲端同步](/docs/cloud-sync/)和[檢查點](/docs/checkpoints/)都會納入它。
- 如果你重新命名專案，下一次編譯會以新標題建立新檔案。舊檔案維持原樣。
- Oleafly 絕不會覆寫不是它建立的檔案。如果已經有同名的檔案，它會改用下一個可用的名稱，例如 `Thesis_2.pdf`。
- 快速編譯不會更新 PDF。**編譯模式**設為**快速**時，選單會這樣告訴你。
- 在即時共用的[協作](/docs/collaboration/)專案中，PDF 不會共用。它只留在你的電腦上，選單也會這樣說明。
- 如果其他應用程式鎖住了該檔案，編譯仍會成功。選單會顯示一則說明，下一次編譯會再試一次。

## 在新視窗開啟預覽

選擇**在新視窗開啟預覽**，可把閱讀器分離成獨立的作業系統視窗。在主視窗寫作時，可把它移到第二個螢幕。它會跟著更新後的建置與專案變更。

## PDF 預覽設定

![設定 → 外觀 → PDF 預覽。在這裡設定 PDF 顏色與停留預覽的預設值。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-pdf-dark-window-v2.png#view=519,89,883,436)

選擇 **PDF 預覽設定**可開啟**設定 → 外觀 → PDF 預覽**。在那裡設定深色閱讀的預設行為，以及專案庫的停留預覽。

## 更多預覽控制項

預覽窗格較窄時，部分控制項會收進**更多預覽控制項**。覺得某個功能不存在之前，請先開啟這個選單。把窗格拉寬，更多控制項就會回到工具列。

## 選取與複製文字

在 PDF 中拖曳選取文字，然後複製。⌘A（Ctrl+A）會選取整份 PDF 的文字。PDF 內的連結仍然可以點選。能否選取文字取決於 PDF 的文字層。預覽不會把純圖片的掃描檔變成可編輯的文字。

## 跳到原始碼

按住 ⌘ 或 Ctrl，並點選 PDF 中的字詞，就會開啟對應的原始碼。在原始碼編輯器中，**前往 PDF** 則是反方向的導覽。這適用於 LaTeX 專案，以及使用 Typst 0.13 或更新版本的 Typst 專案。快捷鍵與限制請參閱[原始碼與 PDF 同步](/docs/synctex/)。

## 過期的預覽

編輯後或建置失敗後，檢視器可能會保留最後一份可讀的 PDF。出現預覽已過期的提示，表示那一頁不是目前的原始碼。要把它當作最終輸出之前，請先成功重新編譯。

重新編譯時，PDF 會停在你原本的位置，分離的預覽視窗也一樣。隱藏預覽再重新顯示時，例如使用 ⌘⌥P（Ctrl+Alt+P），預覽會立刻回到同一個位置。

開啟**自動編譯**時，Typst 專案會在你停止輸入一會兒後更新預覽，並保留捲動位置。請參閱[以自動編譯即時預覽](/docs/typst/#live-preview-with-auto-compile)。

## 完整走一遍閱讀流程

1. 編譯練習文件。
2. 選擇僅預覽與符合高度。
3. 搜尋一個片語，並前往它的結果。
4. 開啟大綱，跳到某個章節。
5. 放大檢查其中的公式或表格。
6. 回到分割檢視以修改原始碼。
7. 重新編譯，確認過期提示已消失，然後下載 PDF。
