大型项目管理

在 EasyLaTeX 中管理长文档时，把主文件、章节、图片与参考文献分开，既能减少误改，也便于协作者定位内容。编译环境和生成文件由平台管理，项目中重点维护的是源码、资源和项目设置。

固定主文件#

在平台的主文件选择处设置完整入口，例如 main.tex。主文件集中管理文档类、宏包、全局设置和章节顺序：

main.tex
chapters/*.tex
figures/*
references.bib

打开章节编辑后，仍从这个主文件编译。模板已有入口时保留其约定。

在文件树中按用途组织#

• chapters/：章节正文。
• figures/：图片和绘图源码。
• tables/：复用的表格片段。
• data/：正文需要读取的数据。
• bibliography/：参考文献 .bib 文件。

创建或上传文件后检查相对路径和大小写。主文件决定章节顺序，不必依赖文件名前的数字。

调试较大的章节#

先保留完整入口，再逐次检查最近修改的章节。\includeonly 可以限制参与排版的章节：

\includeonly{chapters/method,chapters/results}

这只适合预览。跳过章节的编号和引用依赖相应的辅助信息，不应假设它在每次平台任务中都可用。检查文档整体或下载最终 PDF 前，移除 \includeonly，让所有章节参与编译。

用草稿模式减少图片排版#

图片较多时，可以暂时给文档类加上 draft：

\documentclass[draft,UTF8,a4paper,12pt]{ctexbook}

也可只在 graphicx 上启用：

\usepackage[draft]{graphicx}

草稿中可能只有图片框，不能据此判断图片最终清晰度和布局。交付前去掉 draft，重新编译并检查 PDF。

编译生成文件由平台管理#

.aux、.toc、.lof、.lot 等用于目录和引用，通常不需要在项目文件树中创建或手工编辑。目录或引用异常时，先检查主文件、标签和第一处编译错误；修正后重新编译，等待平台完成所需的轮次。

协作与交付#

修改模板设置前先与协作者确认。提交前检查完整编译是否成功，目录、图表目录、页眉页脚、页码与图片是否正确；同时保留项目源码、图片、.bib 和模板依赖文件。下载 PDF 用于交付，不能代替源码备份。

常见问题#

只显示部分章节#

确认主文件是否正确，是否遗留 \includeonly，各个 \input 或 \include 路径是否存在。

同一项目的预览与预期不同#

查看项目保存状态、编译器、主文件和本次任务是否成功。平台实际使用的字体由模板与项目配置决定，不是个人电脑的字体列表。

为清理项目误删文件#

不要把模板的 .cls、.sty、图片或 .bib 当作编译缓存。删除前先检查正文与模板中的引用；已发生缺文件错误时，恢复对应项目资源再编译。

完整主文件示例#

先在文件树中创建示例引用的章节文件，再选择此主文件编译：

\documentclass[UTF8,a4paper,12pt]{ctexbook}
\usepackage{graphicx}
\usepackage[colorlinks=true,linkcolor=blue]{hyperref}
% 调试时取消下一行注释，只编译指定章节
% \includeonly{chapters/method}

\begin{document}
\frontmatter
\tableofcontents
\mainmatter
\include{chapters/introduction}
\include{chapters/method}
\include{chapters/results}
\backmatter
\include{chapters/appendix}
\end{document}