[翻译] 在 Overleaf 上设置主文档

原  文：Set Main Document
译  者：Xovee
翻译时间：2020年7月24日

在 Overleaf 上设置主文档

在 Overleaf 中，主文档是 LaTeX 第一个编译的文档。项目的主文档中定义了各种类（classes）、包（packages）、章节（chapters）等。当主文档没有被手动设置的时候，Overleaf 将会选择项目中包含 \documentclass[…]{…} 命令的文档。所以，如果你有多个文件来存放序言（preamble），在这些文件中最好不要放置 \documentclass[…]{…} 命令，把这个命令放置在主文档中。如果你不这样做的话，那么只有序言会被编译。为了设置项目的主文档，首先打开左上角的菜单：

然后找到 Main document：

这篇教程中介绍了更多 LaTeX 大型项目的信息。

在同一个项目中编译多个文档

为了在同一个项目中编译多个文档，Overleaf 会首先选择编辑器中的那个包含 \documentclass[…]{…} 命令的文档。在这个设定下使用 subfiles 包 是非常方便的。

主文件选择问题

主文件应当永远放置在根目录下（不位于任何文件夹内），来确保编译步骤会运行在正确的文件夹内，以及确保必要的文件能够正常访问，例如，在添加索引的时候。这篇文章介绍了一些在 Overleaf 上重新组织项目的小技巧。

如果主文件包含在某个文件夹中，而在根目录下有一个同名的文件，那么后者将会被优先编译。例如，如果 version1/main.tex 被设置为主文件，但是根目录下有 main.tex 文件，那么 main.tex 将会被编译。这个问题是源自于 Latexmk 在 Overleaf 中运行的方式。为了避免这个问题，请给你的文件一个不同的命名。