Skip to content

Commit

Permalink
lshort-zh-cn v6.0
Browse files Browse the repository at this point in the history
Accumulative update of Chinese version of lshort.
  • Loading branch information
louisstuart96 committed Sep 1, 2018
1 parent d9297fe commit e289d4c
Show file tree
Hide file tree
Showing 14 changed files with 314 additions and 241 deletions.
2 changes: 1 addition & 1 deletion src/chap/app.A.install.tex
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ \section{\protect\TeX\ 发行版简介}\label{sec:dists}
\end{itemize}

\TeX\ Live 和 Mik\TeX\ 都集成了一个简单的 \LaTeX\ 源代码编辑器 \TeX works(Mac\TeX\ 则集成了类似的 \TeX shop)。
用户在完成发行版的安装后,可直接打开编辑器开始编写 \LaTeX\ 源代码。
用户在安装完毕,可直接使用 \TeX works 编写和编译 \LaTeX\ 源代码。

\subsection{安装发行版}\label{subsec:install-dists}

Expand Down
2 changes: 1 addition & 1 deletion src/chap/biblio.tex
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@
\newblock \emph{The \LaTeX\ font catalogue}, a font catalogue of \LaTeX\ font packages.\\
\url{http://www.tug.dk/FontCatalogue/}

\bibitem{ltxprimer} Indian \TeX\ user group.
\bibitem{ltxprimer} Indian \TeX\ users group.
\newblock \emph{\LaTeX\ Tutorials: A primer}. \\
\url{http://www.tug.org/twg/mactex/tutorials/ltxprimer-1.0.pdf}

Expand Down
85 changes: 43 additions & 42 deletions src/chap/chap.01.basics.tex
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ \subsection{\protect\TeX}\label{subsec:tex}
\TeX\ 排版引擎发布于 1982 年,在 1989 年又加以改进以更好地支持 8-bit 字符和多语言排版。
\TeX\ 以其卓越的稳定性、跨平台、几乎没有 Bug 而著称。\TeX\ 的版本号不断趋近于 $\pi$,当前为 3.141592653。

\TeX\ 读作 ``Tech'' ,其中 ``ch'' 的发音类似于 ``h'' ,与汉字“泰赫”的发音类似\TeX\ 的拼写来自希腊词语
\TeX\ 读作 ``Tech'' ,其中 ``ch'' 的发音类似于 ``h'' ,与汉字“泰赫”的发音相近\TeX\ 的拼写来自希腊词语
{\fontencoding{LGR}\selectfont teqnik'h} (technique,技术) 的开头几个字母。在 ASCII 字符环境,\TeX\ 写作 \texttt{TeX}。

\subsection{\LaTeX}\label{subsec:latex}
Expand All @@ -29,7 +29,7 @@ \subsection{\LaTeX}\label{subsec:latex}
\LaTeX\ 的最初开发者为 Leslie Lamport 博士\cite{manual}。\LaTeX\ 使用 \TeX\ 程序作为自己的排版引擎。
当前 \LaTeX\ \LaTeX 3 工作组\footnote{\url{https://www.latex-project.org}}维护。

\LaTeX\ 读作 ``Lah-tech'' 或者 ``Lay-tech''近似于汉字“拉泰赫”或“雷泰赫”。\LaTeX\ 在 ASCII 字符环境写作 \texttt{LaTeX}。
\LaTeX\ 读作 ``Lah-tech'' 或者 ``Lay-tech''与汉字“拉泰赫”或“雷泰赫”的发音相近\LaTeX\ 在 ASCII 字符环境写作 \texttt{LaTeX}。
当前的 \LaTeX\ 版本为 \LaTeXe ,意思是超出了第二版,接近但没达到第三版,在 ASCII 字符环境写作 \texttt{LaTeX2e}。

\subsection{\LaTeX\ 的优缺点}\label{subec:advs}
Expand Down Expand Up @@ -87,16 +87,16 @@ \section{第一次使用 \LaTeX}\label{sec:run}
\end{sourcecode}

假设将源代码 \ref{code:hello-world} 保存成 \texttt{helloworld.txt}。如果使用 \TeX works 或 \TeX studio 等编辑器,
点击编辑器提供的“编译”按钮即可。在此建议将编译命令设为 “\hologo{XeLaTeX}”。编译成功后生成文档 \texttt{helloworld.pdf}。
点击编辑器提供的“编译”按钮即可。在此建议将编译命令设为 “XeLaTeX”。编译成功后生成文档 \texttt{helloworld.pdf}。

另外也可以使用命令行的方式调用程序进行编译(笔者建议尝试一下,以了解背后的工作原理)。
打开 Windows 命令提示符或者 Linux / macOS(OS X)的终端,输入命令
另外也可以使用命令行的方式调用程序进行编译(笔者建议尝试命令行方式,以了解背后的工作原理)。
打开 Windows 命令提示符或者 Linux / macOS(OS X)的终端,在源代码所在的目录下输入命令
\begin{verbatim}
xelatex helloworld
\end{verbatim}
此时命令行会闪过许多信息,如果编译成功,可以看到会生成 \texttt{helloworld.pdf} 以及一些其它文件。

\subsection{引擎、格式和命令}\label{subsec:concepts}
\subsection{引擎、格式和编译命令}\label{subsec:concepts}

\pinyinindex{paibanyinqing}{排版引擎}
\index{pdfTeX@\hologo{pdfTeX}}
Expand All @@ -106,45 +106,51 @@ \subsection{引擎、格式和命令}\label{subsec:concepts}
\item[引擎] 全称为排版引擎,是编译源代码并生成文档的程序,如 \hologo{pdfTeX}、\hologo{XeTeX} 等。有时也称为编译器。
\item[格式] 是定义了一组命令的代码集。\LaTeX\ 就是最广泛应用的一个格式,高德纳本人还编写了一个简单的 plain \TeX\ 格式,
没有定义诸如 \cmd{document\-class} 和 \cmd{section} 等等命令。
\item[命令] 是实际调用的、结合了引擎和格式的排版命令。如之前用过的 \texttt{xelatex} 命令是结合 \hologo{XeTeX}
引擎和 \LaTeX\ 格式的一个命令
\item[编译命令] 是实际调用的、结合了引擎和格式的命令。如 \texttt{xelatex} 命令是结合 \hologo{XeTeX}
引擎和 \LaTeX\ 格式的一个编译命令
\end{description}
常见的引擎、格式和命令的关系总结于表 \ref{tbl:engine-format-command}。
常见的引擎、格式和编译命令的关系总结于表 \ref{tbl:engine-format-command}。

\begin{table}[htp]
\centering
\caption{\TeX\ 引擎、格式和命令。}
\caption{\TeX\ 引擎、格式和编译命令。}
\label{tbl:engine-format-command}
\begin{tabular}{ccc}
\begin{tabular}{cccc}
\hline
& \textbf{plain \TeX\ 格式} & \textbf{\LaTeX\ 格式} \\
& \textbf{文档格式} & \textbf{plain \TeX\ 格式} & \textbf{\LaTeX\ 格式} \\
\hline
\TeX\ 引擎 & \texttt{tex} & N/A \\
\hologo{pdfTeX} 引擎 & \texttt{etex} & \texttt{latex} \\
& \texttt{pdftex} & \texttt{pdflatex} \\
\hologo{XeTeX} 引擎 & \texttt{xetex} & \texttt{xelatex} \\
\TeX\ 引擎 & DVI & \texttt{tex} & N/A \\
\hologo{pdfTeX} 引擎 & DVI & \texttt{etex} & \texttt{latex} \\
& PDF & \texttt{pdftex} & \texttt{pdflatex} \\
\hologo{XeTeX} 引擎 & PDF & \texttt{xetex} & \texttt{xelatex} \\
\hologo{LuaTeX} 引擎 & PDF & \texttt{luatex} & \texttt{lualatex} \\
\hline
\end{tabular}
\end{table}

\texttt{latex} 命令和 \LaTeX\ 格式往往容易混淆,在讨论关于 \LaTeX\ 的时候需要明确。
为避免混淆,本手册中的 \LaTeX\ 一律指的是\textbf{格式},\textbf{命令}则用等宽字体 \texttt{latex} 表示。
\texttt{latex} 编译命令和 \LaTeX\ 格式往往容易混淆,在讨论关于 \LaTeX\ 的时候需要明确。
为避免混淆,本手册中的 \LaTeX\ 一律指的是\textbf{格式},\textbf{编译命令}则用等宽字体 \texttt{latex} 表示。

在此介绍一下几个编译命令的基本特点:
\begin{description}
\item[\texttt{latex}]
虽然名为 \texttt{latex} 命令,底层调用的引擎其实是 \hologo{pdfTeX},不过生成的文档格式不是 \texttt{pdf}
而是 \texttt{dvi}(Device Independent)格式,用 \texttt{dvipdfmx} 命令可以将其转为 \texttt{pdf}。
虽然名为 \texttt{latex} 命令,底层调用的引擎其实是 \hologo{pdfTeX}。
该命令生成 \texttt{dvi}(Device Independent)格式的文档,
\texttt{dvipdfmx} 命令可以将其转为 \texttt{pdf}。
\item[\texttt{pdflatex}]
底层调用的引擎也是 \hologo{pdfTeX},可以直接生成 \texttt{pdf} 格式的文档。
\item[\texttt{xelatex}]
底层调用的引擎是 \hologo{XeTeX},支持 UTF-8 编码和 TrueType / OpenType 字体。
当下排版中文的较为方便的解决方案就基于 \texttt{xelatex},详见 \ref{sec:chinese} 节。
当前较为方便的中文排版解决方案基于 \texttt{xelatex},详见 \ref{sec:chinese} 节。
\item[\texttt{lualatex}]
底层调用的引擎是 \hologo{LuaTeX},这个引擎在 \hologo{pdfTeX} 引擎基础上发展而来,
除了支持 UTF-8 编码和 TrueType / OpenType 字体外,还支持通过 Lua 语言扩展 \TeX\ 的功能。
\texttt{lualatex} 编译命令下的中文排版支持需要借助 \pkg{luatex-ja} 宏包。
\end{description}

\section{\LaTeX\ 命令和代码结构}\label{sec:src}

\LaTeX\ 的源代码本质上是文本文件。这些文本除了文字本身,还包括各种命令,
\LaTeX\ 的源代码为文本文件。这些文本除了文字本身,还包括各种命令,
用在排版公式、划分文档结构、控制样式等等不同的地方。

\subsection{\LaTeX\ 命令和环境}\label{subsec:cmds}
Expand Down Expand Up @@ -177,7 +183,7 @@ \subsection{\LaTeX\ 命令和环境}\label{subsec:cmds}

\index{LaTeX environment@\LaTeX\ 环境}
\cmdindex{begin,end}
\LaTeX\ 还引入了\textbf{环境}的用法,用以令一些效果在局部生效,或是生成特定的文档元素
\LaTeX\ 还引入了\textbf{环境}的用法,用以令一些效果在局部生效,或是生成特殊的文档元素
\LaTeX\ 环境的用法为一对命令 \cmd{begin} 和 \cmd{end}:
\begin{command}
\cmd{begin}\marg{environment name}\marg{arguments} \\
Expand All @@ -186,10 +192,10 @@ \subsection{\LaTeX\ 命令和环境}\label{subsec:cmds}
\end{command}

其中 \Arg{environment name} 为环境名,\cmd{begin} 和 \cmd{end} 中填写的环境名应当一致。
\Arg{arguments} 为环境所需的参数,可能包括参数。环境允许嵌套使用。
\Arg{arguments} 为环境所需的参数,可能包括可选参数。环境允许嵌套使用。

\pinyinindex{fenzu}{分组}
除了 \LaTeX\ 环境之外,花括号本身也起到\textbf{分组}的作用,起到类似环境的令效果在局部生效的作用,
除了 \LaTeX\ 环境之外,花括号本身也起到\textbf{分组}的作用,使命令的效果限制在分组内。
例如 \ref{subsec:fontshape} 和 \ref{subsec:fontsize} 小节中介绍的修改字体和字号的命令用法。

\subsection{\LaTeX\ 源代码结构}\label{subsec:struct}
Expand All @@ -203,16 +209,17 @@ \subsection{\LaTeX\ 源代码结构}\label{subsec:struct}

\cmdindex{usepackage}
\pinyinindex{hongbao}{宏包}
紧接着我们可以用 \cmd{usepackage} 命令调用\textbf{宏包}:
之后用 \cmd{usepackage} 命令调用\textbf{宏包}:
\begin{verbatim}
\usepackage{...}
\end{verbatim}

\envindex{document}
再接着,我们需要用 \env{document} 环境来标记正文内容范围:
再接着, \env{document} 环境来标记正文内容范围:
\begin{verbatim}
\begin{document}
% 正文内容。
\section{...}
正文内容……
\end{document}
\end{verbatim}

Expand Down Expand Up @@ -252,23 +259,19 @@ \subsection{文档类}\label{subsec:classes}
\cls{proc} & 基于 \cls{article} 文档类的一个简单的学术文档模板。\\
\cls{slides} & 幻灯格式的文档类,使用无衬线字体。\\
\cls{minimal} & 一个极其精简的文档类,只设定了纸张大小和基本字号,
用作代码测试的最小工作示例(Minimal Working Example)。 \\
用作代码测试的最小工作示例(Minimal Working Example)。 \\
\hline
\end{tabular}
\end{table}

\pinyinindex{xuanxiang}{选项(宏包/文档类)}
可选参数 \Arg{options} 为文档类指定选项,以全局地影响文档布局的参数,如字号、纸张大小、单双面等等。
可选参数 \Arg{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
\LaTeX\ 的三个标准文档类可指定的选项包括:
\begin{description}
\item[\texttt{10pt, 11pt, 12pt}] \quad 指定文档的基本字号。缺省为 \texttt{10pt}。

Expand All @@ -288,15 +291,13 @@ \subsection{文档类}\label{subsec:classes}
\item[\texttt{titlepage, notitlepage}] 指定标题命令 \cmd{maketitle} 是否生成单独的标题页。
\cls{article} 缺省为 \texttt{notitlepage},\cls{report} 和 \cls{book} 缺省为 \texttt{titlepage}。

\item[\texttt{fleqn}] \quad 令行间公式左对齐(缺省为居中)
\item[\texttt{fleqn}] \quad 令行间公式左对齐。缺省为居中对齐

\item[\texttt{leqno}] \quad 将公式编号放在左边缺省为右边
\item[\texttt{leqno}] \quad 将公式编号放在左边缺省为右边。

\item[\texttt{draft, final}] \quad 指定草稿/终稿模式。
草稿模式下,断行不良的地方会在行尾添加一个黑色方块。缺省为 \texttt{final}。
\end{description}
\hrule
\end{table}

\subsection{宏包}\label{subsec:packages}

Expand Down Expand Up @@ -331,7 +332,7 @@ \subsection{宏包}\label{subsec:packages}

\section{\LaTeX\ 用到的文件一览}\label{sec:latex-files}

除了我们需要编写的源代码 \texttt{.tex} 文件,我们还可能接触到形形色色的文件
除了源代码文件 \texttt{.tex} 以外,我们在使用 \LaTeX\ 时还可能接触到各种格式的文件
本节简单介绍一下在使用 \LaTeX\ 时能够经常见到的文件。

每个宏包和文档类都是带特定扩展名的文件,除此之外也有一些文件出现于 \LaTeX\ 模板中:
Expand Down Expand Up @@ -361,7 +362,7 @@ \section{\LaTeX\ 用到的文件一览}\label{sec:latex-files}

\section{文件的组织方式}\label{sec:latex-multi-files}

当编写较大规模的 \LaTeX\ 源代码,如书籍、毕业论文等,你有理由将源代码分成若干个文件而不是写到一堆,比如很自然地每章写一个文件
当编写较大规模的 \LaTeX\ 源代码,如书籍、毕业论文等,有理由将源代码分成若干个文件,比如每章内容为一个文件
可参考源代码 \ref{code:book-struct} 的写法。

\cmdindex{include}
Expand Down Expand Up @@ -400,6 +401,6 @@ \section{文件的组织方式}\label{sec:latex-multi-files}
\syntaxonly
\end{verbatim}

如果想生成文档,则将 \cmd{syntaxonly} 命令那一行用 \texttt\% 注释掉即可
如果想生成文档,则用 \texttt\% 注释掉 \cmd{syntaxonly} 命令即可

\endinput
Loading

0 comments on commit e289d4c

Please sign in to comment.