ダウンロードとインストール
macOS、Windows、Linux に Oleafly をインストールし、初回の利用時にアプリが何をダウンロードするかを確認します。
Oleafly のインストールは、ダウンロードしてダブルクリックするだけです。アカウントもサインインも、別途 LaTeX ディストリビューションも要りません。コンパイラはアプリに同梱されています。
アプリをダウンロードする
「アプリをダウンロードする」セクション最新のインストーラーはリリースページ (新しいタブで開きます)から入手できます。oleafly.com のダウンロードボタンを使う方法もあります。可能な場合は、お使いのプラットフォームに合うインストーラーが自動で選ばれます。
| プラットフォーム | ダウンロード | 手順 |
|---|---|---|
| macOS (Apple Silicon) | _aarch64.dmg | M1 以降。dmg を開き、Oleafly を Applications にドラッグします。 |
| macOS (Intel) | _x64.dmg | Intel Mac 向け。dmg を開き、Oleafly を Applications にドラッグします。 |
| 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 では glibc 2.35 以降が必要です(2022 年以降の世代: Ubuntu 22.04 以降、Fedora 36 以降、Debian 12 以降)。
お使いの Mac の種類が分からない場合は、Apple メニューからこのMacについてを開いてください。チップの行があれば Apple Silicon、プロセッサの行に Intel と表示されていれば Intel Mac です。
現在の配布対象は macOS Apple Silicon / macOS Intel / Windows x64 / Linux x64 / Linux ARM64 の 5 つです。ARM 版 Windows 向けのネイティブパッケージはまだありません。
初回起動
「初回起動」セクションmacOS
「macOS」セクションディスクイメージを開き、Oleafly を Applications にドラッグして起動します。公式のインストーラーを使ってください。macOS にブロックされた場合は システム設定 → プライバシーとセキュリティ に表示される初回起動のメッセージを確認します。
Windows
「Windows」セクションMSI またはセットアップ用の実行ファイルを実行し、インストーラーの案内に従います。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 デスクトップでは、これがないとドックにアイコンが表示されません。インストール済みのパッケージや別のツールがすでに 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 で
latexmkを実行するには Perl が必要です。Strawberry Perl をインストールするか、独自の Perl が付いてくる TinyTeX をインストールします。 - Debian、Ubuntu、Fedora で
aptかdnfを使ってインストールした TeX Live では、LaTeX のパッケージもaptかdnfから入れます。Oleafly はインストールするものを案内しますが、変更はしません。
LaTeX のエンジンとパッケージを参照してください。
ファイルはディスク上のふつうのフォルダのままです。トークンと AI のキーは、暗号化された、所有者だけがアクセスできるローカルファイルに保存されます。オンライン機能には、ホスト型 AI、GitHub 同期、パッケージのダウンロード、引用の検索、アップデートの確認があります。詳しくは Oleafly を作る理由を参照してください。
最新の状態を保つ
「最新の状態を保つ」セクションOleafly は署名付きのリリースフィードを確認し、リリースノートを表示して、確認すればその場でインストールします。Linux で自動的に置き換えられるのは AppImage でインストールした場合です。 設定 → ヘルプと情報 から確認することもできます。詳しくはアップデートを参照してください。
ソースからビルドする
「ソースからビルドする」セクション前提条件、エンジンのダウンロード、ローカルビルドについては、デスクトップ開発ガイド (新しいタブで開きます)に従ってください。
次のステップ
「次のステップ」セクション- クイックスタート: 最初のプロジェクトから最初の PDF まで、数分で進みます。
- テンプレート: 同梱のひな形とダウンロードできるパック。
- Oleafly Learn: ウェブで学べる、無料の LaTeX と研究ライティングのカリキュラム。
- コマンドラインツール: ターミナルからプロジェクトをビルド、チェック、同期し、コーディングエージェントを接続します。