下載與安裝
在 macOS、Windows 或 Linux 上安裝 Oleafly,並了解應用程式第一次使用時可能會下載什麼。
安裝 Oleafly 只需要下載並按兩下。不需要帳號、不需要登入,也不需要另外安裝 LaTeX 發行版:編譯器就內建在應用程式裡。
下載應用程式
標題為「下載應用程式」的段落從 發行版本頁面 (在新分頁開啟) 取得最新的安裝程式,或使用 oleafly.com 上的下載按鈕,它會盡可能為你的平台挑選安裝程式。
| 平台 | 下載 | 怎麼做 |
|---|---|---|
| macOS(Apple Silicon) | _aarch64.dmg | M1 或更新的晶片。開啟 dmg,把 Oleafly 拖曳到「應用程式」。 |
| macOS(Intel) | _x64.dmg | Intel Mac。開啟 dmg,把 Oleafly 拖曳到「應用程式」。 |
| Windows(x86_64) | .msi 或 -setup.exe | 執行任一種安裝程式,並依照提示操作。 |
| Linux(x86_64) | .AppImage、.deb 或 .rpm | 大多數發行版使用 AppImage,以 Debian 為基礎的系統使用 Debian 套件,Fedora 則使用 RPM。 |
| Linux(ARM64) | .AppImage、.deb 或 .rpm | 適用於 ARM64 Linux 系統的原生套件。 |
在 Linux 上,Oleafly 需要 glibc 2.35 或更新版本(2022 年代以後的系統:Ubuntu 22.04 以上、Fedora 36 以上、Debian 12 以上)。
不確定自己的 Mac 是哪一種?開啟蘋果選單,選擇 關於這台Mac。如果看到 晶片 這一行,就是 Apple Silicon;如果 處理器 這一行寫的是 Intel,就是 Intel Mac。
目前提供的目標平台是 macOS Apple Silicon、macOS Intel、Windows x64、Linux x64 和 Linux ARM64。Windows on ARM 還沒有原生套件。
第一次啟動
標題為「第一次啟動」的段落macOS
標題為「macOS」的段落開啟磁碟映像檔,把 Oleafly 拖曳到「應用程式」,然後啟動它。請使用官方的安裝程式。如果 macOS 阻擋它,請到 系統設定 → 隱私權與安全性 查看第一次啟動的訊息。
Windows
標題為「Windows」的段落執行 MSI 或 setup 執行檔,並依照安裝程式的指示操作。如果 Windows 顯示信譽警告,請在繼續之前確認下載來自官方發行版本。安裝程式會把 Typst 和 LaTeX 語言伺服器所需的 Microsoft Visual C++ 執行階段檔案放在應用程式旁邊,所以你不必另外安裝它。
Linux
標題為「Linux」的段落用你的套件管理員安裝 Debian 或 RPM 套件,或讓 AppImage 變成可執行後開啟它:
chmod +x Oleafly_*.AppImage./Oleafly_*.AppImageOleafly 需要 glibc 2.35 或更新版本。請選擇符合你電腦架構的套件。
.deb 和 .rpm 套件把 Oleafly 自己的 Tectonic、Pandoc 和 Typst 放在 /usr/libexec/oleafly,所以它們能與你發行版的 Pandoc 並存安裝。啟動 AppImage 時,它會把自己加入你的應用程式選單,GNOME 這類 Wayland 桌面環境需要這一步,才會在 Dock 中顯示它的圖示。如果已安裝的套件或其他工具已經加入了 Oleafly,它就不會動選單;而如果你刪除了該項目,它也會維持刪除的狀態。
Debian 套件附有描述,因此 Ubuntu 的 App Center 在你安裝之前就會顯示 Oleafly 是什麼。它也帶有 AppStream 資料,所以 Oleafly 安裝後,軟體中心會顯示圖示、授權、螢幕截圖和版本。應用程式會出現在應用程式選單的 Office 類別下。在 Linux 上和在 Windows 上一樣,Oleafly 會自己繪製標題列。它的工具列位於頂端,有最小化、最大化和關閉按鈕。拖曳工具列可以移動視窗,按兩下可以最大化,拖曳任何邊緣或角落可以調整大小。
第一次編譯會下載 TeX 套件
標題為「第一次編譯會下載 TeX 套件」的段落第一次在內建的 Tectonic 引擎上編譯文件時,它會下載該文件需要的套件並快取起來。這台電腦的第一次編譯也會一次取得一批常用的套件,所以之後的文件會啟動得更快。這需要網路連線,網路慢時可能要花幾分鐘。編譯的時間限制會在套件還在下載時等待,而如果 Oleafly 的套件鏡像站失敗,編譯會改用上游來源。之後同一份文件的編譯會很快,而且可以離線運作。如果文件需要你尚未快取的套件,則會再觸發一次性的取得。請參閱 編譯,其中包括嚴格的離線模式。
選用:TeX 發行版
標題為「選用:TeX 發行版」的段落Tectonic 涵蓋大多數文件。當專案需要 pdfLaTeX、upLaTeX,或完整 TeX 發行版中的其他編譯器時,Oleafly 會使用你電腦上已有的 MacTeX、TeX Live、MiKTeX 或 TinyTeX。如果沒有,它可以從 設定 → 引擎 → LaTeX,或直接從編譯錯誤,幫你安裝 TinyTeX。TinyTeX 不需要管理員權限,下載約 250 MB,而 Oleafly 會要求約 2 GB 的可用磁碟空間。
- 在 Linux 上,TinyTeX 使用系統的 Perl。如果缺少,請先安裝:
sudo apt install perl、sudo dnf install perl或sudo pacman -S perl。 - 在 Windows 上,MiKTeX 需要 Perl 才能執行
latexmk。請安裝 Strawberry Perl,或安裝自帶 Perl 的 TinyTeX。 - 在 Debian、Ubuntu 和 Fedora 上,你用
apt或dnf安裝的 TeX Live,它的 LaTeX 套件也來自apt或dnf。Oleafly 會告訴你要安裝什麼,但不會更動它。
請參閱 LaTeX 引擎與套件。
你的檔案維持為磁碟上的一般資料夾。權杖和 AI 金鑰存放在加密且僅限擁有者存取的本機檔案中。線上功能包括託管的 AI、GitHub 同步、套件下載、引用查詢和更新檢查。請參閱 理念。
保持最新
標題為「保持最新」的段落Oleafly 會檢查已簽署的發行摘要來源(feed)、顯示版本資訊,並在你確認後就地安裝。在 Linux 上,自動替換適用於 AppImage 的安裝。你也可以從 設定 → 說明與關於 檢查。請參閱 更新。
從原始碼建置
標題為「從原始碼建置」的段落先決條件、引擎下載和本機建置,請參考 桌面版開發指南 (在新分頁開啟)。
下一步
標題為「下一步」的段落- 快速入門:幾分鐘內從第一個專案到第一份 PDF。
- 範本:內建的起始範本和可下載的套件包。
- Oleafly Learn:網路上免費的 LaTeX 與研究寫作課程。
- 命令列工具:從終端機建置、檢查與同步專案,並連接程式設計代理程式。