跳到內容
Oleaflyv0.4.12

原始碼與 PDF 同步

從游標跳到 PDF 中對應的位置,或按住 Cmd/Ctrl 點選 PDF,落在原始碼中的那個字上。LaTeX 透過 SyncTeX,Typst 也支援,並可跨檔案運作。

原始碼與 PDF 同步,把你寫的內容連到排版後的頁面。在 LaTeX 中,它依靠 SyncTeX:Oleafly 每次建置都會啟用 SyncTeX 資料。在 Typst 中,它透過 Typst 語言伺服器運作,所以不需要額外設定,同樣的跳轉就能使用。兩個方向都只要一個動作。

在原始碼與 PDF 之間跳轉「前往 PDF」(Command Shift J)會依據上次編譯的同步資料,找出游標在原始碼中的位置,並讓 PDF 中對應的位置閃現。在 PDF 中按住 Command 點選一個字,則會透過同一份同步資料回到原始碼,並把游標放在原始碼檔案中的那個字上。原始碼檔案你的游標同步資料來自上次編譯PDF 預覽排版後的頁面⌘⇧J 前往 PDF讓該位置閃現⌘-點選一個字游標落在那個字上在原始碼與 PDF 之間跳轉「前往 PDF」(Command Shift J)會依據上次編譯的同步資料,找出游標在原始碼中的位置,並讓 PDF 中對應的位置閃現。在 PDF 中按住 Command 點選一個字,則會透過同一份同步資料回到原始碼,並把游標放在原始碼檔案中的那個字上。原始碼檔案你的游標同步資料來自上次編譯PDF 預覽排版後的頁面⌘⇧J 前往 PDF讓該位置閃現⌘-點選一個字游標落在那個字上
兩種跳轉都使用上次編譯的同步資料,所以如果跳到錯的位置,請重新編譯。
前往 PDF 是編輯器工具列最右邊的箭頭,在尋找與專案資訊旁邊。
前往 PDF 是編輯器工具列最右邊的箭頭,在尋找與專案資訊旁邊。 開啟完整螢幕截圖

把游標放在任何一行,然後按 ⌘⇧J(Ctrl+Shift+J)。PDF 會捲動到對應的位置,並在上面閃現一下藍色醒目標示,讓你的視線準確落在游標原本所在的位置。

你也可以使用編輯器工具列最右邊的箭頭、編輯器的右鍵選單,或 ⌘K 面板。LaTeX 專案稱這個指令為前往 PDF(SyncTeX),Typst 專案則稱為前往 PDF。

它可以跨多檔案專案運作。游標位於 chapters/methods.tex 內時,可以在合併的 PDF 中找到它的排版位置,因為 SyncTeX 會跟隨你的 \input 結構。Typst 對主文件引入的檔案也一樣。

點選 PDF 中的一個字,就會跳到原始碼裡的同一個字。
點選 PDF 中的一個字,就會跳到原始碼裡的同一個字。 開啟完整螢幕截圖

按住 ⌘ 或 Ctrl,PDF 上的指標會變成十字準星。點選一個字,就會跳到它在編輯器中的位置。當文字來自另一個檔案時,例如 LaTeX 中以 \input 引入的子檔案,或引入的 .typ 檔案,Oleafly 會先開啟正確的檔案。

Oleafly 會把游標放在你點選的那個字上,而不是行首。在 LaTeX 中,它會讀取 PDF 的文字層來找到那個字。Typst 則自己回報位置。

有一條優先規則:⌘-點選 PDF 中的超連結時,會執行連結的行為,而不是跳轉。

Typst 同步需要 Typst 0.13 或更新版本。固定使用 Typst 0.11 或 0.12 的專案可以正常編譯,但「前往 PDF」按鈕會隱藏,⌘-點選也不會有任何作用。要找回同步功能,請在編譯選單的 Typst 版本(本專案) 下固定較新的版本。如果文件的版面很重要,請先試用較新版本。

同步資料來自上一次編譯,所以可能過期:

  • 自上次建置以來你編輯過。 Oleafly 仍會精確對應未變更的行,並把編輯過的行對應到最近一行未變更的行,所以大多數跳轉仍然有效。如果跳轉落在錯誤的位置,請重新編譯(⌘↵)後再跳一次。
  • 該行不產生可見的輸出(註解、前言行、#set 規則、空白行)。請把游標放在有排版文字的行上。
  • 分離的預覽視窗會鏡像 PDF,但不接受 ⌘-點選。請從主視窗跳轉。
  • Markdown 專案沒有原始碼與 PDF 同步。
  • 圖片和圖表專案不使用它,因為單頁的圖不需要。
圖片預覽

無法載入 AI 回答

請再試一次,或搜尋文件。