准备编译
main.tex已导出
\documentclass{article}
\usepackage{amsmath}
\title{A document made in PetexSpace}
\author{}
\date{}

\begin{document}
\maketitle

Edit this source and the PDF preview will update automatically.

\[
  \int_{0}^{1} x^2\,dx = \frac{1}{3}
\]

\end{document}
PDF 预览
编译项目以生成 PDF 预览。

需要保留项目副本时,请导出 ZIP。

编写 LaTeX 并预览 PDF

编辑并编译包含多个文件的 LaTeX 项目,检查诊断信息和生成的 PDF 预览,并在需要时导出可继续使用的项目副本。

从源码到 PDF

编写或导入 LaTeX 项目,选择 pdfLaTeX 或 XeLaTeX,然后编译以更新 PDF 预览。需要可复用的副本时,随时导出项目 ZIP。

检查与导出

选择与项目匹配的引擎,进行编译,查看诊断信息并检查 PDF 预览。

LaTeX 编辑器常见问题

如何保留 LaTeX 项目的完整副本?

在完成重要编辑后,以及更改根文件、引擎、宏包集或文件夹结构之前,请将项目导出为 ZIP。该归档应包含在其他位置继续开展项目所需的源文件和已添加资源。下载的 PDF 仅是编译结果,无法替代可编辑的源码。在将其作为项目副本之前,请打开 ZIP 并确认各章节、参考文献文件、图像、自定义文档类和样式文件均已包含。

我应该选择哪个 LaTeX 引擎?

尽可能使用现有项目已指定的引擎。对于许多现有文档和宏包,pdfLaTeX 都是实用的选择。当源码需要广泛的 Unicode 文本、系统字体或 OpenType 字体功能时,通常更推荐使用 XeLaTeX。更换引擎可能会影响字体度量、换行、宏包行为以及输出的分页。如果不确定该如何选择,请查看项目文档,并对比代表性页面、公式、参考文献和非拉丁文本的全新编译结果。

为什么 LaTeX 项目会编译失败?

请从第一条有用的诊断信息入手,因为后面的提示往往是由前面的同一错误引起的。常见原因包括未知命令、括号不匹配、文件缺失、路径错误、所选引擎不支持某个宏包,或者根文档未包含 document 环境。一次修正一个原因并重新编译。当错误指向生成的文件时,请检查生成受影响的目录、引用、标签或辅助条目的源码命令。

为什么引用或参考文献会显示为问号?

交叉引用和参考文献可能需要多次成功编译,因为 LaTeX 会先写入辅助信息,然后在后续遍次中读取。请确认每个标签都是唯一的、每个引用都使用了完全一致的标签名称、引用键与参考文献条目相匹配,且参考文献文件已按预期流程引入。在判断引用是否正确之前,请先解决编译错误。如果问号仍然存在,请检查最早的引用或辅助文件诊断信息,并验证所选引擎和参考文献命令是否与项目相符。

编译成功后我应该在 PDF 中检查什么?

编译成功仅意味着生成了 PDF,并不代表文档完全无误。请检查标题页、页序、标题级别、表格、插图、公式、脚注、链接、引用、参考文献、页眉、页脚、页边距和分页符。留意是否存在行溢出、图形被裁切、缺字、未解析的问号、异常空白页以及发生变化的字体替换。对于重要文档,请在标准缩放和打印比例下对比代表性页面,并确认链接和复制的文本均符合预期。

导入前应该检查哪些项目结构和宏包?

确定预期的根 .tex 文件,并保持章节、图像、参考文献、文档类和样式文件的相对路径一致。依赖 shell 命令、外部程序、非常规系统字体、不可用宏包或不同 TeX 发行版的项目,可能需要调整后才能编译。文件名大小写最好与源码中的每一次引用完全一致。导入后,先编译已知正常的简短部分,查看诊断信息,然后再检查整个文档是否存在特定于宏包的差异或缺失资源。