创建第一份文档

从编译的最小文档开始,然后添加标题和标题,直到获得一个小报告。在此过程中,您将了解 LaTeX 的基本规则。

最小的文档

每个 LaTeX 文档都包含三个部分。顶部的 \documentclass{...} 选择文档类型\begin{document} 之前的所有内容都是序言(设置所在的位置); \begin{document}\end{document} 之间的所有内容都是 body。这几行是一个完整的、有效的示例。

latex
\documentclass{article}
\begin{document}
This is my first document.
\end{document}

该类是一个模板,决定文档的整体外观 - 页边距、标题形状、章节的工作方式等等。 article 是论文、简短报告和技术笔记的标准课程,如果您不确定,这是一个安全的起点。还有 reportbook 和(对于日语)jlreq(请参阅“TeX/LaTeX 和日语”以日语书写)。

基本规则

每个命令都以 反斜杠 \ 开头。必需的参数放在大括号 { } 中,可选参数放在 括号 [ ] 中(例如 \documentclass[12pt]{article})。从 % 到行尾的任何内容都是注释,不会打印。

在正文中,源中的换行符将被忽略,空行开始一个新段落 - LaTeX 决定最终的换行符。注意& % $ # _ { }有特殊含义;要按字面打印它们,请将它们转义为 \&\% 等。

将其编译为 PDF

通过 TeX 引擎运行该文件以获得 PDF。在编辑器或 Overleaf 上,您只需按“编译”即可;在命令行上:

terminal
pdflatex document.tex     # → document.pdf
# or, simpler — runs the right number of passes automatically:
latexmk -pdf document.tex

带有目录或交叉引用的文档需要两次通过latexmk 为您计算计数)。有关完整的管道,请参阅“从源到 PDF”。

修复第一个错误

在第一个文档中,学习如何读取错误比避免错误更重要。当编译停止时,在 .log 或编辑器日志中查找以 ! 开头的第一行。 TeX 可能会因一个错误而产生许多后续错误,因此请修复最上面的错误并再次运行。

  • 每个 \begin{...} 都需要其匹配的 \end{...};如果缺少一个,构建可能会在接近尾声时停止。
  • 要按字面打印 %$_&,请编写 \%\$\_\&
  • 拼写错误的 \section 给出 Undefined control sequence;检查命令名称和任何所需的包。

添加标题和标题 - 使其成为报告

\title\author\date 放在序言中,然后在正文顶部调用 \maketitle 打印标题。使用 \section\subsection 制作的标题会自动编号,并且 \tableofcontents 会为您构建内容列表。

latex
\documentclass{article}
\title{My First Report}
\author{Taro Yamada}
\date{\today}
\begin{document}
\maketitle
\tableofcontents

\section{Introduction}
This is the introduction.

\section{Method}
\subsection{Setup}
Details go here.
\end{document}

要使标题不编号,请添加星号:\section*{...}\today 被您编译的日期替换。

通过包添加功能

缺少的功能来自 - 只需将 \usepackage{...} 添加到序言中即可。对于图像,graphicx;对于严肃的数学,amsmath;对于边距,geometry。 CTAN 上有大量收藏。

latex
\documentclass{article}
\usepackage{graphicx}   % images
\usepackage{amsmath}    % better math
\begin{document}
% your content
\end{document}