# クイックスタート

プロジェクトを作り、数行書いて、最初の PDF を書き出します。

実際に必要な文書から始めましょう。論文、授業のレポート、履歴書などです。AI を設定しなくても、書いてコンパイルできます。

![執筆ワークスペースに表示された完成済みの論文。プロジェクトのファイル、編集できる LaTeX、PDF プレビューが並んでいます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## Oleafly をインストールする

[アプリをダウンロード](https://github.com/Oleafly/Oleafly/releases/latest)して開きます。[インストールガイド](/docs/install/)で各プラットフォームの手順を説明しています。アカウントは不要です。

## 始め方を選ぶ

1. ライブラリで **新規プロジェクト** をクリックします。
2. テンプレートと文書の形式を選びます。LaTeX は既存の論文誌向けクラスに向いています。Typst は簡潔な組版言語を備えています。Markdown は軽いマークアップで文章を書くのに向いています。
3. プロジェクトに名前を付け、お好みでカバーの色を選んで作成します。選ばなければ、Oleafly が色を選びます。

すでにソースファイルがある場合は、代わりに[プロジェクトを読み込みます](/docs/import-project/)。研究ノートやデータを伴う論文には、[研究のひな形](/docs/research-workspace/)を使います。

## 書いてコンパイルする

左側でソースを編集します。macOS では **⌘Enter** を、Windows と Linux では Ctrl+Enter を押します。コンパイルした PDF がその隣に開きます。

組み込みの Tectonic エンジンでは、最初の LaTeX ビルドで文書に必要なパッケージをダウンロードします。以降のビルドはそのキャッシュを再利用します。代わりに自分の TeX インストールで新しいプロジェクトをコンパイルするには、[新規プロジェクトの既定を設定する](/docs/engines/#set-a-default-for-new-projects)を参照してください。ビルドに失敗したら、診断を開くとソースの該当行に移動できます。[コンパイル](/docs/compiling/)で、ビルドの操作とログを説明しています。

LaTeX では `\` を入力するとコマンドの候補が、`/` を入力すると挿入メニューが表示されます。Typst では `/` でスニペットが開きます。節、数式、引用を挿入してみましょう。LaTeX、Typst、Markdown のいずれにも、文章を編集するための **コード / ビジュアル** の切り替えがあります。エディタのツールバーの **図を描く** を押すと、文書の言語で[ダイアグラムコンポーザー](/docs/figures-diagrams/)が開きます。

## 参考文献を追加する

ツールバーで **引用を追加** を開きます。DOI、arXiv の識別子、またはタイトルで検索し、レコードを確認してから挿入します。Oleafly が参考文献の項目を追加し、文書の形式に合った引用の構文を使います。

[引用ガイドを読む →](/docs/citations/)

## 確認して書き出す

共有する前に **プリフライト** を開いて文書を点検します。仕上がった文書には **PDF として書き出す** を、プロジェクトのファイルを送るには **ソースを書き出す（.zip）** を使います。

自動チェックポイントが有効なら、コンパイルに成功するたびに[チェックポイント](/docs/checkpoints/)も保存されます。あとから **バージョン管理** で、そのチェックポイントに戻れます。

## アシスタントを試す

[プロバイダまたは CLI エージェントを接続](/docs/ai-setup/)してから、具体的に頼んでみましょう。

> アブストラクトを 200 語に縮めてください。数値の結果と引用キーは変えないでください。編集内容を見せてください。

作業中の編集を確認したいときは **承認を求める** を使います。より大きな作業を別のコピーで行うには、[調査タスク](/docs/research-tasks/)を作成します。
