Skip to content

Commit

Permalink
lshort 5.05-rev2
Browse files Browse the repository at this point in the history
Add bibliography style informations.
Add some error messages.
  • Loading branch information
louisstuart96 committed Aug 4, 2016
1 parent 86511ec commit 3b4a0cf
Show file tree
Hide file tree
Showing 8 changed files with 130 additions and 90 deletions.
4 changes: 2 additions & 2 deletions src/chap/app.A.install.tex
Original file line number Diff line number Diff line change
Expand Up @@ -77,12 +77,12 @@ \section{安装和更新宏包}\label{sec:pkg-manager}
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 % 更新所有宏包
Expand Down
27 changes: 16 additions & 11 deletions src/chap/app.B.error.help.tex
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,10 @@ \subsubsection{常见的 \LaTeX\ 错误信息}
使用了未定义的命令。拼写错误是原因之一,如把 \cmd{LaTeX} 写作 \cmd{Latex} 这样。
也有可能是没有调用某个宏包,但用了该宏包定义的命令。

\item \LaTeXerror{! LaTeX error: Environment \ldots\ undefined.}

使用了未定义的环境。

\item \LaTeXerror{! Missing \$ inserted.}

缺少数学环境的符号 \texttt\$。多由于将数学符号用在公式之外而导致。
Expand All @@ -56,15 +60,15 @@ \subsubsection{常见的 \LaTeX\ 错误信息}

\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\ 命令。
Expand All @@ -90,15 +94,15 @@ \subsubsection{常见的 \LaTeX\ 错误信息}

\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}.}

环境首尾不匹配。比如 \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'.}
Expand Down Expand Up @@ -126,7 +130,7 @@ \subsubsection{常见的 \LaTeX\ 错误信息}

\end{itemize}

\section{查看帮助文档}\label{sec:texdoc}
\section{查找帮助文档}\label{sec:texdoc}

\index{texdoc@\texttt{texdoc} 工具}
无论是 \TeX\ Live 还是 Mik\TeX\ ,提供了一个命令行模式的程序 \texttt{texdoc}。
Expand Down Expand Up @@ -173,9 +177,9 @@ \subsection{文字、公式和符号}\label{subsec:text-math-symbols}
\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}

Expand All @@ -184,6 +188,7 @@ \subsection{排版元素}\label{subsec:pkg-elements}
\begin{pkglist}
\item[ulem] 提供排版可断行下划线的命令 \cmd{uline} 以及其它装饰文字的命令。
\item[endnote] 排版尾注。
\item[marginnote] 改善的边注排版功能。
\item[multicol] 提供将内容自由分栏的 \env{multicols} 环境。
\item[multitoc] 生成多栏排版的目录。
\item[minitoc] 为章节生成独立的小目录。
Expand All @@ -192,20 +197,20 @@ \subsection{排版元素}\label{subsec:pkg-elements}
\item[fancyvrb] 提供了代码排版环境 \env{Verbatim} 以及对版式的自定义。
\item[listings] 提供了排版关键字高亮的代码环境 \env{lst\-listing} 以及对版式的自定义。类似宏包有 \pkg{minted}。
\item[algorithmic] 一个简单的实现算法排版的宏包。如果要生成浮动体的话,需要搭配 \pkg{algorithm} 宏包使用。
\item[algorithm2e] 较为复杂的、可定制的算法排版宏包。类似宏包有 \pkg{algorithmidx} 等。
\item[algorithm2e] 较为复杂的、可定制的算法排版宏包。类似宏包有 \pkg{algorithmicx} 等。
\item[ntheorem] 定制定理环境。类似宏包包括 \pkg{theorem}、\pkg{thmtools}、\pkg{amsthm} 等。
\end{pkglist}

\subsection{图表和浮动体}\label{subsec:pkg-tab-fig}

\begin{pkglist}
\item[booktabs] 制作三线表
\item[booktabs] 排版三线表
\item[array] 对表格列格式的扩展。
\item[tabularx] 提供 \env{tabularx} 环境排版定宽表格,支持自动计算宽度的 X 列格式。
\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} 环境。
Expand Down
2 changes: 1 addition & 1 deletion src/chap/chap.01.basics.tex
Original file line number Diff line number Diff line change
Expand Up @@ -334,7 +334,7 @@ \subsection{宏包}\label{subsec:packages}
\footnote{使用多个宏包时指定选项,相当于给每个宏包指定同样的选项。如果有某个宏包不能识别某个选项,则会出错。}:
\begin{verbatim}
% 一次性载入三个排版表格常用的宏包
\usepackage{tabularx,longtable,multirow}
\usepackage{tabularx,makecell,multirow}
\end{verbatim}

附录 \ref{sec:pkg-list} 汇总了常用的一些宏包。我们在手册接下来的章节中,也会穿插介绍一些最常用的宏包的使用方法。
Expand Down
19 changes: 9 additions & 10 deletions src/chap/chap.03.elements.tex
Original file line number Diff line number Diff line change
Expand Up @@ -204,10 +204,9 @@ \section{脚注}\label{sec:footnote}
“天地玄黄,宇宙洪荒。日月盈昃,辰宿列张。”\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
Expand Down Expand Up @@ -694,10 +693,10 @@ \section{图片}\label{sec:figures}

\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} 格式”的观点。
Expand Down Expand Up @@ -742,11 +741,11 @@ \section{图片}\label{sec:figures}
\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} \\
Expand Down Expand Up @@ -823,7 +822,7 @@ \subsection{垂直盒子}\label{subsec:parbox}

其中 \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}%
Expand Down Expand Up @@ -909,9 +908,9 @@ \section{浮动体}\label{sec:float}

\pkgindex{float}

\pkg{float} 宏包为浮动体提供了 \texttt{H} 选项,不与 \texttt{htbp} 及 \texttt{!} 混用。使用 \texttt{H} 选项时
\pkg{float} 宏包为浮动体提供了 \texttt{H} 位置参数,不与 \texttt{htbp} 及 \texttt{!} 混用。使用 \texttt{H} 位置参数时
会取消浮动机制,将浮动体视为一般的盒子插入当前位置。这在一些特殊情况下很有用(如使用 \pkg{multicol} 宏包排版分栏内容的时候),
但尺寸过大的浮动体可能使得分页比较困呐
但尺寸过大的浮动体可能使得分页比较困难

\subsection{浮动体的标题}\label{subsec:caption}

Expand Down
3 changes: 2 additions & 1 deletion src/chap/chap.04.math.tex
Original file line number Diff line number Diff line change
Expand Up @@ -417,7 +417,8 @@ \subsection{括号和定界符}\label{subsec:math-delims}
\end{example}

使用 \cmd{big} 和 \cmd{bigg} 等命令的另外一个好处是:用 \cmd{left} 和 \cmd{right} 分界符包裹的公式块是不允许断行的
(下文提到的 \env{array} 或者 \amsenv{aligned} 等环境视为一个公式块),而 \cmd{big} 和 \cmd{bigg} 不受限制。
(下文提到的 \env{array} 或者 \amsenv{aligned} 等环境视为一个公式块),所以也不允许在多行公式里跨行使用,
\cmd{big} 和 \cmd{bigg} 等命令不受限制。

\section{多行公式}\label{sec:multi-eqns}

Expand Down
12 changes: 6 additions & 6 deletions src/chap/chap.05.style.tex
Original file line number Diff line number Diff line change
Expand Up @@ -287,15 +287,15 @@ \subsection{行距}\label{subsec:linespread}
\cmd{linespread}\marg{factor}
\end{command}

此处的行距,指的是基本行距(相当于 \cmd{fontsize} 命令的第二个参数)而不是字号大小。所以设置 1.5 倍行距的命令 \cmd{line\-spread}\marg*{1.5}
意味着最终行距为 1.8 倍的字号大小。
这里的 \Arg{factor} 是在基础行距上而不是字号上乘以一个因子。大部分时候,默认的基础行距是 1.2 倍字号大小,
因此设置 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}

Expand Down Expand Up @@ -431,7 +431,7 @@ \subsection{垂直间距}\label{subsec:vspace}

\section{页面和分栏}\label{sec:page-columns}

我们不妨回顾一下第一章介绍的文档类属性。\LaTeX\ 允许你通过文档类选项控制纸张的大小(见表 \ref{tbl:ltx-options}),
我们不妨回顾一下第一章介绍的文档类属性。\LaTeX\ 允许你通过为文档类指定选项来控制纸张的大小(见表 \ref{tbl:ltx-options}),
包括 \texttt{a4paper}、\texttt{letterpaper}等等,并配合字号设置了适合的页边距。

\cmdindex{textheight,textwidth}
Expand Down Expand Up @@ -558,7 +558,7 @@ \subsection{分栏}\label{subsec:columns}
\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}

Expand Down
Loading

0 comments on commit 3b4a0cf

Please sign in to comment.