# プロジェクトの書き出しと変換

最新の PDF の保存、編集できるソースのパッケージ化、ページ画像や HTML の書き出し、Typst からの PDF/A と PDF/UA の書き出し、LaTeX・Typst・Markdown 文書の変換を行います。

プロジェクトツールバーで **書き出し** を開きます。メニューは現在の文書のエンジンと種類に合わせて変わるため、そのプロジェクトで Oleafly が実行できる経路だけが表示されます。

![書き出しは、上部のプロジェクトバーで再コンパイルのすぐ後ろにあるダウンロード用のボタンです。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## 受け取る相手に合う出力を選ぶ

- **PDF** は、閲覧、印刷、ほとんどの投稿ポータル向けです。
- **ソース ZIP** は、原稿、図、参考文献、ローカルのスタイルが必要な共著者やシステム向けです。
- **ページの PNG** は、画像を求めるスライド、メッセージ、査読システム向けです。
- **Typst が書き出す PNG、SVG、HTML** は、すべてのページを画像、ベクタのページ、ウェブページとして必要とする Typst プロジェクト向けです。
- **Word、HTML、Markdown、Typst、LaTeX、プレーンテキスト** は、別の形式で内容を編集したり再利用したりしたい相手向けです。
- **PowerPoint** は、プレゼンテーションや Markdown 文書をスライドにするためのものです。**EPUB** は電子書籍リーダー向けです。どれが表示されるかはエンジンによって決まります。[プレゼンテーションと書籍の書き出し](#presentation-and-book-exports)を参照してください。

## PDF、ソースのアーカイブ、ページ画像を保存する

1. **再コンパイル** を選んで、出力に最新の編集が反映されるようにします。
2. 最後のページや参考文献を含めて、PDF を確認します。
3. **書き出し** を開きます。
4. **PDF として書き出す** / **ソースを書き出す（.zip）** / **ページを PNG として書き出す** のいずれかを選びます。
5. 保存ダイアログで保存先を選びます。
6. 完了メッセージの **フォルダに表示** で、保存されたファイルの場所を開きます。

PDF とページ画像の操作は、プロジェクトに PDF ができるまで無効のままで、メニューには **PDF には先にコンパイルが必要です** と表示されます。 **PDF として書き出す** は、プレビューに表示されている PDF を保存します。 **ページを PNG として書き出す** は、プレビューで見ているページを高解像度で保存します。

ソースのアーカイブには、ビルドのキャッシュと Git の内部ファイルは含まれません。シンボリックリンクも含まれず、完了メッセージにスキップした数が表示されます。

### PDF が最新でないとき

プレビューが古くなっていても、Oleafly は PDF やページ画像を保存し、完了メッセージでそのことを知らせます。

- コンパイルに失敗したあとは、前回のコンパイルが失敗したので、ファイルが不完全かもしれないと表示されます。
- コンパイルしていない編集があるときは、ファイルは前回のコンパイルのもので、最新の編集は含まれていないと表示されます。

誰かに送る前に、再コンパイルし、プレビューを確認して、もう一度書き出してください。

## Typst の画像と HTML

Typst プロジェクトの書き出しメニューには **画像と HTML** もあります。これを選ぶと **Typst で書き出す** が開きます。これらのファイルは Typst 自身が描画するため、PNG と SVG のページは PDF とまったく同じ見た目になります。

- **PNG 画像** では、**解像度** を 72、144、300、600 PPI から選べます。
- **SVG 画像** では、ページがベクタ図形のまま保たれます。
- **HTML** には **試験的** と表示されます。Typst の HTML は、テキストと画像は保ちますが、ページ設定と図形は含まれません。Typst 0.15 より前では数式も含まれず、HTML を選ぶとダイアログにその旨が表示されます。

PNG と SVG では **ページ** に `1, 3-5` や `8-` のようなページ番号と範囲を指定します。すべてのページを書き出すには空欄のままにします。各ページは別々のファイルとして保存され、選んだ名前のあとに番号が付きます。ページ範囲には Typst 0.12 以降、HTML には Typst 0.13 以降が必要です。ダイアログには、プロジェクトの Typst バージョンでできることだけが表示されます。プロジェクトに[ビルドのバリアント](/docs/typst/#build-variants-and-sysinputs)がある場合、書き出しにはコンパイルメニューで選択したものが使われます。

## Typst からの PDF/A と PDF/UA

Typst は、長期保存用やアクセシブルな PDF を自分で書き出せます。プロジェクトレールの **盾** のアイコンから[プリフライト](/docs/preflight/)を開いて **アクセシビリティ** のチェックの下にある **PDF 規格** を見つけます。PDF/A-2b や PDF/UA-1 などの **規格** を選んでから **PDF を書き出す** を選びます。

一覧の内容は、プロジェクトの Typst バージョンによって変わります。Typst 0.11 には何もなく、Typst 0.12 では PDF/A-2b、Typst 0.13 では PDF/A-3b が加わり、Typst 0.14 以降ではすべての PDF/A レベルと PDF/UA-1 を選べます。Typst 0.14 以降は、すべての PDF にスクリーンリーダー用のタグも付けるため、タグ付き用の別コンパイルは不要です。PDF/UA-1 には、文書のタイトルと、すべての画像の代替テキストが必要で、プリフライトがその両方をチェックします。

## 編集できる形式

| プロジェクトのエンジン | 書き出しの形式 |
| --- | --- |
| **LaTeX** | Word、MathML 付きの自己完結型 HTML、Markdown、Typst、プレーンテキスト |
| **Typst** | LaTeX、Word、MathML 付きの自己完結型 HTML、Markdown、プレーンテキスト |
| **Markdown** | Word、MathML 付きの自己完結型 HTML、Typst、LaTeX、プレーンテキスト |

Typst プロジェクトでは EPUB も、Markdown プロジェクトでは PowerPoint と EPUB も選べます。LaTeX プロジェクトでは、該当するドキュメントクラスの場合に限り選べます。

これらの変換は、Pandoc を通じてローカルで実行されます。Oleafly は、コンピュータにある互換性のあるインストールを使うか、必要になった最初のときに、検証済みの管理下のビルドをダウンロードします。

Typst プロジェクトは別の経路をたどります。まず Typst が文書を HTML として書き出し、Pandoc がその HTML を Word、HTML、Markdown、LaTeX、プレーンテキスト、EPUB に変換するので、数式や参照も引き継がれます。文書がこの経路を使えるかどうかは、プロジェクトの Typst バージョンで決まります。

| Typst のバージョン | 経路 |
| --- | --- |
| 0.15 以降 | HTML 経由 |
| 0.13 と 0.14 | Typst が文書全体を書き出せる場合は HTML 経由。書き出せない場合は、代わりに Pandoc が Typst のソースを読み込みます。 |
| 0.12 以前 | Pandoc がソースを読み込む |

HTML の書き出し中に Typst がエラーで止まった場合は、どのバージョンでも Pandoc がソースを読み込みます。Typst 0.13 または 0.14 で Pandoc がソースを読み込んだときは、書き出しに警告がなければ、回転、拡大縮小、移動、傾斜したテキストが欠けている可能性があると完了メッセージで知らせます。最も完全な書き出しにするには、コンパイルメニューの **Typst のバージョン（このプロジェクト）** で、プロジェクトを Typst 0.15 以降に切り替えてください。

HTML 経由で書き出す場合、`align`、`grid`、`rotate` などのレイアウト関数の中のテキストは、そのまま残ります。CeTZ で描いた図は線や図形が失われ、テキストのラベルだけが残り、Typst が省いたものは完了メッセージに示されます。

## 文書を変換する

1. 一度コンパイルして、ソースのエラーを直します。
2. **書き出し** を開き、変換先の形式を選びます。
3. Pandoc のセットアップを求められたら完了させます。Pandoc が使えないと Oleafly に表示された場合は、**設定 → エンジン → Markdown** で **Pandoc を修復**を選び、もう一度書き出します。
4. 提案された拡張子で、変換後のファイルを保存します。
5. 完了メッセージを読みます。警告があると書かれている場合は、**警告を表示**を選んで、書き出しで省かれたものを確認します。
6. 変換先のアプリでファイルを開き、構造と見た目を確認します。

手早く試すには、見出し、数式、表、画像、引用を含む短い節を書き出します。この 5 つの要素がきちんと残っていれば、原稿全体を変換して、もう一度確認します。

LaTeX プロジェクト全体を、そのまま作業を続けられる Typst プロジェクトにするには、代わりに [Typst のプロジェクトに変換](/docs/typst/#convert-a-latex-project-to-typst)を使います。新しいプロジェクトを作成し、対応が必要な点を報告します。

### 変換で保たれるもの

Pandoc は、見出し、段落、リスト、リンク、引用、表、画像、編集できる数式を保つことを目指します。ただし、ソース言語のあらゆる機能をあらゆる変換先で再現できるわけではありません。次の点は念入りに確認してください。

- LaTeX のカスタムコマンドと環境
- 手作業で調整したページレイアウトやフロート
- 複雑な表や入れ子の表
- 参考文献のスタイルと引用の表示
- 変換先に直接対応するものがない Typst の関数
- 生の HTML や Markdown の拡張

HTML の書き出しは、リソースを埋め込み、数式を MathML で書き出します。そのため、単体で開ける文書を共有するのに便利ですが、読者が使うブラウザでの確認はしておきましょう。

### 形式ごとに保たれるもの

- Word と PowerPoint の書き出しでは、PDF、SVG、WebP の図が 220 ppi の PNG 画像になります。ソースにサイズの指定がない図は、元の幅のままです。
- HTML と EPUB の書き出しでは、PDF の図が PNG 画像になります。
- LaTeX から書き出した Markdown とプレーンテキストには、タイトル、著者、概要が残ります。
- LaTeX から Markdown や Typst への書き出し、Markdown から LaTeX や Typst への書き出しは、プロジェクトの図のファイルをコピーせず、リンクします。書き出しに警告がなければ、コンパイルする前に、画像と参考文献を書き出したファイルの隣にコピーするよう、完了メッセージで知らせます。Typst や LaTeX に書き出された Markdown 文書は、文書内で宣言した参考文献を保ちます。宣言がない場合は、プロジェクトの `.bib` ファイルを保ちます。
- Markdown 文書の LaTeX への書き出しは、その[文書の種類](/docs/writing/markdown/#document-types)に従います。スライドとポスターは Beamer のソースに、レポートや書籍は `#` の見出しから章が始まり、手紙は KOMA-Script の手紙になります。
- Typst から LaTeX への書き出しは、文書の画像を `.tex` ファイルの隣の `<name>-media` フォルダにコピーします。LaTeX が読めない SVG、GIF、WebP の画像は、そこで PDF になります。

書き出しは、メイン文書のフォルダ、プロジェクトのルート、`\graphicspath` のフォルダから図を探し、拡張子なしで指定された図も見つけます。EPS の図は変換できないため、警告付きでそのままファイルに入ります。Markdown 文書の Word、HTML、EPUB、PowerPoint への書き出しでは、Mermaid のブロックに、そのために保存された図が表示されます。

### 書き出し後の警告

Pandoc は、形式が保持できないものを省きます。LaTeX や Markdown のプロジェクトからの書き出し、またはソースを読み込む Typst の書き出しでそうなった場合、完了メッセージは、画像のコピーを促す注意書きなどの代わりに、ファイルが警告付きで保存されたことと、その件数を知らせます。**警告を表示**を選ぶと**書き出しの警告**が開き、欠けたものが一覧表示されます。そのダイアログの**フォルダに表示**で、保存したファイルのあるフォルダが開きます。

一覧には次のものが示されることがあります。

- 書き出しで省かれたブロック。分かる場合はファイルと行が付きます。たとえば `tikzpicture`、`\includepdf`、`\only` や `\uncover` のような Beamer のオーバーレイコマンドです
- 書き出しで見つからなかった、または変換できなかった図
- 参考文献にない引用キー
- TeX のコードのまま残った数式
- まだ番号のない参照。コンパイルすれば解決します

同じ警告は 1 回だけ表示され、一覧は 50 件で打ち切られます。PowerPoint の書き出しは、図が見つからないときの動作が異なります。書き出しは止まり、ファイルは保存されず、エラーに図の名前が示されます。HTML 経由の Typst の書き出しでは、Typst が省いたものは、代わりに完了メッセージに示されます。

## プレゼンテーションと書籍の書き出し

LaTeX プロジェクトでは、これらはドキュメントクラスに応じて決まります。 **PowerPoint（.pptx）として書き出す** は Beamer のプレゼンテーションに表示されます。 **EPUB（.epub）として書き出す** は `book`、`report`、`memoir`、`scrbook`、`scrreprt` クラスに表示されます。

Beamer のスライドでは、フレームごとに新しいスライドが始まり、`\section` はセクションのスライドを追加し、`\subsection` は何も追加しません。複数の画像を含むフレームや、画像とほかの内容を含むフレームは、2 枚目のスライドにはみ出すことがあります。

Typst と Markdown のプロジェクトでは、メニューはこれらの書き出しのために文書を確認しません。Markdown プロジェクトでは常に両方が、Typst プロジェクトでは常に EPUB が選べます。Markdown 文書を PowerPoint にすると、レベル 1 の見出しはセクションのスライドになり、レベル 2 の見出しごとに新しいスライドが始まります。例外は `type: slides` の文書で、フロントマターの `slide-level` の行が、スライドを始める見出しのレベルを決めます。EPUB には必ず目次が付き、数式は MathML になります。

これらは、編集できる出発点として使ってください。スライドの構成や書籍の組版が、形式をまたいで 1 対 1 に対応することはまれなので、すべてのスライドや章を変換先のアプリで確認してください。

## 単体の図を書き出す

単体の図のプロジェクトでは、コンパイル後に **PDF（ベクタ画像）として書き出す** と **PNG として書き出す** が選べます。どの倍率でも線や文字をくっきり保ちたいなら PDF を選びます。書き出し先がラスター画像しか受け付けないなら PNG を選びます。

## 出力をプロジェクトの中に保存する

[PDF プレビュー](/docs/pdf-preview/)にも **PDF をプロジェクトに保存** があります。これで、投稿用のコピーやコンパイル済みの図をソースの隣に残せます。そのコピーを最新に保つには、同じメニューで[コンパイル時に PDF を同期](/docs/pdf-preview/#sync-pdf-on-compiles)をオンにします。コンパイルに成功するたびに、Oleafly がプロジェクトの名前を付けた PDF を更新します。以前の PDF は、プロジェクトを復元しなくても、[チェックポイント](/docs/checkpoints/#save-a-pdf-from-a-checkpoint)から保存できます。そのファイルを [Git の履歴](/docs/git-history/)に追加するのは、生成された出力をバージョン管理するつもりのときだけにしてください。

## 共有する前に確認する

投稿の前に[プリフライト](/docs/preflight/)を実行します。タグ付き PDF が必要な場合は、LaTeX ならアクセシブルな書き出しのワークフローに従い、Typst プロジェクトなら PDF/UA の規格を選んで、結果を独立した PDF/UA チェッカーと、人の目によるアクセシビリティの確認で検証してください。プリフライトは多くの有用な指標を確認しますが、適合を証明するものではありません。
