从编译的最小文档开始,然后添加标题和标题,直到获得一个小报告。在此过程中,您将了解 LaTeX 的基本规则。
最小的文档
每个 LaTeX 文档都包含三个部分。顶部的 \documentclass{...} 选择文档类型; \begin{document} 之前的所有内容都是序言(设置所在的位置); \begin{document} 和 \end{document} 之间的所有内容都是 body。这几行是一个完整的、有效的示例。
\documentclass{article}
\begin{document}
This is my first document.
\end{document}该类是一个模板,决定文档的整体外观 - 页边距、标题形状、章节的工作方式等等。 article 是论文、简短报告和技术笔记的标准课程,如果您不确定,这是一个安全的起点。还有 report、book 和(对于日语)jlreq(请参阅“TeX/LaTeX 和日语”以日语书写)。
基本规则
每个命令都以 反斜杠 \ 开头。必需的参数放在大括号 { } 中,可选参数放在 括号 [ ] 中(例如 \documentclass[12pt]{article})。从 % 到行尾的任何内容都是注释,不会打印。
在正文中,源中的换行符将被忽略,空行开始一个新段落 - LaTeX 决定最终的换行符。注意& % $ # _ { }有特殊含义;要按字面打印它们,请将它们转义为 \&、\% 等。
将其编译为 PDF
通过 TeX 引擎运行该文件以获得 PDF。在编辑器或 Overleaf 上,您只需按“编译”即可;在命令行上:
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 会为您构建内容列表。
\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 上有大量收藏。
\documentclass{article}
\usepackage{graphicx} % images
\usepackage{amsmath} % better math
\begin{document}
% your content
\end{document}