# arXiv から Typst へ

arXiv の論文の LaTeX ソースを Typst に変換し、変換できなかったものを一覧するコンパイルチェックを行います。

arXiv から Typst へは、PDF ではなく、著者が投稿したソースから始めます。Oleafly は e-print をダウンロードまたは展開し、そのメインの LaTeX ファイルを Typst に変換して、結果を一度コンパイルします。そのため、まだ直す必要があるものがわかります。

## こんなときに使う

- arXiv の論文の構造を Typst で手に入れたいとき
- 著者として、自分の投稿を Typst に移すとき
- 論文のライセンスが、考えている再利用を認めているとき

論文を LaTeX のままにしておくには、[arXiv から LaTeX へ](/docs/tools/arxiv-to-latex/)を使います。ソース一式のない論文は、この経路では扱えません。[PDF から Typst へ](/docs/tools/pdf-to-typst/)は、代わりに PDF からソースを組み立て直します。

## 論文を変換する

1. **arXiv から Typst へ**を開くか、`/arxiv-to-typst` を実行します。
2. **arXiv の ID** に、`1706.03762` のような識別子を入力します。オフラインで作業するには、**保存済みのアーカイブ**に切り替えて、`.tar.gz`、`.tgz`、`.gz` のソースアーカイブを選びます。
3. **変換**を選びます。
4. 結果の下のメモを読みます。メモには、メインの LaTeX ファイル、Typst が結果をコンパイルできたかどうか、変換されなかった項目の数が示されます。メモの下の一覧には、Typst の各エラーとその行番号、変換されなかった各項目が表示されます。
5. **ZIP を保存**を選ぶと、`main.typ` と論文のほかのファイルが保存されます。**プロジェクトを作成**を選ぶと、Typst プロジェクトとして開きます。

## 変換の内容

Oleafly はメインファイルを見つけ、`\input`、`\include`、`\subfile` で読み込まれるファイルのテキストを、そこに取り込みます。Pandoc が、その LaTeX を番号付きのセクションを持つ Typst に変換します。図、参考文献のファイル、アーカイブ内のほかの TeX 以外のファイルは、`main.typ` の隣に元のフォルダのまま置かれるので、変換後のファイルが画像を見つけられます。そのうえで、Typst が確認のために、変換後のファイルをコンパイルします。

ID の検索は arXiv からソースをダウンロードするため、ネットワーク接続が必要です。保存済みのアーカイブは、Oleafly に同梱の Pandoc で、すべてお使いのデバイス上で変換されます。

## 手で直すところ

独自のマクロ、Typst に対応するものがないパッケージ、TikZ の図、複雑な表、参考文献のスタイルが、よく残るものです。まず一覧の Typst のエラーを順に直し、そのあとコンパイルした PDF を論文とセクションごとに見比べてください。Typst は EPS の図を表示できないので、PDF、PNG、SVG に変換してください。

:::caution[先にライセンスを確認してください]
arXiv の論文のライセンスは、論文ごとに異なります。テキストや図を再利用する前に、その論文のライセンスと著者の条件を確認してください。
:::

Oleafly にすでにある LaTeX プロジェクトを変換するには、代わりにコマンドパレットから **Typst のプロジェクトに変換**を使います。[Typst プロジェクト](/docs/typst/#convert-a-latex-project-to-typst)で説明しています。
