From 4fd81a66c82a2ba8787c6ca78bfcc14820e4017c Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Wed, 17 Jan 2024 03:01:02 +0000
Subject: CTAN sync 202401170301

---
 macros/latex/contrib/easybook/easybook.tex | 35 ++++++++++++++++++++----------
 1 file changed, 23 insertions(+), 12 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 1dbe185ff6..d0df41762e 100644
--- a/macros/latex/contrib/easybook/easybook.tex
+++ b/macros/latex/contrib/easybook/easybook.tex
@@ -23,8 +23,8 @@
     name            = easybook,
     color-scheme    = blue,
     title           = EASYBOOK使用手册,
-    version         = v2024H,
-    date            = 2024/01/14,
+    version         = v2024I,
+    date            = 2024/01/16,
     authors         = 瞿毅,
     info            = 简便地排版中文学位论文或书籍,
     email           = toquyi@163.com,
@@ -558,7 +558,7 @@
   \keyval{numberlike}{计数器}
   定理将使用此 \meta{计数器} 进行编号，通常这是另一个定理环境的名称。
   \keyval{qed}{证毕符号}
-  证毕符号。位于定理段落末尾行的右侧边缘，可以设置成 \cs{qedsymbol} 默认是空心方块。
+  证毕符号。位于定理段落末尾行的版心右边，可以设置成 \cs{qedsymbol} 默认是空心方块。
   \keyval{style}{定理样式}
   选项的值为使用 \cs{declaretheoremstyle} 命令新定义的定理样式。
 
@@ -681,7 +681,7 @@
 
 \begin{commands}
   \command{markrule}[\oarg{长度}\darg{颜色名}\marg{线宽}\baroarg{上间距,下间距}]
-  实线命令 \cs{markrule} 既可在 \meta{横线命令} 中用于绘制页眉页脚横线，也可以在正文中使用。\meta{长度} 默认为页面文本区的宽度，上下间距为横线与上下方部件的间距，带有长度单位，上下间距之间用符号 \code{|} 分开，若只有一部分则表示 \meta{上间距}。下面举一个设置页眉内容的例子：
+  实线命令 \cs{markrule} 既可在 \meta{横线命令} 中用于绘制页眉页脚横线，也可以在正文中使用。\meta{长度} 默认为版心的宽度，上下间距为横线与上下方部件的间距，带有长度单位，上下间距之间用符号 \code{|} 分开，若只有一部分则表示 \meta{上间距}。下面举一个设置页眉内容的例子：
   \begin{ctexexam}
   \ebhdrset{headrule = \markrule(DarkOrchid){0.5pt}[2pt|2pt]}
   \fancyhead[ER]{\leftmark}
@@ -810,10 +810,10 @@
   \end{commands}
   \keyval{tocafter}{距离命令}\dtag\Default{\cs*{hspace}\Marg{1em}}
   目录条目标签与标题间的代码，默认为插入 \code{1em} 横向距离。
-  \keyval{tocbelow}{距离命令}\dtag\newtag%
+  \keyval{tocbelow}{距离命令}\dtag
   在目录条目下方执行的代码，可以插入垂直距离等命令。
   \keyval{tocline}{条目定义}\dtag[\textcolor{red}{\ding{73}}]
-  这个选项在章节标题基础上扩展了浮动环境的题注在目录文件中的定义。选项中参数 \code{\#1} 代表相应题注编号 \cs*{the}\meta{计数器} 的值，参数 \code{\#2} 代表相应题注内容。
+  这个选项在章节标题基础上扩展了浮动环境的题注标题在目录文件中的定义。由于设计的原因，章节标题选项中参数 \code{\#1} 代表标题编号 \cs*{the}\meta{计数器} 对应的计数器名称，而题注标题选项中参数 \code{\#1} 代表标题编号 \cs*{the}\meta{计数器} 的值，章节和题注标题中参数 \code{\#2} 均代表相应标题内容。
   \begin{ctexexam}
   \ctexset
     {
@@ -830,11 +830,11 @@
 \end{options}
 
 \begin{commands}
-  \command{RegisterTocName}[\marg{条目名}]\newtag%
+  \command{RegisterTocName}[\marg{条目名}]
   给条目类型名称为 \meta{条目名} 的标题注册用于设置目录样式的选项，即选项前有符号 \ding{73} 表示需要注册后使用。前面提到的条目类型均已注册，需要注意新类型的条目注册后选项初始值\textbf{均为空}。
   \command{contentsuse}[\marg{条目名}\marg{扩展名}]
   激活条目类型名称为 \meta{条目名} 的目录定制功能，它使用的目录文件后缀为 \meta{扩展名}。需要在激活条目后再使用命令 \cs{RegisterTocName} 注册选项。
-  \command{DeclareFloatList}[\marg{条目名}\marg{扩展名}]\newtag%
+  \command{DeclareFloatList}[\marg{条目名}\marg{扩展名}]
   声明一种条目类型的目录命令 \cs*{listof}\meta{条目名}\code{\textcolor{cs}{s}}，并且支持\ref{subsec:directory command} 中图表目录命令的机制。使用这个命令要确保将条目加入目录的机制已经存在，例如搭配 \pkg*{newfloat} 宏包创建新的浮动环境。选项前有红色符号 \textcolor{red}{\ding{73}}（仍包含黑色符号选项的性质）表示在声明后可用。下面举一个声明算法环境和对应题注目录的例子：
   \begin{ctexexam}
   \usepackage{newfloat}
@@ -846,6 +846,14 @@
   \DeclareFloatList{algorithm}{loa}
   \listofalgorithms[multoc] % 在正文中输出双栏算法目录
   \end{ctexexam}
+  \command{SetTocStyle}[\marg{条目名}\marg{风格名}\marg{键值列表}]\newtag%
+  定义条目类型名称为 \meta{风格名} 的目录风格。使用 \cs*{ctexset} 命令设置目录样式时，除了条目标题定义选项 \option{tocline}，其它选项只有在目录输出命令前设置才有效，定义完目录风格后用 \cs{UseTocStyle} 命令可以在正文中任意位置生效。如果是没有 \ding{73} 符号的选项，\meta{条目名} 设置为 \module*{tocset}。
+  \command{UseTocStyle}[\marg{条目名}\marg{风格名}\marg{扩展名}]\newtag%
+  使用对应条目类型名称为 \meta{风格名} 的目录风格，随后标题在目录中的格式会改变。本命令导言区和正文区均可使用，第三个必选参数还需要指定条目标题加入目录文件的 \meta{扩展名}。
+  \begin{ctexexam}
+  \SetTocStyle{chapter}{fancy}{tocformat = \color{red}\zihao{3}}
+  \UseTocStyle{chapter}{fancy}{toc}
+  \end{ctexexam}
   \command{listnumberline}[\marg{条目名}]
   在图表等浮动环境的题注目录中插入条目标签，默认标签的名字可以由格式命令 \cs{labelformat} 设置。注意其中 \meta{条目名} 需要用对应名称\textbf{显式指定}。
   \begin{ctexexam}
@@ -855,6 +863,8 @@
       lstlisting/tocline  = \protect\numberline{代码#1\hspace{1em}}#2
     }
   \end{ctexexam}
+  \command{contentsmargin}[\marg{右边距}]
+  目录中引导线到版心右边的距离，用于条目页码的精细调整。当设置条目页码对齐方式或数字较大时，可以设置适当的数值，可在导言区全局设置或在 \option{tocformat} 选项给条目类型单独设置。
 \end{commands}
 
 \begin{options}
@@ -864,7 +874,7 @@
   代码目录中每章第一个条目上方增加的垂直距离。与 \CTeX 的表格和图片目录中每章间的条目距离选项 \option*{lotskip} 和 \option*{lofskip} 类似，在 \cls*{article} 模式中此选项失效。
   \keyval{between}{代码钩子}\dtag[\textcolor{red}{\ding{73}}]
   目录标题与条目内容间的钩子（作用于标题下方间距之后），一般插入负的垂直距离代码用于抵消目录首行额外的垂直间距。除了条目名的键路径外，此选项也可用于 \module*{tocset} 路径中，表示章节标题目录标题代码钩子。
-  \keyval{bibetween}{代码钩子}\newtag%
+  \keyval{bibetween}{代码钩子}
   与选项 \option{between} 类似，是英文章节标题目录（如果启用）标题代码钩子。
   \keychoice{dotalign}{\fbox{true},false}
   引导线选项 \option{dotalign} 可以使目录引导线右端对齐并与页码保持一定间距，否则会与页码相连。
@@ -963,9 +973,9 @@
   \command{appendix}[\splitoarg{前名字,后名字}\darg{编号输出命令}]
   附录起始命令，其后的章节标题变为附录形式。\meta{前名字} 为英文目录中附录标题的前名字，同理 \meta{后名字} 为英文目录中附录标题的后名字。前后名字之间用一个半角逗号分开，也可以只有一部分，表示英文目录中附录标题前名字。\meta{编号输出命令} 为附录标题计数器在英文目录中的编号命令。注意这两个参数仅对 \code{bichapter} 级别的标题生效。
   \command{BeforeAddBitoc}[\sarg\marg{英文标题加入目录前的代码}]
-  作用于局部范围的英文目录钩子，可以插入标题或目录设置的命令改变英文目录中标题的显示格式，也可以覆盖上述的目录前后名字和编号等设置，带有星号的命令会重置之前的代码，放置在导言区或 \cs{bichapter} 等双语标题命令前生效。这个命令在设置英文目录标题格式中有最高优先级。举一个在英文目录节标题编号前添加 \code{Section} 字符串的例子：
+  作用于局部范围的英文目录章节标题钩子，代码在标题加入目录前执行，可以插入条目标题定义命令临时改变英文目录中条目的格式，带有星号参数的命令会重置之前的代码。这个命令设置英文目录条目的标题格式具有最高优先级，放置在导言区或 \cs{bichapter} 等双语标题命令前生效。举一个在英文目录节标题编号前添加 \code{Section} 字符串的例子：
   \begin{ctexexam}
-  \BeforeAddBitoc{\ctexset{section/name = Section}}
+  \BeforeAddBitoc{\ctexset{section/name = Section\space}}
   \bisection{zhtitle}{entitle}
   \end{ctexexam}
 \end{commands}
@@ -1340,9 +1350,10 @@
   \shortversion{v = 1.638,date = 2022/03/04,changes = 增加目录条目样式选项注册命令 \cs{RegisterTocName}。}
   \shortversion{v = 1.644,date = 2022/03/10,changes = 增加浮动环境目录声明命令 \cs{DeclareFloatList} 配合 \pkg*{caption} 宏包。}
   \shortversion{v = 1.682,date = 2022/05/01,changes = 将迷你页判断命令 \cs{notminipage} 改为被保护命令兼容 \pkg*{circledtext} 宏包。}
-  \begin{version}[v = 2024H,date = 2024/01/14,simple]
+  \begin{version}[v = 2024I,date = 2024/01/16,simple]
   \item 核对依赖宏包的更新改动，优化使用手册的内容细节。
   \item 修复图表题注目录中条目标签编号的计数器值显示错误问题。
+  \item 新增目录风格定义命令 \cs{SetTocStyle} 和使用命令 \cs{UseTocStyle}。
   \end{version}
 \end{changelog}
 \nocite{*}
-- 
cgit v1.2.3

