# arXiv 转 Typst

把 arXiv 论文的 LaTeX 源码转换为 Typst，并附带编译检查，列出未能转换的内容。

arXiv 转 Typst 从作者提交的源码出发，而不是从 PDF。Oleafly 下载或解压电子预印本，把它的 LaTeX 主文件转换为 Typst，并编译一次结果，让你看到还有哪些地方需要修复。

## 何时使用

- 你想在 Typst 中得到一篇 arXiv 论文的结构；
- 你是作者，正在把自己的投稿迁移到 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)对此有说明。
