From 39394e7cba63ab69525546760c8e542bb98f48e0 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Tue, 11 Jan 2022 03:01:10 +0000
Subject: CTAN sync 202201110301

---
 macros/latex/contrib/easybook/easybook.tex | 96 ++++++++++++++++--------------
 1 file changed, 52 insertions(+), 44 deletions(-)

(limited to 'macros/latex/contrib/easybook/easybook.tex')

diff --git a/macros/latex/contrib/easybook/easybook.tex b/macros/latex/contrib/easybook/easybook.tex
index 259bbd6bd4..f54b553500 100644
--- a/macros/latex/contrib/easybook/easybook.tex
+++ b/macros/latex/contrib/easybook/easybook.tex
@@ -20,7 +20,7 @@
     name            = easybook,
     color-scheme    = blue,
     title           = EASYBOOK 使用手册,
-    version         = v1.44,
+    version         = v1.45,
     date            = 2022/01/08,
     authors         = 瞿毅,
     info            = 排版简体中文学位论文和书籍,
@@ -250,7 +250,7 @@
 \subsection{英文字体}
 \begin{options}
   \keychoice{font}{noto,times,times*,ebgaramond,libertine,palatino,auto}\Default{auto}
-  预置的英文字体相关配置方案如下表所示，这些字体已经包含在了 \TeX Live 发行版中，所以通常不需要再专门安装。如果您想使用其他英文字体，可以使用 \pkg*{fontspec} 宏包的相关命令进行设置。
+  预置的英文字体相关配置方案如下表所示，这些字体已经包含在了 \TeX Live 发行版中，所以通常不需要再专门安装。如果您想使用其它英文字体，可以使用 \pkg*{fontspec} 宏包的相关命令进行设置。
   \insertblr
   {
     colspec = @{}*{4}{c}@{},
@@ -607,8 +607,8 @@
 \label{subsec:theorem of style}
 文档类已预置 12 个定理环境，环境名及对应的定理名见\ref{subsec:theorem}，它们均使用预置的定理样式 \code{fancy}。下面 \module*{thmset} 模块选项的用法名称与 \pkg*{thmtools} 宏包基本一致，且仅对预置定理样式生效。如果下面的选项不满足需求，可使用支持完整选项的相关命令创建定理环境。
 \begin{options}
-  \keybool{thmframe}\Module{thmset}\Default{false}
-  给定理环境使用彩色盒子。这个特殊选项在本模块中使用 \pkg*{tcolorbox} 宏包来支持，\meta{盒子风格} 默认为 \code{tc-theorem}。注意它应当在定理声明命令前使用。\pkg*{thmtools} 具有类似的选项 \option*{thmbox}。
+  \keybool{tcbwrap}\Module{thmset}\Default{false}
+  给定理环境使用彩色盒子。这个特殊选项在本模块中使用 \pkg*{tcolorbox} 宏包来支持，\meta{盒子风格} 默认为 \code{tc-theorem}。注意它应当在定理声明命令前使用。\pkg*{thmtools} 具有类似的选项 \option*{shaded}。
   \keyval-{headfont}{字体命令}\Default{\cs*{color}\Carg{ctex@emph}\cs*{sffamily}}
   定理标题部分的字体，包括字体族、字体系列、字体尺寸和字体形状命令。
   \keyval-{notefont}{字体命令}\Default
@@ -658,12 +658,12 @@
   \begin{itemize}
   \item 可以重复定义已存在的定理环境而不会报错。
   \item 中英文模式下定理标题自动切换。针对中文定理标题的特点将 \meta{中文标题} 设计为必选参数，\meta{英文标题} 则默认为首字母大写的 \meta{环境名}。
-  \item 自动定义交叉引用的格式，引用标签前缀为相应定理名。
-  \item 定理盒子选项 \option{thmframe} 仍然生效，\meta{盒子风格} 可以使用 \cs{deftcbstyle} 命令创建。
+  \item 自动定义交叉引用的格式，标签引用前缀为相应定理名。
+  \item 定理盒子选项 \option{tcbwrap} 仍然生效，\meta{盒子风格} 可以使用 \cs{deftcbstyle} 命令创建。
   \item 新建定理环境默认使用的 \meta{定理样式} 为 \code{fancy}，而不是 \pkg*{thmtools} 的默认样式。
   \end{itemize}
 
-  下面新建一个与\ref{exam:new theorem env} 相同的定理环境猜想，并使用 \cs{addtotcbstyle} 命令调整 \option{thmframe} 开启时默认的盒子风格。它的第一个参数为 \code{tc-theorem}，关于命令的介绍在\ref{subsec:box}。
+  下面新建一个与\ref{exam:new theorem env} 相同的定理环境猜想，并使用 \cs{addtotcbstyle} 命令调整 \option{tcbwrap} 开启时默认的盒子风格。它的第一个参数为 \code{tc-theorem}，关于命令的介绍在\ref{subsec:box}。
   \begin{ctexexam}
   \deftheorem{caixiang}{猜想}[style = mythm]
   \addtotcbstyle{tc-theorem}{colback = GreenYellow}
@@ -776,6 +776,10 @@
   脚注正文标记编号的类型，默认为原生样式 \code{plain}，还可以改为 \code{pifont} 的各个版本，从左往右依次为普通版、阴文衬线版、阳文无衬线版和阴文无衬线版，缺点是它们的编号仅包括 1-10。
 
   短编号的形式与列表环境类似，不过增加了中文数字 \code{c} 和符号 \code{s} 格式参数。原生样式 \code{plain} 等同于单独使用数字 \code{1} 参数。这个选项可以用在正文中改变其后脚注编号类型。
+  \begin{commands}
+  \command{footref}[\marg{脚注标签名}]
+  在当前位置对自动编号的脚注进行引用，与被引用的正文标记共享一个编号与格式。
+  \end{commands}
   \begin{ctexexam}
   \ebhdrset{fnmark-num = 1} % 等于编号类型plain
   \ebhdrset{fnmark-num = (a)}
@@ -811,7 +815,16 @@
     }
   \end{ctexexam}
   \keychoice{fncust-form}{format code,match}\Default
-  单独设定自定义脚注标记的格式，选项 \code{match} 可以匹配 \option*{spcmd} 全局的值。自定义脚注的命令与用法可以见\ref{subsubsec:custom footnotes}。
+  单独设定自定义脚注标记的格式，选项 \code{match} 可以匹配 \option*{spcmd} 全局的值。自定义脚注的命令与用法可以见下方的介绍。
+  \begin{commands}\noitemsep
+  \command{Footnote}[\oarg{内容标记}\marg{正文标记}\marg{脚注文本}]\default{}
+  \command{Footnotetext}[\marg{内容标记}\marg{脚注文本}]\default{}
+  \command{Footnotemark}[\marg{正文标记}]
+  这些是自定义标记且不影响正常编号的脚注命令，用法与它们对应首字母小写的命令类似。\meta{内容标记} 默认与 \meta{正文标记} 一致，可以进行微调。如果当前标记为空，那么将会使用上一个脚注标记。
+  \begin{ctexexam}
+  \Footnote{*}{这是可以自定义标记的脚注。}
+  \end{ctexexam}
+  \end{commands}
   \keychoice{fnboth-form}{format code,match}\Default
   同时设定默认脚注标记 \option{fnmate-form} 和自定义脚注标记 \option{fncust-form} 的格式。两种脚注标记匹配上标格式 \option*{spcmd} 的值是独立的，使用 \code{match} 则可以同时匹配。标记格式选项含有字体命令会覆盖 \option{footnote} 的设置，最后一个格式命令可以带有一个参数接受脚注标记。
   \keyval-{fnpara-form}{格式代码}\Default
@@ -905,7 +918,6 @@
 
 \subsection{表格}
 \begin{environments}\noitemsep
-  \environment*{tabularx}[\marg{长度}\marg{列格式}]\default{}
   \environment*{tabular}[\marg{列格式}]\default{}
   \environment{tblr}[\marg{键值列表}]
   \pkg*{tabularray} 是一个强大且全面的表格宏包，不依赖其它表格宏包所以同时使用不会产生冲突。不仅提供了各种传统表格宏包的功能，还实现了用键值列表方式简便地设置表格样式。具体用法可见宏包的说明文档，下面演示一个 \env{tblr} 表格的用法：
@@ -952,7 +964,7 @@
   \begin{ctexexam}
   \setlist*{wide = 0em} % 取消所有列表的左边距
   \begin{enumerate}[label = (\arabic*),leftmargin = 1cm,resume]
-  \begin{enumerate}[(1)] % 短编号形式
+  \begin{enumerate*}[(1)] % 短编号形式
   \begin{itemize}[label = \textbullet,labelsep = *]
   \begin{description}[font = \sffamily\bfseries,style = nextline]
   \end{ctexexam}
@@ -973,7 +985,7 @@
   \environment{remark}\default{}
   \environment{conjecture}\default{}
   \environment{problem}
-  这些是预置的定理环境，可使用选项 \option{thmframe} 为它们添加盒子边框，其中注与证明环境不编号，证明末尾会自动添加证明结束符，声明新的定理环境或更改定理盒子样式见\ref{subsec:theorem of style}。环境名与之对应的定理名如下：
+  这些是预置的定理环境，可使用选项 \option{tcbwrap} 为它们添加盒子边框和背景，其中注与证明环境不编号，证明末尾会自动添加证明结束符，声明新的定理环境或更改定理盒子样式见\ref{subsec:theorem of style}。环境名与之对应的定理名如下：
   \insertblr
   {
     colspec = @{}*{6}{c}@{},
@@ -1056,10 +1068,9 @@
   \end{ctexexam}
 \end{commands}
 
-\subsubsection{行间盒子}
 \begin{environments}
   \environment{easybox}[\sarg\oarg{颜色名}\darg{段落标题}\oarg{配置选项}]
-  环境 \env{easybox} 创建一个带有三个可选参数的扁平盒子。使用星号参数时给盒子添加边框，\meta{颜色名} 选项设置背景颜色，\meta{段落标题} 选项可以设置标题，默认无标题。
+  行间环境 \env{easybox} 创建一个带有三个可选参数的扁平盒子。使用星号参数时给盒子添加边框，\meta{颜色名} 选项设置背景颜色，\meta{段落标题} 选项可以设置标题，默认标题为空。
   \begin{ctexexam}
   \addtotcbstyle{tc-easybox}{arc = 6pt}
   \begin{easybox}*[DarkCyan](段落标题)
@@ -1069,18 +1080,17 @@
   \end{easybox}
   \end{ctexexam}
   \environment{ebparbox}[\sarg\oarg{颜色名}\darg{段落标题}\oarg{配置选项}]
-  环境 \env{ebparbox} 用法与 \env{easybox} 类似，同样带有三个可选参数。当使用星号参数时盒子左边带有一条竖线，\meta{颜色名} 选项可以自定义竖线颜色，使用带有星号的环境则盒子带有竖线颜色的浅色背景。\meta{段落标题} 选项可以设置标题，默认无标题。
+  环境 \env{ebparbox} 用法与 \env{easybox} 类似，同样带有三个可选参数。盒子的左边带有一条粗竖线，\meta{颜色名} 选项可以自定义这条竖线颜色，使用星号参数则盒子带有竖线颜色的浅色背景。
 \end{environments}
 
-\subsubsection{行内盒子}
 \begin{commands}
   \command{ebemph}[\oarg{颜色名}\marg{内容}\oarg{配置选项}]
-  行内盒子均为抄录命令。盒子 \cs{ebemph} 具有模糊边缘类似高亮的效果。
+  行内盒子命令 \cs{ebemph} 具有模糊边缘类似高亮的效果。
   \command{ebfbox}[\oarg{颜色名}\marg{内容}\oarg{配置选项}]
-  盒子 \cs{ebfbox} 则有直角边缘和四周框线，效果类似带颜色的 \cs*{fbox} 盒子。
+  行内盒子命令 \cs{ebfbox} 则有直角边缘和四周框线，效果类似带颜色的 \cs*{fbox} 盒子。
 \end{commands}
 
-\section{更多用法}
+\section{扩展功能}
 
 \subsection{物理量}
 \begin{commands}
@@ -1106,12 +1116,32 @@
   \command{counteruse}[\sarg\oarg{父计数器}\darg{编号}\marg{计数器}\oarg{分隔符}\darg{整数}]
   命令 \cs{newcounter} 是 \LaTeX 自带的创建计数器命令，计数器值输出命令 \cs{counteruse} 以一定的格式使用由它创建的计数器，将会以 \cs*{the}\meta{父计数器}\meta{分隔符}\cs*{the}\meta{计数器} 输出这种计数器的值。命令 \cs{counteruse} 仅具有\textbf{输出功能}，并不会改变计数器原有的绑定关系。默认每使用一次命令 \meta{计数器} 的值增加 1，带有星号的命令使 \meta{计数器} 值保持不变，\meta{计数器} 的值也可以设为指定的 \meta{整数}。计数器的 \meta{编号} 为 \code{arabic} 或 \code{alph} 等计数形式。
 
-  在一定的场合下可能用到 \cs{counteruse} 命令，比如通过新建快捷命令在一些位置使用定理环境的计数器，使用 \cs{labelformat} 设置计数器的引用标签需添加 \code{eb@}：
+  在一定的场合下可能用到 \cs{counteruse} 命令，比如通过新建快捷命令在一些位置使用定理环境的计数器，使用 \cs{labelformat} 设置计数器的标签引用需添加 \code{eb@}：
   \begin{ctexexam}
   \labelformat{eb@theorem}{定理 #1}
   \newcommand{\theoremhead}[1]{定理\counteruse[chapter]{theorem}\hspace{1em}#1}
   \theoremhead{定理内容}\label{thm:theorem}
   \end{ctexexam}
+
+  \command{counterwithin}[\sarg\oarg{格式}\marg{计数器}\marg{父计数器}]
+  对计数器进行绑定的命令。将 \meta{计数器} 绑定于 \meta{父计数器}，即 \meta{父计数器} 的值递增时 \meta{计数器} 的值会归零，输出格式 \cs*{the}\meta{计数器} 被改为 \cs*{the}\meta{父计数器}\code{.}\meta{格式}\marg{计数器}。\meta{格式} 应当为接受计数器值并改变编号形式的命令，默认为 \cs*{arabic}。带有星号参数的命令仅进行绑定不更改输出格式。
+  \command{counterwithout}[\sarg\oarg{格式}\marg{计数器}\marg{父计数器}]
+  对计数器关系进行解绑的命令。将 \meta{计数器} 解绑于 \meta{父计数器}，同时输出格式被改为 \meta{格式}\marg{计数器}。带有星号参数的命令仅进行解绑不更改输出格式。
+  \begin{ctexexam}
+  \counterwithin[\Roman]{child}{parent}
+  \counterwithout*{child}{parent}
+  \end{ctexexam}
+\end{commands}
+
+\subsection{标签引用}
+\begin{commands}
+  \command{labelformat}[\marg{计数器}\marg{标签引用格式}]
+  标签格式命令 \cs{labelformat} 可以设置标签引用格式，\meta{标签引用格式} 中 \code{\#1} 代表 \cs*{the}\meta{计数器}，可以设置引用序号的前缀和后缀。也可以使用 \pkg*{cleveref} 宏包提供更强大的标签功能。
+  \begin{ctexexam}
+  \labelformat{chapter}{第 #1 章}
+  \labelformat{chapter}{第\thechapter 章}
+  \AtBeginDocument{\usepackage{cleveref}}
+  \end{ctexexam}
 \end{commands}
 
 \subsection{图表题注}
@@ -1176,17 +1206,7 @@
   \end{options}
 \end{commands}
 
-\subsection{交叉引用}
-\begin{commands}
-  \command*{ref}[\marg{标签名}]
-  使用 \cs*{ref} 命令引用 \cs*{label} 设置的 \meta{标签名}，将会检测临近计数器并添加相应的前缀，比如图表题注、章节标题和定理等。
-  \command{footref}[\marg{脚注标签名}]
-  对自动编号的脚注进行引用可使用 \cs{footref} 命令，与引用的标记共享一个编号与格式。
-  \command{labelformat}[\marg{计数器}\marg{标签引用格式}]
-  标签格式命令 \cs{labelformat} 可以设置引用标签格式，\meta{标签引用格式} 中 \code{\#1} 代表 \cs*{the}\meta{计数器}，可以设置引用序号的前缀和后缀。
-\end{commands}
-
-\subsubsection{索引}
+\subsection{索引}
 \begin{commands}
   \command*{indexsetup}[\marg{键值列表}]
   \pkg*{imakeidx} 宏包增强了索引的功能，这是它的的接口命令，用于设置索引表的整体格式。
@@ -1198,19 +1218,7 @@
   现在索引表生成命令 \cs{printindex} 被重新定义，\meta{键值列表} 中的选项与\ref{sec:document command} 其它目录命令相同，但是原本接口命令 \cs*{indexsetup} 的部分选项失效。
 \end{commands}
 
-\subsubsection{自定义脚注}
-\label{subsubsec:custom footnotes}
-\begin{commands}\noitemsep
-  \command{Footnote}[\oarg{内容标记}\marg{正文标记}\marg{脚注文本}]\default{}
-  \command{Footnotetext}[\marg{内容标记}\marg{脚注文本}]\default{}
-  \command{Footnotemark}[\marg{正文标记}]
-  这些是自定义标记且不影响正常编号的脚注命令，用法与它们对应首字母小写的命令类似。\meta{内容标记} 默认与 \meta{正文标记} 一致，可以进行微调。如果当前标记为空，那么将会使用上一个脚注标记。
-  \begin{ctexexam}
-  \Footnote{*}{这是可以自定义标记的脚注。}
-  \end{ctexexam}
-\end{commands}
-
-\subsubsection{边注}
+\subsection{边注}
 \begin{commands}
   \command{marginnote}[\oarg{左文本}\marg{右文本}\oarg{垂直偏移}]
   命令 \cs{marginnote} 可以生成简单的边注，如果只给定了 \meta{右文本}，那么边注在奇偶数页文字相同。如果同时给定了 \meta{左文本}，则偶数页使用 \meta{左文本} 的文字。
@@ -1238,7 +1246,7 @@
 
 \appendix
 \begin{changelog}[title = 更新日志]
-  \shortversion{v = 1.44,date = 2022/01/08,changes = 经过前期各模块的功能调整和错误修复，稳定版本正式发布。}
+  \shortversion{v = 1.45,date = 2022/01/08,changes = 经过前期各模块的功能调整和错误修复，稳定版本正式发布。}
 \end{changelog}
 \nocite{*}
 
-- 
cgit v1.2.3

