原 文:Creating a document in LaTeX
译 者:Xovee
翻译时间:2020年5月23日
LaTeX 是一个非常棒的创建文档的工具。它基于 “WYSIWYM” 理念(你见到的就是你所想表达的),你只需要关注于文档的内容,让计算机来帮助你处理文档的格式和排版。你可以非常轻松地使用 LaTeX 来创建专业的文档。这篇文档将教会你如何在 LaTeX 中创建一个文档。
介绍
让我们首先来看一个最简单的例子:
\documentclass{article}
\begin{document}
First document. This is a simple example, with no
extra parameters or packages included.
\end{document}
这个例子的输入是一个只含有纯文字的 .tex 文件,它包含了可以让计算机创建 PDF 文档的代码。代码的第一行定义了文档的类型,article,然后,在 \begin{document}
和 \end{document}
两个标签之间,你可以书写文档的正文。
注意:关于如何生成输出文件,请参考这篇文章。
文档的序言(preamble)
在之前的例子中,正文的范围是在 \begin{document}
之后。而在这个命令之前的内容,被称作文档的序言 preamble。在文档的序言之中,你定义将要创建的文档类型和文档语言,加载你需要的外部包,并设置各种参数。下面展示了一个标准的文档序言:
\documentclass[12pt, letterpaper]{article}
\usepackage[utf8]{inputenc}
\title{First document}
\author{Hubert Farnsworth \thanks{funded by the Overleaf team}}
\date{February 2014}
下面是每一行代码的说明:
\documentclass[12pt, letterpaper]{article}
像之前的例子一样,这行代码定义了文档的类型。你可以在方括号中使用逗号分割的参数。在这个例子中,额外的参数包括:设置字体大小(12pt)和纸张大小(letterpaper)。当然,你也可以设置其他数值的字体大小(9pt、11pt),默认的字体大小是 10pt。纸张大小的参数值还包括:A4 和 legalpaper。需要注意的是,Overleaf 使用了一种欧洲的 LaTeX 发行版,也就是说,它默认的纸张大小是 A4。参考我们的文档(纸张大小和边距)来获取更多有关使用 Geometry 包来设定排版参数的信息。
\usepackage[utf8]{inputenc}
这一行代码设定了文档的编码形式(utf8),来允许你输入更多种类的字符(不仅仅是 ASCII,例如输入 à, ü, č …)。你可以忽略这行代码,或者使用另外一种编码,但是我们强烈推荐 utf-8。除非你有确切的理由使用另外一种编码,当你不确定使用哪种编码的时候,请在序言中添加这一行代码。
下面的三行代码是非常容易去理解的。不管怎么样,我们将在下一节中介绍这些命令。
还有两个非常重要的参数可以传递给 \documentclass
,即 twocolumn
和 twoside
,如果你想使用一种双栏的布局,或者双面打印的布局的话。
显示你文档的标题
为了在文档中显示标题,你需要在序言之中定义一些额外的信息:
\documentclass[12pt, letterpaper, twoside]{article}
\usepackage[utf8]{inputenc}
\title{First document}
\author{Hubert Farnsworth \thanks{funded by the Overleaf team}}
\date{February 2014}
\begin{document}
\begin{titlepage}
\maketitle
\end{titlepage}
In this document some extra packages and parameters
were added. There is an encoding package
and pagesize and fontsize parameters.
\end{document}
序言中的三行代码定义了标题页中所要展示的信息。
\title{First document}
这是标题。
\author{Hubert Farnsworth}
你可以在这里添加一个或多个作者。作为一个可选的参数,你还可以添加下面这个命令:
\thanks{funded by the Overleaf team}
这个命令可以被添加在\author
命令的内部,作者名字的后面。它会在作者名后添加一个上标,并且在当前页添加一个脚注来显示该命令的内容。当你需要感谢一个机构的时候,这个命令非常有用。
\date{February 2014}
你可以手动输入日期,或者使用\today
命令来在每次编译之后显示最新的日期。
当你搞定了序言之后,你可以使用下面的指令来显示序言中所定义的内容:
\begin{titlepage} \end{titlepage}
这个命令定义了一种环境,在这个例子中,不管你在 titlepage
中定义了什么内容,它都将显示在文档的第一页。
\maketitle
这个命令将会显示你之前定义的标题、作者和日期。如果这个命令没有出现在 titlepage
环境之中,那么序言中所定义的内容将会出现在文档的开头。
基础的排版:摘要、段落和换行
任何出现在 \begin{document}
和 \end{document}
之间的内容,都将会出现在文档的正文之中。
\documentclass[12pt, letterpaper, twoside]{article}
\usepackage[utf8]{inputenc}
\begin{document}
\begin{abstract}
This is a simple paragraph at the beginning of the document. A brief introduction to the main subject.
\end{abstract}
In this document some extra packages and parameters
were added. There is an encoding package,
and pagesize and fontsize parameters.
This line will start a second paragraph. And I can
break\\ the lines \\ and continue on a new line.
\end{document}
通常来说,在科研论文写作之中,我们需要写一段简短的摘要来说明文章的大体内容。你可以使用 abstract 环境来做到这一点。abstract 环境将会用一种特殊的格式来将其中的文字置于文档的顶部。
在书写文档的正文的时候,如果你需要换行,那么你需要点击 Enter 按键两次(输入一个空白行)。需要注意的是,段落在它的开始有一个空格。
你可以使用\\
,或者\newline
,来使文字换行。
你可以在段落和换行中找到更多的信息。
有关更多文档结构的讨论,请参考文档的章节。
注释
有时候你可以在 LaTeX 代码之中添加注释来增强文档的可读性。在文字之前添加 %
,LaTeX 将会忽略该行其后的文字。
\documentclass{article}
\usepackage[utf8]{inputenc} %codification of the document
\usepackage{comment}
%Here begins the body of the document
\begin{document}
This document contains a lot of comments, none of them
will appear here, only this text.
This document contains a lot of comments, none of them
will appear here, only this text.
\begin{comment}
This text won't show up in the compiled pdf
this is just a multi-line comment. Useful
to, for instance, comment out slow-rendering parts
while working on a draft.
\end{comment}
\end{document}
在这个例子的最后一个部分,你可以看到一个 comment 环境,你可以使用它来注释多行内容。为了使用这个指令,你必须在序言中引入 comment 包:
\usepackage{comment}
因为 %
符号使一个保留符号,如果你想在文档中真正显示这个符号,使用\%
。完整的保留符号列表如下:
参考指南
你可以在 \documentclass
中使用的文档类型:
文档类型 | 描述 |
---|---|
article | 对于短的文章和期刊文章,这个类型是最常用的。 |
report | 更长的文章和学位论文,使用这个类型 |
book | 用来书写一本书 |
letter | 用来写信 |
slides | 极少使用 |
beamer | 使用 beamer 类样式的 slides,更多信息请参考这篇文章 |
保留符号
下面的符号是 LaTeX 的保留符号,它们被用来生成指令,或者有其他特殊的用途。
# $ % ^ & _ { } ~ \
如果你想在文档中显示这些符号,需要一些特殊的技巧:
符号 | 作用 | 如何去显示它 |
---|---|---|
# | 宏参数 | \# |
$ | 数学模式 | $ |
% | 注释 | \% |
^ | 上标(数学模式) | \^{} 或 \textasciicircum |
& | 在表格中分割列 | \& |
_ | 下标(数学模式) | \_ |
{} | 处理块 | {} |
~ | 不可分割的空格 | \textasciitilde 或 \~{} |
\ | 指令的开始符 | \textbackslash 或 \ |