diff options
| author | Karl Berry <karl@freefriends.org> | 2017-03-26 21:46:53 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2017-03-26 21:46:53 +0000 |
| commit | f281d730a5b02f4c9ddd75caf59c2bdb2b2f4b43 (patch) | |
| tree | a4e0b7b2e6832983c3ad2d5a561e317f4d2fbd4a /Master/texmf-dist/doc/latex/lshort-chinese | |
| parent | d7b92e080a4ea517469567218b11a23684bf868d (diff) | |
lshort-chinese (26mar17)
git-svn-id: svn://tug.org/texlive/trunk@43606 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/lshort-chinese')
22 files changed, 873 insertions, 536 deletions
diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/README-zh.md b/Master/texmf-dist/doc/latex/lshort-chinese/README-zh.md new file mode 100644 index 00000000000..3dd2eee1d99 --- /dev/null +++ b/Master/texmf-dist/doc/latex/lshort-chinese/README-zh.md @@ -0,0 +1,35 @@ +# 中文版 lshort，5.10 版 + +## 许可证 + +本文档以 **GNU 自由文档许可证（1.3 版）** 发布。详见文档中题为“GNU Free Documentation License”的章节，或者源代码文件 `fdl.tex`。 + +## 编译之前的准备 + +将发行版内的 `ctex` 宏包、`xeCJK` 宏包更新到最新（包括它们依赖的所有宏包），并确认 `lshort-zh-cn-style.sty` 调用的其它宏包都已正确安装并更新到最新。 + +本文档使用 `fandol` 字体包。`fontspec` 宏包会对此字体报 script-not-exist 的警告，可以无视。 + +## 编译方式 + +### 手动编译 + +在 src 目录下按照以下顺序编译： +``` +xelatex lshort-zh-cn +makeindex -s lshort-zh-cn.ist lshort-zh-cn +xelatex lshort-zh-cn +xelatex lshort-zh-cn +``` + +如果编译正确生成 PDF，之后将 PDF 移动到根目录。 + +### 使用脚本和 Makefile 编译 + +Linux 下提供了 GNU make 可用的 Makefile，使用 GNU make 的顺序为： +``` +make +make install +``` + +Windows 下在 src 目录提供批处理脚本 `make.bat`，双击执行编译。 diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/README.md b/Master/texmf-dist/doc/latex/lshort-chinese/README.md index 3d2b57a5933..d7c15b3b55c 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/README.md +++ b/Master/texmf-dist/doc/latex/lshort-chinese/README.md @@ -1,4 +1,4 @@ -# The Not So Short Introduction To LaTeX, v5.05 +# The Not So Short Introduction To LaTeX (Chinese Edition), v5.10 ## License @@ -9,7 +9,7 @@ For detailed information, see the section entitled 'GNU Free Documentation Licen Update `ctex` and `xeCJK` (and all the packages they rely on) in your TeX distritusion. And make sure you've installed all the other packages used in `lshort-zh-cn-style.sty` and updated them to the newest version. -This document uses `fandol` font package. You may receive a warning like 'script-not-exist' made by 'fontspec' package. Just leave it alone. +This document uses `fandol` font package. You may receive a warning like 'script-not-exist' made by `fontspec` package. Just leave it alone. ## Typesetting @@ -20,6 +20,7 @@ In 'src' directory, typeset the source code in the following order: xelatex lshort-zh-cn makeindex -s lshort-zh-cn.ist lshort-zh-cn xelatex lshort-zh-cn +xelatex lshort-zh-cn ``` If typesetting succeeds and the target PDF document is made correctly, then move it to the root directory. @@ -32,41 +33,4 @@ make make install ``` -For Windows users, we also provide a batch file `make.bat` in the 'src' directory, which you can double-click to do the typesetting. - ---- - -# 中文版 lshort，5.05 版 - -## 许可证 - -本文档以**GNU 自由文档许可证（1.3 版）**发布。详见文档中题为“GNU Free Documentation License”的章节，或者源代码文件“fdl.tex”。 - -## 编译之前的准备 - -将发行版内的 `ctex` 宏包、`xeCJK` 宏包更新到最新（包括它们依赖的所有宏包），并确认 `lshort-zh-cn-style.sty` 调用的其它宏包都已正确安装并更新到最新。 - -本文档使用 Fandol 字体包。fontspec 宏包会对此字体报 script-not-exist 的警告，可以无视。 - -## 编译方式 - -### 手动编译 - -在 src 目录下按照以下顺序编译： -``` -xelatex lshort-zh-cn -makeindex -s lshort-zh-cn.ist lshort-zh-cn -xelatex lshort-zh-cn -``` - -如果编译正确生成 PDF，之后将 PDF 移动到根目录。 - -### 使用脚本和 Makefile 编译 - -Linux 下提供了 GNU make 可用的 Makefile，使用 GNU make 的顺序为： -``` -make -make install -``` - -Windows 下在 src 目录提供批处理脚本 `make.bat`，双击执行编译。 +For Windows users, we also provide a batch file `make.bat` in the 'src' directory, which you can double-click to do the typesetting.
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf b/Master/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf Binary files differindex 069ba487e11..9cea2511743 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf +++ b/Master/texmf-dist/doc/latex/lshort-chinese/lshort-zh-cn.pdf diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/INSTRUCTIONS.md b/Master/texmf-dist/doc/latex/lshort-chinese/src/INSTRUCTIONS.md index 09f30c5029e..fa493e575a2 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/INSTRUCTIONS.md +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/INSTRUCTIONS.md @@ -89,7 +89,7 @@ cmdname 和 envname 可写多个命令和环境名，以逗号分隔（唯一例 ``` 用 `\rule` 命令画的一个宽度示意符号。 -**command 环境** 用表格生成的一个加框的命令展示环境。多行命令在每行末尾（最后一行除外）加 \\。 +**command 环境** 用表格生成的一个加框的命令展示环境，用 `\\` 换行。 **intro 环境** 每章开头的一个摘要环境。 diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/Makefile b/Master/texmf-dist/doc/latex/lshort-chinese/src/Makefile index dd65a174672..4a7b464e671 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/Makefile +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/Makefile @@ -1,10 +1,10 @@ LSHORT = lshort-zh-cn PDF = $(LSHORT).pdf REQUIRE = $(LSHORT).tex $(LSHORT)-style.sty $(LSHORT)-layout.tex $(LSHORT).ist -TEMP = $(LSHORT).{aux,log,idx,ind,ilg,out,toc,los} $(LSHORT)-example.aux +TEMP = $(LSHORT).{aux,log,idx,ind,ilg,out,toc,los,synctex.gz} $(LSHORT)-example.aux TEX = xelatex -MODE = -interaction=nonstopmode +MODE = -interaction=nonstopmode -synctex=1 MAKEIDX = makeindex RM = rm -f @@ -16,6 +16,7 @@ $(PDF): $(REQUIRE) $(TEX) $(MODE) $(LSHORT) $(MAKEIDX) -s $(LSHORT).ist $(LSHORT) $(TEX) $(MODE) $(LSHORT) + $(TEX) $(MODE) $(LSHORT) install: all $(INSTALL) $(LSHORT).pdf .. diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.A.install.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.A.install.tex index 8e9a82e1016..ae7d3b11416 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.A.install.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.A.install.tex @@ -11,13 +11,13 @@ \section{\protect\TeX\ 发行版简介}\label{sec:dists} 一个\textbf{\TeX\ 发行版}是 \TeX\ 排版引擎、支持排版的文件（基本格式、\LaTeX\ 宏包、字体等）以及一些辅助工具的集合。 -各式各样的 \TeX\ 发行版经过十多年的发展，大浪淘沙，最终形成两个成熟的分支： +各式各样的 \TeX\ 发行版经过十多年的发展，大浪淘沙，现今的两个主流发行版为： \begin{itemize} \item \textbf{\TeX\ Live}\par - \TeX\ Live 由类 Unix 系统上的 te\TeX\ 发展并取而代之，最终成为跨平台的 \TeX\ 发行版。 + \TeX\ Live 由类 UNIX 系统上的 te\TeX\ 发展并取而代之，最终成为跨平台的 \TeX\ 发行版。 \TeX\ Live 自 2011 年起以年份作为发行版的版本号，保持了一年一更的频率。 - Mac\TeX\ 是 OS X 系统下的一个定制化的 \TeX\ Live 版本，与 \TeX\ Live 同步更新。 + Mac\TeX\ 是 macOS（OS X）系统下的一个定制化的 \TeX\ Live 版本，与 \TeX\ Live 同步更新。 \item \textbf{Mik\TeX}\par Mik\TeX\ 是主要用于 Windows 平台的一个稳定发展的 \TeX\ 发行版。 @@ -77,12 +77,12 @@ tlmgr update --list % 列出所有可更新的宏包 tlmgr repository set http://.../CTAN/systems/texlive/tlnet % 指定更新源（CTAN）地址 tlmgr info <package-name> % 查看宏包信息 - % 加 --list 选项可列出宏包的所有文件 + % 加 --list 参数可列出宏包的所有文件 \end{verbatim} \begin{verbatim} % MikTeX 命令行工具 mpm 的使用示例 -% 建议始终加 --admin 选项使用 +% 建议始终加 --admin 参数使用 mpm --admin --install <package-name> % 安装某个宏包 mpm --admin --uninstall <package-name> % 卸载某个宏包 mpm --admin --update % 更新所有宏包 @@ -95,7 +95,7 @@ mpm --admin --print-package-info <package-name> \TeX\ Live 默认安装所有宏包，而 Mik\TeX\ 的安装程序只包含了若干用于 \LaTeX\ 的基本宏包。从 \TeX\ Live 的光盘镜像和 Mik\-\TeX\ 的安装包体积可见一斑。 默认情况下，编译过程中如果遇到宏包未安装而报错的情况下，Mik\TeX\ 会弹出一个对话框，让用户可以选择临时安装宏包，安装成功后继续编译。 -\subsection{手动安装宏包}\label{sec:pkg-manual-install} +\subsection{手动安装宏包}\label{subsec:pkg-manual-install} \textbf{\textcolor{red}{如非万不得已，尽量不要手动安装宏包}}。绝大多数宏包都已打包到 \TeX\ Live 和 Mik\TeX\ 两大发行版的安装源， 可用宏包管理器安装。如果你知道某个宏包的名称，但不确定是否在发行版中已打包，可在 CTAN 中搜索。 diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.B.error.help.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.B.error.help.tex index 679db7fa376..612642ae1e0 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.B.error.help.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/app.B.error.help.tex @@ -25,15 +25,15 @@ l.3 Test \LaTEx {} and it's friends. \end{verbatim} -这种错误信息分两部分，前一部分（一行或多行）提示了错误的原因，后一部分指出了错误发生的行号， -以及通过错落的文字告知发生错误的命令所在位置。如上错误显示 \cmd{LaTEx} 位置发生了错误，错误提示是“未定义的控制序列”， -意思是 \cmd{LaTEx} 是 \TeX\ 程序无法识别的一个命令，很显然是我们把 \cmd{LaTeX} 的大小写写错了。 +这种错误信息分两部分，前一部分提示了错误的信息，后一部分指出了错误发生的行号， +以及通过错落的文字告知发生错误的命令所在位置。如上错误显示 \cmd{LaTEx} 位置发生了错误，错误信息是“未定义的控制序列”， +意思是 \cmd{LaTEx} 是 \TeX\ 编译器无法识别的一个命令，很显然是我们把 \cmd{LaTeX} 的大小写写错了。 \subsubsection{处理方式} 出现错误时，编译过程将暂停，等待用户输入命令。用户可以直接敲回车跳过当前的错误，继续编译，相当于丢掉了写错的命令， -将``Test and it's friends.''编译出来。但这个例子过于简单，有些复杂的代码中，有可能会由于一个小问题导致一连串的错误。 -此时可以选择按 \textbf{S/R/Q} 选择跳过接下来的所有错误，或者按 \textbf{X} 直接退出编译。 +将``Test and it's friends.''排版出来。但这个例子过于简单，有些复杂的代码中，有可能会由于一个小问题导致一连串的错误。 +此时可以选择按 \textbf{S/R/Q} 选择跳过接下来的所有错误，或者按 \textbf{X} 直接退出编译，将源代码中的错误修改后重新编译。 \subsubsection{常见的 \LaTeX\ 错误信息} @@ -47,6 +47,10 @@ l.3 Test \LaTEx 使用了未定义的命令。拼写错误是原因之一，如把 \cmd{LaTeX} 写作 \cmd{Latex} 这样。 也有可能是没有调用某个宏包，但用了该宏包定义的命令。 +\item \LaTeXerror{! LaTeX error: Environment \ldots\ undefined.} + +使用了未定义的环境。 + \item \LaTeXerror{! Missing \$ inserted.} 缺少数学环境的符号 \texttt\$。多由于将数学符号用在公式之外而导致。 @@ -54,24 +58,26 @@ l.3 Test \LaTEx \item \LaTeXerror{Runaway argument? \\ ! Paragraph ended before \ldots\ was complete.} -\item \LaTeXerror{! File ended while scanning use of \ldots}. +\item \LaTeXerror{! File ended while scanning definition/use of \ldots} + +这两个错误主要是由于漏写了包裹命令参数的花括号，导致识别参数时出现错误。许多编辑器的括号配对功能有助于检查和消除这类错误。 -两个错误都是主要由于漏写了包裹命令参数的花括号，导致识别参数时出现错误。 +这类错误还有可能是由于前一次编译中断导致 \texttt{.aux} 等辅助文件不完整，再次编译读入不完整的文件产生错误。解决办法是删除辅助文件并重新编译。 \item \LaTeXerror{! Extra alignment tab has been changed to \cmd{cr}.} \item \LaTeXerror{! Misplaced \cmd{noalign}.} -两个错误都与表格有关。 +两个错误信息都与表格有关。 \begin{itemize} - \item 前者的字面意义是“一行中使用的列分隔符 \texttt\& 太多”，有的时候可能确实是 \texttt\& 的个数和列格式不匹配， - 但多数情况是漏了行尾的 \crcmd。 - \item 后者常出现于漏掉了行尾的 \crcmd\ 而接着使用 \cmd{hline} 画横线的时候。 + \item 前者的字面意义是“一行中使用的列分隔符 \texttt\& 太多”，有时可能确实是 \texttt\& 的个数和列格式不匹配， + 但多数情况是漏掉了行尾的 \crcmd\ 命令。 + \item 后者常出现于漏掉了行尾的 \crcmd\ 命令而接着使用 \cmd{hline} 命令画横线的时候。 \end{itemize} -\item \LaTeXerror{! LaTeX Error: Lonely \cmd{item}--perhaps a missing list environment.} +\item \LaTeXerror{! LaTeX Error: Lonely \cmd{item}-{}-perhaps a missing list environment.} -\item \LaTeXerror{! LaTeX Error: Something's wrong--perhaps a missing \cmd{item}.} +\item \LaTeXerror{! LaTeX Error: Something's wrong-{}-perhaps a missing \cmd{item}.} 两个错误信息都与列表环境和 \cmd{item} 命令有关。前者意味着在没有使用列表环境的情况下用了 \cmd{item}； 后者则相反，是在列表环境中漏了 \cmd{item}。 @@ -82,50 +88,49 @@ l.3 Test \LaTEx 两个错误都意味着缺少文件。 \begin{itemize} - \item 如果使用 \cmd{input} 或者 \cmd{include} 命令添加文件，文件不存在，文件名或路径不正确，将会出现上述错误； + \item 如果使用 \cmd{input} 或者 \cmd{include} 命令添加文件，出现上述错误的原因当然是文件不存在或者文件名不对； \item 如果错误提示里的文件名带 \texttt{.cls} 或者 \texttt{.sty} 扩展名，那么很显然，是因为\textbf{没有安装所需的宏包或文档类}。 \end{itemize} \item \LaTeXerror{! LaTeX Error: Missing \cmd{begin}\marg*{document}.} -字面上是缺少 \cmd{begin}\marg*{docu\-ment}，实际上往往是由于在 \cmd{begin}\marg*{docu\-ment} 之前（导言区）输入了文字。 +字面上是缺少 \cmd{begin}\marg*{docu\-ment}，实际上往往是由于在 \cmd{begin}\marg*{docu\-ment} 之前（导言区）输入了文字或某些命令。 \item \LaTeXerror{! LaTeX Error: Cam be used only in preamble.} -与上一条相反，由于将必须用于导言区的命令放到了 \cmd{begin}\marg*{docu\-ment} 之后使用而产生。 +与上一条相反，由于将必须用于导言区的命令在 \cmd{begin}\marg*{docu\-ment} 之后使用而产生。 -\item \LaTeXerror{! LaTeX Error: \cmd{begin}\marg*{\ldots} on input line \ldots ended by \cmd{end}\marg*{\ldots}.} +\item \LaTeXerror{! LaTeX Error: \cmd{begin}\marg*{\ldots} on input line \ldots\ ended by \cmd{end}\marg*{\ldots}.} -环境首尾不匹配。比如 \cmd{begin}\marg*{enumerate} 用了 \cmd{end}\marg*{itemize} 结尾。往往是由于漏写了 \cmd{begin} +环境首尾不匹配。比如 \cmd{begin}\marg*{enumerate} 用了 \cmd{end}\marg*{itemize} 结尾。或者也可能是由于漏写了 \cmd{begin} 或者 \cmd{end} 命令。 \item \LaTeXerror{! LaTeX Error: Option clash for package `\ldots'.} 以\textbf{不同选项}重复调用宏包造成冲突。有可能是因为其它宏包内部事先调用了这个宏包，用户再次带选项调用而导致冲突。 -可尝试去掉重复调用的宏包避免冲突。如果宏包允许的话，尽量使用其定义的命令改变设置，避免将设置作为宏包选项。 +解决问题的办法是去掉重复调用的宏包。如果宏包允许的话，尽量使用其定义的命令改变设置，减少宏包选项的使用。 -\item \LaTeXerror{! LaTeX Error: Command \ldots already defined, \\ - or name \cmd{end}\ldots illegal \ldots} +\item \LaTeXerror{! LaTeX Error: Command \ldots\ already defined, \\ + or name \cmd{end}\ldots\ illegal \ldots} -使用 \cmd{newcommand} 或 \cmd{newenvironment} 定义已有的命令/环境时产生的错误。如果自己确实使用了前述命令，可考虑改成 -\cmd{re\-new\-command} 或 \cmd{re\-new\-environment}；如果是宏包定义的命令产生了这个错误，则属于隐性的宏包冲突。 +使用 \cmd{newcommand} 或 \cmd{newenvironment} 定义已有的命令/环境时产生的错误。如果自己确实作了定义，可考虑用 +\cmd{re\-new\-command} 或 \cmd{re\-new\-environment} 定义；如果是宏包定义的命令产生了这个错误，则属于隐性的宏包冲突。 -相比之前的 ``Option Clash''，隐性宏包冲突是更难以解决的问题，对各种宏包不熟悉的用户，尤其是使用模板的用户而言，往往难以下手。 -用户可尝试查找冲突的命令所在宏包的帮助手册。详尽的手册里通常会告知用户这个宏包应当用在某个宏包的前面/后面。 +相比之前的 ``Option Clash''{}，隐性宏包冲突是更难以解决的问题，对各种宏包不熟悉的用户，尤其是使用模板的用户而言，往往难以下手。 +用户可尝试查找引起冲突的宏包的帮助手册。详尽的手册里通常会告知用户这个宏包应当在某个宏包的前面/后面调用，或者不能与某个宏包一起调用。 如果是模板调用了大量宏包导致冲突，可联系模板的作者解决。 \item \LaTeXerror{! LaTeX Error: Unknown option `\ldots' for package `\ldots'.} -调用宏包时使用了不能被其识别的选项。此时应该查找宏包的帮助文档来解决问题。 +调用宏包时指定了不能被其识别的选项。此时应该查找宏包的帮助文档来解决问题。 \item \LaTeXerror{! Package `\ldots' error: \ldots} -宏包或文档类自定义的错误，由于不正确地使用宏包里的命令而导致。 -此时应该查找宏包的帮助文档来解决问题。 +宏包或文档类自定义的错误，由于不正确地使用宏包里的命令而导致。此时应该查找宏包的帮助文档来解决问题。 \end{itemize} -\section{查看帮助文档}\label{sec:texdoc} +\section{查找帮助文档}\label{sec:texdoc} \index{texdoc@\texttt{texdoc} 工具} 无论是 \TeX\ Live 还是 Mik\TeX\ ，提供了一个命令行模式的程序 \texttt{texdoc}。 @@ -172,9 +177,9 @@ texdoc fancyhdr \item[mathtools] 数学公式扩展宏包，提供了公式编号定制和更多的符号、矩阵等。 \item[amsfonts] \AmS\ 扩展符号的基础字体支持。 \item[amssymb] 在 \pkg{amsfonts} 基础上将 \AmS\ 扩展符号定义成命令。 - \item[bm] 提供将符号加粗的命令 \cmd{bm}。 + \item[bm] 提供将数学符号加粗的命令 \cmd{bm}。 \item[siunitx] 以国际单位规范排版物理量的单位。 - \item[mhchem] 排版化学公式。 + \item[mhchem] 排版化学式和方程式。 \item[tipa] 排版国际音标。 \end{pkglist} @@ -183,6 +188,7 @@ texdoc fancyhdr \begin{pkglist} \item[ulem] 提供排版可断行下划线的命令 \cmd{uline} 以及其它装饰文字的命令。 \item[endnote] 排版尾注。 + \item[marginnote] 改善的边注排版功能。 \item[multicol] 提供将内容自由分栏的 \env{multicols} 环境。 \item[multitoc] 生成多栏排版的目录。 \item[minitoc] 为章节生成独立的小目录。 @@ -190,20 +196,24 @@ texdoc fancyhdr \item[verbatim] 对原始的 \env{verbatim} 环境的改善。提供了命令 \cmd{verbatim\-input} 调用源文件。 \item[fancyvrb] 提供了代码排版环境 \env{Verbatim} 以及对版式的自定义。 \item[listings] 提供了排版关键字高亮的代码环境 \env{lst\-listing} 以及对版式的自定义。类似宏包有 \pkg{minted}。 - \item[algorithm2e] 排版算法。 + \item[algorithmic] 一个简单的实现算法排版的宏包。如果要生成浮动体的话，需要搭配 \pkg{algorithm} 宏包使用。 + \item[algorithm2e] 较为复杂的、可定制的算法排版宏包。类似宏包有 \pkg{algorithmicx} 等。 \item[ntheorem] 定制定理环境。类似宏包包括 \pkg{theorem}、\pkg{thmtools}、\pkg{amsthm} 等。 + \item[mdframed] 排版可自动断页的带边框文字段落，提供边框样式的定制功能。 + \item[tcolorbox] 以 \TikZ\ 为基础提供排版样式丰富的彩色盒子的功能。 \end{pkglist} \subsection{图表和浮动体}\label{subsec:pkg-tab-fig} \begin{pkglist} - \item[booktabs] 制作三线表。 + \item[booktabs] 排版三线表。 \item[array] 对表格列格式的扩展。 \item[tabularx] 提供 \env{tabularx} 环境排版定宽表格，支持自动计算宽度的 X 列格式。 + \item[arydshln] 支持排版虚线表格线。 \item[colortbl] 支持修改表格的行、列、单元格的颜色。 \item[multirow] 支持合并多行单元格。 \item[makecell] 支持在单元格里排版多行内容（嵌套一个单列的小表格）。 - \item[diagbox] 制作斜线表头。 + \item[diagbox] 排版斜线表头。 \item[longtable] 提供排版跨页长表格的 \env{longtable} 环境。 \item[ltxtable] 跨页长表格可使用 \env{tabularx} 的 X 列格式。 \item[tabu] 提供排版复杂格式表格的 \env{tabu} 环境。与 \pkg{longtable} 一同调用时，提供排版复杂格式跨页长表格的 \env{longtabu} 环境。 @@ -212,8 +222,9 @@ texdoc fancyhdr \item[epstopdf] \texttt{pdflatex} 命令下支持 EPS 格式的矢量图。 \item[wrapfig] 支持简单的文字在图片周围的绕排。 \item[subfig] 提供子图表和子标题的排版。类似宏包有 \pkg{subfigure} 和 \pkg{subcaption} 等。 - \item[caption] 控制图表标题的格式。 - \item[float] 为浮动体提供不浮动的 H 模式；提供自定义的浮动体结构。 + \item[caption] 控制浮动体标题的格式。 + \item[bicaption] 生成双语浮动体标题。 + \item[float] 为浮动体提供不浮动的 H 模式；提供自定义浮动体结构的功能。 \end{pkglist} \subsection{修改版式}\label{subsec:pkg-layout} @@ -227,7 +238,9 @@ texdoc fancyhdr \item[tocbibind] 支持将目录、参考文献、索引本身写入目录项。 \item[footmisc] 修改脚注 \cmd{footnote} 的格式。 \item[indentfirst] 令章节标题后的第一段首行缩进。 + \item[enumerate] 提供简单的自定义标签格式的 \env{enumerate} 环境。 \item[enumitem] 修改列表环境 \env{enumerate} 和 \env{itemize} 等的格式。 + \item[lettrine] 生成段落首字母大写的效果。 \end{pkglist} \endinput
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/biblio.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/biblio.tex index a0dcd5d0613..53d3b5c5ba1 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/biblio.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/biblio.tex @@ -22,7 +22,7 @@ \newblock \emph{\LaTeX\ 入门}. \newblock 电子工业出版社, 北京, 2013, ISBN~978-7-121-20208-7. -\item[\S] {\bfseries \TeX\ 经典书籍，介绍底层的命令和排版方式，有志深入学习 \LaTeX\ 或参与宏包开发者必读。有一些书籍已经开放网络资源：} +\item[\S] {\bfseries \TeX\ 经典书籍，介绍底层的命令和排版方式，有志深入学习 \LaTeX\ 者或参与宏包开发者必读。有一些书籍已经开放网络资源：} \bibitem{texbook} Donald~E. Knuth. \newblock \emph{The \TeX book}, Volume~A of \textit{Computers and Typesetting}, 2nd edition. \newblock Addison-Wesley, Reading, Massachusetts, 1984, ISBN~0-201-13448-9. diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.01.basics.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.01.basics.tex index d0364ffc0ed..60b7ed229ef 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.01.basics.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.01.basics.tex @@ -30,9 +30,9 @@ 当下 \LaTeX\ 主要的维护者为 Frank Mittelbach。 \LaTeX\ 读作 ``Lah-tech'' 或者 ``Lay-tech'' ，近似于汉字“拉泰赫”或“雷泰赫”。\LaTeX\ 在 ASCII 字符环境写作 \texttt{LaTeX}。 -当前的 \LaTeX\ 版本为 \LaTeXe\ ，意思是超出了第二版，接近但没达到第三版，在 ASCII 字符环境写作 \texttt{LaTeX2e}。 +当前的 \LaTeX\ 版本为 \LaTeXe ，意思是超出了第二版，接近但没达到第三版，在 ASCII 字符环境写作 \texttt{LaTeX2e}。 -\subsection{\LaTeX 的优缺点}\label{subec:advs} +\subsection{\LaTeX\ 的优缺点}\label{subec:advs} \LaTeX\ 总会拿来和一些“所见即所得”（What You See Is What You Get）的文字处理和排版工具比较优缺点。 笔者认为这种比较并不值得提倡，毕竟所有工具都有自己值得使用的原因。 @@ -44,7 +44,7 @@ \item 方便而强大的数学公式排版能力，无出其右。 - \item 绝大多数时候，用户只需掌握一些简单易懂的命令来组织文档结构，无需（或很少）操心文档的版面设计。 + \item 绝大多数时候，用户只需专注于一些组织文档结构的基础命令，无需（或很少）操心文档的版面设计。 \item 很容易生成复杂的专业排版元素，如脚注、交叉引用、参考文献、目录等。 @@ -54,13 +54,13 @@ \item \LaTeX\ 促使用户写出结构良好的文档——而这也是 \LaTeX\ 存在的初衷。 \item \LaTeX\ 依赖的 \TeX\ 排版引擎和其它软件是跨平台、免费、开源的。 - 无论用户使用的是 Windows，OS X，GNU/Linux 还是 FreeBSD 等系统，都能轻松获得并使用这一强大的排版工具。 + 无论用户使用的是 Windows，macOS（OS X），GNU/Linux 还是 FreeBSD 等操作系统，都能轻松获得和使用这一强大的排版工具。 \end{itemize} \LaTeX\ 的缺点也是显而易见的： \begin{itemize} \item 入门门槛高。本手册的副标题叫做 “\pageref{lshort-minutes}~分钟了解 \LaTeXe ”， - 实际上 \pageref{lshort-minutes} 是本手册正文部分的页数。如果你以平均一页一分钟的速度看完了本手册， + 实际上 \pageref{lshort-minutes} 是本手册正文部分（包括附录）的页数。如果你以平均一页一分钟的速度看完了本手册， 你只是粗窥门径而已，离学会它还很远。 \item 排查错误困难。\LaTeX\ 作为一个依靠编写代码工作的排版工具，其使用的宏语言比 C++ 或 Python 等程序设计语言在错误排查方面困难得多。 @@ -83,7 +83,7 @@ TeXworks / TeXstudio / WinEdt 等提供了一些语法高亮、命令补全等 \subsection{\LaTeX\ 命令和环境}\label{subsec:cmds} \index{LaTeX macro@\LaTeX\ 命令} -\LaTeX\ 命令以反斜线 \texttt\textbackslash 开头，为以下两种形式之一： +\LaTeX\ 命令以反斜线 \texttt{\textbackslash} 开头，为以下两种形式之一： \begin{itemize} \item 反斜线和后面的一串字母，如 \cmd{LaTeX}。它们以任意非字母符号（空格、数字、标点等）作为分隔符。 \item 反斜线和后面的一个非字母符号，如 \cmd{\$}。它们无需分隔符。 @@ -107,9 +107,6 @@ or \TeX{} users? 有些命令带一个或多个可选参数，以方括号 \texttt[ 和 \texttt] 包裹。 还有些命令在命令名称后可以带一个星号 \texttt*，带星号和不带星号的命令效果有一定差异。 -\pinyinindex{fenzu}{分组} -\LaTeX\ 的花括号本身也起到\textbf{分组}的作用，可以将字体、格式等的更改限制在大括号范围之内。 - \index{LaTeX environment@\LaTeX\ 环境} \cmdindex{begin,end} \LaTeX\ 还引入了\textbf{环境}的用法，用以令一些效果在局部生效，或是生成特定的文档元素。 @@ -123,6 +120,10 @@ or \TeX{} users? 其中 \Arg{environment name} 为环境名，\cmd{begin} 和 \cmd{end} 中填写的环境名应当一致。 \cmd{begin} 在 \Arg{environment name} 后可以带一个或多个参数，甚至可选参数。环境允许嵌套使用。 +\pinyinindex{fenzu}{分组} +除了 \LaTeX\ 环境之外，花括号本身也起到\textbf{分组}的作用，起到类似环境的令效果在局部生效的作用， +例如 \ref{subsec:fontshape} 和 \ref{subsec:fontsize} 小节中介绍的修改字体和字号的命令用法。 + \subsection{\LaTeX\ 源代码结构}\label{subsec:struct} \cmdindex{documentclass} @@ -150,7 +151,7 @@ or \TeX{} users? 在 \cmd{documentclass} 和 \cmd{begin}\marg*{document} 之间的位置称为\textbf{导言区}，除了使用 \cmd{use\-package} 调用宏包之外，一些对文档的全局设置命令也在这里使用。当然也可以什么都不写，一个宏包都不调用。一切视自己需求。 -\section{用命令行操作 \LaTeX} +\section{用命令行操作 \LaTeX}\label{sec:run} 相信你看到这里已经急不可耐地想要写一个 \LaTeX\ 源代码试一试了。我们这就给一个最小的例子，见源代码 \ref{code:hello-world}。 @@ -164,10 +165,10 @@ or \TeX{} users? \caption{\LaTeX\ 的一个最简单的源代码示例。}\label{code:hello-world} \end{sourcecode} -有相当多的编辑器会提供一个按钮完成编译，不过笔者仍然觉得有必要了解一下其背后的工作原理。\LaTeX\ 调用的程序都是基于命令行的， -所以建议打开 Windows 命令提示符或者 Linux / OS X 的终端，按照本手册的范例尝试一下调用命令行程序编译。 +有相当多的编辑器会提供“编译”按钮，不过笔者仍然觉得有必要了解一下其背后的工作原理。\LaTeX\ 调用的程序都是基于命令行的， +所以建议打开 Windows 命令提示符或者 Linux / macOS（OS X）的终端，按照本手册的范例尝试一下调用命令行程序编译。 -\subsection{引擎、格式和命令} +\subsection{引擎、格式和命令}\label{subsec:concepts} \pinyinindex{paibanyinqing}{排版引擎} \index{pdfTeX@\hologo{pdfTeX}} @@ -178,7 +179,7 @@ or \TeX{} users? \item[格式] 是定义了一组命令的代码集。\LaTeX\ 就是最广泛应用的一个格式，高德纳本人还编写了一个简单的 plain \TeX\ 格式， 没有定义诸如 \cmd{document\-class} 和 \cmd{section} 等等命令。 \item[命令] 是引擎和格式二者的结合体。如下文要用到的 \texttt{pdflatex} 命令是结合 \hologo{pdfTeX} - 引擎和 \LaTeX\ 格式的一个命令，用于编译类似源代码 \ref{code:hello-world} 的代码并输出 PDF。 + 引擎和 \LaTeX\ 格式的一个命令，用于编译类似源代码 \ref{code:hello-world} 的代码并生成文档。 \end{description} \texttt{latex} 命令和 \LaTeX\ 格式往往容易混淆，在同他人讨论关于 \LaTeX\ 的时候需要明确。 @@ -199,7 +200,7 @@ or \TeX{} users? \end{center} \footnotetext{现今的发行版中 \texttt{latex} 命令也用 \hologo{pdfTeX} 引擎结合 \LaTeX\ 格式，输出扩展名为 DVI 的文档。} -\subsection{\texttt{latex}命令} +\subsection{\texttt{latex} 命令}\label{subsec:latex-exe} 假使你的计算机上已经安装了 \LaTeX\ 依赖的程序和工具（安装方法在附录 \ref{app:install} 有简单介绍）。 我们将源代码 \ref{code:hello-world} 拷贝到一个文本文件中，保存为 \texttt{helloworld.tex}。然后在命令行输入： @@ -208,8 +209,8 @@ latex helloworld.tex \end{verbatim} （也可以输入不带扩展名的 \texttt{latex helloworld}）。 -此时命令行界面会闪过许多信息。如果一切正常，再行检查目录，会发现生成了 \texttt{hello\-world.dvi} 以及其它文件。 -这个扩展名为 DVI 的文件就是编译输出的文档。 +此时命令行会闪过许多信息。如果一切正常，在目录中将生成 \texttt{hello\-world.dvi} 以及其它文件。 +这个扩展名为 \texttt{dvi} 的文件就是编译生成的文档。 Linux 系统下，可以在命令行调用 \texttt{xdvi} 程序打开这个文档： \begin{verbatim} @@ -219,14 +220,14 @@ xdvi helloworld.dvi Windows 系统下大多预装了 yap 软件（Mik\TeX) 或 dviout 软件（\TeX\ Live），可以双击 \texttt{hello\-world.dvi} 打开它。 \index{dvipdfmx@\texttt{dvipdfmx} 命令} -要进一步生成现今流行的 PDF 文档格式，我们还需要用额外的命令将 DVI 转为 PDF： +要进一步生成现今流行的 PDF 文档格式，我们还需要用额外的程序将 \texttt{dvi} 转为 \texttt{pdf}： \begin{verbatim} dvipdfmx helloworld.dvi \end{verbatim} 然后就可以用查看 PDF 的软件 （Adobe Reader / Foxit Reader 等）打开生成的 \texttt{hello\-world.pdf} 查看了。 -\subsection{\texttt{pdflatex} 和 \texttt{xelatex} 命令} +\subsection{\texttt{pdflatex} 和 \texttt{xelatex} 命令}\label{subsec:pdflatex-exe} \index{pdflatex@\texttt{pdflatex} 命令} 这两个命令相比于 \texttt{latex} 命令更为方便，我们可以直接生成 PDF： @@ -275,7 +276,7 @@ xelatex helloworld.tex \begin{description} \item [\texttt{proc}] 基于 \cls{article} 文档类的一个简单的学术文档模板。 \item [\texttt{slides}] 幻灯格式的文档类，使用无衬线字体。 - \item [\texttt{minimal}] 一个极其精简的文档类，只设定了纸张大小和字号， + \item [\texttt{minimal}] 一个极其精简的文档类，只设定了纸张大小和基本字号， 用作代码测试的最小工作示例（Minimal Working Example）。 \end{description} \hrule @@ -283,13 +284,13 @@ xelatex helloworld.tex \pinyinindex{xuanxiang}{选项（宏包/文档类）} 可选参数 \Arg{options} 为文档类指定选项，以全局地影响文档布局的参数，如字号、纸张大小、单双面等等。 -\LaTeX\ 的三个标准文档类可指定的选项见表 \ref{tbl:ltx-options}。 - 比如调用 \cls{article} 文档类排版文章，指定纸张为 A4 大小，基本字号为 11pt，双面排版： \begin{verbatim} \documentclass[11pt,twoside,a4paper]{article} \end{verbatim} +\LaTeX\ 的三个标准文档类可指定的选项见表 \ref{tbl:ltx-options}。 + \begin{table}[htp] \caption{\LaTeX\ 的三个标准文档类可指定的选项}\label{tbl:ltx-options} \hrule @@ -334,13 +335,13 @@ xelatex helloworld.tex \footnote{使用多个宏包时指定选项，相当于给每个宏包指定同样的选项。如果有某个宏包不能识别某个选项，则会出错。}： \begin{verbatim} % 一次性载入三个排版表格常用的宏包 -\usepackage{tabularx,longtable,multirow} +\usepackage{tabularx,makecell,multirow} \end{verbatim} 附录 \ref{sec:pkg-list} 汇总了常用的一些宏包。我们在手册接下来的章节中，也会穿插介绍一些最常用的宏包的使用方法。 在使用宏包和文档类之前，一定要首先确认它们是否安装在你的计算机中，否则 \cmd{use\-package} 等命令会报错误。 -详见附录 \ref{sec:pkg-manager} 。 +详见附录 \ref{sec:pkg-manager}。 每个宏包（包括前面所说的文档类）都定义了许多命令和环境，或者修改了 \LaTeX\ 已有的命令和环境。 为了明白它们的用法，需要查阅宏包和文档类的帮助手册。使用方法是在 Windows 命令提示符或者 Linux 终端下输入命令： diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.02.text.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.02.text.tex index 62c0c99bd6d..fdc916e0241 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.02.text.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.02.text.tex @@ -32,13 +32,13 @@ ASCII （美国通用信息交换码）使用 0x00-0x7F 对文字编码，也就 \pkgindex{inputenc} 现在的 \TeX\ 程序支持 8-bit，能够识别源代码里编码处于 0x80-0xFF 范围的字符。 西欧（拉丁字母）、俄语系（西里尔字母）等语言的编码方案刚好能够利用 0x80-0xFF 这个范围，处理起来较为方便。 -\texttt{latex} 命令及 \texttt{pdflatex} 命令下，这些编码的处理由 \pkg{inputenc} 宏包支持。比如将源代码保存为 Latin-1 编码，并在导言区使用： +\texttt{latex} 命令及 \texttt{pdflatex} 命令下，这些编码的处理由 \pkg{inputenc} 宏包支持。 +比如将源代码保存为 Latin-1 编码，并在导言区调用宏包： \begin{verbatim} \usepackage[latin1]{inputenc} \end{verbatim} 接下来，M\"obius 就直接可以通过（用适当输入法）输入 \texttt{M\"obius} 得到了。 -其它一些语言也可以使用 \pkg{inputenc} 宏包配合 \pkg{babel} 宏包排版。 \index{bianma@编码!GBK} GBK 等编码是多字节编码，ASCII 字符为一个字节，汉字等非 ASCII 字符为两个字节，这就需要借助一些宏包进行较为复杂的判断和处理。 @@ -65,14 +65,14 @@ Unicode 是一个多国字符的集合，覆盖了几乎全球范围内的语言 \subsection{\pkg{xeCJK} 宏包}\label{subsec:xeCJK} -用 \LaTeX\ 排版中文的一大门槛是中文字体。\TeX\ 使用的字体格式仅支持不超过 256 个字符，要想排版中文，比如旧式的 \pkg{CJK} 宏包， -往往需要复杂的预处理，将中文字体拆分成数百个小字体，非常麻烦% +用 \LaTeX\ 排版中文的一大难题是中文字体的处理。\TeX\ 使用的字体格式仅支持不超过 256 个字符， +旧式的中文排版方案如 \pkg{CJK} 宏包往往需要复杂的预处理，将中文字体拆分成数百个小字体，非常麻烦% \footnote{现在的 \texttt{pdflatex} 以及 \texttt{latex} + \texttt{dvipdfmx} 命令通过字体映射的方式支持直接使用中文字体，不需要经过预处理， 但仍然是不方便新手操作的。}。 \index{xelatex@\texttt{xelatex} 命令} \pkgindex{xeCJK} -\texttt{xelatex} 命令支持直接使用系统安装的 TrueType (\texttt{.ttf}) / OpenType(\texttt{.otf}) 等格式的字体，加上对 UTF-8 编码的原生支持， +\texttt{xelatex} 命令支持直接使用系统安装的 TrueType (\texttt{.ttf}) / OpenType (\texttt{.otf}) 等格式的字体，加上对 UTF-8 编码的原生支持， 免去了预处理字体的麻烦。在此基础上的 \pkg{xeCJK} 宏包更进一步完善了排版中文的一些细节，比如中英文之间插入空隙、 中文行尾的回车不引入空格、标点符号不出现在行首，等等。 @@ -128,8 +128,8 @@ starts a new line. \subsection{注释}\label{subsec:comments} \index{%@\texttt\% (\textit{注释})} -\LaTeX\ 用 \texttt\% 字符作为注释。在这个字符之后直到行末，所有的字符都被忽略，连同回车引入的空格。 -我们需要注意以下示例中“回车引入的空格被忽略”的效果： +\LaTeX\ 用 \texttt\% 字符作为注释。在这个字符之后直到行末，所有的字符都被忽略， +行末的回车也不引入空格。见如下示例： \begin{example} This is an % short comment % --- @@ -161,7 +161,7 @@ ak a word. \subsection{连字}\label{subsec:ligatures} -西文排版中经常会出现连字（Ligatures），常见的有 ff / fi / fl / ffi / ffl。 +西文排版中经常会出现连字（Ligatures），常见的有 ff / fi / fl / ffi / ffl{}。 \begin{example} It's difficult to find \ldots .\\ It's dif{}f{}icult to f{}ind \ldots . @@ -241,11 +241,11 @@ Stra\ss e \begin{tabular}{*4{cl}} \hline \TACC{\`}{o} & \TACC{\'}{o} & \TACC{\^}{o} & \TACC{\~}{o} \\ - \TACC{\=}{o} & \TACC{\.}{o} & \TACC{\"}{o} & \TTACC{\c}{c}\\ + \TACC{\=}{o} & \TACC{\.}{o} & \TACC{\"}{o} & \TTACC{\r}{o}\\ \TTACC{\u}{o} & \TTACC{\v}{o} & \TTACC{\H}{o} & \TTACC{\c}{o} \\ \TTACC{\d}{o} & \TTACC{\b}{o} & \WTACC{\t}{oo} \\[6pt] \TSYM{\oe} & \TSYM{\OE} & \TSYM{\ae} & \TSYM{\AE} \\ - \TSYM{\aa} & \TSYM{\AA} \\[6pt] + \TSYM{\aa} & \TSYM{\AA} & \TSYM{\ss} \\[6pt] \TSYM{\o} & \TSYM{\O} & \TSYM{\l} & \TSYM{\L} \\ \TSYM{\i} & \TSYM{\j} & !` & \verb|!`| & ?` & \verb|?`| \\ \hline @@ -318,17 +318,18 @@ words}, are shown here. \section{断行和断页}\label{sec:break} -\LaTeX\ 将一个段落的文档在合适的位置进行断行，尽可能做到每行的宽度一致，并且单词间距匀称。 -文字段落和公式、图表等内容顺序排布，并在合适的位置断页，分割成匀称的页面。 +\LaTeX\ 将文字段落在合适的位置进行断行，尽可能做到每行的宽度一致，并且单词间距匀称。 +文字段落和公式、图表等内容从上到下顺序排布，并在合适的位置断页，分割成匀称的页面。 在绝大多数时候，我们无需自己操心断行和断页。但偶尔会遇到需要手工调整的地方。 \subsection{单词间距和断行}\label{subsec:interword} 通常情况下，断行的位置尽可能选取在两个单词之间，也就是你输入到源文件中的“空格”。 -没有断开的单词间位置则插入一小段间距，间距是根据行宽和文字自动调整的，文字密一些的地方，单词间距就略窄，反之略宽。 +一般情况下，这个“空格”生成一个间距，它会根据行宽和文字自动调整，文字密一些的地方，单词间距就略窄，反之略宽。 \index{~@\texttt\textasciitilde\ (\textit{不断行空格})} -我们可以使用字符 \texttt\textasciitilde 在合适的位置插入一个空格，并且这个空格不能被断开，通常用在英文人名、图表名称等场景： +我们可以使用字符 \texttt\textasciitilde 在合适的位置插入一个不会断行的空格（高德纳称之为 tie，“带子”）， +通常用在英文人名、图表名称等场景： \begin{example} Fig.~2a \\ Donale~E. Knuth @@ -371,7 +372,7 @@ Donale~E. Knuth \subsection{断词}\label{subsec:hyphen} 如果 \LaTeX\ 遇到了很长的英文单词，仅在单词之间的位置断行无法生成宽度匀称的行时，就要考虑从单词中间断开。 -对于绝大部分单词，\LaTeX\ 能够找到合适的断词位置，在断开的行尾加上连字符 -。 +对于绝大部分单词，\LaTeX\ 能够找到合适的断词位置，在断开的行尾加上连字符 \char\hyphenchar\font 。 \index{-@\cmd{-} (\textit{断词})} 如果一些单词没能自动断词，我们可以在单词内手动使用 \cmd{-} 命令指定断词的位置： diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.03.elements.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.03.elements.tex index 6e37adb5b73..3c7f21d48b5 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.03.elements.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.03.elements.tex @@ -9,31 +9,29 @@ \subsection{章节标题}\label{subsec:secs} -\cmdindex{section,subsection,subsubsection,paragraph,subparagraph} +\cmdindex{chapter,section,subsection,subsubsection,paragraph,subparagraph} +\clsindex{article,book,report} + 一篇结构化的、条理清晰文档一定是层次分明的，通过不同的命令分割为章、节、小节。\LaTeX\ 的三个标准文档类 \cls{article}、\cls{report} 和 \cls{book}% -\footnote{千万注意是\textbf{标准文档类}，其它文档类可能没有定义或只定义了一部分，如 \cls{beamer} 或 \cls{moderncv} 等。}% +\footnote{千万注意是\textbf{标准文档类}，其它文档类，如果不是从标准文档类衍生而来， +很可能没有定义或只定义了一部分命令，如 \cls{beamer} 或 \cls{moderncv} 等。}% 提供了一系列命令，用以划分章节、生成章节标题并自动编号： \begin{command} -\cmd{section}\marg{title} \quad +\cmd{chapter}\marg{title} \quad +\cmd{section}\marg{title} \\ \cmd{subsection}\marg{title} \quad \cmd{subsubsection}\marg{title} \\ \cmd{paragraph}\marg{title} \quad \cmd{subparagraph}\marg{title} \end{command} +其中 \cmd{chapter} \textbf{只在 \cls{book} 和 \cls{report} 文档类有定义}。 \cmdindex{part} -\cmd{part} 命令用以将整个文档分割为大的分块，但不影响 \cmd{section} 等的编号： +\cmd{part} 命令用以将整个文档分割为大的分块，但不影响 \cmd{chapter} 或 \cmd{section} 等的编号： \begin{command} \cmd{part}\marg{title} \end{command} -\cmdindex{chapter} -\clsindex{book,report} -\cls{book} 和 \cls{report} 提供了章一级的结构： -\begin{command} -\cmd{chapter}\marg{title} -\end{command} - 上述命令除了生成带编号的标题之外，还向目录中添加条目，并影响页眉页脚的内容（详见 \ref{sec:pagestyle} 节）。每个命令有两种变体： \begin{itemize} \item 带可选参数的变体：\cmd{section}\oarg{short title}\marg{title}\par @@ -42,8 +40,15 @@ 标题不带编号，也不生成目录项和页眉页脚。 \end{itemize} +较低层次如 \cmd{paragraph} 和 \cmd{subparagraph} 即使不用带星号的变体，生成的标题默认也不带编号，事实上，除 \cmd{part} 外： +\begin{itemize} + \item \cls{article} 文档类带编号的层级为 \cmd{section} / \cmd{subsection} / \cmd{sub\-sub\-section} 三级； + \item \cls{report}/\cls{book} 文档类带编号的层级为 \cmd{chapter} / \cmd{section} / \cmd{sub\-section} 三级。 +\end{itemize} +对此的详细解释和调整方法见 \ref{subsec:latex-counts} 小节。 + \pkgindex{titlesec} -\LaTeX\ 并未提供为 \cmd{section} 等章节命令定制格式的功能，这一功能由 \pkg{titlesec} 宏包提供。详情请参考宏包的帮助手册。 +\LaTeX\ 及标准文档类并未提供为 \cmd{section} 等章节命令定制格式的功能，这一功能由 \pkg{titlesec} 宏包提供。详情请参考宏包的帮助手册。 \subsection{目录}\label{sec:toc} @@ -53,21 +58,24 @@ \cmd{tableofcontents} \end{command} -正确生成目录项，一般需要多次编译源代码。 +这个命令会生成单独的一个章节，标题默认为 ``Contents''{}，可通过 \ref{sec:latex-settings} 节给出的方法定制标题。 + +正确生成目录项，一般需要编译两次源代码。 \cmdindex{addcontentsline} -有时我们使用了 \cmd{chapter*} 或 \cmd{section*} 这样不生成目录项的命令，而又想手动生成该章节的目录，可以在标题命令后面使用： +有时我们使用了 \cmd{chapter*} 或 \cmd{section*} 这样不生成目录项的章节标题命令， +而又想手动生成该章节的目录项，可以在标题命令后面使用： \begin{command} \cmd{addcontentsline}\marg*{toc}\marg{level}\marg{title} \end{command} -其中 \Arg{level} 为章节层次 \texttt{chapter} 或 \texttt{section} 等，\Arg{title} 为需要生成目录项的章节标题。 +其中 \Arg{level} 为章节层次 \texttt{chapter} 或 \texttt{section} 等，\Arg{title} 为出现于目录项的章节标题。 \subsection{文档结构的划分}\label{sec:matters} \cmdindex{appendix} 所有标准文档类都提供了一个 \cmd{appendix} 命令将正文和附录分开% -\footnote{有的地方可能写作 \cmd{begin} \marg*{appendix} \ldots \cmd{end} \marg*{appendix} 这样， +\footnote{有的参考文档可能使用 \cmd{begin} \marg*{appendix} \ldots \cmd{end} \marg*{appendix} 这样的写法， 虽然有效，但并不规范，只要使用 \cmd{appendix} 命令就够了。}， 使用 \cmd{appendix} 后，最高一级章节改为使用拉丁字母编号，从 A 开始。 @@ -75,9 +83,9 @@ \cmdindex{frontmatter,mainmatter,backmatter} \cls{book} 文档类还提供了前言、正文、后记结构的划分命令： \begin{description} - \item[\cmd{frontmatter}] 前言部分，页码为小写罗马字母格式；其后的章节不编号（但生成页眉页脚和目录项）。 - \item[\cmd{mainmatter}] 正文部分，页码改回数字格式，并从 1 开始计数；其后的章节正常编号。 - \item[\cmd{backmatter}] 后记部分，页码继续正常计数，格式不变；其后的章节不编号，类似 \cmd{frontmatter} 命令。 + \item[\cmd{frontmatter}] 前言部分，页码为小写罗马字母格式；其后的 \cmd{chapter} 不编号。 + \item[\cmd{mainmatter}] 正文部分，页码为阿拉伯数字格式，从 1 开始计数；其后的章节编号正常。 + \item[\cmd{backmatter}] 后记部分，页码格式不变，继续正常计数；其后的 \cmd{chapter} 不编号。 \end{description} \cmdindex{include} @@ -126,13 +134,15 @@ \cmd{author}\marg{author} \quad \cmd{date}\marg{date} \end{command} -其中前两个命令是必须的，\cmd{date} 命令可选。\LaTeX\ 还提供了一个 \cmd{today} 命令自动生成当前日期， -可用在 \cmd{date} 的参数里，或者别的地方。 +其中前两个命令是必须的（不用 \cmd{title} 会报错；不用 \cmd{author} 会警告），\cmd{date} 命令可选。 +\LaTeX\ 还提供了一个 \cmd{today} 命令自动生成当前日期，\cmd{date} 默认使用 \cmd{today}。 -\cmdindex{thanks} -在 \cmd{title}、\cmd{author} 等命令内可以使用 \cmd{thanks} 命令生成标题页的脚注，如： +\cmdindex{thanks,and} +在 \cmd{title}、\cmd{author} 等命令内可以使用 \cmd{thanks} 命令生成标题页的脚注，用 \cmd{and} 隔开多个人名，如： \begin{verbatim} -\author{Mary\thanks{E-mail:*****@***.com}} +\author{Mary\thanks{E-mail:*****@***.com} + \and Ted\thanks{Corresponding author} + \and Louis} \end{verbatim} \cmdindex{maketitle} @@ -142,7 +152,22 @@ \cmd{maketitle} \end{command} 生成一个简单的标题页了。\cls{article} 文档类的标题默认不单独成页，而 \cls{report} 和 \cls{book} 默认单独成页。 -可在 \cmd{document\-class} 命令中指定 \texttt{titlepage / notitlepage} 选项修改。 +可在 \cmd{document\-class} 命令调用文档类时指定 \texttt{titlepage / notitlepage} 选项以修改默认的行为。 + +\envindex{titlepage} +\LaTeX\ 标准类还提供了一个简单的 \env{titlepage} 环境，生成不带页眉页脚的一页。用户可以在这个环境中使用各种排版元素自由发挥， +生成自定义的标题页以替代 \cmd{maketitle} 命令。甚至可以利用 \env{titlepage} 环境重新定义 \cmd{maketitle}： +\begin{verbatim} +\renewcommand{\maketitle}{\begin{titlepage} +... % 用户自定义命令 +\end{titlepage}} +\end{verbatim} + +事实上，为标准文档类指定了 \texttt{titlepage} 选项以后，使用 \cmd{maketitle} 命令生成的标题页就是一个 \env{titlepage} 环境。 + +以上是 \LaTeX\ 标准文档类的标题页相关命令用法。在各种文档模板中经常有自定义的标题页， +有可能需要除了 \cmd{title} 和 \cmd{author} 以外的命令给定信息，用法也可能与标准文档类的不一致 +（甚至有些模板可能没有定义 \env{titlepage} 等环境）。使用文档模板前\textbf{一定要仔细阅读文档模板的帮助手册}。 \section{交叉引用}\label{sec:crossref} @@ -196,10 +221,9 @@ page~\pageref{sec:this}.'' “天地玄黄，宇宙洪荒。日月盈昃，辰宿列张。”\footnote{出自《千字文》。} \cmdindex{footnotemark,footnotetext} -有些情况下（比如在表格环境、盒子内）使用 \cmd{footnote} 并不能正确生成脚注。我们可以分两步进行， -先使用 \cmd{foot\-note\-mark} 为脚注计数，再在合适的位置用 \cmd{foot\-note\-text} 生成脚注。 +有些情况下（比如在表格环境、各种盒子内）使用 \cmd{footnote} 并不能正确生成脚注。我们可以分两步进行， +先使用 \cmd{foot\-note\-mark} 为脚注计数，再在合适的位置用 \cmd{foot\-note\-text} 生成脚注。比如： -比如： \begin{verbatim} \begin{tabular}{l} \hline @@ -274,16 +298,17 @@ page~\pageref{sec:this}.'' \end{description} \end{example} -默认的列表间距比较宽，\LaTeX\ 本身也未提供方便的定制功能，而要用到 \pkg{enumitem} 宏包。有兴趣的读者可参考其帮助手册。 +默认的列表间距比较宽，\LaTeX\ 本身也未提供方便的定制功能，而要用到 \pkg{enumitem} 宏包定制各种列表间距。 +\pkg{enumitem} 宏包还提供了对列表标签、引用等的定制。有兴趣的读者可参考其帮助手册。 \subsection{对齐环境}\label{subsec:flush} \envindex{center,flushleft,flushright} \env{center}、\env{flush\-left} 和 \env{flush\-right} 环境分别用于生成居中、左对齐和右对齐的文本环境。 \begin{command} -\cmd{begin}\marg*{center} -\ldots -\cmd{end}\marg*{center} +\cmd{begin}\marg*{center} \ldots\ \cmd{end}\marg*{center} \\ +\cmd{begin}\marg*{flushleft} \ldots\ \cmd{end}\marg*{flushleft} \\ +\cmd{begin}\marg*{flushright} \ldots\ \cmd{end}\marg*{flushright} \end{command} \begin{example} @@ -320,7 +345,7 @@ Left-aligned text paragraph. Right-aligned text paragraph. \end{example} -三个命令和对应的环境经常被误用，有直接用所谓 \cmd{flushleft} 命令或者 \env{raggedright} 环境的，都是不合理的用法（即使它们可能有效）。 +三个命令和对应的环境经常被误用，有直接用所谓 \cmd{flushleft} 命令或者 \env{raggedright} 环境的，都是不甚严格的用法（即使它们可能有效）。 有一点可以将两者区分开来：\env{center} 等环境会在上下文产生一个额外间距，而 \cmd{centering} 等命令不产生，只是改变对齐方式。 比如在浮动体环境 \env{table} 或 \env{figure} 内实现居中对齐，用 \cmd{centering} 命令即可，没必要再用 \env{center} 环境。 @@ -362,9 +387,9 @@ a perfect mirror. \subsection{摘要环境}\label{subsec:abstract} \envindex{abstract} -摘要环境 \env{abstract} 只在 \cls{article} 和 \cls{report} 文档类可用，一般用于紧跟 \cmd{maketitle} 命令之后介绍文档的摘要。 -如果文档类给定了 \texttt{titlepage} 选项，则单独成页；反之相当于一个小标题加一个 \env{quotation} 环境% -（双栏下相当于 \cmd{section*} 定义的一节）。 +摘要环境 \env{abstract} 默认只在标准文档类中的 \cls{article} 和 \cls{report} 文档类可用， +一般用于紧跟 \cmd{maketitle} 命令之后介绍文档的摘要。如果文档类指定了 \texttt{titlepage} 选项，则单独成页； +反之，单栏排版时相当于一个居中的小标题加一个 \env{quotation} 环境，双栏排版时相当于 \cmd{section*} 定义的一节。 \subsection{代码环境}\label{subsec:verbatim} @@ -396,7 +421,7 @@ for (int i=0; i<4; ++i) \cmd{verb}\Arg{delim}\Arg{code}\Arg{delim} \end{command} -\Arg{delim} 标明代码的分界位置，不能是字母、空格或星号，前后必须一致，可任意选择使得不与代码本身冲突，习惯上使用 \texttt| 符号。 +\Arg{delim} 标明代码的分界位置，前后必须一致，除字母、空格或星号外，可任意选择使得不与代码本身冲突，习惯上使用 \texttt| 符号。 同 \env{verbatim} 环境，\cmd{verb} 后也可以带一个星号，以显示空格： \begin{example} @@ -471,6 +496,8 @@ for (int i=0; i<4; ++i) \end{tabular} \end{example} +表格中每行的单元格数目不能多于列格式里 \texttt{l/c/r/p} 的总数（可以少于这个总数），否则出错。 + \texttt{@} 格式可在单元格前后插入任意的文本，但同时它也消除了单元格前后额外添加的间距。 \texttt{@} 格式可以适当使用以充当“竖线”。特别地，\texttt{@}\marg*{} 可直接用来消除单元格前后的间距： \begin{example} @@ -500,7 +527,7 @@ for (int i=0; i<4; ++i) \end{tabular} \end{example} -辅助格式甚至支持插入 \cmd{centering} 等命令改变 \texttt{p} 列格式的对齐方式，一般还要加额外的命令\cmd{array\-back\-slash} 以免出错% +辅助格式甚至支持插入 \cmd{centering} 等命令改变 \texttt{p} 列格式的对齐方式，一般还要加额外的命令 \cmd{array\-back\-slash} 以免出错% \footnote{\cmd{centering} 等对齐命令会破坏表格环境里 \crcmd\ 换行命令的定义， \cmd{array\-back\-slash} 用来恢复之。如果不加 \cmd{array\-back\-slash} 命令， 也可以用 \cmd{tabular\-newline} 命令代替原来的 \crcmd\ 实现表格换行。}： @@ -516,7 +543,7 @@ for (int i=0; i<4; ++i) \subsection{列宽}\label{subsec:colwidth} 在控制列宽方面，\LaTeX\ 表格有着明显的不足：\texttt{l/c/r} 格式的列宽是由文字内容的自然宽度决定的， -而 \texttt{p} 格式给定了列宽却不好控制对齐（需要 \pkg{array} 宏包辅助）， +而 \texttt{p} 格式给定了列宽却不好控制对齐（可用 \pkg{array} 宏包的辅助格式）， 更何况列与列之间通常还有间距，所以直接生成给定总宽度的表格并不容易。 \envindex{tabular*} @@ -558,13 +585,15 @@ for (int i=0; i<4; ++i) \end{example} \pkgindex{booktabs} -\cmdindex[booktabs]{toprule,midrule,bottomrule} +\cmdindex[booktabs]{toprule,midrule,bottomrule,cmidrule} 在科技论文排版中广泛应用的表格形式是三线表，形式干净简明。 三线表由 \pkg{booktabs} 宏包支持，它提供了 \cmd{toprule}、\cmd{midrule} 和 \cmd{bottomrule} 命令用以排版三线表的三条线， -除此之外，最好不要用其它横线以及竖线： +以及和 \cmd{cline} 对应的 \cmd{cmidrule}。除此之外，最好不要用其它横线以及竖线： \begin{example} \begin{tabular}{cccc} \toprule + & \multicolumn{3}{c}{Numbers} \\ + \cmidrule{2-4} & 1 & 2 & 3 \\ \midrule Alphabet & A & B & C \\ @@ -619,13 +648,13 @@ for (int i=0; i<4; ++i) 在以下的例子中，注意要用 \cmd{multi\-column} 命令配合 \texttt{@\{\}} 格式把单元格的额外边距去掉，使得嵌套的表格线能和外层的表格线正确相连： \begin{example} -\begin{tabular}{|c|l|c|} +\begin{tabular}{|c|c|c|} \hline - a & bbb & c \\ \hline - a & \multicolumn{1}{@{}l@{}|} + a & b & c \\ \hline + a & \multicolumn{1}{@{}c@{}|} {\begin{tabular}{c|c} - a & b \\ \hline - aa & bb \\ + e & f \\ \hline + e & f \\ \end{tabular}} & c \\ \hline a & b & c \\ \hline @@ -633,7 +662,7 @@ for (int i=0; i<4; ++i) \end{example} \pkgindex{makecell} -如果不要求画横线，并且只需要在垂直方向“拆分单元格”的话，\pkg{makecell} 宏包提供的 \cmd{make\-cell} 命令是一个简单的解决方案： +如果不需要为“拆分的单元格”画线，并且只在垂直方向“拆分”的话，\pkg{makecell} 宏包提供的 \cmd{make\-cell} 命令是一个简单的解决方案： \begin{example} \begin{tabular}{|c|c|} @@ -649,7 +678,7 @@ for (int i=0; i<4; ++i) \cmdindex{arraystretch} \LaTeX\ 生成的表格看起来通常比较紧凑。修改参数 \cmd{array\-stretch} 可以得到行距更加宽松的表格 -（相关命令参考 \ref{sec:newcommands} 节）： +（相关命令参考 \ref{subsec:newcmd} 小节）： \begin{example} \renewcommand\arraystretch{1.8} \begin{tabular}{|c|} @@ -682,10 +711,10 @@ for (int i=0; i<4; ++i) \LaTeX\ 本身不支持插图功能，需要由 \pkg{graphicx} 宏包辅助支持。 -使用 \texttt{latex + dvipdfmx} 编译命令时，调用 \pkg{graphicx} 宏包时要给定 \texttt{dvipdfmx} 选项% +使用 \texttt{latex + dvipdfmx} 编译命令时，调用 \pkg{graphicx} 宏包时要指定 \texttt{dvipdfmx} 选项% \footnote{早期常使用 \texttt{latex + dvips} 组合命令，后者将 \texttt{.dvi} 文件转为 \texttt{.ps} 文件（PostScript）， 可进一步通过 \texttt{ps2pdf} 工具生成 PDF。\texttt{dvips} 和 \texttt{dvipdfmx} 在图形、颜色、超链接等功能的实现上有差别，而 \LaTeX\ 无法识别 -用户是用 \texttt{dvips} 还是 \texttt{dvipdfmx}，所以要给定选项（缺省为 \texttt{dvips}）。 +用户是用 \texttt{dvips} 还是 \texttt{dvipdfmx}，所以要指定选项（缺省为 \texttt{dvips}）。 \ref{sec:hyperlinks} 节中的 \pkg{hyperref} 宏包同理。}；而使用 \texttt{pdflatex} 或 \texttt{xelatex} 命令编译时不需要。 读者可能听说过“\LaTeX\ 只能插入 \texttt{.eps} 格式的图片，需要把 \texttt{.jpg} 转成 \texttt{.eps} 格式”的观点。 @@ -730,11 +759,11 @@ for (int i=0; i<4; ++i) \graphicspath{{figures/}{logo/}} \end{verbatim} -\cmd{includegraphics} 命令的可选参数 \Arg{options} 支持 \Arg{key}=\Arg{value} 形式赋值，常用的选项如下： +\cmd{includegraphics} 命令的可选参数 \Arg{options} 支持 \Arg{key}=\Arg{value} 形式赋值，常用的参数如下： \begin{center} \begin{tabular}{lp{18em}} \hline - 选项 & 含义 \\ + 参数 & 含义 \\ \hline width=\Arg{width} & 将图片缩放到宽度为 \Arg{width} \\ height=\Arg{height} & 将图片缩放到高度为 \Arg{height} \\ @@ -749,7 +778,7 @@ for (int i=0; i<4; ++i) 盒子是 \LaTeX\ 排版的基础单元，虽然解释上去有些抽象：每一行是一个盒子， 里面的文字从左到右依次排列；每一页也是一个盒子，各行文字从上到下依次排布……颇有一些活字印刷术的味道。 -不管如何，\LaTeX\ 提供了一些实用的命令让我们生成一些有用的盒子。 +不管如何，\LaTeX\ 提供了一些命令让我们生成一些有特定用途的盒子。 \subsection{水平盒子}\label{subsec:mbox} @@ -760,7 +789,7 @@ for (int i=0; i<4; ++i) \cmd{makebox}\oarg{width}\oarg{align}\marg*{\ldots} \end{command} -\cmd{mbox} 生成一个基本的水平盒子，内容只有一行（除非嵌套下文的垂直盒子），不允许分段。 +\cmd{mbox} 生成一个基本的水平盒子，内容只有一行（除非嵌套下文介绍的垂直盒子，或者其它内容），不允许分段。 外表看上去，\cmd{mbox} 的内容与正常的文本无二，不过断行时文字不会从盒子里断开。 \cmd{makebox} 更进一步，可以加上可选参数用于控制盒子的宽度 \Arg{width}，以及内容的对齐方式 \Arg{align}， @@ -811,7 +840,7 @@ for (int i=0; i<4; ++i) 其中 \Arg{align} 为盒子和周围文字的对齐情况（类似 \env{tabular} 环境）； \Arg{height} 和 \Arg{inner-align} 设置盒子的高度和内容的对齐方式，类似水平盒子 \cmd{makebox} 的设置， -不过 \Arg{inner-align} 接受的选项是顶部 \texttt{t}、底部 \texttt{b}、居中 \texttt{c} 和分散对齐 \texttt{s}。 +不过 \Arg{inner-align} 接受的参数是顶部 \texttt{t}、底部 \texttt{b}、居中 \texttt{c} 和分散对齐 \texttt{s}。 \begin{example} 三字经：\parbox[t]{3em}% @@ -852,12 +881,12 @@ A \rule[-.4pt]{3em}{.4pt} line. \section{浮动体}\label{sec:float} -内容丰富的文章或者书籍往往包含丰富的图片和表格等内容。这些内容的尺寸往往太大，导致分页困难。 +内容丰富的文章或者书籍往往包含许多图片和表格等内容。这些内容的尺寸往往太大，导致分页困难。 \LaTeX\ 为此引入了浮动体的机制，令大块的内容可以脱离上下文，放置在合适的位置。 \envindex{figure,table} \LaTeX\ 预定义了两类浮动体环境 \env{figure} 和 \env{table}。习惯上 \env{figure} 里放图片，\env{table} 里放表格， -但并没有严格限制，可以在任何一个浮动体里放置表格、文字、列表等等任意内容。 +但并没有严格限制，可以在任何一个浮动体里放置文字、公式、表格、图片等等任意内容。 以 \env{table} 环境的用法举例，\env{figure} 同理： \begin{command} @@ -866,8 +895,8 @@ A \rule[-.4pt]{3em}{.4pt} line. \cmd{end}\marg*{table} \end{command} -\Arg{placement} 参数提供了一些符号用来表示浮动体允许排版的位置，如 \texttt{[hbp]} 允许浮动体排版在当前位置、底部或者单独成页。 -\env{table} 和 \env{figure} 浮动体的默认设置为 \texttt{[tbp]}。 +\Arg{placement} 参数提供了一些符号用来表示浮动体允许排版的位置，如 \texttt{hbp} 允许浮动体排版在当前位置、底部或者单独成页。 +\env{table} 和 \env{figure} 浮动体的默认设置为 \texttt{tbp}。 \begin{center} \begin{tabular}{>{\ttfamily}lp{14em}} \hline @@ -880,7 +909,7 @@ A \rule[-.4pt]{3em}{.4pt} line. \end{tabular} \end{center} \begin{quote}\footnotesize -注 1：排版位置的选取与参数里符号的顺序无关，\LaTeX\ 总是以 \texttt{h-t-b-p} 的优先级顺序选取位置。 +注 1：排版位置的选取与参数里符号的顺序无关，\LaTeX\ 总是以 \texttt{h-t-b-p} 的优先级顺序决定浮动体位置。 也就是说 \texttt{[!htp]} 和 \texttt{[ph!t]} 没有区别。\par 注 2：限制包括浮动体个数（除单独成页外，默认每页不超过 3 个浮动体，其中顶部不超过 2 个，底部不超过 1 个） 以及浮动体空间占页面的百分比（默认顶部不超过 70\%，底部不超过 30\%）。 @@ -891,14 +920,15 @@ A \rule[-.4pt]{3em}{.4pt} line. 它们的用法与 \env{table} 和 \env{figure} 一样，不同之处为双栏的 \Arg{placement} 参数只能用 \texttt{tp} 两个位置。 \cmdindex{clearpage} -浮动体的位置选取受到先后顺序的限制。如果某个浮动体由于参数限制、空间限制等原因在当前页无法放置，就要推迟到后一页， -并使得之后的同类浮动体一并推迟。\cmd{clearpage} 命令会在另起一页之前，先将所有推迟放置的浮动体排版成页。 +浮动体的位置选取受到先后顺序的限制。如果某个浮动体由于参数限制、空间限制等原因在当前页无法放置，就要推迟到之后处理， +并使得之后的同类浮动体一并推迟。\cmd{clearpage} 命令会在另起一页之前，先将所有推迟处理的浮动体排版成页， +此时 \texttt{htbp} 等位置限制被完全忽略。 \pkgindex{float} -\pkg{float} 宏包为浮动体提供了 \texttt{H} 选项，不与 \texttt{htbp} 及 \texttt{!} 混用。使用 \texttt{H} 选项时， -会取消浮动机制，将浮动体视为一般的盒子插入当前位置。这在一些特殊情况下（如使用 \pkg{multicol} 宏包生成分栏）的时候很有用， -但尺寸过大的浮动体可能影响到分页。 +\pkg{float} 宏包为浮动体提供了 \texttt{H} 位置参数，不与 \texttt{htbp} 及 \texttt{!} 混用。使用 \texttt{H} 位置参数时， +会取消浮动机制，将浮动体视为一般的盒子插入当前位置。这在一些特殊情况下很有用（如使用 \pkg{multicol} 宏包排版分栏内容的时候）， +但尺寸过大的浮动体可能使得分页比较困难。 \subsection{浮动体的标题}\label{subsec:caption} @@ -909,8 +939,12 @@ A \rule[-.4pt]{3em}{.4pt} line. \end{command} \cmd{caption} 的用法非常类似于 \cmd{section} 等命令，可以用带星号的命令 \cmd{caption*} 生成不带编号的标题， 也可以使用带可选参数的形式 \cmd{caption}\oarg*{\ldots}\marg*{\ldots}，使得在目录里使用短标题。 +\cmd{caption} 命令之后还可以紧跟 \cmd{label} 命令标记交叉引用。 -\cmd{caption} 之后还可以紧跟 \cmd{label} 命令标记交叉引用。 +\pkgindex{caption} +\cmd{caption} 生成的标题形如 ``Figure 1: \ldots''{}（\env{figure} 环境）或 ``Table 1: \ldots''{}（\env{table} 环境）。 +可通过修改 \cmd{figurename} 和 \cmd{tablename} 的内容来修改标题的前缀（详见第 \ref{sec:latex-settings} 节）。 +标题样式的定制功能由 \pkg{caption} 宏包提供，详见该宏包的帮助手册，在此不作赘述。 \cmdindex{listoftables,listoffigures} \env{table} 和 \env{figure} 两种浮动体分别有各自的生成目录的命令： @@ -949,13 +983,13 @@ A \rule[-.4pt]{3em}{.4pt} line. \begin{verbatim} \begin{figure}[htbp] \centering - \begin{minipage} + \begin{minipage}{...} \centering \includegraphics[width=...]{...} \caption{...} \end{minipage} \qquad - \begin{minipage} + \begin{minipage}{...} \centering \includegraphics[width=...]{...} \caption{...} @@ -986,14 +1020,14 @@ A \rule[-.4pt]{3em}{.4pt} line. \begin{figure}[htbp] \centering \subfloat[...]{\label{sub-fig-1}% 为子图加交叉引用 - \begin{minipage} + \begin{minipage}{...} \centering \includegraphics[width=...]{...} \end{minipage} } \qquad \subfloat[...]{% - \begin{minipage} + \begin{minipage}{...} \centering \includegraphics[width=...]{...} \end{minipage} diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.04.math.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.04.math.tex index 30de4c04e93..84ea8472137 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.04.math.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.04.math.tex @@ -1,4 +1,4 @@ -\chapter{排版数学公式} +\chapter{排版数学公式}\label{chap:math} \addtocontents{los}{\protect\addvspace{10pt}} \begin{intro} @@ -22,7 +22,7 @@ 数学公式有两种排版方式：其一是与文字混排，称为\textbf{行内公式}；其二是单独列为一行排版，称为\textbf{行间公式}。 \pinyinindex{hangneigongshi}{行内公式} -\index{$@\texttt\$ (\textit{数学模式})} +\index{^^d@\texttt\$ (\textit{数学模式})} 行内公式由一对 \texttt\$ 符号包裹： \begin{example} Add $a$ squared and $b$ squared @@ -114,12 +114,12 @@ In display: \begin{enumerate} \item 数学模式中输入的空格全部被忽略。数学符号的间隙默认完全由符号的性质（关系符号、运算符等）决定。 需要人为引入空隙时，使用 \cmd{quad} 和 \cmd{qquad} 等命令。详见 \ref{sec:math-space} 节。 - \item \textbf{不允许有空行（分段）。}每个公式（每组多行公式）自成一个段落。 + \item \textbf{不允许有空行（分段）}，公式也无法自动换行或者用 \crcmd\ 换行。排版多行公式需要用到 \ref{sec:multi-eqns} 节介绍的各种环境。 \item 所有的字母被当作数学公式中的变量处理，字母间距与文本模式不一致，也无法生成单词之间的空格。 如果想在数学公式中输入正体的文本，简单情况下可用 \ref{subsec:math-alpha} 小节中提供的 \cmd{mathrm} 命令。 - \pkg{amsmath} 提供了更加方便的 \amscmd{text} 命令% + 或者用 \pkg{amsmath} 提供的 \amscmd{text} 命令% \footnote{\amscmd{text} 命令仅适合在公式中穿插少量文字。如果你的情况正好相反，需要在许多文字中穿插使用公式， - 则应该像正常的行内公式那样，而不是滥用 \amscmd{text} 命令。}。 + 则应该像正常的行内公式那样用，而不是滥用 \amscmd{text} 命令。}。 \end{enumerate} \begin{example} $x^{2} \geq 0 \qquad @@ -133,15 +133,16 @@ x\in\mathbb{R}$ \pkgindex{amssymb} 本节我们将接触到形形色色的数学符号，它们是 \LaTeX\ 卓越的数学公式排版能力的基础。\LaTeX\ 默认提供了常用的数学符号， -\pkg{amssymb} 宏包提供了一些次常用的符号。大多数常用的数学符号都能在本章末尾的 \ref{sec:math-tables} 节列出的表格里查到。 +\pkg{amssymb} 宏包提供了一些次常用的符号。大多数常用的数学符号都能在本章末尾的 \ref{sec:math-tables} 节列出的各个表格里查到。 +更多符号可查阅参考文献\cite{symbols}。 -\subsection{一般符号} +\subsection{一般符号}\label{subsec:math-general} \pinyinindex{xilazimu}{希腊字母 (数学符号)} \msymindex{infty} 希腊字母符号的名称就是其英文名称，如 \msym{alpha}、\msym{beta} 等等。 大写的希腊字母为首字母大写的命令，如 \msym{Gamma}、\msym{Delta} 等等。 -无穷大符号为 \msym{infty} 。详情请参考本章末尾的表 \ref{tbl:math-greek} 和 \ref{tbl:math-misc} 等。 +无穷大符号为 \msym{infty}。更多符号命令可参考表 \ref{tbl:math-greek} 和 \ref{tbl:math-misc} 等。 \msymindex{dots,ldots,cdots} 省略号有 \msym{dots} 和 \msym{cdots} 两种形式。它们有各自合适的用途： @@ -151,7 +152,7 @@ $a_1 + a_2 + \cdots + a_n$ \end{example} \cmd{ldots} 和 \cmd{dots} 是完全等效的，它们既能用在公式中，也用来在文本里作为省略号（详见 \ref{subsec:punct} 小节）。 -除此之外，在矩阵中会用到竖排的 \msym{vdots} 和斜排的 \msym{ddots}。 +除此之外，在矩阵中可能会用到竖排的 \msym{vdots} 和斜排的 \msym{ddots}。 \subsection{指数、上下标和导数}\label{subsec:math-scripts} @@ -289,7 +290,7 @@ $a\bmod b \\ \[\argh 3 = \nut_{x=1} 4x\] \end{example} -\subsection{巨算符} +\subsection{巨算符}\label{subsec:math-bigop} \msymindex{int,oint,sum,prod} 积分号 \msym{int}、求和号 \msym{sum} 等符号称为\textbf{巨算符}。巨算符在行内公式和行间公式的大小和形状有区别。 @@ -339,7 +340,7 @@ P(i,j) = Q(n) \] \end{example} -\subsection{数学重音和上下括号} +\subsection{数学重音和上下括号}\label{subsec:math-accents} \maccindex{dot,ddot,vec,hat} 数学符号可以像文字一样加重音，比如对时间求导的符号 $\dot{r}$ (\cmd{dot}\marg*{r})、 $\ddot{r}$ (\cmd{ddot}\marg*{r}) @@ -372,7 +373,7 @@ $\underbrace{\overbrace{a+b+c}^6 _\text{meaning of life} = 42$ \end{example} -\subsection{箭头} +\subsection{箭头}\label{subsec:math-arrows} \cmdindex[amsmath]{xleftarrow,xrightarrow} 除了作为上下标之外，箭头还用于表示过程。\pkg{amsmath} 的 \amscmd{xleft\-arrow} 和 \amscmd{xright\-arrow} 命令可以为箭头增加上下标： @@ -381,7 +382,7 @@ _\text{meaning of life} = 42$ \[ c\xrightarrow[x<y]{a*b*c}d \] \end{example} -\subsection{括号和定界符} +\subsection{括号和定界符}\label{subsec:math-delims} \LaTeX\ 提供了多种括号和定界符表示公式块的边界。除小括号\texttt{( )}、中括号\texttt{[ ]}之外，其余都是 \LaTeX\ 命令， 包括大括号 \cmd{\{} \cmd{\}}。表 \ref{tbl:math-delims} 和 \ref{tbl:math-large-delims} 给出了更多的括号/定界符命令。 @@ -408,21 +409,22 @@ ${a,b,c} \neq \{a,b,c\}$ （\cmd{bigl} 和 \cmd{bigr} 不必成对出现）。 \begin{example} $\Bigl((x+1)(x-1)\Bigr)^{2}$\\ -$\bigl( \Bigl( \biggl( \Biggl( -\quad -\bigr\} \Bigr\} \biggr\} \Biggr\} -\quad -\big\| \Big\| \bigg\| \Bigg\| -\quad +$\bigl( \Bigl( \biggl( \Biggl( \quad +\bigr\} \Bigr\} \biggr\} \Biggr\} \quad +\big\| \Big\| \bigg\| \Bigg\| \quad \big\Downarrow \Big\Downarrow \bigg\Downarrow \Bigg\Downarrow$ \end{example} +使用 \cmd{big} 和 \cmd{bigg} 等命令的另外一个好处是：用 \cmd{left} 和 \cmd{right} 分界符包裹的公式块是不允许断行的 +（下文提到的 \env{array} 或者 \amsenv{aligned} 等环境视为一个公式块），所以也不允许在多行公式里跨行使用， +而 \cmd{big} 和 \cmd{bigg} 等命令不受限制。 + \section{多行公式}\label{sec:multi-eqns} -\subsection{长公式折行}\label{sec:multline} +\subsection{长公式折行}\label{subsec:multline} -通常来讲应当避免写出需要折行的长公式。如果一定要折行的话，优先在等号之前折行，其次在加号、减号之前，再次在乘号、除号之前。 +通常来讲应当避免写出超过一行而需要折行的长公式。如果一定要折行的话，优先在等号之前折行，其次在加号、减号之前，再次在乘号、除号之前。 其它位置应当避免折行。 \envindex[amsmath]{multline} @@ -525,16 +527,15 @@ l + m &= n \envindex{array} \index{&@\texttt\& (\textit{单元格/对齐})} 为了排版二维数组，\LaTeX\ 提供了 \env{array} 环境，用法与 \env{tabular} 环境极为类似，也需要定义列格式，并用 \crcmd\ 换行。 -数组可作为一个子公式，在外套用 \cmd{left}、\cmd{right} 等定界符： +数组可作为一个公式块，在外套用 \cmd{left}、\cmd{right} 等定界符： \begin{example} -\[ -\mathbf{X} = \left( -\begin{array}{ccc} -x_1 & x_2 & \ldots \\ -x_3 & x_4 & \ldots \\ -\vdots & \vdots & \ddots -\end{array} \right) -\] +\[ \mathbf{X} = \left( +\begin{array}{cccc} +x_{11} & x_{12} & \ldots & x_{1n}\\ +x_{21} & x_{22} & \ldots & x_{2n}\\ +\vdots & \vdots & \ddots & \vdots\\ +x_{n1} & x_{n2} & \ldots & x_{nn}\\ +\end{array} \right) \] \end{example} 值得注意的是，上一节末尾介绍的 \amsenv{aligned} 等环境也可以用定界符包裹。 @@ -543,45 +544,57 @@ x_3 & x_4 & \ldots \\ \mathindex{right} 我们还可以利用空的定界符排版出这样的效果： \begin{example} -\[ -|x| = \left\{ +\[ |x| = \left\{ \begin{array}{rl} -x & \text{if } x < 0,\\ 0 & \text{if } x = 0,\\ x & \text{if } x > 0. -\end{array} \right. -\] +\end{array} \right. \] \end{example} \envindex[amsmath]{cases} 不过上述例子可以用 \pkg{amsmath} 提供的 \amsenv{cases} 环境更轻松地完成： \begin{example} -\[ -|x| = +\[ |x| = \begin{cases} -x & \text{if } x < 0,\\ 0 & \text{if } x = 0,\\ x & \text{if } x > 0. -\end{cases} -\] +\end{cases} \] \end{example} \envindex[amsmath]{matrix,pmatrix,bmatrix,Bmatrix,vmatrix,Vmatrix} 我们当然也可以用 \env{array} 环境排版各种矩阵。\pkg{amsmath} 宏包还直接提供了多种排版矩阵的环境，包括不带定界符的 \amsenv{matrix}， 以及带各种定界符的矩阵 \amsenv{pmatrix}（$\bigl($）、\amsenv{bmatrix}（$\bigl[$）、\amsenv{Bmatrix}（$\bigl\{$）、 -\amsenv{vmatrix}（$\bigl\vert$）、\amsenv{Vmatrix}（$\bigl\Vert$）。 -使用这些环境时，无需给定列格式： +\amsenv{vmatrix}（$\bigl\vert$）、\amsenv{Vmatrix}（$\bigl\Vert$）。使用这些环境时，无需给定列格式% +\footnote{事实上这些矩阵内部也是用 \env{array} 环境生成的，列格式默认为 \texttt{*\{\Arg{n}\}\{c\}}，\Arg{n} 默认为 10； +\amsenv{cases} 内部是一个列格式为 \texttt{@\{\}l@\{\cmd{quad}\}l@\{\}} 的 \env{array} 环境。}： \begin{example} \[ \begin{matrix} -1 & 2 \\ -3 & 4 +1 & 2 \\ 3 & 4 \end{matrix} \qquad \begin{bmatrix} -p_{11} & p_{12} & \ldots & p_{1n} \\ -p_{21} & p_{22} & \ldots & p_{2n} \\ -\vdots & \vdots & \ddots & \vdots \\ -p_{m1} & p_{m2} & \ldots & p_{mn} +x_{11} & x_{12} & \ldots & x_{1n}\\ +x_{21} & x_{22} & \ldots & x_{2n}\\ +\vdots & \vdots & \ddots & \vdots\\ +x_{n1} & x_{n2} & \ldots & x_{nn}\\ +\end{bmatrix} +\] +\end{example} + +在矩阵中的元素里排版分式时，一来要用到 \amscmd{dfrac} 等命令，二来行与行之间有可能紧贴着，这时要用到 +\ref{subsec:tabular-colht} 小节的方法来调节间距： +\begin{example} +\[ +\mathbf{H}= +\begin{bmatrix} +\dfrac{\partial^2 f}{\partial x^2} & +\dfrac{\partial^2 f} + {\partial x \partial y} \\[8pt] +\dfrac{\partial^2 f} + {\partial x \partial y} & +\dfrac{\partial^2 f}{\partial y^2} \end{bmatrix} \] \end{example} @@ -595,8 +608,9 @@ p_{m1} & p_{m2} & \ldots & p_{mn} 我们已经认识了两个生成间距的命令 \cmd{quad} 和 \cmd{qquad}。在公式中我们还可能用到的间距包括 \cmd{,}、\cmd{:}、\cmd{;} 以及负间距 \cmd{!}，其中 \cmd{quad} 、 \cmd{qquad} 和 \cmd{,} 在文本和数学环境中可用，后三个命令只用于数学环境。 文本中的 \cmd{\textvisiblespace} 也能使用在数学公式中。 -\begin{center} + \newdimen\testdimen \testdimen=\fontdimen6\textfont2 \divide\testdimen18\relax +\begin{center} \begin{tabularx}{0.9\textwidth}{*{3}{>{\raggedright\arraybackslash}X}|*{3}{>{\raggedright\arraybackslash}X}} \hline 无额外间距 & & $a a$ & @@ -634,7 +648,7 @@ f(x)g(y) \diff x \diff y \\ \end{gather*} \end{example} -\section{数学符号的字体控制} +\section{数学符号的字体控制}\label{sec:math-fonts} \subsection{数学字母字体}\label{subsec:math-alpha} @@ -675,7 +689,7 @@ $\mathbb{ABCDE}$ & \cmd{mathbb}\marg*{\ldots} & \pkg{amssymb} \end{tabular} \end{table} -\subsection{数学符号的尺寸} +\subsection{数学符号的尺寸}\label{subsec:math-styles} \mathindex{displaystyle,textstyle,scriptstyle,scriptscriptstyle} 数学符号按照符号排版的位置规定尺寸，从大到小包括行间公式尺寸、行内公式尺寸、上下标尺寸、次级上下标尺寸。 @@ -705,7 +719,7 @@ P = \frac \] \end{example} -\subsection{加粗的数学符号} +\subsection{加粗的数学符号}\label{subsec:math-bold} 在 \LaTeX\ 中为符号切换数学字体并不十分自由，只能通过 \cmd{mathbf} 等有限的命令切换字体。比如想得到粗斜体的符号，就没有现成的命令% \footnote{国内可能还有使用粗斜体表示向量符号的习惯，但这并不是正确的习惯。}；再比如 \cmd{mathbf} 只能改变拉丁字母，希腊字母就没有用。 @@ -800,8 +814,8 @@ described in theorem \ref{thm:light}. 以上例子定义的 \env{jury} 环境与 \env{law} 环境共用编号，\env{mar} 环境不编号： \begin{example} -\begin{law} \label{law:box} -Don’t hide in the witness box +\begin{law}\label{law:box} +Don't hide in the witness box. \end{law} \begin{jury}[The Twelve] It could be you! So beware and @@ -869,4 +883,19 @@ E=mc^2.\qedhere 在 \amsenv{align} 等环境中使用 \cmd{qedhere} 命令会使 \qedsymbol\ 盖掉公式的编号；使用 \env{equation} 嵌套 \amsenv{aligned} 等环境时， \cmd{qedhere} 命令会将 \qedsymbol\ 直接放在公式后。这些位置都不太正常。 +证毕符号 \qedsymbol\ 本身被定义在命令 \cmd{qedsymbol} 中，如果有使用实心符号作为证毕符号的需求，需要自行用 \cmd{re\-new\-comm\-and} +命令修改（用法见 \ref{subsec:newcmd} 小节）\footnote{注意，这个改法\textbf{只对 \pkg{amsthm} 宏包适用}。 +其它宏包如 \pkg{ntheorem} 等须参考帮助手册里提供的修改方法。}。 +我们可以利用在 \ref{subsec:rules} 小节介绍的标尺盒子来生成一个适当大小的“实心矩形”： +\begin{example} +\renewcommand{\qedsymbol}% + {\rule{1ex}{1.5ex}} +\begin{proof} +For simplicity, we use +\[ +E=mc^2 \qedhere +\] +\end{proof} +\end{example} + \endinput
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.05.style.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.05.style.tex index 0b6543d629a..bacb3f98778 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.05.style.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.05.style.tex @@ -151,40 +151,54 @@ He likes {\LARGE large and \usepackage[T1]{fontenc} \end{verbatim} +\pkg{fontenc} 宏包是用来配合传统的 \LaTeX\ 字体的，如表 \ref{tbl:font-pkgs} 中的大部分宏包。如果使用下文的 \pkg{fontspec} +宏包调用 \texttt{ttf} 或 \texttt{otf} 格式字体，就不要再使用 \pkg{fontenc} 宏包。 + \begin{table}[!p] \centering \caption{常见的 \LaTeX\ 字体宏包。}\label{tbl:font-pkgs} -\begin{minipage}{\linewidth} -\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}cp{0.65\linewidth}@{}} +\begin{tabularx}{\linewidth}{cX} + \hline + \multicolumn{2}{c}{文本/数学字体搭配的宏包} \\ \hline \pkg{lmodern} & Latin Modern 字体，对 Computer Modern 字体的扩展 \\ + \pkg{cmbright} & 仿 Computer Modern 风格的无衬线字体 \\ + \pkg{euler} & Euler 风格数学字体，也出自于高德纳之手 \\ + \pkg{ccfonts} & Concrete 风格字体 \\ \pkg{txfonts} & Times 风格的字体宏包 \\ - \pkg{pxfonts} & Palation 风格的字体宏包 \\ + \pkg{pxfonts} & Palatino 风格的字体宏包 \\ \pkg{stix} & Times 风格的字体宏包 \\ \pkg{newtxtext},\pkg{newtxmath} & \pkg{txfonts} 的改进版本，分别设置文本和数学字体 \\ \pkg{newpxtext},\pkg{newpxmath} & \pkg{pxfonts} 的改进版本，分别设置文本和数学字体 \\ - \pkg{mathptmx} & \pkg{psnfss} 组件之一，Times 风格，较为陈旧，不推荐使用 \\ - \pkg{mathpazo} & \pkg{psnfss} 组件之一，Palatino 风格，较为陈旧，不推荐使用 \\ - \pkg{ccfonts} & Concrete 风格字体 \\ - \pkg{euler} & Euler 风格数学字体，也出自于高德纳之手 \\ - \pkg{fourier} & fourier 风格数学字体 \\ - \pkg{arev} & Arev 风格的无衬线字体 \\ - \pkg{cmbright} & 仿 Computer Modern 风格的无衬线字体 \\ - \pkg{libertine} & Linux Libertine 衬线字体 \\ - \pkg{droid} & Droid Serif/Droid Sans 等 \\ - \pkg{inconsolata} & Inconsolata 一款不错的开源等宽字体 \\ + \pkg{mathptmx} & \pkg{psnfss} 字体宏集之一，Times 风格，较为陈旧，不推荐使用 \\ + \pkg{mathpazo} & \pkg{psnfss} 字体宏集之一，Palatino 风格，较为陈旧，不推荐使用 \\ + \pkg{fourier} & fourier 风格数学字体，配合 Utopia 正文字体 \\ + \pkg{fouriernc} & fourier 风格数学字体，配合 New Century Schoolbook 正文字体 \\ + \pkg{arev} & Arev 无衬线字体宏包，Vera Sans 风格 \\ + \pkg{mathdesign} & 配合 Charter/Garamond/Utopia 正文字体的数学字体宏包（Garamond 字体可能需要单独安装） \\ + \hline + \multicolumn{2}{c}{文本字体宏包} \\ + \multicolumn{2}{l}{\small 以下字体包括传统的 \LaTeX\ 字体格式以及 TrueType / OpenType 格式。} \\ + \hline + \pkg{dejavu} & DejaVu 开源字体 \\ + \pkg{droid} & Droid 开源字体 \\ + \pkg{inconsolata} & Inconsolata 开源等宽字体 \\ + \pkg{libertine} & Linux Libertine / Linux Biolium 开源字体 \\ + \pkg{roboto} & Roboto 开源无衬线字体 \\ \pkg{sourcesanspro} & Source Sans Pro 开源无衬线字体 \\ \pkg{sourcecodepro} & Source Code Pro 开源等宽字体 \\ + \hline + \multicolumn{2}{c}{符号宏包} \\ + \hline \pkg{mathabx} & 数学符号宏包之一 \\ \pkg{MnSymbol} & 数学符号宏包之一 \\ \pkg{fdsymbol} & 数学符号宏包之一 \\ - \pkg{mathdesign} & 配合 Charter/Garamond/Utopia 正文字体的数学字体宏包（Garamond 字体可能需要单独安装） \\ + \pkg{pifont} & Zapf Dingbats 符号字体宏包 \\ \hline -\end{tabular*} -\end{minipage} +\end{tabularx} \end{table} -\subsection{\texttt{xelatex} 命令下使用 \pkg{fontspec} 宏包更改字体}\label{subsec:fontspec} +\subsection{使用 \pkg{fontspec} 宏包更改字体 (\texttt{xelatex})}\label{subsec:fontspec} \index{xelatex@\texttt{xelatex} 命令} \texttt{xelatex} 编译命令能够支持直接调用系统安装的 \texttt{.ttf} 或 \texttt{.otf} 格式字体% @@ -193,7 +207,7 @@ He likes {\LARGE large and \pkgindex{fontspec} \cmdindex[fontspec]{setmainfont,setsansfont,setmonofont} \texttt{xelatex} 命令下支持用户调用字体的宏包是 \pkg{fontspec}。宏包提供了几个设置全局字体的命令，设置 \cmd{rmfamily} 等对应命令的默认字体% -\footnote{新版本 \pkg{fontspec} 的命令支持把必选参数 \Arg{font name} 放在可选参数 \Arg{font features} 的前面。}： +\footnote{新版本 \pkg{fontspec} 的命令支持（并且推荐）把必选参数 \Arg{font name} 放在可选参数 \Arg{font features} 的前面。}： \begin{command} \cmd{setmainfont}\oarg{font features}\marg{font name} \\ \cmd{setsansfont}\oarg{font features}\marg{font name} \\ @@ -253,7 +267,7 @@ He likes {\LARGE large and 表示基础长度为 \texttt{12pt}，可以伸展到 \texttt{14pt} ，也可以收缩到 \texttt{9pt}。 也可只定义 \texttt{plus} 或者 \texttt{minus} 的部分，如 \texttt{0pt plus 5pt}。 -长度的数值还可以用长度变量的倍数来表达，如 \texttt{2.5}\cmd{parindent} 等。 +长度的数值还可以用长度变量本身或其倍数来表达，如 \texttt{2.5}\cmd{parindent} 等。 \cmdindex{newlength,setlength,addtolength} \LaTeX\ 预定义了大量的长度变量用于控制版面格式。如页面宽度和高度、首行缩进、段落间距等。 @@ -278,15 +292,15 @@ He likes {\LARGE large and \cmd{linespread}\marg{factor} \end{command} -此处的行距，指的是基本行距（相当于 \cmd{fontsize} 命令的第二个参数）而不是字号大小。所以设置 1.5 倍行距的命令 \cmd{line\-spread}\marg*{1.5} -意味着最终行距为 1.8 倍的字号大小。 +这里的 \Arg{factor} 是在基础行距上而不是字号上乘以一个因子。大部分时候，默认的基础行距是 1.2 倍字号大小（参考 \cmd{fontsize} 命令）， +因此设置 1.5 倍行距的命令 \cmd{line\-spread}\marg*{1.5} 意味着最终行距为 1.8 倍的字号大小。 \cmdindex{selectfont} 如果不是在导言区全局修改，而想要局部地改变某个段落的行距，需要用 \cmd{select\-font} 命令使 \cmd{line\-spread} 命令的改动立即生效： \begin{example} {\linespread{2.0}\selectfont -The baseline skip is set to twice -the normal baseline skip. +The baseline skip is set to be +twice the normal baseline skip. Pay attention to the \verb|\par| command at the end. \par} @@ -319,26 +333,16 @@ But remember I am a liar.}\par \cmd{setlength}\marg*{\cmd{parindent}}\marg*{2em} \end{command} -它们和设置字号的命令一样，在分段时生效。 +它们和设置行距的命令一样，在分段时生效。 \cmdindex{indent,noindent} \LaTeX\ 默认在段落开始时缩进，长度为你用上述命令设置的 \cmd{parindent}。如果你在某一段不想使用缩进，可使用某一段开头使用 -\begin{command} -\cmd{noindent} -\end{command} -命令。相反地， -\begin{command} -\cmd{indent} -\end{command} -命令强制开启一段首行缩进的段落。多个 \cmd{indent} 命令的效果可以累加。 +\cmd{noindent} 命令。相反地，\cmd{indent} 命令强制开启一段首行缩进的段落。多个 \cmd{indent} 命令可以累加缩进量。 \pkgindex{indentfirst} -\LaTeX\ 还默认\textbf{在 \cmd{chapter}、\cmd{section} 等章节命令之后的第一段不缩进}% -\footnote{\pkg{ctex} 宏包默认按照中文习惯保持第一段的首行缩进。}。 -如果不习惯这种设定，可以调用 \pkg{indent\-first} 宏包： -\begin{verbatim} -\usepackage{indentfirst} -\end{verbatim} +\LaTeX\ 还默认\textbf{在 \cmd{chapter}、\cmd{section} 等章节标题命令之后的第一段不缩进}% +\footnote{\pkg{ctex} 宏包和文档类默认按照中文习惯保持标题后第一段的首行缩进。}。 +如果不习惯这种设定，可以调用 \pkg{indent\-first} 宏包，令第一段的首行缩进照常。 \cmdindex{parskip} 段落间的垂直间距为 \cmd{parskip}，如设置段落间距在 \texttt{0.8ex} 到 \texttt{1.5ex} 变动： @@ -349,7 +353,7 @@ But remember I am a liar.}\par \subsection{水平间距}\label{subsec:hspace} \cmdindex{hspace} -\LaTeX 默认为单词之间增添了水平间距。如果想要手动插入额外的间距，需要用到如下命令： +\LaTeX 默认为将单词之间的“空格”转化为水平间距。如果需要在文中手动插入额外的水平间距，可使用如下命令： \begin{command} \cmd{hspace}\marg{length} \end{command} @@ -359,14 +363,15 @@ of 1.5 cm. \end{example} \cmdindex{hspace*} -\cmd{hspace} 命令生成的间距如果位于一行的开头或末尾，则有可能因为断行而被“吞掉”。可使用 \cmd{hspace*} 命令代替 \cmd{hspace} 命令 +\cmd{hspace} 命令生成的水平间距如果位于一行的开头或末尾，则有可能因为断行而被“吞掉”。可使用 \cmd{hspace*} 命令代替 \cmd{hspace} 命令 得到不会因断行而消失的水平间距。 \cmdindex{stretch,fill} -命令 \cmd{stretch}\marg{n} 生成一个特殊弹性长度，参数 \Arg{n} 为权重。它的基础长度为零，但可以无限延伸，直到占满可用的空间。 +命令 \cmd{stretch}\marg{n} 生成一个特殊弹性长度，参数 \Arg{n} 为权重。它的基础长度为 0pt，但可以无限延伸，直到占满可用的空间。 如果同一行内出现多个 \cmd{stretch}\marg{n}，这一行的所有可用空间将按每个 \cmd{stretch} 命令给定的权重 \Arg{n} 进行分配。 -命令 \cmd{fill} 相当于 \cmd{stretch}\marg*{1}。 +命令 \cmd{fill} 相当于 \cmd{stretch}\marg*{1}% +\footnote{注意不要用 \texttt{1.5}\cmd{fill} 这样的用法，它生成的长度只有基础长度 0pt 而没有延伸部分。}。 \begin{example} x\hspace{\stretch{1}} @@ -375,8 +380,8 @@ x\hspace{\fill}x \end{example} \cmdindex{quad,qquad} -在正文中用 \cmd{hspace} 命令生成水平间距时，往往使用 \texttt{em} 作为单位，它会随字号大小而变。 -我们常用 \cmd{quad} 和 \cmd{qquad} 命令方便地生成水平间距，相当于 \cmd{hspace}\marg*{1em} 和 \cmd{hspace}\marg*{2em}： +在正文中用 \cmd{hspace} 命令生成水平间距时，往往使用 \texttt{em} 作为单位，生成的间距随字号大小而变。 +我们在数学公式中见过 \cmd{quad} 和 \cmd{qquad} 命令，它们也可以用于文本中，分别相当于 \cmd{hspace}\marg*{1em} 和 \cmd{hspace}\marg*{2em}： \begin{example} {\Large big\hspace{1em}y}\\ @@ -421,13 +426,14 @@ between lines in a paragraph. \section{页面和分栏}\label{sec:page-columns} -我们不妨回顾一下第一章介绍的文档类属性。\LaTeX\ 允许你通过文档类选项控制纸张的大小（见表 \ref{tbl:ltx-options}）， +我们不妨回顾一下第一章介绍的文档类属性。\LaTeX\ 允许你通过为文档类指定选项来控制纸张的大小（见表 \ref{tbl:ltx-options}）， 包括 \texttt{a4paper}、\texttt{letterpaper}等等，并配合字号设置了适合的页边距。 \cmdindex{textheight,textwidth} 控制页边距的参数由图 \ref{fig:layouts} 里给出的各种长度变量控制。 可以用 \cmd{setlength} 命令修改这些长度变量，以达到调节页面尺寸和边距的作用； -反之也可以利用这些长度变量来决定排版内容的尺寸，如设置图片或表格的宽度为 0.8\cmd{textwidth}。 +反之也可以利用这些长度变量来决定排版内容的尺寸，如在 \env{tabularx} 环境或 \cmd{include\-graphics} 命令的参数里， +设置图片或表格的宽度为 0.8\cmd{textwidth}： \begin{figure}[!p] \centering @@ -528,6 +534,10 @@ between lines in a paragraph. 切换单/双栏排版时总是会另起一页（\cmd{clearpage}）。 在双栏模式下使用 \cmd{newpage} 会换栏而不是换页；\cmd{clearpage} 则能够换页。 +\cmdindex{columnwidth,columnsep,columnseprule} +双栏排版时每一栏的宽度为 \cmd{columnwidth}，它由 \cmd{textwidth} 减去 \cmd{columnsep} 的差除以 2 得到。 +两栏之间还有一道竖线，宽度为 \cmd{columnseprule}，默认为零，也就是看不到竖线。 + \pkgindex{multicol} \envindex[multicol]{multicols} 一个比较好用的分栏解决方案是 \pkg{multicol}，它提供了简单的 \env{multicols} 环境 @@ -543,7 +553,7 @@ between lines in a paragraph. \pkgindex{float} \pkg{multicol} 宏包能够在一页之中切换单栏/多栏，也能处理跨页的分栏，且各栏的高度分布平衡。但代价是% \textbf{在 \env{multicols} 环境中无法正常使用 \env{table} 和 \env{figure} 等浮动体环境}，它会直接让浮动体丢失。 -\env{multicols} 环境中只能用跨栏的 \env{table*} 和 \env{figure*} ，或者用 \pkg{float} 宏包提供的 \texttt{H} 选项固定浮动体的位置。 +\env{multicols} 环境中只能用跨栏的 \env{table*} 和 \env{figure*} 环境，或者用 \pkg{float} 宏包提供的 \texttt{H} 参数固定浮动体的位置。 \section{页眉页脚}\label{sec:pagestyle} @@ -569,9 +579,9 @@ between lines in a paragraph. \begin{tabularx}{0.8\textwidth}{lX} \hline \texttt{empty} & 页眉页脚为空 \\ - \texttt{plain} & 页眉为空，页脚为页码。（article 和 report 文档类默认；book 文档类的每章第一页也为 plain 格式） \\ + \texttt{plain} & 页眉为空，页脚为页码。（\cls{article} 和 \cls{report} 文档类默认；\cls{book} 文档类的每章第一页也为 plain 格式） \\ \hline - \texttt{headings} & 页眉为章节标题和页码，页脚为空。（book 文档类默认） \\ + \texttt{headings} & 页眉为章节标题和页码，页脚为空。（\cls{book} 文档类默认） \\ \texttt{myheadings} & 页眉为页码及 \cmd{markboth} 和 \cmd{markright} 命令手动指定的内容，页脚为空。\\ \hline \end{tabularx} @@ -581,9 +591,9 @@ between lines in a paragraph. 其中 \texttt{headings} 的情况较为复杂： \begin{description} \item[\cls{article} 文档类，\texttt{twoside} 选项：] 偶数页为页码和节标题，奇数页为小节标题和页码； - \item[\cls{article} 文档类，\texttt{oneside} 选项：] 同 \texttt{twoside} 选项的奇数页页眉； + \item[\cls{article} 文档类，\texttt{oneside} 选项：] 页眉为节标题和页码； \item[\cls{book/report} 文档类，\texttt{twoside} 选项：] 偶数页为页码和章标题，奇数页为节标题和页码； - \item[\cls{book/report} 文档类，\texttt{oneside} 选项：] 同 \texttt{twoside} 选项的奇数页页眉。 + \item[\cls{book/report} 文档类，\texttt{oneside} 选项：] 页眉为章标题和页码。 \end{description} \subsection{手动更改页眉页脚的内容}\label{subsec:marks} @@ -600,7 +610,7 @@ between lines in a paragraph. 事实上 \cmd{chapter}、\cmd{section} 等命令内部也使用 \cmd{mark\-both} 或者 \cmd{mark\-right} 写页眉。 \LaTeX\ 默认将页眉的内容都转为大写字母。如果你不喜欢这样，可以尝试以下代码 -（相关命令的用法参照 \ref{sec:newcommands} 节）% +（相关命令的用法参照 \ref{subsec:newcmd} 节）% \footnote{但是这不能改变页眉的斜体样式（\cmd{slshape}），斜体是定义在 \texttt{headings} 样式里的。 如果不喜欢斜体，可在 \cmd{mark\-both} 等命令的参数里先使用 \cmd{normal\-font} ，再使用想要的字体样式命令， 或直接尝试使用 \pkg{fancyhdr} 宏包。}： @@ -612,7 +622,7 @@ between lines in a paragraph. \end{verbatim} 其中 \cmd{thechapter}、\cmd{thesection} 等命令为章节计数器的数值（详见 \ref{sec:counters} 节）。以上代码适用于 \cls{report/book} 文档类。 -对于 \cls{article} 文档类，与两个页眉相关的命令分别为 \cmd{sec\-tion\-mark} 和 \cmd{sub\-sec\-tion\-mark} 。 +对于 \cls{article} 文档类，与两个页眉相关的命令分别为 \cmd{sec\-tion\-mark} 和 \cmd{sub\-sec\-tion\-mark}。 \subsection{\pkg{fancyhdr} 宏包}\label{subsec:fancyhdr} diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.06.spec.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.06.spec.tex index f4c5418e2f4..cfaf0b19ace 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.06.spec.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.06.spec.tex @@ -1,4 +1,4 @@ -\chapter{特色工具和功能} +\chapter{特色工具和功能}\label{chap:spec} \addtocontents{los}{\protect\addvspace{10pt}} \begin{intro} @@ -6,9 +6,9 @@ 之后的使用颜色、超链接等则令我们生成美观易用的电子文档。 \end{intro} -\section{参考文献和 \hologo{BibTeX} 工具} +\section{参考文献和 \hologo{BibTeX} 工具}\label{sec:bib} -\subsection{基本的参考文献和引用} +\subsection{基本的参考文献和引用}\label{subsec:bib-basics} \pinyinindex{cankaowenxian}{参考文献} \LaTeX\ 提供的参考文献和引用方式比较原始，需要用户自行书写参考文献列表。不同学术论文对参考文献列表的格式要求不一样， @@ -20,20 +20,25 @@ \cmd{cite}\marg{citation} \end{command} -\cmd{cite} 带一个可选参数，为引用的编号后加上额外的内容，如 \cmd{cite}\oarg*{page 22}\marg{pa} 可能得到形如 [13, page 22] 这样的引用。 +\Arg{citation} 为引用的参考文献的标签，类似 \cmd{ref} 里的参数；\cmd{cite} 带一个可选参数，为引用的编号后加上额外的内容， +如 \cmd{cite}\oarg*{page 22}\marg{pa} 可能得到形如 [13, page 22] 这样的引用。 \envindex{thebibliography} +\cmdindex{bibitem} 参考文献由 \env{thebibliography} 环境包裹。每条参考文献由 \cmd{bibitem} 开头，其后是参考文献本身的内容： \begin{command} \cmd{bibitem}\oarg{item number}\marg{citation} \end{command} -其中 \Arg{citation} 是 \cmd{cite} 用以引用的一个标签，类似交叉引用里的 \cmd{label}。 +其中 \Arg{citation} 是 \cmd{cite} 使用的文献标签， \Arg{item number} 自定义参考文献的序号，如果省略，则按自然排序给定序号。 -\env{thebibliography} 环境带一个参数，用以设定 \cmd{cite} 命令生成的引用编号的最大宽度， +\env{thebibliography} 环境带一个参数，用以设定 \cmd{bibitem} 命令生成的参考文献编号的宽度， 如 99 意味着不超过两位数字。通常设定为与参考文献的数目一致。 -\env{the\-biblio\-graphy} 环境自动生成不带编号的一章（\cls{report} / \cls{book} 文档类）或一节（\cls{article} 文档类）。 + +\env{thebibliography} 环境自动生成不带编号的一节（\cls{article} 文档类）或一章（\cls{report} / \cls{book} 文档类）。 +在 \cls{article} 文档类的节标题默认为 ``Reference''{}，而在 \cls{report / book} 文档类 +的章标题默认为 ``Bibliography''{}。用户可通过 \ref{sec:latex-settings} 节给出的方法定制参考文献的标题。 以下为一个使用 \env{the\-biblio\-graphy} 排版参考文献的例子： @@ -50,11 +55,11 @@ Partl~\cite{pa} has proposed that \ldots \end{document} \end{verbatim} -\subsection{\hologo{BibTeX} 数据库} +\subsection{\hologo{BibTeX} 数据库}\label{subsec:bibtex-data} \index{bibtexdb@\protect\hologo{BibTeX} 数据库} -\hologo{BibTeX} 是最为流行的参考文献数据组织格式之一。它的出现让我们摆脱手写参考文献条目的麻烦。我们还可以通过参考文献格式的支持， -让同一份 \hologo{BibTeX} 数据库生成不同格式的参考文献列表。我们首先简单介绍 \hologo{BibTeX} 数据库，之后介绍如何将数据库利用在 \LaTeX\ 中。 +\hologo{BibTeX} 是最为流行的参考文献数据组织格式之一。它的出现让我们摆脱手写参考文献条目的麻烦。我们还可以通过参考文献样式的支持， +让同一份 \hologo{BibTeX} 数据库生成不同样式的参考文献列表。 \hologo{BibTeX} 数据库以 \texttt{.bib} 作为扩展名，其内容是若干个文献条目，每个条目的格式为： \begin{command} @@ -65,70 +70,108 @@ Partl~\cite{pa} has proposed that \ldots \texttt\} \end{command} -其中 \Arg{type} 为参考文献的类型，如 \texttt{article} 为学术论文，\texttt{book} 为书籍，\texttt{in\-collection} 为论文集中的某一篇，等等。 -\Arg{citation} 为 \cmd{cite} 命令所用的参考文献的标签。在 \Arg{citation} 之后为条目里的各个数据项，以 \Arg{key} = \marg{value} 的形式组织。 +其中 \Arg{type} 为文献的类别，如 \texttt{article} 为学术论文，\texttt{book} 为书籍，\texttt{in\-collection} 为论文集中的某一篇，等等。 +\Arg{citation} 为 \cmd{cite} 命令使用的文献标签。在 \Arg{citation} 之后为条目里的各个数据项，以 \Arg{key} = \marg{value} 的形式组织。 -我们在此简单列举学术论文里使用较多的 \hologo{BibTeX} 文献条目格式。所有条目格式参考 \CTAN|biblio/bibtex/base/btxdoc.pdf|。 +我们在此简单列举学术论文里使用较多的 \hologo{BibTeX} 文献条目类别： \begin{description} - \item[\texttt{article}] 学术论文，必需数据项有 author, title, journal, year; 可选数据项包括 volumn, issue, number, pages, doi 等； + \item[\texttt{article}] 学术论文，必需数据项有 author, title, journal, year; 可选数据项包括 volumn, number, pages, doi 等； \item[\texttt{book}] 书籍，必需数据项有 author/editor, title, publisher, year; 可选数据项包括 volumn/number, series, address 等； \item[\texttt{incollection}] 论文集中的一篇，必需数据项有 author, title, booktitle, publisher, year; 可选数据项包括 editor, volumn/number, chapter, pages, address 等； \item[\texttt{inbook}] 书中的一章，必需数据项有 author/editor, title, chapter/pages, publisher, year; 可选数据项包括 volumn/number, series, address 等。 \end{description} +例如 \texttt{article} 类别的参考文献数据条目写法如下： +\begin{verbatim} +@article{Alice13, + title = {Demostration of bibliography items}, + author = {A. Alice and B. Bob and C. Charlie and D. Danny}, + year = {2013}, + journal = {Journal of \TeX perts}, + volume = {36}, + number = {7}, + pages = {114-120}} +\end{verbatim} +所有类别的文献条目格式请参考 \CTAN|biblio/bibtex/base/btxdoc.pdf|。 + 多数时候，我们无需自己手写 \hologo{BibTeX} 文献条目。从 Google Scholar 或者期刊/数据库的网站上都能够导出 \hologo{BibTeX} 文献条目， 老牌的文献管理软件 EndNote 也支持生成 \hologo{BibTeX} 格式的数据库。开源软件 JabRef 甚至支持 \hologo{BibTeX} 文献条目的导入、导出和管理。 -\subsection{使用 \hologo{BibTeX} 排版参考文献}\label{subsec:bibtex-use} - -\index{bibtex@\protect\hologo{BibTeX} 工具} -现在我们来看如何利用 \hologo{BibTeX} 数据库生成参考文献和引用。 - -第一步：我们当然需要一份 \hologo{BibTeX} 数据库，假设起名为 \texttt{books.bib} ，和我们的 \LaTeX\ 源代码\textbf{一般位于同一个目录下}。 +\subsection{\hologo{BibTeX} 样式}\label{subsec:bibtex-style} -\begin{sourcecode}[htp] -\begin{Verbatim} -@book{Lamport1994, - title = {{\LaTeX}: A Document Preparation System}, - author = {Lamport, L.}, - publisher = {Addison-Wesley}, - address = {Reading, Massachusetts}, - year = {1994}, - edition = {2nd} -} -@book{Mittelbach2004, - title = {The {\LaTeX} Companion}, - author = {Mittelbach, F. and Goossens, M. and - Braams, J. and Carlisle, D. and Rowley, C.}, - publisher = {Addison-Wesley}, - address = {Reading, Massachusetts}, - year = {2004}, - edition = {2nd} -} -\end{Verbatim} -\caption{\hologo{BibTeX} 数据库示例 \texttt{books.bib}。} -\end{sourcecode} +参考文献的写法在不同文献里千差万别，包括作者、标题、年份等各项的顺序和字体样式、文献在列表中的排序规则等。 +\hologo{BibTeX} 用样式（style）来管理参考文献的写法。\hologo{BibTeX} 提供了几个预定义的样式，如 plain, unsrt, alpha 等。 +如果使用期刊模板的话，可能会提供自用的样式。 +样式文件以 \texttt{.bst} 为扩展名。 \cmdindex{bibliographystyle} -第二步：在源代码中添加必要的命令。假设源代码的名称为 \texttt{demo.tex}。首先需要的是在\textbf{导言区}设定参考文献的格式： +使用样式文件的方法是在源代码内（一般在导言区）使用 \cmd{biblio\-graphy\-style} 命令： \begin{command} \cmd{bibliographystyle}\marg{bst-name} \end{command} +这里 \Arg{bst-name} 为 \texttt{.bst} 样式文件的名称，\textbf{不要带 \texttt{.bst} 扩展名}。 + +我们以 \ref{subsec:bibtex-data} 小节给出的数据条目为例，使用 \cmd{biblio\-graphy\-style} 命令选择不同的参考文献样式， +效果大致如表 \ref{tbl:bibtex-style} 所示。 + +\begin{table}[htp] +\caption{\hologo{BibTeX} 样式的排版效果。}\label{tbl:bibtex-style} +\hrule +\begin{trivlist}\item\relax +\textbf{plain}\\{} +[1] A.~Alice, B.~Bob, C.~Charlie, and D.~Danny. +\newblock Demostration of bibliography items. +\newblock {\em Journal of \TeX perts}, 36(7):114--120, 2013. + +\medskip +\textbf{alpha}\\{} +[ABCD13] A.~Alice, B.~Bob, C.~Charlie, and D.~Danny. +\newblock Demostration of bibliography items. +\newblock {\em Journal of \TeX perts}, 36(7):114--120, 2013. + +\medskip +\textbf{amsplain}（\AmS\ 文档类 \textsf{amsart} 等配套的样式）\\{} +[1] A.~Alice, B.~Bob, C.~Charlie, and D.~Danny, \emph{Demostration of bibliography + items}, Journal of \TeX perts \textbf{36} (2013), no.~7, 114--120. + +\medskip +\textbf{elsarticle-num}（Elsevier 提供的 \textsf{elsarticle} 文档类配套的样式）\\{} +[1] A.~Alice, B.~Bob, C.~Charlie, D.~Danny, Demostration of bibliography items, + Journal of \TeX perts 36~(7) (2013) 114--120. + +\medskip +\textbf{IEEEtran}（\textsf{IEEEtran} 模板文档类配套的样式）\\{} +[1] A.~Alice, B.~Bob, C.~Charlie, and D.~Danny, ``Demostration of bibliography + items,'' \emph{Journal of \TeX perts}, vol.~36, no.~7, pp. 114--120, 2013. +\end{trivlist} +\hrule +\end{table} + +\subsection{使用 \hologo{BibTeX} 排版参考文献}\label{subsec:bibtex-use} -其中 \Arg{bst-name} 为格式文件的名称。\hologo{BibTeX} 提供了几个预定义的格式，如 plain, unsrt, alpha 等。 -一些学术论文的模板会提供自有的格式文件，以 \texttt{.bst} 作为扩展名，同样和 \LaTeX\ 源代码\textbf{放在同一个目录下}。 +\index{bibtex@\protect\hologo{BibTeX} 工具} +现在我们来看如何利用 \hologo{BibTeX} 数据库生成参考文献和引用。 -\cmdindex{cite,nocite} -其次就是在正文中引用参考文献了。\hologo{BibTeX} 程序在生成参考文献列表的时候，通常只列出你用 \cmd{cite} 命令引用的那些。 -如果需要列出没有被引用的文献，则需要 \cmd{nocite}\marg{citation} 命令；而 \cmd{nocite}\marg*{*} 则让所有未引用的参考文献都列出。 +第一步：我们当然需要一份 \hologo{BibTeX} 数据库，假设数据库文件名为 \texttt{books.bib}， +和 \LaTeX\ 源代码\textbf{一般位于同一个目录下}。 -\cmdindex{bibliography} +第二步：在源代码中添加必要的命令。假设源代码名为 \texttt{demo.tex}（见 \ref{code:bibtex-demo}）。 +\begin{enumerate} +\item \cmdindex{bibliographystyle} +首先需要使用命令 \cmd{bibliographystyle} 设定参考文献的格式。 + +\item \cmdindex{cite,nocite} +其次，在正文中引用参考文献。\hologo{BibTeX} 程序在生成参考文献列表的时候，通常只列出用了 \cmd{cite} 命令引用的那些。 +如果需要列出未被引用的文献，则需要 \cmd{nocite}\marg{citation} 命令；而 \cmd{nocite}\marg*{*} 则让所有未被引用的文献都列出。 + +\item \cmdindex{bibliography} 再次，在你需要列出参考文献的位置，使用 \cmd{biblio\-graphy} 命令代替 \env{the\-biblio\-graphy} 环境： \begin{command} \cmd{bibliography}\marg{bib-name} \end{command} 其中 \Arg{bib-name} 是 \hologo{BibTeX} 数据库的文件名，\textbf{不要带 \texttt{.bib} 扩展名}。 +\end{enumerate} \begin{sourcecode}[htp] \begin{Verbatim} @@ -136,13 +179,13 @@ Partl~\cite{pa} has proposed that \ldots \bibliographystyle{plain} \begin{document} \section{Some words} -Some excellent books, for example, \cite{Lamport1994} -and \cite{Mittelbach2004} \ldots +Some excellent books, for example, \cite{citation1} +and \cite{citation2} \ldots \bibliography{books} \end{document} \end{Verbatim} -\caption{利用 \texttt{books.bib} 生成参考文献的源代码 \texttt{demo.tex}。} +\caption{利用 \texttt{books.bib} 生成参考文献的源代码 \texttt{demo.tex}。}\label{code:bibtex-demo} \end{sourcecode} 注意：\cmd{bibliographystyle} 和 \cmd{bibliography} 命令缺一不可，没有这两个命令，使用 \hologo{BibTeX} 生成参考文献列表的时候会报错。 @@ -150,26 +193,26 @@ and \cite{Mittelbach2004} \ldots 第三步：写好了以上两个文件之后，我们就可以开始编译了。 \begin{enumerate} \item 首先使用 \texttt{pdflatex} 或 \texttt{xelatex} 等命令编译 \LaTeX\ 源代码 \texttt{demo.tex}； - \item 接下来用 \texttt{bibtex} 命令处理 \texttt{demo.aux} 文件记录的参考文献格式、引用条目等信息。 + \item 接下来用 \texttt{bibtex} 命令处理 \texttt{demo.aux} 辅助文件记录的参考文献格式、引用条目等信息。 \texttt{bibtex} 命令处理完毕后会生成 \texttt{demo.bbl} 文件，内容就是一个 \env{thebibliography} 环境； \item 再使用 \texttt{pdflatex} 或 \texttt{xelatex} 等命令把源代码 \texttt{demo.tex} 编译\textbf{两遍}，读入参考文献并正确生成引用。 \end{enumerate} 整个过程使用的命令如下（可以略去扩展名）： \begin{verbatim} -pdflatex demo +xelatex demo bibtex demo -pdflatex demo -pdflatex demo +xelatex demo +xelatex demo \end{verbatim} 使用 \texttt{latex + dvipdfmx} 命令编译时，则 \texttt{dvipdfmx} 命令放在最后，相当于先后使用 \texttt{latex}, \texttt{bibtex}, \texttt{latex}, \texttt{latex}, \texttt{dvipdfmx}。 -\subsection{\pkg{natbib} 宏包} +\subsection{\pkg{natbib} 宏包}\label{subsec:natbib} \pkgindex{natbib} -时下许多学术期刊比较喜欢使用人名——年份的引用方式，形如(\emph{Alice et~al.}, 2005)。 +时下许多学术期刊比较喜欢使用人名——年份的引用方式，形如(\emph{Alice et~al.}, 2013)。 \pkg{natbib} 宏包提供了对这种“自然”引用方式的处理。 \cmdindex[natbib]{citep,citet} @@ -179,7 +222,7 @@ pdflatex demo \cmd{citet}\marg{citation} \end{command} -它们分别生成形如(\emph{Alice et~al.}, 2005) 和 \emph{Alice et~al.}(2005) 的人名——年份引用。 +它们分别生成形如(\emph{Alice et~al.}, 2013) 和 \emph{Alice et~al.} (2013) 的人名——年份引用。 \pkg{natbib} 宏包同样也支持数字引用，并且支持将引用的序号压缩，例如： \begin{verbatim} @@ -187,7 +230,7 @@ pdflatex demo \end{verbatim} 调用 \pkg{natbib} 宏包时指定以上选项后，连续引用多篇文献时，会生成形如 (3-7) 的引用而不是 (3, 4, 5, 6, 7)。 -\pkg{natbib} 宏包还有更多选项和用法，比如默认的引用是用小括号包裹的，可以为宏包添加 \texttt{square} 选项改为中括号； +\pkg{natbib} 宏包还有更多选项和用法，比如默认的引用是用小括号包裹的，可指定 \texttt{square} 选项改为中括号； 再比如 \cmd{citep} 命令也支持可选参数，为引用前后都添加额外内容。这里不再赘述，请参考 \pkg{natbib} 宏包的帮助文档。 \section{索引和 makeindex 工具}\label{sec:index} @@ -216,7 +259,7 @@ pdflatex demo 第三步，编译过程： \begin{enumerate} - \item 首先用 \texttt{pdflatex} 等命令编译源代码 \texttt{demo.tex}。编译过程中产生索引记录文件 \texttt{demo.idx}； + \item 首先用 \texttt{xelatex} 等命令编译源代码 \texttt{demo.tex}。编译过程中产生索引记录文件 \texttt{demo.idx}； \item 用 makeindex 程序处理 \texttt{demo.idx}，生成用于排版的索引列表文件 \texttt{demo.ind}； \item 再次编译源代码 \texttt{demo.tex}，正确生成索引列表。 \end{enumerate} @@ -266,7 +309,7 @@ pdflatex demo \end{tabular} \end{table} -读者可以钻研一下下面给出的一个较为复杂的，结合多级索引、索引格式、页码格式等的示例。但在自己使用时， +读者可以钻研一下以下给出的一个较为复杂的，结合多级索引、索引格式、页码格式等的用法示例。但在自己使用时， 最好还是遵循“简单的就是最好的”原则，尽量使用表 \ref{tbl:index-entry} 中的写法。 \begin{verbatim} Test index. @@ -282,7 +325,7 @@ Test index. \pinyinindex{yanse}{颜色} \LaTeX\ 原生不支持颜色，它依赖 \pkg{color} 宏包或者 \pkg{xcolor} 宏包，给 PDF 输出生成颜色的特殊指令。 -\subsection{颜色的表达方式} +\subsection{颜色的表达方式}\label{subsec:color-code} \pkgindex{color} \cmdindex[color/xcolor]{color} @@ -352,10 +395,11 @@ Test index. \cmd{definecolor}\marg{color-name}\marg{color-mode}\marg{code} \end{command} -如果调用 \pkg{color} 或 \pkg{xcolor} 宏包时指定 \texttt{dvipsnames} 选项，就有额外的 68 种颜色名称可用。 +如果调用 \pkg{color} 或 \pkg{xcolor} 宏包时指定 \texttt{dvipsnames} 选项，就有额外的 68 种颜色名称可用% +\footnote{\pkg{color} 宏包实际要指定 \texttt{dvipsnames} 和 \texttt{usenames} 选项。}。 \pkg{xcolor} 宏包还支持通过指定其它选项载入更多颜色名称。限于篇幅不展开介绍，详情请参考 \pkg{xcolor} 宏包的手册。 -\subsection{带颜色的文本和盒子} +\subsection{带颜色的文本和盒子}\label{subsec:colorbox} 原始的 \cmd{color} 命令类似于字体命令 \cmd{bfseries}，它使之后排版的内容全部变成指定的颜色， 所以直接使用时通常要加花括号分组。\pkg{color} / \pkg{xcolor} 宏包都定义了一些方便用户使用的带颜色元素。 @@ -413,12 +457,50 @@ PDF 文档格式是现今最流行的电子文档格式，而电子文档最实 而 \texttt{pdflatex} 或 \texttt{xelatex} 命令下不需要。 \cmdindex[hyperref]{hypersetup} -\pkg{hyperref} 宏包提供了命令 \cmd{hypersetup} 配置各种选项，或者也可以作为宏包选项，在调用宏包时使用： +\pkg{hyperref} 宏包提供了命令 \cmd{hypersetup} 配置各种参数，或者也可以作为宏包选项，在调用宏包时指定： \begin{command} \cmd{hypersetup}\marg*{\Arg{option1},\Arg{option2}=\marg*{value},\ldots} \\ \cmd{usepackage}\oarg*{\Arg{option1},\Arg{option2}=\marg*{value},\ldots}\marg*{hyperref} \end{command} +\begin{table}[htp] +\centering +\caption{\pkg{hyperref} 宏包提供的参数设置。}\label{tbl:hyperref-settings} +\begin{tabular}{lcp{19.5em}} + \hline + 参数 & 默认值 & \multicolumn{1}{c}{含义} \\ + \hline + \texttt{colorlinks=}\Arg{true\textnormal|false} + & \textit{false} & 设置为 \textit{true} 为链接文字带颜色，反之加上带颜色的边框 \\ + \texttt{hidelinks} & & 取消链接的颜色和边框 \\ + \texttt{pdfborder=}\marg*{\Arg{n} \Arg{n} \Arg{n}} + & 0 0 1 & 超链接边框设置，设为 0 0 0 可取消边框 \\ + \hline + \texttt{bookmarks=}\Arg{true\textnormal|false} + & \textit{true} & 是否生成书签 \\ + \texttt{bookmarksopen=}\Arg{true\textnormal|false} + & \textit{false} & 是否展开书签 \\ + \texttt{bookmarksnumbered=}\Arg{true\textnormal|false} + & \textit{false} & 书签是否带章节编号 \\ + \texttt{CJKbookmarks=}\Arg{true\textnormal|false} + & \textit{false} & 使用 \pkg{CJK} 宏包/ GBK 编码排版中文时必须设定的参数， + 在第一次编译后需要将生成的 \texttt{.out} 文件用工具处理编码 \\ + \texttt{unicode} & & 使用 \pkg{CJKutf8} 宏包/ UTF-8 编码排版中文时必须设定的参数 \\ + \hline + \texttt{pdftitle=}\Arg{string} + & 空 & 标题 \\ + \texttt{pdfauthor=}\Arg{string} + & 空 & 作者 \\ + \texttt{pdfsubject=}\Arg{string} + & 空 & 主题 \\ + \texttt{pdfkeywords=}\Arg{string} + & 空 & 关键词 \\ + \texttt{pdfstartview=}\Arg{Fit\textnormal|FitH\textnormal|FitV} + & \textit{Fit} & 设置 PDF 页面以适合页面/适合宽度/适合高度等方式显示，默认为适合页面 \\ + \hline +\end{tabular} +\end{table} + \subsection{超链接}\label{subsec:url-href} \cmdindex[hyperref]{url,nolinkurl} @@ -451,8 +533,8 @@ PDF 文档格式是现今最流行的电子文档格式，而电子文档最实 \cmd{hyperref}\oarg{label}\marg{text} \end{command} -默认的超链接在文字外边加上一个带颜色的方框（在打印 PDF 时边框不会打印），可指定 \texttt{color\-links} 选项修改为将文字本身加上颜色， -或指定 \texttt{pdf\-border} 选项的参数；\texttt{hide\-links} 选项则令超链接既不变色也不加框。 +默认的超链接在文字外边加上一个带颜色的边框（在打印 PDF 时边框不会打印），可指定 \texttt{color\-links} 参数修改为将文字本身加上颜色， +或修改 \texttt{pdf\-border} 参数调整边框宽度以“去掉”边框；\texttt{hide\-links} 参数则令超链接既不变色也不加边框。 \begin{verbatim} \hypersetup{hidelinks} % or: @@ -491,44 +573,7 @@ PDF 文档格式是现今最流行的电子文档格式，而电子文档最实 \subsection{PDF 文档属性}\label{subsec:pdf-settings} -\pkg{hyperref} 宏包还提供了一些选项用于改变 PDF 文档的属性，部分见表 \ref{tbl:hyperref-settings}。 +\pkg{hyperref} 宏包还提供了一些参数用于改变 PDF 文档的属性，部分见表 \ref{tbl:hyperref-settings}。 -\begin{table}[htp] -\centering -\caption{\pkg{hyperref} 宏包提供的设置。}\label{tbl:hyperref-settings} -\begin{tabular}{lcp{19.5em}} - \hline - 选项 & 默认值 & \multicolumn{1}{c}{含义} \\ - \hline - \texttt{colorlinks=}\Arg{true\textnormal|false} - & \textit{false} & 设置为 \textit{true} 为链接文字带颜色，反之加上带颜色的边框 \\ - \texttt{hidelinks} & & 取消链接的颜色和边框 \\ - \texttt{pdfborder=}\marg*{\Arg{n} \Arg{n} \Arg{n}} - & 0 0 1 & 超链接边框设置，设为 0 0 0 可取消边框 \\ - \hline - \texttt{bookmarks=}\Arg{true\textnormal|false} - & \textit{true} & 是否生成书签 \\ - \texttt{bookmarksopen=}\Arg{true\textnormal|false} - & \textit{false} & 是否展开书签 \\ - \texttt{bookmarksnumbered=}\Arg{true\textnormal|false} - & \textit{false} & 书签是否带章节编号 \\ - \texttt{CJKbookmarks=}\Arg{true\textnormal|false} - & \textit{false} & 使用 \pkg{CJK} 宏包/ GBK 编码排版中文时必须指定的选项， - 在第一次编译后需要将生成的 \texttt{.out} 文件用工具处理编码 \\ - \texttt{unicode} & & 使用 \pkg{CJKutf8} 宏包/ UTF-8 编码排版中文时必须指定的选项 \\ - \hline - \texttt{pdftitle=}\Arg{string} - & 空 & 标题 \\ - \texttt{pdfauthor=}\Arg{string} - & 空 & 作者 \\ - \texttt{pdfsubject=}\Arg{string} - & 空 & 主题 \\ - \texttt{pdfkeywords=}\Arg{string} - & 空 & 关键词 \\ - \texttt{pdfstartview=}\Arg{Fit\textnormal|FitH\textnormal|FitV} - & \textit{Fit} & 设置 PDF 页面以适合页面/适合宽度/适合高度等方式显示，默认为适合页面 \\ - \hline -\end{tabular} -\end{table} \endinput
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.07.graphic.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.07.graphic.tex index cc711ac878f..9692245611e 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.07.graphic.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.07.graphic.tex @@ -1,4 +1,4 @@ -\chapter{绘图功能} +\chapter{绘图功能}\label{chap:graphics} \addtocontents{los}{\protect\addvspace{10pt}} \begin{intro} @@ -12,18 +12,18 @@ \section{绘图语言简介}\label{sec:pict-lang} \LaTeX\ 提供了原始的 \env{picture} 环境，能够绘制一些基本的图形如点、线、矩形、圆、B\'ezier 曲线等等， -不过受制于 \LaTeX\ 本身，它的绘图功能极为有限，效果也往往不够美观。 +不过受制于 \LaTeX\ 本身，它的绘图功能极为有限，效果也不够美观。 现在流行的绘图代码有以下几种： \begin{itemize} \item PSTricks \par - 基于 PostSciprt 绘图方式的宏包，具有优秀的绘图能力。它对老式的 \texttt{latex + dvips} 编译命令支持最好， + 以 PostSciprt 语言的功能为基础的绘图宏包，具有优秀的绘图能力。它对老式的 \texttt{latex + dvips} 编译命令支持最好， 而现在的几种编译命令下使用起来都不够方便。 \item \TikZ\ \& \pkg{pgf} \par - 德国的 Till Tantau 在开发著名的 \LaTeX 幻灯片文档类 \cls{beamer} 时一并开发了绘图宏包 \pkg{pgf}， - 以令绘图语言能够在不同的编译方式下使用，如 \texttt{pdflatex} 和 \texttt{xelatex} 等。 - \TikZ\ 是在 \pkg{pgf} 基础上的一个封装，提供了方便的绘图语言，绘图能力不输 PSTricks。 + 德国的 Till Tantau 在开发著名的 \LaTeX\ 幻灯片文档类 \cls{beamer} 时一并开发了绘图宏包 \pkg{pgf}， + 目的是令其能够在 \texttt{pdflatex} 或 \texttt{xelatex} 等不同的编译命令下都能使用。 + \TikZ\ 是在 \pkg{pgf} 基础上封装的一个宏包，采用了类似 \hologo{METAPOST} 的语法，提供了方便的绘图命令，绘图能力不输 PSTricks。 \item \hologo{METAPOST} \& Asymptote \par \hologo{METAPOST} 脱胎于高德纳为 \TeX\ 配套开发的字体生成程序 \hologo{METAFONT}， @@ -36,7 +36,7 @@ 其复杂程度已远远超出入门手册的范围（\TikZ\ 的帮助文档有上千页之厚）。 对此感兴趣的读者需要自行查阅帮助手册，或者到互联网上参考现成的范例。 -\section{\TikZ}\label{sec:tikz} +\section{\TikZ\ 绘图语言}\label{sec:tikz} \index{TikZ@\TikZ} \pkgindex{tikz} @@ -46,15 +46,16 @@ \footnote{\texttt{latex + dvipdfmx} 编译方式要在 \pkg{tikz} 宏包之前调用 \pkg{graphicx} 宏包并指定 \texttt{dvipdfmx} 选项。}： \begin{command} \cmd{tikz}\oarg*{\ldots} \Arg{tikz code}\texttt{;} \\[1ex] +\cmd{tikz}\oarg*{\ldots} \marg*{\Arg{tikz code 1}\texttt{;} \Arg{tikz code 2}\texttt{;} \ldots} \\[1ex] \cmd{begin}\marg*{tikzpicture}\oarg*{\ldots} \\ \Arg{tikz code 1}\texttt{;} \\ -\Arg{tikz code 2}\texttt{;} \\ +\Arg{tikz code 2}\texttt{;}\ldots \\ \ldots \\ \cmd{end}\marg*{tikzpicture} \end{command} 前一种用法为 \cmd{tikz} 带单条绘图命令，以分号结束，一般用于在文字之间插入简单的图形； -后一种用法较为常见，使用多条绘图命令，可以在 \env{figure} 等浮动体中使用。 +后两种用法较为常见，使用多条绘图命令，可以在 \env{figure} 等浮动体中使用。 \subsection{\TikZ\ 坐标和路径}\label{subsec:tikz-path} @@ -78,6 +79,18 @@ \end{tikzpicture} \end{example} +坐标的表示形式还包括“垂足”形式： +\begin{example} +\begin{tikzpicture} +\coordinate (S) at (2,2); +\draw[gray] (-1,2) -- (S); +\draw[gray] (2,-1) -- (S); +\draw[red] (0,0) -- (0,0 -| S); +\draw[blue] (0,0) -- (0,0 |- S); +\end{tikzpicture} +\end{example} + + \TikZ\ 最基本的路径为两点之间连线，如 \texttt{(\Arg{$x_1$},\Arg{$y_1$}) -{}- (\Arg{$x_2$},\Arg{$y_2$})}，可以连用表示多个连线（折线）。 连续使用连线时，可以使用 \texttt{cycle} 令路径回到起点，生成闭合的路径。 \begin{example} @@ -101,13 +114,39 @@ \end{example} \begin{itemize} - \item 直角、圆弧： + \item 直角、圆弧、椭圆弧： \end{itemize} \begin{example} \begin{tikzpicture} \draw (0,0) |- (1,1); \draw (1,0) -| (2,1); \draw (4,0) arc (0:135:1); +\draw (6,0) arc (0:135:1 and 0.5); +\end{tikzpicture} +\end{example} + +\begin{itemize} + \item 正弦、余弦曲线（四分之一个周期）： +\end{itemize} +\begin{example} +\begin{tikzpicture} +\draw (0,0) sin (1.57,1); +\draw (0,1) sin (1.57,0); +\draw (2,1) cos (3.57,0); +\draw (2,0) cos (3.57,1); +\end{tikzpicture} +\end{example} + +\begin{itemize} + \item 抛物线，用 \texttt{bend} 控制顶点： +\end{itemize} +\begin{example} +\begin{tikzpicture} +\draw (0,0) parabola (1,2); +\draw (2,0) parabola + bend (2.25,-0.25) (3,2); +\draw (4,0) parabola + bend (4.75,2.25) (5,2); \end{tikzpicture} \end{example} @@ -127,7 +166,7 @@ \end{example} \begin{itemize} - \item 网格、函数图像，网格可用 \texttt{step} 选项控制网格大小，函数图像用 \texttt{domain} 选项控制定义域： + \item 网格、函数图像，网格可用 \texttt{step} 参数控制网格大小，函数图像用 \texttt{domain} 参数控制定义域： \end{itemize} \begin{example} \begin{tikzpicture} @@ -154,7 +193,18 @@ 绘图参数可作为可选参数用在 \env{tikzpiture} 环境或 \cmd{tikz} 命令时，参数会影响到所有具体的绘图命令； 用在单个绘图命令 \cmd{draw}、\cmd{filldraw} 等时，只对这个命令起效。 -\TikZ 有数不清的绘图参数，这些参数令 \TikZ\ 能够绘制丰富多彩的图像，同时也令 \TikZ\ 易学难精。 +\envindex[tikz]{scope} +\TikZ\ 还提供了 \env{scope} 环境，令一些绘图参数在局部起效： +\begin{example} +\begin{tikzpicture} +\draw (0,0) rectangle (2.5, 2.5); +\begin{scope}[fill=gray,scale=0.5] +\filldraw (0,0) rectangle (2.5, 2.5); +\end{scope} +\end{tikzpicture} +\end{example} + +\TikZ\ 有数不清的绘图参数，这些参数令 \TikZ\ 能够绘制丰富多彩的图像，同时也令 \TikZ\ 难以精通。 本手册仅总结常用的一些绘图参数，见表 \ref{tbl:tikz-options}。 \begin{table}[htp] @@ -166,7 +216,7 @@ 为线条（\cmd{draw}）或填充（\cmd{fill}）指定颜色，\Arg{color} 使用颜色名或是 \pkg{xcolor} 的混合颜色语法。 往往可以不写 \texttt{color=} 直接写颜色名称。 \item \texttt{fill=\Arg{color} / draw=\Arg{color}} \par - 分别给 \cmd{filldraw} 指定填充和描边的颜色。也可分别给 \cmd{fill} 和 \cmd{draw} 命令使用。 + 分别给 \cmd{filldraw} 指定填充和描边的颜色。也可给 \cmd{fill} 和 \cmd{draw} 命令使用。 不带参数直接使用 \texttt{fill} 和 \texttt{draw}，相当于用默认颜色。 \end{itemize} \hrule @@ -180,7 +230,7 @@ \item \texttt{help lines} \par 指定线条为辅助线，相当于 \texttt{line width=0.2pt,gray}。 \item \texttt{solid / dashed / dotted / dash dot / dash dot dot / \dots} \par - 指定线条类型（实现、虚线等）。 + 指定线条类型（实线、虚线等）。 \item \texttt{rounded corners} \par 将路径转向处绘制成圆角。可写成 \texttt{rounded corners=\Arg{radius}} 使用给定的半径。 \end{itemize} @@ -210,6 +260,8 @@ \begin{command} \cmd{node}\oarg{options} \texttt{(\Arg{name})} \texttt{at (\Arg{coordinate})} \marg{text}\texttt{;} \end{command} +\texttt{(\Arg{name})} 为结点命名，类似 \cmd{coordinate}；\texttt{at (\Arg{coordinate})} 指定结点的位置。 +这两者和前面的 \Arg{options} 都可以省略，只有 \Arg{text} 是必填的。 \begin{example} \begin{tikzpicture} \node (A) at (0,0) {A}; @@ -228,7 +280,8 @@ \begin{itemize} \item \texttt{anchor=\Arg{position}} \par 指定结点的某个角落 \Arg{position} 位于给定的位置 \Arg{coordinate}。 - \item \texttt{center/ above / below / left / right / above left / \ldots} \par + 参数 \Arg{position} 用 \texttt{center}、\texttt{north}、\texttt{north west} 等形式表示。 + \item \texttt{centered / above / below / left / right / above left / \ldots} \par 指定结点相对于 \Arg{coordinate} 的位置，\texttt{anchor=\Arg{position}} 的等效写法。\texttt{above} 相当于 \texttt{anchor=south}，以此类推。 带参数的形式 \texttt{above=\Arg{length}} 指定节点相对于 \Arg{coordinate} 的距离。 \item \texttt{shape=\Arg{shape}} \par @@ -246,7 +299,7 @@ \hrule \end{table} -\cmd{node} 命令不仅为文字结点的位置命名（类似 \cmd{coordinate} 命令），在 \cmd{draw} 等命令中还可以使用某个结点的相对位置， +\cmd{node} 命令不仅为文字结点的位置命名，在 \cmd{draw} 等命令中还可以使用某个结点的相对位置， 以“东南西北”的方式命名： \begin{example} @@ -271,8 +324,8 @@ \end{tikzpicture} \end{example} -除了 \cmd{node} 命令之外，\cmd{coordinate} 也可以通过参数为某个位置添加文字。 -我们最后举一个较为复杂的例子，综合前面介绍过的各种路径、形状、文字结点和参数设置。 +除了 \cmd{node} 命令之外，\cmd{coordinate} 也可以通过参数为某个位置添加文字（label）。 +在此举一个较为复杂的例子，综合前面介绍过的各种路径、形状、文字结点和参数设置。 \begin{sourcecode}[htp] \begin{Verbatim} @@ -281,8 +334,8 @@ \draw[-stealth,line width=0.2pt] (0,-0.5) -- (0,2.5); \coordinate (a) at (0.5,1.9); \coordinate (b) at (4,1.2); -\coordinate[label=below:$a$] (a0) at (0.5,0); -\coordinate[label=below:$b$] (b0) at (4,0); +\coordinate[label=below:$a$] (a0) at (a |- 0,0); +\coordinate[label=below:$b$] (b0) at (b |- 0,0); \filldraw[fill=gray!20,draw,thick] (a0) -- (a) .. controls (1,2.8) and (2.7,0.4) .. (b) -- (b0) -- cycle; \node[above right,outer sep=0.2cm, rounded corners, @@ -296,8 +349,8 @@ \draw[-stealth,line width=0.2pt] (0,-0.5) -- (0,2.5); \coordinate (a) at (0.5,1.9); \coordinate (b) at (4,1.2); -\coordinate[label=below:$a$] (a0) at (0.5,0); -\coordinate[label=below:$b$] (b0) at (4,0); +\coordinate[label=below:$a$] (a0) at (a |- 0,0); +\coordinate[label=below:$b$] (b0) at (b |- 0,0); \filldraw[fill=gray!20,draw,thick] (a0) -- (a) .. controls (1,2.8) and (2.7,0.4) .. (b) -- (b0) -- cycle; \node[above right,outer sep=0.2cm, rounded corners, @@ -306,4 +359,38 @@ \end{tikzpicture} \end{center} \caption{\TikZ\ 绘图示例源代码和效果。}\label{code:tikz-example} -\end{sourcecode}
\ No newline at end of file +\end{sourcecode} + +\subsection{在 \TikZ\ 中使用循环} + +\cmdindex[tikz]{foreach} +\TikZ\ 通过 \pkg{pgffor} 功能宏包实现了简单的循环功能，语法为： +\begin{command} +\cmd{foreach} \cmd{a} \texttt{in} \marg{list} \marg{commands} +\end{command} +上述语法定义了 \cmd{a} 为变量，在 \marg{commands} 中使用 \cmd{a} 完成循环。 + +\Arg{list} 可以直接将所有值写出来，如 1,2,3,4；也可以写成省略形式，如 1,2,\ldots,10。 +\begin{example} +\begin{tikzpicture} +\draw (0,0)--(5,0); +\foreach \i in {0.0,0.1,...,5.0} + {\draw[very thin] + (\i,0)--(\i,0.15);} +\foreach \I in {0,1,2,3,4,5} + {\draw (\I,0)--(\I,0.25) + node[above] {\I};} +\end{tikzpicture} +\end{example} + +\cmd{foreach} 还可使用变量对参与循环： +\begin{example} +\begin{tikzpicture} +\foreach \n/\t in + {0/\alpha,1/\beta,2/\gamma} + {\node[circle,fill=lightgray,draw] + at (\n,0) {$\t$};} +\end{tikzpicture} +\end{example} + +\endinput
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.08.custom.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.08.custom.tex index 1990ebf61c4..bfcdb787a44 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.08.custom.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/chap.08.custom.tex @@ -1,4 +1,4 @@ -\chapter{自定义 \LaTeX\ 命令和功能} +\chapter{自定义 \LaTeX\ 命令和功能}\label{chap:custom} \addtocontents{los}{\protect\addvspace{10pt}} \begin{intro} @@ -10,7 +10,7 @@ 不过作为入门手册，这些知识仍是不全面的。如果你不满足于此，需要参考更多资料，比如 \cite{companion,clsguide}。 \end{intro} -\section{自定义命令和环境}\label{sec:newcommands} +\section{自定义命令和环境}\label{sec:defs} 你也许已经意识到了，在本手册中介绍的所有命令都被包含在一个带颜色的矩形背景框中。 笔者并没有直接使用基础的 \LaTeX\ 命令来实现这个效果，而是创建了一个\textbf{宏包}， @@ -25,10 +25,10 @@ 这个例子中使用了一个新的环境 \env{command}。这个环境负责给命令代码加上一个带颜色的矩形背景框。 同时还使用了一个命令：\cmd{cmd}， 这个命令负责输出命令的名字，包括前面的反斜杠。 -一旦笔者想要修改命令代码的央视，比如更换颜色、加边框等等，可以通过改变 \env{command} 环境的定义来很容易地创建新的外观， +一旦笔者想要修改命令代码的样式，比如更换颜色、加边框等等，可以通过改变 \env{command} 环境的定义来很容易地创建新的外观， 而不是挨个修改每个命令示例。 -\subsection{定义新命令} +\subsection{定义新命令}\label{subsec:newcmd} \cmdindex{newcommand} 使用如下命令可以定义你自己的命令： @@ -73,7 +73,7 @@ This is ``\tnss'' \ldots{} 在某些情况之下，你可能会希望使用 \cmd{pro\-vide\-comm\-and} 命令。在命令不存在时，它相当于 \cmd{new\-comm\-and} ；在命令已经存在时，仍沿用存在的定义。 -\subsection{定义环境} +\subsection{定义环境}\label{subsec:newenv} \cmdindex{newenvironment} 与 \cmd{new\-comm\-and} 命令类似，有一个命令用于定义新的环境。这个命令是 \cmd{new\-environ\-ment}，它的语法如下所示： @@ -103,9 +103,9 @@ My humble subjects \ldots 不会不小心新建重名的环境。如果你确实希望改变一个现有的环境，你可以使用命令 \cmd{re\-new\-environ\-ment}，它使用和命令 \cmd{new\-environ\-ment} 相同的语法。 -\section{编写自己的宏包和文档类} +\section{编写自己的宏包和文档类}\label{sec:packages} -\subsection{编写简单的宏包} +\subsection{编写简单的宏包}\label{subsec:provide-pkg} \cmdindex{usepackage} 如果你定义了很多新的环境和命令，你的文档的导言区将变得相当长，在这种情况下，好的方式是 @@ -132,11 +132,11 @@ My humble subjects \ldots \cmd{ProvidesPackage}\marg{package name} \end{command} 这个命令应该放在你的宏包的最前面，并且一定要注意：\textbf{\Arg{package name} 需要和宏包的文件名一致。} -\cmd{Provides\-Package} 让 \LaTeX\ 记录宏包的名称，从而在你尝试再次调用同一个宏包的时候忽略后面的引入% +\cmd{Provides\-Package} 让 \LaTeX\ 记录宏包的名称，从而在你尝试再次调用同一个宏包的时候忽略后面的调用% \footnote{但如果你以\emph{不同的选项}多次引入宏包，则有可能会引起错误，见附录 \ref{sec:errors}。}。 源代码 \ref{code:package} 给出了一个小的宏包示例，其中包含了我们之前定义的一些命令。 -\subsection{在宏包中调用其它宏包} +\subsection{在宏包中调用其它宏包}\label{subsec:require-pkg} \cmdindex{RequirePackage} 如果你想进一步把各种宏包的功能汇总到一个文件里，而不是在文档的导言区罗列一大堆宏包的话， @@ -146,7 +146,7 @@ My humble subjects \ldots \cmd{RequirePackage}\oarg{options}\marg{package name} \end{command} -\subsection{编写自己的文档类} +\subsection{编写自己的文档类}\label{subsec:provide-cls} \cmdindex{ProvidesClass} 当你更进一步，需要编写自己的文档类，如论文模板等，问题就稍稍麻烦了一些。首先，自己的文档类以 \texttt{.cls} 作扩展名，开头使用 @@ -178,7 +178,7 @@ My humble subjects \ldots \cmd{newcounter}\marg{counter name}\oarg{parent counter name} \end{command} -\Arg{counter name} 为计数器的名称，可选参数 \Arg{parent counter name} 定义为 \Arg{counter name} 的上级计数器。 +\Arg{counter name} 为计数器的名称。计数器可以有上下级的关系，可选参数 \Arg{parent counter name} 定义为 \Arg{counter name} 的上级计数器。 \cmdindex{setcounter,addtocounter,stepcounter} 以下命令修改计数器的数值，\cmd{set\-counter} 将数值设为 \Arg{number}；\cmd{add\-to\-counter} 将数值加上 \Arg{number}； @@ -201,19 +201,21 @@ My humble subjects \ldots 命令 \cmd{Alph} 控制计数器 \Arg{counter} 的值以大写字母形式显示。下表列出所有可用于修改计数器格式的命令。 注意：这些命令\textbf{只能用于计数器，不能直接用于数字}，如 \cmd{roman}\marg*{1} 这样的命令会出错。 \begin{center} -\begin{tabular}{cl} +\begin{tabular}{lp{12em}l} \hline - \cmd{arabic} & 阿拉伯数字（默认） \\ - \cmd{alph} & 小写字母 \\ - \cmd{Alph} & 大写字母 \\ - \cmd{roman} & 小写罗马数字 \\ - \cmd{Roman} & 大写字母 \\ - \cmd{fnsymbol} & 一系列符号，用于标题页生成的脚注中 \\ + \textbf{命令} & \textbf{样式} & \textbf{备注} \\ + \hline + \cmd{arabic} & 阿拉伯数字（默认） & \\ + \cmd{alph} & 小写字母 & 限 0-26 \\ + \cmd{Alph} & 大写字母 & 限 0-26 \\ + \cmd{roman} & 小写罗马数字 & 限正数 \\ + \cmd{Roman} & 大写罗马数字 & 限正数 \\ + \cmd{fnsymbol} & 一系列符号，用于 \cmd{thanks} 命令生成的脚注 & 限 0-9 \\ \hline \end{tabular} \end{center} -计数器的值还可以利用其它字符，甚至其它计数器的值与之组合。如标准文档类里对 \cmd{sub\-section} 相关的计数器的输出格式的定义相当于： +计数器的输出格式还可以利用其它字符，甚至其它计数器的输出格式与之组合。如标准文档类里对 \cmd{sub\-section} 相关的计数器的输出格式的定义相当于： \begin{verbatim} \renewcommand\thesubsection{\thesection.\arabic{subsection}} \end{verbatim} @@ -222,44 +224,120 @@ My humble subjects \ldots \begin{itemize} \item 我们当然早就意识到了，所有章节命令 \cmd{chapter}、\cmd{section} 等分别对应计数器 chapter、section 等等，而且有上下级的关系。 -而计数器 part 是独立的。 + 而计数器 part 是独立的。 \item 有序列表 \env{enumerate} 的各级计数器为 enumi, enumii, enumiii, enumiv，也是有上下级的关系。 \item 图表浮动体的计数器就是 table 和 figure；公式的计数器为 equation。 - 这些计数器在 \cls{article} 文档类中是独立的，而在 \cls{book} 和 \cls{report} 中以 chapter 为上级计数器。 + 这些计数器在 \cls{article} 文档类中是独立的，而在 \cls{book} 和 \cls{report} 中以 chapter 为上级计数器。 \item 页码、脚注的计数器分别是 page 和 footnote。 \end{itemize} +我们可以利用前面介绍过的命令，修改计数器的样式以达到想要的效果，比如把页码修改成大写罗马字母，左右加横线，或是给脚注加上方括号： +\begin{verbatim} +\renewcommand\thepage{--~\Roman{page}~--} +\renewcommand\thefootnote{[\arabic{footnote}]} +\end{verbatim} + \cmdindex{pagenumbering} -我们可以利用前面介绍过的命令，修改计数器的样式以达到想要的效果，比如把页码修改成大写罗马字母，或是给脚注加上方括号。 -修改页码的样式有个更方便的命令 \cmd{page\-number\-ing}： +如果只是简单将计数器输出格式应用到页码上的话，有个更方便的命令 \cmd{page\-number\-ing}： \begin{verbatim} \pagenumbering{Roman} -\renewcommand\thefootnote{[\arabic{footnote}]} \end{verbatim} +不过它在修改 page 计数器输出格式的同时，还将计数器的值改为 1，令修改后的页码总是从 1 开始。\cls{book} 文档类的 +\cmd{frontmatter} 和 \cmd{mainmatter} 等都用了 \cmd{pagenumbering} 命令。 最后介绍两个有用的计数器： +\subsubsection{secnumdepth} + +\index{secnumdepth@secnumdepth (\textit{计数器})} +\LaTeX\ 标准文档类对章节划分了层级： \begin{itemize} - \item secnumdepth \index{secnumdepth@secnumdepth (\textit{计数器})} + \item 在 \cls{article} 文档类里 part 为 0，section 为 1，依此类推； + \item 在 \cls{report}/\cls{book} 文档类里 part 为 -1，chapter 为 0，section 为 1，等等。 +\end{itemize} + +secnumdepth 计数器控制章节编号的深度，如果章节的层级大于 secnumdepth，那么章节的标题、在目录和页眉页脚的标题都不编号 +（照常生成目录和页眉页脚），章节计数器也不计数。 + +可以用 \cmd{setcounter} 命令设置 secnumdepth 为较大的数使得层级比较深的章节也编号， +如设置为 4 令 \cmd{paragraph} 也编号；或者设置一个较小的数以取消编号，如设置为 -1 令 \cmd{chapter} 不编号。 +后者是生成不编号的章节的一个妙招，免去了手动使用 \cmd{add\-contents\-line} 和 \cmd{mark\-both} 的麻烦。 - \LaTeX\ 内部对章节规定了层级： - \begin{itemize} - \item 在 \cls{article} 文档类里 part 为 0，section 为 1，依此类推； - \item 在 \cls{report}/\cls{book} 文档类里 part 为 -1，chapter 为 0，section 为 1，等等。 - \end{itemize} +secnumdepth 计数器在 \cls{article} 文档类里默认为 3 （subsubsection 一级）；在 \cls{report} 和 \cls{book} 文档类里默认为 2 （subsection 一级）。 - secnumdepth 计数器控制章节编号的深度，如果章节的层级大于 secnumdepth，那么章节的标题、在目录和页眉页脚的标题都不编号 - （照常生成目录和页眉页脚），章节计数器也不计数。 +\subsubsection{tocdepth} - 可以用 \cmd{setcounter} 命令设置 secnumdepth 为较大的数使得层级比较深的章节也编号， - 如设置为 4 令 \cmd{paragraph} 也编号；或者设置一个较小的数以取消编号，如设置为 -1 令 \cmd{chapter} 不编号。 - 后者是生成不编号的章节的一个妙招，免去了手动使用 \cmd{add\-contents\-line} 和 \cmd{mark\-both} 的麻烦。 +\index{tocdepth@tocdepth (\textit{计数器})} +tocdepth 计数器控制目录的深度，如果章节的层级大于 tocdepth，那么章节将不会自动写入目录项。默认值同 secnumdepth。 - secnumdepth 计数器在 \cls{article} 文档类里默认为 3 （subsubsection 一级）；在 \cls{report} 和 \cls{book} 文档类里默认为 2 （subsection 一级）。 +\section{\LaTeX\ 可定制的一些命令和参数}\label{sec:latex-settings} - \item tocdepth \index{tocdepth@tocdepth (\textit{计数器})} +\LaTeX\ 事实上有相当一些可以定制的命令和参数，不过对于修改样式或者开发宏包来说，这些定制项还远远不够。 - tocdepth 计数器控制目录的深度，如果章节的层级大于 tocdepth，那么章节将不会自动写入目录项。默认值同 secnumdepth。 +对于用户来讲，容易定制的是这一些项目： + +\begin{itemize} + \item 标题名称/前后缀等。表 \ref{tbl:latex-settings-names} 列出了标准文档类里可定制的项目， + 表中所有的 \LaTeX\ 命令都可以用 \cmd{re\-new\-comm\-and} 来修改。 + \item 长度。前文在叙述各种排版元素时已经涉及到一些，现归纳于表 \ref{tbl:latex-settings-lengths}。 + 表中所有的长度命令可用 \cmd{setlength} 来修改。 + 大多数控制页面尺寸的长度参数在图 \ref{fig:layouts} 给出，此处不再赘述。 \end{itemize} +\begin{table}[htbp] +\centering +\caption{\LaTeX\ 可定制的标题名称/前后缀。}\label{tbl:latex-settings-names} +\small +\begin{tabularx}{\textwidth}{llX} + \hline + \textsf{命令} & \textsf{默认值} & \textsf{含义} \\ + \hline + \cmd{partname} & Part & \cmd{part} 命令生成的标题前缀 \\ + \cmd{chaptername} & Chapter & \cmd{chapter} 命令生成的标题前缀 \\ + \cmd{appendixname} & Appendix & 使用 \cmd{appendix} 命令生成的附录部分的章标题前缀 \\ + \cmd{abstractname} & Abstract & 摘要环境 \env{abstract} 的标题名称 \\[1ex] + \cmd{contentsname} & Contents & \cmd{tableofcontents} 命令生成的目录标题 \\ + \cmd{listfigurename} & List of Figures & \cmd{listoffigures} 命令生成的插图目录标题 \\ + \cmd{listtablename} & List of Tables & \cmd{listoftables} 命令生成的表格目录标题 \\[1ex] + \cmd{tablename} & Table & \env{table} 浮动体中 \cmd{caption} 命令生成的标题前缀 \\ + \cmd{figurename} & Figure & \env{figure} 浮动体中 \cmd{caption} 命令生成的标题前缀 \\[1ex] + \cmd{refname} & References & \env{thebibliography} 环境或 \cmd{biblio\-graphy} + 命令生成的参考文献标题（\cls{article} 文档类） \\ + \cmd{bibname} & Bibliography & \env{thebibliography} 环境或 \cmd{biblio\-graphy} + 命令生成的参考文献标题（\cls{book / report} 文档类）\\ + \cmd{indexname} & Index & \cmd{printindex} 命令生成的索引标题 \\ + \hline +\end{tabularx} +\begin{quotation}\footnotesize% +注：形如“第 X 章”和“第 X 部分”的中文章节标题不能直接由修改本表的命令得到，需要使用 \pkg{titlesec} 等宏包定制。 +如果使用 \pkg{ctex} 宏包或文档类，那么标题默认被修改成“第 X 章”和“第 X 部分”的形式，本表中的其它标题也修改为中文标题。详见 \pkg{ctex} 宏包的帮助手册。 +\end{quotation} +\end{table} + +\begin{table}[htbp] +\centering +\caption{\LaTeX\ 可定制的长度参数。}\label{tbl:latex-settings-lengths} +\small +\begin{tabularx}{\textwidth}{ll@{pt\hskip2\tabcolsep}X} + \hline + \textsf{命令} & \multicolumn{1}{l@{\hskip2\tabcolsep}}{\textsf{默认值}} & \textsf{含义} \\ + \hline + \cmd{fboxrule} & 0.4 & \cmd{fbox} 或 \cmd{framebox} 等带框盒子的线宽 \\ + \cmd{fboxsep} & 3 & \cmd{fbox} 或 \cmd{framebox} 等带框盒子的内边距 \\[1ex] + \cmd{arraycolsep} & 5 & \env{array} 环境的表格项前后的间距 \\ + \cmd{tabcolsep} & 6 & \env{tabular} 环境的表格项前后的间距 \\ + \cmd{arrayrulewidth} & 0.4 & 表格线宽 \\ + \cmd{doublerulesep} & 2 & 连续两根表格线之间的间距 \\[1ex] + \cmd{abovecaptionskip} & 10 & \cmd{caption} 命令位于图表下方时，与上方图表的间距 \\ + \cmd{belowcaptionskip} & 0 & \cmd{caption} 命令位于图表上方时，与下方图表的间距 \\[1ex] + \cmd{columnsep} & 10 & 双栏排版下两栏的间距 \\ + \cmd{columnseprule} & 0 & 双栏排版下两栏之间竖线的宽度 \\ + \hline +\end{tabularx} +\begin{quotation}\footnotesize% +注：\cmd{arraycolsep} 和 \cmd{tabcolsep} 是每个表格项本身前后的间距（表格线前后无间距；\texttt{@} 列格式会消除与前后表格项的间距）。 +两个表格项之间的间距相当于 2\cmd{arraycolsep} 或 2\cmd{tabcolsep}。 +\end{quotation} +\end{table} + \endinput
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/sec.symbol.table.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/sec.symbol.table.tex index 46528589fd8..edd0b7d8c3c 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/sec.symbol.table.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/sec.symbol.table.tex @@ -15,15 +15,10 @@ \def\SC #1{#1 & \texttt{\string#1}} - -\newsavebox{\symbbox} \newenvironment{symbols}[1]% - {\def\arraystretch{1.1} - \begin{lrbox}{\symbbox} + {\small\def\arraystretch{1.1} \begin{tabular}{@{}#1@{}}}% - {\end{tabular}\end{lrbox}\makebox[\linewidth]{\usebox{\symbbox}}} - -\newcount\savesecdepth + {\end{tabular}} \clearpage \section{符号表}\label{sec:math-tables} @@ -39,6 +34,7 @@ \symindex{dag,ddag,P,S,copyright,pounds} \begin{table}[htp] +\centering \caption{文本/数学模式通用符号}\label{tbl:general-syms} \begin{quote}\footnotesize% 这些符号可用于文本和数学模式。 @@ -53,6 +49,7 @@ \end{table} \begin{table}[htp] +\centering \caption{希腊字母。} \label{tbl:math-greek} \begin{quote}\footnotesize% \cmd{Alpha}，\cmd{Beta} 等希腊字母符号不存在，因为它们和拉丁字母 A,B 等一模一样； @@ -79,6 +76,7 @@ \end{table} \begin{table}[htp] +\centering \caption{二元关系符。} \label{tbl:math-rel} \begin{quote}\footnotesize% 所有的二元关系符都可以加 \cmd{not} 前缀得到相反意义的关系符，例如 \cmd{not}\texttt{=} 就得到不等号（同 \cmd{ne}）。 @@ -104,6 +102,7 @@ \end{table} \begin{table}[htp] +\centering \caption{二元运算符。}\label{tbl:math-op} \begin{symbols}{*3{cl}} \hline @@ -125,6 +124,7 @@ \end{table} \begin{table}[htp] +\centering \caption{巨算符。}\label{tbl:math-bigop} \def\arraystretch{1.8} \begin{symbols}{*3{ccl}} @@ -141,6 +141,7 @@ \end{table} \begin{table}[htp] +\centering \caption{数学重音符号。}\label{tbl:math-accents} \begin{quote}\footnotesize% 最后一个 \cmd{wideparen} 依赖 \pkg{yhmath} 宏包。 @@ -158,6 +159,7 @@ \end{table} \begin{table}[htp] +\centering \caption{箭头。} \label{tbl:math-arrows} \begin{symbols}{*2{cl}} \hline @@ -183,6 +185,7 @@ \end{table} \begin{table}[htp] +\centering \caption{作为重音的箭头符号。} \label{tbl:math-arrow-accents} \begin{symbols}{*2{cl}} \hline @@ -194,6 +197,7 @@ \end{table} \begin{table}[htp] +\centering \caption{定界符。}\label{tbl:math-delims} \begin{symbols}{*3{cl}} \hline @@ -210,6 +214,7 @@ \end{table} \begin{table}[htp] +\centering \caption{用于行间公式的大定界符。}\label{tbl:math-large-delims} \def\arraystretch{1.8} \begin{symbols}{*3{cl}} @@ -222,6 +227,7 @@ \end{table} \begin{table}[htp] +\centering \caption{其他符号。}\label{tbl:math-misc} \begin{symbols}{*4{cl}} \hline @@ -244,6 +250,7 @@ 本小节所有符号依赖 \pkg{amssymb} 宏包。 \begin{table}[htp] +\centering \caption{\AmS\ 希腊字母和希伯来字母。} \label{tbl:ams-greek-hebrew} \begin{symbols}{*5{cl}} \hline @@ -253,6 +260,7 @@ \end{table} \begin{table}[htp] +\centering \caption{\AmS\ 二元关系符。} \label{tbl:ams-rel} \begin{symbols}{*3{cl}} \hline @@ -283,6 +291,7 @@ \end{table} \begin{table}[htp] +\centering \caption{\AmS\ 二元运算符。} \label{tbl:ams-op} \begin{symbols}{*3{cl}} \hline @@ -299,6 +308,7 @@ \end{table} \begin{table}[htp] +\centering \caption{\AmS\ 箭头。}\label{tbl:ams-arrows} \begin{symbols}{*2{cl}} \hline @@ -322,6 +332,7 @@ \end{table} \begin{table}[htp] +\centering \caption{\AmS\ 反义二元关系符和箭头。}\label{tbl:ams-negative} \begin{symbols}{*3{cl}} \hline @@ -350,6 +361,7 @@ \end{table} \begin{table}[htp] +\centering \caption{\AmS\ 定界符}\label{tbl:ams-delims} \begin{symbols}{*4{cl}} \hline @@ -360,6 +372,7 @@ \end{table} \begin{table}[htp] +\centering \caption{\AmS\ 其它符号。}\label{tbl:ams-misc} \begin{symbols}{*3{cl}} \hline diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/titlepage.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/titlepage.tex index 68223ab13c7..7a03456356b 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/titlepage.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/chap/titlepage.tex @@ -15,9 +15,9 @@ \linespread{1.67}\selectfont\raggedleft {\bfseries 原版作者：} Tobias Oetiker\\ Hubert Partl, Irene Hyna and Elisabeth Schlegl \\ - {\bfseries 原版版本：} Version~5.05, July 18, 2015\\[4ex] + {\bfseries 原版版本：} Version~\lshortversionoriginal, July 18, 2015\\[4ex] {\bfseries 中文翻译：} China\TeX\ 论坛\\ - {\bfseries 中文版本：} 版本~5.05，\zhdigits*{\the\year}年\zhnumber{\the\month}月 + {\bfseries 中文版本：} 版本~\lshortversioncn，\zhdigits*{\the\year}年\zhnumber{\the\month}月 \end{minipage}% } diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-layout.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-layout.tex index 7bf60e338c5..35734b7260e 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-layout.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-layout.tex @@ -1,12 +1,11 @@ +\newif\ifoddsidelayout + \expandafter\ifx\csname ver@layout.sty\endcsname\relax \typeout{Package `layout' not loaded. Command \string\layoutpicture{} will have no effect.} \def\layoutpicture{\@ifstar\@empty\@empty} -% \let\oddsidelayouttrue\relax \let\oddsidelayoutfalse\relax \expandafter\endinput \fi -\newif\ifoddsidelayout - \newcommand\lay@layoutpic{% \if@twoside \ifoddsidelayout diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-style.sty b/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-style.sty index 6eca77209f6..c0129b950fa 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-style.sty +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn-style.sty @@ -18,17 +18,18 @@ % % ctex 宏包 2.2(2015/06/24) 或以上版本 % ctex 宏包的字号设定会让许多固定字号的字体宏包报太多 warning，应当抑制 +% 中文正文字体使用 Fandol % \RequirePackage[fontset=fandol,zihao=false,scheme=chinese,heading=true]{ctex}[2015/06/24] % % 字体和符号宏包 % -\RequirePackage{lmodern} % 正文字体使用 Latin Modern +\RequirePackage{lmodern} % 西文正文字体使用 Latin Modern \RequirePackage{amssymb,latexsym,textcomp,mathrsfs,euscript,yhmath} % 与默认字体不冲突的一些符号包 \RequirePackage[LGR,T1]{fontenc} -% layout 宏包生成能放入浮动体的命令，手动指定奇偶页的 layout +% 调整 layout 宏包的命令使之能够放入浮动体，手动指定奇偶页的 layout \input lshort-zh-cn-layout \oddsidelayouttrue % layout 文字汉化 @@ -77,33 +78,48 @@ % 索引依赖 multicols 环境排版 % \renewenvironment{thebibliography}[1] - {\chapter{\bibname}% - \@mkboth{\MakeUppercase\bibname}{\MakeUppercase\bibname}% - \list{\@biblabel{\@arabic\c@enumiv}}% - {\settowidth\labelwidth{\@biblabel{#1}}% - \leftmargin\labelwidth - \advance\leftmargin\labelsep - \@openbib@code - \usecounter{enumiv}% - \let\p@enumiv\@empty - \renewcommand\theenumiv{\@arabic\c@enumiv}}% - \sloppy - \clubpenalty4000 - \@clubpenalty \clubpenalty - \widowpenalty4000% - \sfcode`\.\@m} - {\def\@noitemerr - {\@latex@warning{Empty `thebibliography' environment}}% - \endlist} + {\chapter{\bibname% + \protect\@mkboth{\MakeUppercase\bibname}{\MakeUppercase\bibname}}% + \list{\@biblabel{\@arabic\c@enumiv}}% + {\settowidth\labelwidth{\@biblabel{#1}}% + \leftmargin\labelwidth + \advance\leftmargin\labelsep + \@openbib@code + \usecounter{enumiv}% + \let\p@enumiv\@empty + \renewcommand\theenumiv{\@arabic\c@enumiv}}% + \sloppy + \clubpenalty4000 + \@clubpenalty \clubpenalty + \widowpenalty4000% + \sfcode`\.\@m} + {\def\@noitemerr + {\@latex@warning{Empty `thebibliography' environment}}% + \endlist} \renewenvironment{theindex}% - {\chapter{\indexname}% - \@mkboth{\MakeUppercase{\indexname}}{\MakeUppercase{\indexname}} + {\chapter{\indexname% + \protect\@mkboth{\MakeUppercase\indexname}{\MakeUppercase\indexname}} \parskip\z@ \@plus .3\p@\relax \let\item\@idxitem + \small \begin{multicols}{2}} {\end{multicols}} % +% 将主目录和源代码目录合并排版 +% 不依赖 float 宏包的 \listof，因此要补充定义 \l@sourcecode +% +\renewcommand\tableofcontents% + {\chapter{\contentsname% + \protect\@mkboth{\MakeUppercase\contentsname}{\MakeUppercase\contentsname}}% + \begin{multicols}{2} + \@starttoc{toc}% + \end{multicols} + \@makeschapterhead{\sourcecodename}% + \@starttoc{los}% +} + +% % 令 \cleardoublepage 的偶数页页眉页脚为空 % \renewcommand{\cleardoublepage} @@ -127,8 +143,10 @@ % % PDF 书签中对符号的特殊处理 % -\pdfstringdefDisableCommands{\def\AmS{AMS}}% -\pdfstringdefDisableCommands{\def\TikZ{TikZ}}% +\pdfstringdefDisableCommands{% + \def\AmS{AMS}% + \def\TikZ{TikZ}% +} % % 示意长度 @@ -162,14 +180,20 @@ \def\ltxcmdindex#1{\@for\@ltxcmd:=#1\do{\index{\@ltxcmd @\cmd{\@ltxcmd}}}} \def\ltxenvindex#1{\@for\@ltxenv:=#1\do{\index{\@ltxenv @\env{\@ltxenv} 环境}}} \def\pkgcmdindex[#1]#2{\@for\@pkgcmd:=#2\do{\index{\@pkgcmd @\cmd{\@pkgcmd} (\pkg{#1})}}} -\def\pkgenvindex[#1]#2{\@for\@pkgcmd:=#2\do{\index{\@pkgcmd @\env{\@pkgcmd} 环境 (\pkg{#1})}}} +\def\pkgenvindex[#1]#2{\@for\@pkgenv:=#2\do{\index{\@pkgenv @\env{\@pkgenv} 环境 (\pkg{#1})}}} + +% % 文本和数学符号索引 +% \def\symindex#1{\@for\t@xtsym:=#1\do{\index{\t@xtsym @\cmd{\t@xtsym} (\textit{符号} \expandafter\protect\csname \t@xtsym\endcsname)}}} \def\mathindex#1{\@for\m@thcmd:=#1\do{\index{\m@thcmd @\cmd{\m@thcmd} (\textit{数学命令})}}} \def\msymindex#1{\@for\m@thsym:=#1\do{\index{\m@thsym @\cmd{\m@thsym} (\textit{数学符号}$\expandafter\protect\csname \m@thsym\endcsname$)}}} \def\maccindex#1{\@for\m@thacc:=#1\do{\index{\m@thacc @\cmd{\m@thacc} (\textit{数学重音}$\expandafter\protect\csname \m@thacc\endcsname{a}$)}}} \def\waccindex#1{\@for\wideacc:=#1\do{\index{\wideacc @\cmd{\wideacc} (\textit{数学重音}$\expandafter\protect\csname \wideacc\endcsname{AB}$)}}} + +% % 拼音索引 +% \def\pinyinindex#1#2{\index{#1@#2}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -190,14 +214,11 @@ \def\arraystretch{1.2}% \hskip\parindent% \begin{tabular}{>{\columncolor{blue!5}}l} - }% - {\\ - \end{tabular} - \endtrivlist} + }{\end{tabular}\endtrivlist} % % 示例环境 example -% 环境中的代码被 verbatim 环境处理到一个临时文件中 +% 环境中的代码写入临时文件 lshort-zh-cn-example.aux % 再从临时文件中读取，分别生成代码盒子和示例盒子 % \newwrite\example@out @@ -242,7 +263,7 @@ \fvset{fontsize=\small,frame=lines} \newfloat{sourcecode}{tbp}{los}[chapter] \floatname{sourcecode}{源代码} -\def\listofsources{\listof{sourcecode}{源代码示例列表}} - +\def\sourcecodename{源代码示例列表} +\def\l@sourcecode{\@dottedtocline{1}{1.5em}{2.3em}} \endinput
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn.tex b/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn.tex index 7d616811338..f6bc3f8f7ef 100644 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn.tex +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/lshort-zh-cn.tex @@ -1,6 +1,9 @@ \documentclass[a4paper]{book} \usepackage{lshort-zh-cn-style} +\def\lshortversionoriginal{5.05} +\def\lshortversioncn{5.10} + \hypersetup{% pdftitle={The Not So Short Introduction to LaTeX2e(Chinese Simplified)},% pdfkeywords={LaTeX, LaTeX2e}, @@ -12,6 +15,8 @@ % 第四章用到的自定义算符 \DeclareMathOperator{\argh}{argh} \DeclareMathOperator*{\nut}{Nut} +% 第四章的 \proofname 用原先的英文定义 +\def\proofname{Proof} \makeindex @@ -24,7 +29,7 @@ \input{chap/preface.contrib} \input{chap/preface.overview} \tableofcontents -\listofsources +%\listofsources \mainmatter \input{chap/chap.01.basics} diff --git a/Master/texmf-dist/doc/latex/lshort-chinese/src/make.bat b/Master/texmf-dist/doc/latex/lshort-chinese/src/make.bat index 686897658a2..fe563c7e171 100755 --- a/Master/texmf-dist/doc/latex/lshort-chinese/src/make.bat +++ b/Master/texmf-dist/doc/latex/lshort-chinese/src/make.bat @@ -1,24 +1,25 @@ -@echo off -set LSHORT=lshort-zh-cn -set PDF=%LSHORT%.pdf -set TEMP=%LSHORT%.aux %LSHORT%.log %LSHORT%.idx %LSHORT%.ind %LSHORT%.ilg %LSHORT%.out %LSHORT%.toc %LSHORT%.los %LSHORT%-example.aux - -if "%1"=="clean" goto clean - -set TEX=xelatex -set MODE=-interaction=nonstopmode -set MAKEINDEX=makeindex - -%TEX% %MODE% %LSHORT% -%MAKEINDEX% -s %LSHORT%.ist %LSHORT% -%TEX% %MODE% %LSHORT% - -if exist %PDF% ( -move %PDF% .. -start "" "..\%PDF%" -) -exit - -:clean -del %TEMP% -exit +@echo off
+set LSHORT=lshort-zh-cn
+set PDF=%LSHORT%.pdf
+set TEMP=%LSHORT%.aux %LSHORT%.log %LSHORT%.idx %LSHORT%.ind %LSHORT%.ilg %LSHORT%.out %LSHORT%.toc %LSHORT%.los %LSHORT%-example.aux %LSHORT%.synctex.gz
+
+if "%1"=="clean" goto clean
+
+set TEX=xelatex
+set MODE=-interaction=nonstopmode -synctex=1
+set MAKEINDEX=makeindex
+
+%TEX% %MODE% %LSHORT%
+%MAKEINDEX% -s %LSHORT%.ist %LSHORT%
+%TEX% %MODE% %LSHORT%
+%TEX% %MODE% %LSHORT%
+
+if exist %PDF% (
+move %PDF% ..
+start "" "..\%PDF%"
+)
+exit
+
+:clean
+del %TEMP%
+exit
|