zhlineskip (16may19)

git-svn-id: svn://tug.org/texlive/trunk@51142 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 277 insertions, 172 deletions

diff --git a/Master/texmf-dist/doc/latex/zhlineskip/README.md b/Master/texmf-dist/doc/latex/zhlineskip/README.md
index af89b6f66ea..7b738ff3865 100644
--- a/Master/texmf-dist/doc/latex/zhlineskip/README.md
+++ b/Master/texmf-dist/doc/latex/zhlineskip/README.md
@@ -2,15 +2,16 @@ zhlineskip
 ==========
 
 `zhlineskip` is a package for typesetting CJK documents. This package allows users
-to specify the two ratios between the leading and the font size of the body text
-and the footnote text. For Latin typesetting, these ratios usually range
+to specify two ratios: One between the leading and the font size of the body text
+and the other between those of the footnote text.
+For Latin typography, these ratios usually range
 [from 1.2 to 1.45](https://practicaltypography.com/line-spacing.html),
-but they should be larger for CJK typesetting (usually from 1.5 to 1.67).
+but they should be larger for CJK typography (usually from 1.5 to 1.67).
 
-On the one hand, CJK text requires larger line spacing. On the other hand, math
-line spacing should follow Latin typesetting, since math often consists of only
-Latin letters and symbols. The `zhlineskip` package is capable of restoring the
-math leading to that of the Latin text.
+Although CJK text requires larger line spacing, maths formulae should follow
+the rules of Latin typography, since maths often consists of only Latin-based
+letters and symbols. The `zhlineskip` package is capable of restoring the
+maths leading to that of the Latin text.
 
 Finally, it is possible to achieve the “Microsoft Word multiple line spacing”
 style using `zhlineskip`.
@@ -25,7 +26,7 @@ Issues and pull requests are welcome.
 Copyright and Licence
 ---------------------
 
-    Copyright (C) 2018 by Ruixi Zhang <ruixizhang42@gmail.com>
+    Copyright (C) 2018, 2019 by Ruixi Zhang <ruixizhang42@gmail.com>
     
     This work may be distributed and/or modified under the
     conditions of the LaTeX Project Public License, either version 1.3c
@@ -40,9 +41,9 @@ Copyright and Licence
     The Current Maintainer of this work is Ruixi Zhang.
     
     This work consists of the files zhlineskip.sty,
-                                    zhlineskip-man.tex,
+                                    zhlineskip.tex,
                                     zhlineskip-test.tex,
                                     Latinmetrics.pdf,
                                     CJKmetrics.pdf,
                                     README.md (this file)
-              and the derived file  zhlineskip-man.pdf.
\ No newline at end of file
+              and the derived file  zhlineskip.pdf.
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip-man.pdf b/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip-man.pdf
deleted file mode 100644
index cafc5c4a075..00000000000
--- a/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip-man.pdf
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip.pdf b/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip.pdf
new file mode 100644
index 00000000000..7f3c693dd04
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip.pdf
diff --git a/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip-man.tex b/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip.tex
index 07ac6e8a00d..834689fb729 100644
--- a/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip-man.tex
+++ b/Master/texmf-dist/doc/latex/zhlineskip/zhlineskip.tex
@@ -1,20 +1,23 @@
 % !TeX program = XeLaTeX
 % !TeX encoding = UTF-8 Unicode
 %
-% 为了得到最佳的排版结果，可以考虑安装免费的思源宋体、思源黑体与 Fandol 字库
+% 为了得到最佳的排版结果，可以考虑安装免费的思源宋体、思源黑体与 M+ 字体
 % - 思源字库可以前往
 %   https://github.com/adobe-fonts/source-han-serif/tree/release
 %   https://github.com/adobe-fonts/source-han-sans/tree/release
 % 下载，请安装 Language-specific OTFs 的简体中文版本
-% - Fandol 字库可以通过发行版 TeX Live 或 MiKTeX 安装
+% - M+ 字体可以前往
+%   https://osdn.net/projects/mplus-fonts/releases/
+% 下载
 %
-% 如果已经安装了思源、Fandol 字库，请在导言区启用 \SourceHanSCandFandoltrue
+% 如果已经安装了思源、M+ 字体，请在导言区启用 \SourceHanSCandMplustrue
 %
-\documentclass[zihao=5,no-math,a4paper]{ctexart}
-\newif\ifSourceHanSCandFandol
-\SourceHanSCandFandolfalse
-% 如果已经安装了思源、Fandol 字库，请启用 \SourceHanSCandFandoltrue
-%\SourceHanSCandFandoltrue
+\documentclass[zihao=5,a4paper]{ctexart}
+\XeTeXgenerateactualtext=1 %
+\newif\ifSourceHanSCandMplus
+\SourceHanSCandMplusfalse
+% 如果已经安装了思源、M+ 字体，请启用 \SourceHanSCandMplustrue
+%\SourceHanSCandMplustrue
 \frenchspacing
 \ctexset{
   section={
@@ -33,91 +36,116 @@
 }
 \usepackage{mathtools}
 \usepackage[math-style=ISO]{unicode-math}
-\ifSourceHanSCandFandol
-  \setmainfont{TeX Gyre Pagella}[
-    Scale=1.0534682080924855,
-    WordSpace={0.8984910836762689,1.2030178326474623,0.6954732510288066},
+\ifSourceHanSCandMplus
+  \setmainfont{texgyrepagella}[
+    Extension=.otf,
+    UprightFont=*-regular,
+    ItalicFont=*-italic,
+    BoldFont=*-bold,
+    BoldItalicFont=*-bolditalic,
+    Scale=1.05924855491329480,
     SmallCapsFeatures={LetterSpace=5}
   ]
-  \setsansfont{TeX Gyre Heros}[
-    Scale=1.0068587105624143,
-    WordSpace={0.7863093721208319,1.4273812557583361,0.3589281163624958}
+  \setsansfont{texgyreheros}[
+    Extension=.otf,
+    UprightFont=*-regular,
+    ItalicFont=*-italic,
+    BoldFont=*-bold,
+    BoldItalicFont=*-bolditalic,
+    Scale=1.00685871056241427
   ]
-  \setmonofont{Source Han Sans SC}[
-    BoldFont=Source Han Sans SC Bold,
-    CharacterWidth=Half
+  \setmonofont{mplus-1m-regular.ttf}[
+    BoldFont=mplus-1m-bold.ttf
   ]
-  \setmathfont{TeX Gyre Pagella Math}[
-    Scale=1.0534682080924855
+  \setmathfont{texgyrepagella-math.otf}[
+    Scale=1.05924855491329480
   ]
-  \setCJKmainfont{Source Han Serif SC Medium}[
-    ItalicFont=FandolKai-Regular,
-    ItalicFeatures={FakeBold=1},
-    BoldFont=Source Han Serif SC Bold,
-    BoldItalicFont=FandolKai-Regular,
-    BoldItalicFeatures={FakeBold=3},
-    CharacterWidth=Full
+  \setCJKmainfont{SourceHanSerifSC-Medium.otf}[
+    ItalicFont=SourceHanSerifSC-Heavy.otf,
+    BoldFont=SourceHanSerifSC-Bold.otf,
+    Language=Chinese Simplified
+  ]
+  \setCJKsansfont{SourceHanSansSC-Regular.otf}[
+    BoldFont=SourceHanSansSC-Bold.otf,
+    Language=Chinese Simplified
+  ]
+  \setCJKmonofont{SourceHanSansSC-Regular.otf}[
+    BoldFont=SourceHanSansSC-Bold.otf,
+    Language=Chinese Simplified
   ]
-  \usepackage{etoolbox}
   \makeatletter
-  \newcommand*\original@CJKsymbol{}
-  \newcommand*\original@CJKpunctsymbol{}
-  \let\original@CJKsymbol\CJKsymbol
-  \let\original@CJKpunctsymbol\CJKpunctsymbol
-  \newcommand*\raise@Fandol@CJK[1]{\raise0.08\ccwd\hbox{#1}}
-  \appto\itshape{%
-    \let\CJKsymbol\raise@Fandol@CJK
-    \let\CJKpunctsymbol\raise@Fandol@CJK
+  \def\setCJKecglue@nnn#1#2#3{%
+    \xeCJKsetup
+      { xCJKecglue = {\hskip #1em plus #2em minus #3em\relax} }%
   }
-  \appto\upshape{%
-    \let\CJKsymbol\original@CJKsymbol
-    \let\CJKpunctsymbol\original@CJKpunctsymbol
+  \newcommand*\setCJKecglue{%
+    \ifnum\strcmp{\f@family}{\rmdefault}=0 %
+      \setCJKecglue@nnn{0.22203274215552524}
+                       {0.11101637107776262}
+                       {0.07401091405184175}%
+    \else
+      \ifnum\strcmp{\f@family}{\sfdefault}=0 %
+        \setCJKecglue@nnn{0.21859400544959128}
+                         {0.10929700272479564}
+                         {0.07286466848319709}%
+      \else
+        \setCJKecglue@nnn{0.25}
+                         {0.125}
+                         {0.08333333333333333}%
+      \fi
+    \fi
   }
   \makeatother
-  \setCJKsansfont{Source Han Sans SC}[
-    BoldFont=Source Han Sans SC Bold,
-    CharacterWidth=Full
-  ]
-  \setCJKmonofont{Source Han Sans SC}[
-    BoldFont=Source Han Sans SC Bold,
-    CharacterWidth=Full
-  ]
+  \usepackage{everysel}
+  \EverySelectfont{\setCJKecglue}
 \else
-  \setmainfont{TeX Gyre Pagella}[
+  \setmainfont{texgyrepagella}[
+    Extension=.otf,
+    UprightFont=*-regular,
+    ItalicFont=*-italic,
+    BoldFont=*-bold,
+    BoldItalicFont=*-bolditalic,
     SmallCapsFeatures={LetterSpace=5}
   ]
-  \setsansfont{TeX Gyre Heros}
-  \setmathfont{TeX Gyre Pagella Math}
+  \setsansfont{texgyreheros}[
+    Extension=.otf,
+    UprightFont=*-regular,
+    ItalicFont=*-italic,
+    BoldFont=*-bold,
+    BoldItalicFont=*-bolditalic
+  ]
+  \setmathfont{texgyrepagella-math.otf}
 \fi
 \usepackage{zhlineskip}
 \SetTextEnvironmentSinglespace{1.05}
 \SetMathEnvironmentSinglespace{1.05}
-\ifSourceHanSCandFandol
-  \SetTextEnvironmentSinglespace{1.106}
-  \SetMathEnvironmentSinglespace{1.106}
+\ifSourceHanSCandMplus
+  \SetTextEnvironmentSinglespace{1.112}
+  \SetMathEnvironmentSinglespace{1.112}
 \fi
 \usepackage{caption}
-\DeclareCaptionLabelSeparator{zhcolon}{~：}% U+FF1A, Fullwidth Colon
-\captionsetup{labelsep=zhcolon,format=hang}
+\DeclareCaptionLabelFormat{zhlabel}{\bothIfFirst{#1}{\nobreak\CJKecglue}#2\CJKecglue}
+\DeclareCaptionLabelSeparator{zhcolon}{\char"FF1A }% Fullwidth Colon
+\captionsetup{format=hang,labelformat=zhlabel,labelsep=zhcolon,font={small,sf}}
 \usepackage{enumitem}
 \setlist{
   listparindent=\parindent,parsep=\parskip
 }
-\ifSourceHanSCandFandol
+\ifSourceHanSCandMplus
   \setlist[itemize,1]{
     itemsep=0pt,
-    label=・,% U+30FB, Katakana Middle Dot
+    label=\char"30FB,% Katakana Middle Dot
     leftmargin=\parindent,labelsep=0pt,labelwidth=0.5\parindent
   }
 \else
   \setlist[itemize,1]{
     itemsep=0pt,
-    label=·,% U+00B7, Middle Dot
+    label=\char"00B7,% Middle Dot
     leftmargin=\parindent,labelsep=0pt,labelwidth=0.5\parindent
   }
 \fi
 \setlist[description,1]{
-  font=\mdseries,
+  font=\bfseries,
   leftmargin=\parindent,labelsep=0.5\parindent
 }
 \usepackage{booktabs}
@@ -126,15 +154,15 @@
   colorlinks=true,
   pdfstartview={FitH},
   unicode=true,
-  pdftitle={zhlineskip-man},
-  pdfauthor={张瑞熹}
+  pdftitle={zhlineskip},
+  pdfauthor={Ruixi Zhang}
 }
 \usepackage[open,openlevel=-1,numbered]{bookmark}
-\usepackage[width=378bp]{geometry}
+\usepackage[text={378bp,609bp},centering]{geometry}
 
 \makeatletter
-\ifSourceHanSCandFandol
-  \ExplSyntaxOn
+\ExplSyntaxOn
+\ifSourceHanSCandMplus
   \xeCJK_new_class:n { PoZheHao }
   \__xeCJK_save_CJK_class:n { PoZheHao }
   \seq_map_inline:Nn \g__xeCJK_class_seq
@@ -146,8 +174,8 @@
         }
     }
   \xeCJK_declare_char_class:nn { PoZheHao } { "2014 , "2015 }
-  \ExplSyntaxOff
 \fi
+\ExplSyntaxOff
 % From `doc.dtx'
 \ifx\l@nohyphenation\undefined
   \newlanguage\l@nohyphenation
@@ -179,12 +207,12 @@
 \newcommand\parg[1]{%
   {\ttfamily(}\meta{#1}{\ttfamily)}}
 % My commands
-\newcommand\cls[1]{{\normalfont\ttfamily#1}}
-\newcommand\pkg[1]{{\normalfont\ttfamily#1}}
-\newcommand\opt[1]{{\normalfont\ttfamily#1}}
-\newcommand\env[1]{{\normalfont\ttfamily#1}}
+\newcommand\cls[1]{{\ttfamily#1}}
+\newcommand\pkg[1]{{\ttfamily#1}}
+\newcommand\opt[1]{{\ttfamily#1}}
+\newcommand\env[1]{{\ttfamily#1}}
 \newcommand*\packagedependency[1]{%
-  \mbox{\pkg{#1}~宏包：}\ignorespaces
+  \mbox{\pkg{#1}\CJKecglue 宏包：}\ignorespaces
 }
 \newcommand*\keyvalueitem[3][2.5]{%
   \item[\opt{#2}\hskip0.5\ccwd\relax\rlap{\meta{#3}}\hskip#1\ccwd\relax]%
@@ -204,12 +232,20 @@
 }
 \newenvironment{originalpmatrix}{\left(\env@matrix}{\endmatrix\right)}
 \newenvironment{originalcases}{\env@cases}{\endarray\right.}
+\newcounter{example}
+\newcommand*\example{%
+  \refstepcounter{example}%
+  例\nobreak\CJKecglue\theexample\CJKecglue\char"FF1A %
+}
+\newenvironment{english}
+  {\addvspace\medskipamount}
+  {\par\addvspace\medskipamount}
 \newcommand*\myemail{ruixizhang42@gmail.com}
 \makeatother
 
 \title{\vspace*{-26bp}\pkg{zhlineskip} 宏包}
 \author{张瑞熹\thanks{\href{mailto:\myemail}{\nolinkurl{\myemail}}。}}
-\date{2018/11/30\hskip\ccwd\relax v1.0d}
+\date{2019/05/15\hskip\ccwd\relax v1.0e}
 
 \begin{document}
 
@@ -222,8 +258,8 @@
 \pkg{zhlineskip} 宏包允许用户指定正文行距相比于正文字号的倍数（通常建议设置在
 $1.5$ 至 $1.67$ 之间），以及脚注行距相比于脚注字号的倍数。另一方面，由于数学公式
 主要是由西文字符构成的，\pkg{zhlineskip} 还能将数学公式的行距“恢复”成西文
-较为紧凑的行距（通常为西文字号的 $1.2$~倍），使得全文的视觉密度较为均匀。最后，
-本宏包还支持按照 Microsoft Word 进行“多倍行距”排版。
+较为紧凑的行距（通常为西文字号的 $1.2$\nobreak\CJKecglue 倍），使得全文的视觉
+密度较为均匀。最后，本宏包还支持按照 Microsoft Word 进行“多倍行距”排版。
 
 \subsection{宏包依赖}
 
@@ -232,7 +268,7 @@ $1.5$ 至 $1.67$ 之间），以及脚注行距相比于脚注字号的倍数。
 \item \packagedependency{kvoptions}
 为用户提供载入本宏包的键值选项。
 \item \packagedependency{xintexpr~}
-实现精确的浮点运算，属于 \pkg{xint} 宏集的一个部分。
+实现精确的浮点运算，属于\CJKecglue\pkg{xint} 宏集的一个部分。
 \item \packagedependency{etoolbox~}
 处理脚注行距与数学行距时需要打补丁。
 \item \packagedependency{mathtools}
@@ -245,9 +281,9 @@ $1.5$ 至 $1.67$ 之间），以及脚注行距相比于脚注字号的倍数。
 在西文排版里，相邻两行\emph{基线}（baseline）之间的距离称为\emph{行距}（leading，
 发音为 led-ding）。这个词的词根是 lead，即\emph{铅}。早在铅字时代，每当工匠填满
 一行铅字之后要开始填下一行，都会在两行之间插入铅条，从而适当地扩大行距。因为西文的
-每个字母四周与其\emph{字框}（em-box，见图~\ref{fig:eng-font-size}）之间有
+每个字母四周与其\emph{字框}（em-box，见图\nobreak\CJKecglue\ref{fig:eng-font-size}）之间有
 较大的空隙，所以不需要插入很高的铅条。一般来说，西文的行距为\emph{字号}（font
-size）的 $1.2$ 至 $1.45$~倍\footnote{参见
+size）的 $1.2$ 至 $1.45$\nobreak\CJKecglue 倍\footnote{参见
 \url{https://practicaltypography.com/line-spacing.html}。}。
 
 \begin{figure}[h]
@@ -258,12 +294,13 @@ size）的 $1.2$ 至 $1.45$~倍\footnote{参见
 \end{figure}
 
 中文排版虽然没有基线的概念，但有非常相似的概念：\emph{底线}（ideographic baseline，
-见图~\ref{fig:chi-font-size}）。中文里相邻两行底线之间的距离，与西文里行距的
+见图\nobreak\CJKecglue\ref{fig:chi-font-size}）。中文里相邻两行底线之间的距离，与西文里行距的
 概念是一致的。另一概念是上一行底线和下一行\emph{顶线}之间的距离，即\emph{行间距}（line
 gap），这与西文里插入铅条的高度是一致的。由于汉字四周与其字框间的空隙较小，所以需要
-使用比西文更大的行间距。根据场合不同，行间距从字号的 $1/4$ 至 $1$~倍不等：以中文
-书刊为例，行间距一般为字号的 $1/2$ 至 $2/3$~倍\footnote{参见张胜涛、王忆波著
-《方正飞腾4.0实用培训教程》，第~6.1.1~节。}，即行距约为字号的 $1.5$ 至 $1.67$~倍。
+使用比西文更大的行间距。根据场合不同，行间距从字号的 $1/4$ 至 $1$\nobreak\CJKecglue 倍不等：以中文
+书刊为例，行间距一般为字号的 $1/2$ 至 $2/3$\nobreak\CJKecglue 倍\footnote{参见张胜涛、王忆波著
+《方正飞腾4.0实用培训教程》，第\nobreak\CJKecglue6.1.1\nobreak\CJKecglue 节。}，即行距约为字号的
+$1.5$ 至 $1.67$\nobreak\CJKecglue 倍。
 
 \begin{figure}[h]
 \centering
@@ -272,13 +309,14 @@ gap），这与西文里插入铅条的高度是一致的。由于汉字四周�
 \label{fig:chi-font-size}
 \end{figure}
 
-在一般情况下，\CTeX\ 会默认用 \opt{linespread=1.3} 这个文档类选项将中文的
-行距设置为字号的 $1.56$~倍（基础行距是字号的 $1.2$~倍，而 $1.2 \times 1.3
+在一般情况下，\CTeX\ 会默认用\CJKecglue\opt{linespread=1.3} 这个文档类
+选项将中文的行距设置为字号的 $1.56$\nobreak\CJKecglue 倍（基础行距是字号的
+$1.2$\nobreak\CJKecglue 倍，而 $1.2 \times 1.3
 = 1.56$）。通过这种方法扩大全文的行距，自然会影响到文章里数学公式的行距。而数学
 公式主要是由西文字符构成的，把它们按照中文的行距进行排版，就会显得有些松散。
-图~\ref{fig:math-leading} 左边是 \CTeX\ 默认排版效果，文本、数学看似
-一紧、一松；右边是配合用 \pkg{zhlineskip} 的效果，视觉密度比较均匀。
-\pkg{zhlineskip} 宏包还允许用户调整数学行距的大小。
+图\nobreak\CJKecglue\ref{fig:math-leading}\CJKecglue 左边是 \CTeX\ 默认
+排版效果，文本、数学看似一紧、一松；右边是配合用\CJKecglue\pkg{zhlineskip} 的效果，
+视觉密度比较均匀。\pkg{zhlineskip} 宏包还允许用户调整数学行距的大小。
 
 \begin{figure}[h]
 \sbox0{%
@@ -286,7 +324,8 @@ gap），这与西文里插入铅条的高度是一致的。由于汉字四周�
 \fontsize{9}{10.8}\linespread{1.3}\selectfont
 \rule{0pt}{\ht\strutbox}\hskip2\ccwd\relax
 设 $\symbf{I}_2=\begin{psmallmatrix} 1&0\\0&1 \end{psmallmatrix}$.
-又设 $\symbf{A}=(a_{ij})_{m \times n}$ 为一个 $m$~行 $n$~列的实值矩阵, 即
+又设 $\symbf{A}=(a_{ij})_{m \times n}$ 为一个 $m$\nobreak\CJKecglue 行
+$n$\nobreak\CJKecglue 列的实值矩阵, 即
 \[
 \symbf{A} = \begin{originalpmatrix}
 a_{11} & a_{12} & \dotsc & a_{1n} \\
@@ -314,7 +353,8 @@ a_{m1} & a_{m2} & \dotsc & a_{mn}
 \fontsize{9}{10.8}\linespread{1.25}\selectfont
 \hskip2\ccwd\relax
 设 $\symbf{I}_2=\begin{psmallmatrix} 1&0\\0&1 \end{psmallmatrix}$.
-又设 $\symbf{A}=(a_{ij})_{m \times n}$ 为一个 $m$~行 $n$~列的实值矩阵, 即
+又设 $\symbf{A}=(a_{ij})_{m \times n}$ 为一个 $m$\nobreak\CJKecglue 行
+$n$\nobreak\CJKecglue 列的实值矩阵, 即
 \[
 \symbf{A} = \begin{pmatrix}
 a_{11} & a_{12} & \dotsc & a_{1n} \\
@@ -336,14 +376,14 @@ a_{m1} & a_{m2} & \dotsc & a_{mn}
 \rule[\dimexpr-\dp0-0.5em\relax]{0.4pt}{\dimexpr\dp0+\ht0+1em\relax}%
 \llap{\rule[\dimexpr-\dp0-0.5em\relax]{\dimexpr2\wd0+4em+1.2pt\relax}{0.4pt}}%
 \llap{\rule[\dimexpr\ht0+0.5em-0.4pt\relax]{\dimexpr2\wd0+4em+1.2pt\relax}{0.4pt}}
-\caption[数学行距对比]{数学行距对比。在左图中，大矩阵 \env{pmatrix} 与分类
-  \env{cases} 两个环境受到影响，行距都被扩大了；但第一行文本里的小矩阵与末尾
+\caption[数学行距对比]{数学行距对比。在左图中，大矩阵\CJKecglue\env{pmatrix} 与
+  分类\CJKecglue\env{cases} 两个环境受到影响，行距都被扩大了；但第一行文本里的小矩阵与末尾
   公式里求和号的下角标却没有受到影响，行距仍然较为紧凑。在右图中，数学公式的行距
   都是西文的行距，密度比较均匀，行间公式里的大括弧、大括号也不会特别突兀。}
 \label{fig:math-leading}
 \end{figure}
 
-综上所述，在进行中西文混排时，最好能够区分中文与西文的行距。在使用 \pkg{zhlineskip}
+综上所述，在进行中西文混排时，最好能够区分中文与西文的行距。在使用\CJKecglue\pkg{zhlineskip}
 时，就可以分开处理中文文本与数学公式的行距。用户甚至还能分别指定正文行距与脚注
 行距，实现灵活的排版。同时，\pkg{zhlineskip} 宏包能恢复各种“多行”数学环境
 （包括矩阵、分类、多行公式推导等等）的行距，使数学公式的行距符合西文行距的规范。
@@ -351,8 +391,9 @@ a_{m1} & a_{m2} & \dotsc & a_{mn}
 最后，\pkg{zhlineskip} 宏包还支持用户在一定范围内按 Microsoft Word 的
 “多倍行距”进行排版\footnote{本宏包默认假定“被要求”用的字体是中易系列字体，
 这包括 Microsoft Word 里的“宋体”、“黑体”、“楷体”与“仿宋”。若改用其他字体，
-可能需要调整 \opt{MSWordSinglespaceRatio} 的值。
-参见第~\ref{sec:key-value}~节与第~\ref{sec:MS-Word}~节。}。
+可能需要调整\CJKecglue\opt{MSWordSinglespaceRatio} 的值。
+参见第\nobreak\CJKecglue\ref{sec:key-value}\nobreak\CJKecglue 节
+与第\nobreak\CJKecglue\ref{sec:MS-Word}\nobreak\CJKecglue 节。}。
 用户可以指定“多倍行距”的“倍数”，但是这只保证用 \TeX\ 排出来的文本行距与用
 Microsoft Word 排的行距相同。硬要用 \TeX\ 模仿 Microsoft Word 是没有
 太大意义的。
@@ -360,15 +401,17 @@ Microsoft Word 排的行距相同。硬要用 \TeX\ 模仿 Microsoft Word 是没
 \section{功能介绍}
 
 首先，请避免使用“多倍行距”这个概念：Microsoft Word 中“单倍行距”的值严重依赖于
-字体（参见第~\ref{sec:MS-Word}~节）。在严格排版的时候，一般都会给定具体的字号
-与行距，例如字号 $12$~磅、行距 $22$~磅。对于一般的用户，指定目标行距相比字号的
-倍数即可——\pkg{zhlineskip} 宏包可以自动提取基础行距（即 \TeX\ 中的单倍行距）
-相比字号的倍数（详见表~\ref{tab:default-leading-ratio}），再通过用户指定的
+字体（参见第\nobreak\CJKecglue\ref{sec:MS-Word}\nobreak\CJKecglue 节）。
+在严格排版的时候，一般都会给定具体的字号
+与行距，例如字号 $12$\nobreak\CJKecglue 磅、行距 $22$\nobreak\CJKecglue 磅。
+对于一般的用户，指定目标行距相比字号的倍\nobreak 数
+即可——\pkg{zhlineskip} 宏包可以自动提取基础行距（即 \TeX\ 中的单倍行距）
+相比字号的倍数（详见表\nobreak\CJKecglue\ref{tab:default-leading-ratio}），再通过用户指定的
 倍数来计算所需的行伸展因子。因此，不论是中日韩文还是西文的横排文档，都是可以使用
 本宏包的。本宏包的缺省设置更适合中日韩文文档。
 \begin{table}[h]
 \centering
-\caption[基础行距倍数]{\cls{ctexart} 与 \cls{article} 各个文档类选项
+\caption[基础行距倍数]{\cls{ctexart} 与\CJKecglue\cls{article} 各个文档类选项
   设置的基础行距倍数。}
 \label{tab:default-leading-ratio}
 \begin{tabular}{l l l}
@@ -387,34 +430,39 @@ Microsoft Word 排的行距相同。硬要用 \TeX\ 模仿 Microsoft Word 是没
 \subsection{载入宏包时的键值选项}
 \label{sec:key-value}
 
-载入 \pkg{zhlineskip} 宏包时可以设定六个基本的键值选项，它们分别是：
+载入\CJKecglue\pkg{zhlineskip} 宏包时可以设定六个基本的键值选项，它们分别是：
 \begin{description}
 \keyvalueitem{bodytextleadingratio}{real}
-指定正文目标行距相比于正文字号的倍数。以书刊为例，建议设置在~$1.5$ 至~$1.67$
-之间。缺省值是~\opt{1.5}，即 $1/2$~的行间距。
+指定正文目标行距相比于正文字号的倍数。以书刊为例，建议设置在\nobreak\CJKecglue$1.5$
+至\nobreak\CJKecglue$1.67$ 之间。缺省值是\nobreak\CJKecglue\opt{1.5}，
+即 $1/2$\nobreak\CJKecglue 的行间距。
 \keyvalueitem{footnoteleadingratio}{real}
 指定脚注目标行距相比于脚注字号的倍数，它可以比正文的倍数稍小一些，建议设置在正文
-倍数的 $98\%$ 至 $100\%$ 之间。缺省值是~\opt{1.48}，即大约为正文倍数的~$98.67\%$。
+倍数的 $98\%$ 至 $100\%$ 之间。缺省值是\nobreak\CJKecglue\opt{1.48}，
+即为正文倍数的\nobreak\CJKecglue$98.67\%$ 左右。
 \keyvalueitem{restoremathleading}{bool}
-指定是否要将数学公式的行距恢复成西文基础行距。缺省值是~\opt{true}，即恢复数学
-行距。该选项为真时，会自动载入 \pkg{mathtools} 宏包，此时还能利用
-\cmd{\SetMathEnvironmentSinglespace}\marg{real}
+指定是否要将数学公式的行距恢复成西文基础行距。缺省值是\nobreak\CJKecglue\opt{true}，
+即恢复数学行距。该选项为真时，会自动载入\CJKecglue\pkg{mathtools} 宏包，
+此时还能利用\CJKecglue\cmd{\SetMathEnvironmentSinglespace}\marg{real}
 命令\emph{微调}数学公式的基础行距。
 \keyvalueitem{UseMSWordMultipleLineSpacing}{bool}
 在排版论文时，如果被要求按照 Microsoft Word 来设置“多倍行距”，那么用户可以
-将该选项设置为~\opt{true}，并通过设置 \opt{MSWordLineSpacingMultiple}
+将该选项设置为\nobreak\CJKecglue\opt{true}，并通过
+设置\CJKecglue\opt{MSWordLineSpacingMultiple}
 指定“倍数”，这会忽略用户之前指定的正文行距与脚注行距倍数，但是与数学行距的设置
-独立。该选项的缺省值是~\opt{false}。
+独立。该选项的缺省值是\nobreak\CJKecglue\opt{false}。
 \keyvalueitem{MSWordLineSpacingMultiple}{real}
 设置 Microsoft Word“多倍行距”的“倍数”，
-仅在 \opt{UseMSWordMultipleLineSpacing} 为真时生效。
-缺省值是~\opt{1.15}，在不修改 \opt{MSWordSinglespaceRatio} 时，
-相当于设置了目标行距为字号的 $1.49140625$~倍，适用于中易字体
-（参见第~\ref{sec:MS-Word}~节）。
+仅在\CJKecglue\opt{UseMSWordMultipleLineSpacing} 为真时生效。
+缺省值是\nobreak\CJKecglue\opt{1.15}，
+在不修改\CJKecglue\opt{MSWordSinglespaceRatio} 时，
+相当于设置了目标行距为字号的 $1.49140625$\nobreak\CJKecglue 倍，适用于中易字体
+（参见第\nobreak\CJKecglue\ref{sec:MS-Word}\nobreak\CJKecglue 节）。
 \keyvalueitem{MSWordSinglespaceRatio}{real}
 设置 Microsoft Word 的“单倍行距”相比字号的倍数，
-仅在 \opt{UseMSWordMultipleLineSpacing} 为真时生效。
-缺省值是~\opt{1.296875}，适用于中易字体（参见第~\ref{sec:MS-Word}~节）。
+仅在\CJKecglue\opt{UseMSWordMultipleLineSpacing} 为真时生效。
+缺省值是\nobreak\CJKecglue\opt{1.296875}，适用于中易字体
+（参见第\nobreak\CJKecglue\ref{sec:MS-Word}\nobreak\CJKecglue 节）。
 若改用其他字体，则需调整该选项的值。
 \end{description}
 
@@ -422,14 +470,17 @@ Microsoft Word 排的行距相同。硬要用 \TeX\ 模仿 Microsoft Word 是没
 
 \subsubsection{调整数学公式的行距}
 
-当键值选项 \opt{restoremathleading} 为~\opt{true} 时，数学公式的行距被
-恢复成字号的 $1.2$~倍。对于某些字面较大的数学字体（例如类似 Palatino 的字体），
+当键值选项\CJKecglue\opt{restoremathleading}
+为\nobreak\CJKecglue\opt{true} 时，数学公式的行距被
+恢复成字号的 $1.2$\nobreak\CJKecglue 倍。对于某些字面较大的数学字体
+（例如类似 Palatino 的字体），
 这个基础行距会显得过小。此时，用户可以通过如下命令微调数学行距：
 \begin{description}
 \usercmditem{\SetMathEnvironmentSinglespace}{real}
-如果数学字体来自 \pkg{newpxmath} 或是 TeX Gyre Pagella Math，那么
-数学行距在字号 $1.2$~倍的基础上再扩大 $1.05$~倍更加合适。此时，只需指定
-\verb|\SetMathEnvironmentSinglespace{1.05}| 即可。
+如果数学字体来自\CJKecglue\pkg{newpxmath} 或是 TeX Gyre Pagella Math，
+那么数学行距在字号 $1.2$\nobreak\CJKecglue 倍的基础上再扩大
+$1.05$\nobreak\CJKecglue 倍更加合适。此时，只需指定
+\verb|\SetMathEnvironmentSinglespace{1.05}|\CJKecglue 即可。
 \end{description}
 本宏包恢复的多行数学环境包括：
 \begin{description}
@@ -482,37 +533,42 @@ Microsoft Word 排的行距相同。硬要用 \TeX\ 模仿 Microsoft Word 是没
 超出上述列表范围、用户自定义的\emph{数学}环境，可用如下命令恢复其行距：
 \begin{description}
 \usercmditem[6]{\RestoreMathEnvironmentLeading}{env name}
-使用范例：本宏包恢复数学环境 \env{array} 的行距，通过
-\verb|\RestoreMathEnvironmentLeading{array}| 实现。
+例如本宏包恢复 \LaTeX\ 数学环境\CJKecglue\env{array} 的行距，是通过
+\verb|\RestoreMathEnvironmentLeading{array}|\CJKecglue 实现的。
+\meta{env name}\CJKecglue 可以是由若干环境名构成的逗号列表。
 \end{description}
 
-\emph{注意，在 \opt{restoremathleading} 为~\opt{false} 时，
+\emph{注意，在\CJKecglue\opt{restoremathleading}
+为\nobreak\CJKecglue\opt{false} 时，
 \cmd{\SetMathEnvironmentSinglespace}
-与 \cmd{\RestoreMathEnvironmentLeading} 无效。}
+与\CJKecglue\cmd{\RestoreMathEnvironmentLeading} 无效。}
 
 \subsubsection{调整西文文本的行距}
 
 与数学行距命令对应，本宏包还提供两个调整\emph{西文文本}行距的命令，用法类似。
 \begin{description}
 \usercmditem{\SetTextEnvironmentSinglespace}{real}
-如果西文字体来自 \pkg{newpxtext} 或是 TeX Gyre Pagella，那么可以指定
+如果西文字体来自\CJKecglue\pkg{newpxtext} 或是 TeX Gyre Pagella，
+那么可以指定
 \verb|\SetTextEnvironmentSinglespace{1.05}|。
 \usercmditem[6]{\RestoreTextEnvironmentLeading}{env name}
-使用范例：假设文中的表格仅含西文、数字，此时如果想要文本环境 \env{tabular} 的
+使用范例：假设文中的表格仅含西文、数字，此时如果想要文本环境\CJKecglue\env{tabular} 的
 行距与西文行距一致，可通过
-\verb|\RestoreTextEnvironmentLeading{tabular}| 实现。
+\verb|\RestoreTextEnvironmentLeading{tabular}|\CJKecglue 实现。
+亦可参见例\nobreak\CJKecglue\ref{example:english-block}。
+\meta{env name}\CJKecglue 可以是由若干环境名构成的逗号列表。
 \end{description}
 
-如果作者没有顾及到某些\emph{基本环境}（数学或文本），鼓励用户向 \pkg{zhlineskip} 的
-\href{https://github.com/CTeX-org/ctex-kit/issues}{GitHub 维护页}%
+如果作者没有顾及到某些\emph{基本环境}（数学或文本），鼓励用户向\CJKecglue\pkg{zhlineskip} 的
+\href{https://github.com/CTeX-org/ctex-kit/issues}{GitHub 维护页}\CJKecglue
 提供相关信息。
 
 \subsection{使用范例}
 
-下面以 \CTeX\ 提供的 \cls{ctexart} 文档类为例，展示 \pkg{zhlineskip} 的
-使用方法。
+下面以 \CTeX\ 提供的\CJKecglue\cls{ctexart} 文档类为例，
+展示\CJKecglue\pkg{zhlineskip} 的使用方法。
 
-\subsubsection*{例：直接载入}
+\subsubsection*{\example 直接载入}
 
 \begin{verbatim}
     \documentclass{ctexart}
@@ -522,57 +578,105 @@ Microsoft Word 排的行距相同。硬要用 \TeX\ 模仿 Microsoft Word 是没
     \end{document}
 \end{verbatim}
 
-\subsubsection*{例：设置正文行距为字号的 1.6~倍}
+\subsubsection*{\example 设置正文行距为字号的 1.6\nobreak\CJKecglue 倍}
 
 \begin{verbatim}
-    \documentclass{ctexart}
+    % 导言区
     \usepackage[
         bodytextleadingratio=1.6, % 设置正文行距倍数为 1.6
         footnoteleadingratio=1.57 % 设置脚注行距倍数为 1.57
       ]{zhlineskip}               % 缺省数学行距倍数为 1.2
-    \begin{document}
-    正文测试。
-    \end{document}
 \end{verbatim}
 
-\subsubsection*{例：按照 Microsoft Word 设置“1.62~倍行距”}
+\subsubsection*{\example 按照 Microsoft Word 设置“1.62\nobreak\CJKecglue 倍行距”}
 
 \begin{verbatim}
-    \documentclass{ctexart}
+    % 导言区
     \usepackage[
-        restoremathleading=false,
-        UseMSWordMultipleLineSpacing,
+        restoremathleading=false,      % 可选
+        UseMSWordMultipleLineSpacing,  % 需设置为真
         MSWordLineSpacingMultiple=1.62
       ]{zhlineskip}
-    \begin{document}
-    按照 Microsoft Word 设置 1.62~倍行距。
-    \end{document}
 \end{verbatim}
 
-\subsubsection*{例：中文正文里需要插入成段的西文}
+\subsubsection*{\example\label{example:english-block}中文正文里需要插入成段的西文}
 
-如果插入的西文是引用参考文献的段落，那么使用 \env{quote} 或 \env{quotation}
-环境就比较合适。此时，可以直接在引用环境内部使用 \cmd{\linespread}\marg{real}
-命令，建议将 \meta{real} 设置在正文行距倍数的 $0.7$~倍左右。例如，在载入
-\pkg{zhlineskip} 宏包后，正文行距为字号的 $1.5$~倍，那么
-\verb|\linespread{1.05}| 就比较合适（$1.5 \times 0.7 = 1.05$）。
+如果需要插入成段的西文，最好的方法是先定义一个西文专用的环境。比如说可以在导言区
+定义如下这个环境：
 \begin{verbatim}
-    \documentclass{ctexart}
-    \usepackage{zhlineskip}
-    \begin{document}
-    下面引用一段出自英文文献的段落：
-    \begin{quotation}
-    \linespread{1.05}\selectfont % 此处数值为正文行距倍数的 0.7 倍左右
-    A quotation from English literature.
-    \end{quotation}
-    \end{document}
+    \newenvironment{english}                % 新建“英文”段落环境
+      {\addvspace\medskipamount}            % 段前间距，上文段落需结束
+      {\par\addvspace\medskipamount}        % 段后间距
 \end{verbatim}
+注意要先用空行结束上文段落。这时，可以通过\CJKecglue\pkg{zhlineskip} 声明
+\begin{verbatim}
+    \RestoreTextEnvironmentLeading{english} % 恢复“英文”使用紧凑行距
+\end{verbatim}
+将“英文”段落的行距恢复成西文较为紧凑的行距。
+这样一来，正文（也许是中英交替的译文）就会有比较均匀的视觉密度，
+而不至于“中文很挤、英文很散”。
+
+\begin{center}
+\rule[\dimexpr-200.34pt-0.25em\relax]{0.4pt}{\dimexpr206.5pt+0.5em\relax}\quad
+\begin{minipage}[t]{161pt}
+\fontsize{7}{8.4}\linespread{1.25}\selectfont
+\begin{verbatim}
+\RestoreTextEnvironmentLeading{english}
+人人生而自由，在尊严和权利上一律平等。他们赋有
+理性和良心，并应以兄弟关系的精神相对待。
+
+\begin{english}
+All human beings are born free and equal in
+dignity and rights. They are endowed with
+reason and conscience and should act towards
+one another in a spirit of brotherhood.
+\end{english}
+
+人人有资格享有本宣言所载的一切权利和自由，不分
+种族、肤色、性别、语言……
+
+\begin{english}
+Everyone is entitled to all the rights and
+freedoms set forth in this Declaration,
+without distinction of any kind, such as
+race, colour, sex, language\dots
+\end{english}
+\end{verbatim}
+\end{minipage}\quad
+\rule[\dimexpr-200.34pt-0.25em\relax]{0.4pt}{\dimexpr206.5pt+0.5em\relax}\quad
+\begin{minipage}[t]{161pt}
+\fontsize{7}{8.4}\linespread{1.25}\selectfont
+\parindent2\ccwd\relax
+\RestoreTextEnvironmentLeading{english}
+人人生而自由，在尊严和权利上一律平等。他们赋有
+理性和良心，并应以兄弟关系的精神相对待。
+
+\begin{english}
+All human beings are born free and equal in
+dignity and rights. They are endowed with
+reason and conscience and should act towards
+one another in a spirit of brotherhood.
+\end{english}
+
+人人有资格享有本宣言所载的一切权利和自由\nobreak\makebox[\ccwd]{，}\allowbreak
+不分种族、肤色、性别、语言……
+
+\begin{english}
+Everyone is entitled to all the rights and
+freedoms set forth in this Declaration,
+without distinction of any kind, such as
+race, colour, sex, language\dots
+\end{english}
+\end{minipage}\quad
+\rule[\dimexpr-200.34pt-0.25em\relax]{0.4pt}{\dimexpr206.5pt+0.5em\relax}
+\end{center}
 
 \subsection{Microsoft Word 中的“单倍行距”}
 \label{sec:MS-Word}
 
 Microsoft Word 中“单倍行距”的设置，其行距值相比字号的倍数严重依赖于字体，
-甚至还可能因为操作系统的不同而迥然不同。表~\ref{tab:word-line-height} 列出
+甚至还可能因为操作系统的不同而迥然不同。
+表\nobreak\CJKecglue\ref{tab:word-line-height}\CJKecglue 列出
 几种常见字体对应的单倍行距倍数。正是因为“单倍行距”本身随字体、操作系统而变化，
 所以请尽量避免使用“多倍行距”的概念！
 \begin{table}[h]
@@ -593,9 +697,9 @@ Microsoft Word 中“单倍行距”的设置，其行距值相比字号的倍�
 \fontandsinglespaceratio{华文中宋（macOS）}{1723/1000=1.723} \\
 \fontandsinglespaceratio{微软雅黑 Light（macOS）}{3542/2048=1.7294921875} \\
 \fontandsinglespaceratio{苹方（macOS）}{1820/1000=1.82} \\
-\fontandsinglespaceratio{思源宋体~1.001}{1869/1000=1.869} \\
-\fontandsinglespaceratio{思源黑体~2.000}{1882/1000=1.882} \\
-\fontandsinglespaceratio{思源黑体~1.004}{1924/1000=1.924} \\
+\fontandsinglespaceratio{思源宋体\nobreak\CJKecglue1.001}{1869/1000=1.869} \\
+\fontandsinglespaceratio{思源黑体\nobreak\CJKecglue2.000}{1882/1000=1.882} \\
+\fontandsinglespaceratio{思源黑体\nobreak\CJKecglue1.004}{1924/1000=1.924} \\
 \bottomrule
 \end{tabular}
 \end{table}
@@ -621,8 +725,8 @@ Microsoft Word 中“单倍行距”的设置，其行距值相比字号的倍�
 \newblock O'Reilly Media, Inc., 2008.
 
 \bibitem{zhang2005fang}
-\textsc{张胜涛, 王忆波}.
-\newblock \textit{方正飞腾4.0实用培训教程}.
+\textsc{张胜涛 \& 王忆波}.
+\newblock \textbf{方正飞腾4.0实用培训教程}.
 \newblock 清华大学出版社, 2005.
 \end{thebibliography}