# 既存の作業を Oleafly に取り込む

プロジェクトのアーカイブを読み込む、文書を変換する、arXiv のソース一式を取り込む、GitHub リポジトリをコピーする、LaTeX プロジェクトを Typst プロジェクトに変える、のいずれかを行います。

**新規プロジェクト → プロジェクトを読み込む** を選ぶか、ライブラリの **読み込む** を使います。Oleafly は新しいローカルのプロジェクトを作成し、元のファイルやリポジトリには手を加えません。読み込むものが独自の Git リポジトリを持っていない限り、読み込んだファイルは、プロジェクトの[最初の Git コミット](/docs/new-project/#the-first-git-commit)になります。コミットの名前は **Create project** です。

![新規プロジェクトのダイアログで「プロジェクトを読み込む」を選ぶと、既存の作業から始められます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

## 手元のものに合う方法を選ぶ

| 手元にあるもの | 読み込みの方法 | 作成できるプロジェクト |
| --- | --- | --- |
| 完成したプロジェクトのフォルダ | **既存のプロジェクト** (`.zip`) | アーカイブされたソース、図、参考文献、ローカルのスタイルファイル |
| Word 文書 | **Word 文書** (`.docx`) | LaTeX、Markdown、Typst |
| Markdown 文書 | **Markdown 文書** (`.md`, `.markdown`) | LaTeX または Typst |
| HTML 文書 | **HTML ページ** (`.html`, `.htm`) | LaTeX、Markdown、Typst |
| Typst 文書 | **Typst 文書** (`.typ`) | LaTeX または Markdown |
| arXiv の論文 | ID または URL を指定する **arXiv の論文** | 論文の LaTeX ソース一式 |
| GitHub リポジトリ | **GitHub** | リポジトリに接続されたローカルのプロジェクト |
| 編集できるソースのない PDF | **Oleafly ツール → PDF 変換** | 選んだツールに応じて再構成された LaTeX、Markdown、Typst |
| すでに Oleafly にある LaTeX プロジェクト | コマンドパレットの **Typst のプロジェクトに変換** | 新しい Typst プロジェクト（LaTeX プロジェクトはそのまま残ります） |

同じ執筆形式を選べるのは、Oleafly がその選択肢を出した場合だけです。Markdown や Typst のファイルを元の形式のまま使うには、その形式の白紙のプロジェクトを始め、[ファイルツリー](/docs/files/#adding-existing-files)からソースファイルを追加します。

## プロジェクトのアーカイブ全体を読み込む

すでに動作するソースツリーがあるときは、ZIP を使います。

1. メイン文書、図、参考文献、ローカルのクラスファイルやスタイルファイルを 1 つのフォルダにまとめます。ソースで使っている相対パスは、そのまま保ってください。
2. フォルダを `.zip` ファイルに圧縮します。
3. **読み込む → 既存のプロジェクト** を選び、ZIP を選択します。
4. 読み込まれたファイルツリーで、星印の付いたメイン文書を確認します。
5. コンパイルします。プロジェクトに別の LaTeX ツールチェーンが必要な場合は、コンパイラメニューから選びます。

たとえば、`main.tex`、`references.bib`、`sections/method.tex`、`figures/plot.pdf` を一緒にしておきます。ソースの ZIP なら、これらの関係が保たれます。PDF には、同じ編集可能なプロジェクト構造は含まれていません。

アーカイブにメイン文書の候補が複数ある場合は、コンパイルする前に、ファイルメニューから正しいものを確認します。

## 読み込みで使われる LaTeX コンパイラ

読み込んだ、または変換した LaTeX プロジェクトは **設定 → エンジン → LaTeX** の既定のコンパイルエンジンで始まります。変更していなければ Tectonic です。既定が `latexmk` で、プロジェクトが pdfLaTeX、XeLaTeX、LuaLaTeX を指定している場合は、そのコンパイラが保たれます。読み込み時に Tectonic では扱えない機能が見つかると、エンジンのダイアログが開くので、別のものを選べます。[新規プロジェクトの既定を設定する](/docs/engines/#set-a-default-for-new-projects)と [Tectonic では足りないとき](/docs/latex-engines/#when-tectonic-isnt-enough)を参照してください。

## Word、Markdown、HTML、Typst を変換する

1. **読み込む** で、該当する文書の種類を選びます。
2. ファイルを選択します。
3. Oleafly が複数の変換先を提示した場合は、次に編集したい形式を選びます。LaTeX には「おすすめ」の印が付きます。
4. Pandoc のセットアップを求められたら完了させます。Oleafly は、互換性のあるインストールを使うことも、管理下のバージョンをダウンロードすることもできます。
5. 新しいプロジェクトを開いてコンパイルし、元のものと見比べます。

変換は Pandoc を通じてローカルで実行されます。Word や HTML の読み込みでは、埋め込まれたメディアもプロジェクトに取り出されるので、変換後のソースからそれを参照できます。LaTeX プロジェクトに読み込んだ Markdown 文書は、引用も保たれます。`[@key]` は `\citep` または `\citet` になり、参考文献ファイルも一緒に取り込まれるので、参考文献パネルには最初から資料がそろっています。

これからの作業に合う変換先を選びます。

- **LaTeX** は、論文誌のテンプレート、細かな組版、タグ付き PDF のワークフローに向いています。
- **Markdown** は、より軽いソース形式と、幅広い文書変換に向いています。
- **Typst** は、高速なコンパイルと、Typst ネイティブのテンプレートに向いています。

変換では、ソース形式が公開している範囲で文書の構造が保たれます。Word 固有のページレイアウト、独自の HTML スタイル、手作業で調整した表、引用、複雑な数式には、それでも手直しが必要になることがあります。元のファイルを削除する前に、見出し、リスト、表、数式、リンク、引用、画像の配置を見比べてください。

## arXiv のソース一式を読み込む

**arXiv の論文** を選び、`2401.01234` のような識別子か、`arxiv.org/abs/...` の URL を貼り付けます。Oleafly は投稿されたソース一式をダウンロードし、LaTeX プロジェクトとして開きます。

著者が書いた編集可能なソースが必要なときは、この方法を使います。読み込みダイアログから始めずに、ソースのアーカイブを確認または保存したいときは [arXiv から LaTeX へ](/docs/tools/arxiv-to-latex/)を、論文を Typst に変換したいときは [arXiv から Typst へ](/docs/tools/arxiv-to-typst/)を使います。arXiv の識別子にはネットワーク接続が必要ですが、すでにディスクにあるソースのアーカイブには必要ありません。

ソースや図を再利用する前に、必ずライセンスと著者の利用条件を確認してください。

## GitHub から読み込む

読み込みダイアログで **GitHub** を選びます。必要なら **設定 → 連携 → GitHub** でアカウントを接続し、アクセスできるリポジトリを選択します。

Oleafly はライブラリにローカルのコピーを作成します。編集する前に、メイン文書を確認してコンパイルしてください。読み込み後のプル、コミット、変更の公開については、[GitHub 同期](/docs/github-sync/)で説明しています。

## LaTeX プロジェクトを Typst に変換する

Oleafly は、すでにある LaTeX プロジェクトの Typst 版を作れます。LaTeX プロジェクトは変更されません。

1. LaTeX プロジェクトを開きます。
2. ⌘K（Ctrl+K）のコマンドパレットを開いて **Typst のプロジェクトに変換** を実行します。
3. **新しいプロジェクトの名前** を確認します。既定では、プロジェクト名のあとに `(Typst)` が付きます。
4. **変換** を選びます。Oleafly が Pandoc でプロジェクトを変換し、Typst プロジェクトを作成して、確認のために一度コンパイルします。
5. レポートを読んで **Typst のプロジェクトを開く** を選びます。

レポートには、新しいプロジェクトがコンパイルできるかどうか、変換されたものの件数、手作業で直す必要があるものが、各コンパイルエラーへのリンクとともに示されます。変換とレポートの詳細は、[Typst プロジェクト](/docs/typst/#convert-a-latex-project-to-typst)で説明しています。

## PDF を再構成する

**設定 → 実験的な機能** で **LaTeX ツール** を有効にしてから、必要な出力に合うツールを選びます。

- LaTeX プロジェクトまたはソースのアーカイブには [PDF から LaTeX へ](/docs/tools/pdf-to-latex/)
- 編集できる Markdown には [PDF から Markdown へ](/docs/tools/pdf-to-markdown/)
- 編集できる Typst には [PDF から Typst へ](/docs/tools/pdf-to-typst/)

ローカルの PDF 処理は、テキストレイヤーを読み取り、読み順を復元し、図を抽出します。PDF がページ画像でできている場合は **PDF から LaTeX へ** でスキャン文書モードに切り替えます。この方法は、ツール用のモデル（別のモデルを選ばない限り、ローカルの Ollama モデル）を使い、最大 50 ページの文書に対応します。

結果を PDF と 1 ページずつ見比べてください。段組み、数式、表、脚注、読み順は再構成で問題になりやすい部分なので、PDF からの変換結果を元のソースと同じものとして扱ってはいけません。

## 原稿を読み込まずに参考文献を追加する

BibTeX、RIS、EndNote XML、Zotero RDF は、[参考文献と引用](/docs/citations/#import-a-whole-reference-library)から読み込めます。論文やデータのフォルダをプロジェクトの外に置いておきたい場合は、[読み取り専用の調査コンテキスト](/docs/linked-folders/)としてリンクします。