# 模板

模板图库：28 个可直接编辑的起点，涵盖 LaTeX、Typst 和 Markdown，从简历到 IEEE 论文、学位论文、Beamer 幻灯片和海报，另有可下载的模板包。

每个 Oleafly 项目都从模板开始。图库为每个模板提供真实的首页预览，所以你可以看着输出来选，而不是凭名字猜。模板以朴素、可编辑的源码形式提供，具体是 LaTeX、Typst 还是 Markdown，取决于模板本身：你创建出来的就是你的。

![从模板图库创建一份基金申请书，并填好它的封面表格。](https://cdn.oleafly.com/images/gifs/desktop/new-grant.gif?v=2)

## 模板图库

在项目库中选择**新建项目 → 使用模板**。图库分两步：

1. **选择模板。** 在左侧栏按分类浏览，在**搜索模板**框中输入，或用筛选器缩小网格：**ATS 友好**显示阅读顺序简单的简历模板，引擎筛选器可选 LaTeX、Typst 或 Markdown，**离线**显示资源已在你电脑上的模板。每张卡片都显示编译后首页的预览。
2. **为项目命名。** 你会看到该模板的完整详情：预览、分类、简历模板的 **ATS 友好**或**设计感强**徽章、编译引擎，以及它的许可证和作者。选择项目名称（每个模板都会建议一个合理的占位名称）和封面颜色，然后点击**创建项目**。如果没有选择封面颜色，Oleafly 会从调色板中随机选一个。

![当前 Oleafly 应用中的模板图库，带有分类筛选、引擎选择和文档预览。](https://cdn.oleafly.com/images/screenshots/desktop/docs/template-gallery-dark-window-v2.png)

![用模板创建一份 Beamer 演讲幻灯片，并编译出标题页。](https://cdn.oleafly.com/images/gifs/desktop/new-talk.gif?v=2)

## 模板目录

| 模板 | 分类 | 内容 |
|---|---|---|
| **Blank document** | 空白 | 一份最简的 LaTeX 文章，从零开始。 |
| **Blank Typst document** | 空白 | 一份最简的 Typst 文档，用内置的 Typst 引擎编译。 |
| **Blank Markdown document** | 空白 | 带 YAML 元数据的 Pandoc Markdown 文档。 |
| **Diagram / Figure** | 图表 | 独立的 TikZ 图项目；以图片形式预览，可搭配[图表编排器](/docs/figures-diagrams/)使用。 |
| **Typst Figure** | 图表 | 独立的 Typst 图，以图片形式预览。用形状和文字绘制、编译后，可在任何地方复用。 |
| **ATS Resume** | 简历 | 单栏、ATS 友好的简历，章节分隔线简洁。 |
| **Software Engineer Resume** | 简历 | 精心排版的单页软件工程师简历，已按资深工程师的示例预先填好，你只需修改，不必从头编写。 |
| **Sidebar Resume** | 简历 | 设计感强的双栏版式：彩色侧栏，左侧是照片占位和技能，右侧是工作经历。 |
| **Modern Resume** | 简历 | 单栏、ATS 友好的简历，使用 Lato 字体排版。 |
| **Typst Resume** | 简历 | 简洁的单栏 Typst 简历：编辑快捷、ATS 友好，用内置的 Typst 引擎编译。 |
| **IEEE Research Paper** | 期刊 | 双栏 IEEEtran 会议论文，含图、表、公式和参考文献。 |
| **Academic Article** | 期刊 | 极简的单栏研究论文，含摘要和 `references.bib` 参考文献。 |
| **ACM Article** | 期刊 | 官方 acmart 文档类：作者、摘要、CCS 概念、参考文献。 |
| **Elsevier Article** | 期刊 | elsarticle 文档类：单位、摘要、关键词和 `references.bib` 参考文献。 |
| **Typst Conference-style Paper** | 期刊 | 双栏会议风格的 Typst 论文，含作者、摘要、一张图、一个表、一个公式和参考文献。 |
| **Homework Assignment** | 作业 | 标题区、页眉、带解答空间的编号题目。 |
| **Bibliography (natbib)** | 参考文献 | natbib + BibTeX 起步模板，附示例 `.bib` 和引用示例。 |
| **Thesis / Report** | 论文与报告 | 标题页、目录、章节和 `references.bib` 参考文献。 |
| **Typst Report** | 论文与报告 | 结构化的 Typst 报告，含编号章节、摘要和交叉引用。 |
| **Typst Technical Report** | 论文与报告 | 完整的 Typst 技术报告，含标题页、执行摘要、目录、图、表和参考文献。 |
| **Typst Thesis** | 论文与报告 | Typst 学位论文，含标题页、摘要、目录、章节、图、参考文献和附录。 |
| **Book** | 书籍 | 部分、章节、前置内容、目录。 |
| **Beamer Presentation** | 演示文稿 | beamer 幻灯片：标题、提纲、内容页、结束页。也可导出为 PowerPoint。 |
| **Newsletter** | 时事通讯 | 双栏版式：刊头、头条文章、简短栏目。 |
| **Research Poster** | 海报 | tikzposter 科研海报：标题横幅、作者栏、分栏内容块。 |
| **Monthly Calendar** | 日历 | 单页月历网格，单元格宽松。 |
| **Formal Letter** | 信函 | 发件人和收件人栏、日期、称呼、正文、签名。 |
| **Typst Formal Letter** | 信函 | Typst 正式信函，含发件人和收件人栏、日期、主题行、正文和签名。 |

以上是 28 个内置模板：19 个 LaTeX、8 个 Typst、1 个 Markdown。LaTeX 模板开箱即用，用内置的 Tectonic 引擎编译；如果你已将 `latexmk` 设为[默认编译引擎](/docs/engines/#set-a-default-for-new-projects)，则用它编译。Typst 模板使用内置的 Typst 引擎，Markdown 模板走受管理的 Pandoc 路径。Typst 模板不使用任何包，所以可以用 0.13 到 0.15 的任意 Typst 离线编译。每个模板都附有其许可证文本（均为宽松许可）。

![用模板创建一张 A0 研究海报并完成编译。](https://cdn.oleafly.com/images/gifs/desktop/new-poster.gif?v=2)

## 可下载的模板包

内置的模板集有意保持精简。按需下载的模板包会增加更多模板，涵盖学术写作、Beamer 主题、商务文档、会议预印本样式、课程作业、创意文档、履历和简历样式、实验室和技术报告、幻灯片和海报，以及期刊或会议文档类。在图库中选择**获取更多模板**，或打开**设置 → 下载**，即可安装模板包。安装后，它的模板会像内置模板一样出现在图库中，之后也可以移除模板包以释放空间。模板包来自一个公开目录，你联网打开下载页时，Oleafly 会刷新它，所以列表可以在应用版本发布之间增长。安装模板包需要网络连接。

## AI 生成的模板

选择**生成模板**，向 AI 模型描述你自己的版式。选择一个模型，检查生成的源码和预览，然后保存该模板，或用它创建项目。**使用此模板**同样会把它保存到图库中。

[一步步生成可复用的报告版式 →](/docs/templates/ai-templates/)

## 简历模板与 ATS

简历徽章帮助你选择版式：

- **ATS 友好**（绿色徽章）：ATS Resume、Software Engineer Resume、Modern Resume。单栏、线性的阅读顺序、没有用于布局的表格、使用真实文字。用提取预览检查解析器能从你完成的 PDF 中读到什么。
- **设计感强**（琥珀色徽章）：Sidebar Resume。它外观醒目，徽章是提醒你多栏版式可能难倒严格的解析器。

无论选哪一种，提交之前都请运行[预检](/docs/preflight/)：它会针对你实际的 PDF 模拟简历解析器，并显示提取到了什么。

## 按需字体（“需安装”徽章）

使用额外开源字体的模板（例如基于 Lato 的 Modern Resume）会在图库中显示一个小小的**需安装**徽章。创建这类项目会触发一次性的字体下载并显示实时进度，字体会被复制到项目自己的 `fonts/` 文件夹中，所以字体会随你的源文件一起移动。

你随时可以在设置 → 下载中预先下载或移除这些字体包。详情参见[设置](/docs/settings/#downloads)。

![把实验室的论文保存为模板，然后以它为基础新建一篇论文。](https://cdn.oleafly.com/images/gifs/desktop/save-template.gif?v=2)

## 创建之后

新项目会立即打开，[文件树](/docs/files/)中是模板的结构：主文档、所有的 `.bib` 和资源文件。先编译一次（⌘↵ / Ctrl+Enter），然后开始用你自己的内容替换示例内容。模板是可编辑的 LaTeX、Typst 或 Markdown 源码。替换其中的内容，并根据你的工作调整结构。

起始文件还会被保存为项目的第一次 Git 提交，提交信息为 **Create project**，这样源代码管理从第一次编辑起就能显示你自己的更改。[新建项目](/docs/new-project/#the-first-git-commit)说明了什么情况下会跳过这次提交。
