texlive[69747] Master/texmf-dist: easybook (8feb24)
commits+karl at tug.org
commits+karl at tug.org
Thu Feb 8 22:40:24 CET 2024
Revision: 69747
https://tug.org/svn/texlive?view=revision&revision=69747
Author: karl
Date: 2024-02-08 22:40:24 +0100 (Thu, 08 Feb 2024)
Log Message:
-----------
easybook (8feb24)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/easybook/easybook.pdf
trunk/Master/texmf-dist/doc/latex/easybook/easybook.tex
trunk/Master/texmf-dist/source/latex/easybook/easybook.dtx
trunk/Master/texmf-dist/tex/latex/easybook/easybase.sty
trunk/Master/texmf-dist/tex/latex/easybook/easybook.cls
trunk/Master/texmf-dist/tex/latex/easybook/eb-tcolorbox.cfg
Modified: trunk/Master/texmf-dist/doc/latex/easybook/easybook.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/easybook/easybook.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/easybook/easybook.tex 2024-02-08 21:40:14 UTC (rev 69746)
+++ trunk/Master/texmf-dist/doc/latex/easybook/easybook.tex 2024-02-08 21:40:24 UTC (rev 69747)
@@ -23,7 +23,7 @@
name = easybook,
color-scheme = blue,
title = EASYBOOK使用手册,
- version = v2024x,
+ version = v2024z,
date = 2024/02/08,
authors = 瞿毅,
info = 简便地排版中文学位论文或书籍,
@@ -371,9 +371,9 @@
\keyval{multoc}{整数}\Default{2}
设置目录的排版栏数，与\ref{subsec:directory command} 中目录命令的同名选项有相同效果。
\keychoice{withpart}{true,\fbox{false}}
- 使章标题跟随部分计数器编号，当开启新的一部分时章编号从1开始。
+ 使章标题跟随部分计数器编号，仅在导言区有效。当开启新的部分标题时章编号从1开始。
\keychoice{fntnumwith}{part,\fbox{chapter},page}
- 使脚注跟随编号的计数器名。默认跟随章计数器，即开启新的一章时脚注编号从1开始。
+ 设置脚注跟随编号的计数器，仅在导言区有效。默认跟随章计数器，即开启新的章标题时脚注编号从1开始。
\keychoice{uppercase}{\fbox{all},first,none,none*}
使用 \cs{rightmark} 和 \cs{leftmark} 等标题标记命令获取标题内容用于页眉页脚时其中英文的大小写类型。\code{all} 为标题标记中的英文字母全部大写。\code{first} 为标记以英文起始时仅第一个字母大写。\code{none} 不改变标记中英文字母的大小写形式，变体 \code{none*} 则强制标记的字母均为小写形式。
\kvsplit{brackets}{左括号,右括号}\Default{\Marg{(,)}}
@@ -706,7 +706,9 @@
\keyval{fnafterindent}{刚性长度}\Default{2em}
每个脚注第二段及之后段落的首行缩进，等于长度 \cs{fnafterindent} 的值。
\keyval{fnparskip}{弹性长度}\Default{0ex plus .1ex}
- 不同脚注的段落间距，等于长度 \cs{fnparskip} 的值。
+ 不同脚注自身的段落间距，脚注内容文本分段时生效，等于长度 \cs{fnparskip} 的值。
+ \keyval{footnotesep}{弹性长度}\newtag%
+ 不同脚注之间的距离，默认情况下它自适应 \module*{spread} 模块脚注行距选项 \option{footnote} 的值。
\keychoice{fntext-pos}{normal,\fbox{super}}
设置脚注内容标记的位置，正常文本或是上标形式。
\keychoice{fnmark-num}{\fbox{plain},pifont,pifont*,pisans,pisans*,\textcolor{SlateGray}{short num}}
@@ -783,9 +785,9 @@
\end{ctexexam}
\end{commands}
\keychoice{fnboth-format}{\textcolor{SlateGray}{format code},match}
- 同时设定默认脚注标记 \option{fnmarktext-format} 和自定义脚注标记 \option{fncustom-format} 的格式。两种脚注标记匹配上标格式 \option{spcmd} 的值是独立的，使用 \code{match} 则可以同时匹配。标记格式选项含有字体命令会覆盖 \option{footnote} 的设置，最后一个格式命令可以带有一个参数接受脚注标记。
+ 同时设定默认脚注标记 \option{fnmarktext-format} 和自定义脚注标记 \option{fncustom-format} 的格式。两种脚注标记匹配上标格式 \option{spcmd} 的值是独立的，使用 \code{match} 则可以同时匹配。会覆盖 \module*{subfont} 模块脚注字体选项 \option{footnote} 相同类型的命令，最后一个格式命令可以带有一个参数接受脚注标记。
\keyval{fnpara-format}{格式代码}
- 脚注内容文本的格式。在此设置字体命令会覆盖 \option{footnote} 的设置，最后一个格式命令可以带有一个参数接受脚注内容文本。
+ 脚注内容文本的格式。会覆盖 \module*{subfont} 模块脚注字体选项 \option{footnote} 相同类型的命令，最后一个格式命令可以带有一个参数接受脚注内容文本。
\kvsplit{fntext-code}{前代码,后代码}
可以用 \meta{前代码} 与 \meta{后代码} 额外增加脚注内容标记前后的代码。也可以只有前部分，\meta{前代码} 中最后一个格式命令可以带有一个参数接受脚注内容标记。由于脚注标记处于水平模式，可以配合盒子命令设置脚注内容标记的对齐方式，或在标记与脚注首行间插入一点距离。
\begin{ctexexam}
@@ -1200,19 +1202,15 @@
\subsection{计数器}
\begin{commands}\noitemsep
\command{newcounter}[\marg{计数器}\oarg{父计数器}]\default{}
- \command{counteruse}[\sarg\oarg{编号}\darg{分隔符}\marg{计数器}\oarg{父计数器}]
- 命令 \cs{newcounter} 是 \LaTeX 自带的创建计数器命令。命令 \cs{counteruse} 可以在当前位置输出这种计数器的值，它仅具有\textbf{输出}功能，并不会改变计数器原有的绑定关系。默认每使用一次输出命令 \meta{计数器} 的值增加1，带有星号参数的命令使 \meta{计数器} 的值保持不变。计数器的 \meta{编号} 为 \code{arabic} 或 \code{alph} 等计数形式。在一定的场合下可能用到 \cs{counteruse} 命令，比如通过新建快捷命令在一些位置使用定理环境的计数器。使用 \cs{labelformat} 设置计数器的标签引用时需添加 \code{eb-} 前缀：
- \begin{ctexexam}
- \labelformat{eb-theorem}{定理#1}
- \newcommand{\theoremhead}[1]{定理\counteruse{theorem}[chapter]\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{setcounter}[\marg{计数器}\marg{整数}]\default{}
+ \command{stepcounter}[\marg{计数器}]
+ 常用的计数器设置命令。命令 \cs{newcounter} 创建一个初始值为0的新计数器。命令 \cs{setcounter} 将计数器的值设定为指定值。命令 \cs{stepcounter} 使计数器的值递增1。
+ \command{counterwithin}[\sarg\oarg{格式}\marg{计数器}\oarg{连字符}\marg{父计数器}]\newtag[Chg]%
+ 对计数器进行绑定的命令。将 \meta{计数器} 绑定于 \meta{父计数器}，即 \meta{父计数器} 的值递增时 \meta{计数器} 的值会归零。输出格式 \cs*{the}\meta{计数器} 被定义为 \cs*{the}\meta{父计数器}\meta{连字符}\meta{格式}\marg{计数器}。\meta{格式} 一般为更改计数器编号形式的命令，默认为 \cs*{arabic}。带有星号参数的命令仅进行绑定不更改输出格式。
\command{counterwithout}[\sarg\oarg{格式}\marg{计数器}\marg{父计数器}]
对计数器关系进行解绑的命令。将 \meta{计数器} 解绑于 \meta{父计数器}，同时输出格式被改为 \meta{格式}\marg{计数器}。带有星号参数的命令仅进行解绑不更改输出格式。
\begin{ctexexam}
- \counterwithin[\Roman]{child}{parent}
+ \counterwithin[\Roman]{child}[-]{parent}
\counterwithout*{child}{parent}
\end{ctexexam}
\end{commands}
@@ -1354,12 +1352,12 @@
\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 = 2024x,date = 2024/02/08,simple]
+ \begin{version}[v = 2024z,date = 2024/02/08,simple]
\item 核对依赖宏包的更新改动，优化使用手册的内容细节。
\item 修复图表等浮动环境题注目录中条目标签编号的计数器值显示错误问题。
\item 修复附录命令 \cs{appendix} 的可选参数设置英文目录中条目名字和编号失效的问题。
\item 新增目录风格定义命令 \cs{SetTocStyle} 和使用命令 \cs{UseTocStyle}。
- \item 新增脚注段落文本格式定义命令 \cs{deffntpara}。
+ \item 新增脚注段落文本格式定义命令 \cs{deffntpara} 和脚注间距离选项 \option{footnotesep}。
\end{version}
\end{changelog}
\nocite{*}
Modified: trunk/Master/texmf-dist/source/latex/easybook/easybook.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/easybook/easybook.dtx 2024-02-08 21:40:14 UTC (rev 69746)
+++ trunk/Master/texmf-dist/source/latex/easybook/easybook.dtx 2024-02-08 21:40:24 UTC (rev 69747)
@@ -15,7 +15,7 @@
%<*class>
\NeedsTeXFormat{LaTeX2e}[2021/11/15]
\RequirePackage{l3keys2e}
-\ProvidesExplClass{easybook}{2024/02/08}{2024x}
+\ProvidesExplClass{easybook}{2024/02/08}{2024z}
{Easily typesetting Chinese theses or books}
\bool_set_false:N \l__eb_compile_draft_bool
@@ -297,7 +297,7 @@
%<*package>
\NeedsTeXFormat{LaTeX2e}[2021/11/15]
\RequirePackage{l3keys2e,etoolbox}
-\ProvidesExplPackage{easybase}{2024/02/08}{2024x}
+\ProvidesExplPackage{easybase}{2024/02/08}{2024z}
{Easily typesetting Chinese theses or books}
\cs_generate_variant:Nn \dim_set:Nn { NV }
@@ -848,10 +848,11 @@
{
fnfirstindent .dim_set:N = \fnfirstindent,
fnfirstindent .initial:n = 0.8em,
- fnafterindent .tl_set:N = \fnafterindent,
+ fnafterindent .dim_set:N = \fnafterindent,
fnafterindent .initial:n = 2em,
fnparskip .skip_set:N = \fnparskip,
fnparskip .initial:n = 0ex plus .1ex,
+ footnotesep .skip_set:N = \footnotesep,
fnpara-format .tl_set:N = \l__eb_fnpara_format_tl,
fntext-pos .tl_set:N = \l__eb_fntext_position_tl,
fntext-pos .initial:n = super,
@@ -889,11 +890,6 @@
\eb_at_end_preamble:n
{
- \group_begin:
- \footnotesize
- \setspread{\fp_use:N \l__eb_spread_footnote_fp}
- \exp_args:NNNo \group_end:
- \dim_set:Nn \footnotesep { \dim_use:N \box_ht:N \strutbox }
\bool_if:NT \l__eb_chap_counter_withpart_bool
{ \counterwithin*{chapter}{part} }
\str_case:VnT \l__eb_fnt_parent_counter_tl
@@ -951,7 +947,7 @@
}
\msg_new:nnn { easybase } { bottom-not-compatible }
{
- Not~compatible~with~the~'footmisc'~package, \\
+ Not~compatible~with~the~'footmisc'~package. \\
Please~use~the~'bottom'~option~of~'footmisc'~package.
}
@@ -1061,6 +1057,14 @@
\@footnotemark
\@footnotetext
}
+\cs_new_protected:Npn \eb_set_current_label:n #1
+ {
+ \protected at edef\@currentlabel
+ {
+ \exp_args:Nnv
+ \use:c { p@#1 } { the#1 }
+ }
+ }
\cs_set_protected:Npn \footnote
{
\peek_meaning:NTF [
@@ -1067,7 +1071,7 @@
{ \@xfootnote }
{
\exp_args:NV \stepcounter \@mpfn
- \eb_current_label:n { upfootnote }
+ \eb_set_current_label:n { upfootnote }
\protected at xdef\@thefnmark{\thempfn}
\protected at xdef\@the at up@fnmark{\theupfootnote}
\@footnotemark
@@ -1198,24 +1202,27 @@
\newcounter{bichapter}
\newcounter{bisection}[bichapter]
\newcounter{bisubsection}[bisection]
-\cs_new_protected:Npn \eb_current_label:n #1
+\NewDocumentCommand{\counteruse}{sO{}D(){}mo}
{
- \tl_set:Nx \@currentlabel
- {
- \exp_args:Nnv
- \use:c { p@#1 } { the#1 }
- }
+ \use:c { the#4 }
+ \msg_warning:nnn { easybase } { counteruse } {#4}
}
-\NewDocumentCommand{\counteruse}{sO{arabic}D(){.}mo}
+\msg_new:nnn { easybase } { counteruse }
{
- \IfBooleanF{#1}{\stepcounter{#4}}
- \tl_set:cn { theeb-#4 }
+ The~command~\string\counteruse{#1}\ is~deprecated. \\
+ Please~use~the~\string\the#1\ command.
+ }
+\RenewDocumentCommand{\counterwithin}{sO{\arabic}mO{.}m}
+ {
+ \@ifbothcounters{#3}{#5}
{
- \IfValueT{#5}{\use:c { the#5 }#3}
- \use:c {#2}{#4}
+ \@addtoreset{#3}{#5}
+ \IfBooleanF{#1}
+ {
+ \exp_args:Nc \cs_gset:Npn { the#3 }
+ { \use:c { the#5 }#4#2{#3} }
+ }
}
- \tl_use:c { theeb-#4 }
- \eb_current_label:n { eb-#4 }
}
\cs_new:Npn \eb_section_counter_prefix:n #1
{
@@ -1724,7 +1731,15 @@
table .initial:n = 1.354,
math .fp_set:N = \l__eb_spread_math_fp,
math .initial:n = 1.354,
- footnote .fp_set:N = \l__eb_spread_footnote_fp,
+ footnote .code:n =
+ {
+ \fp_set:Nn \l__eb_spread_footnote_fp {#1}
+ \group_begin:
+ \footnotesize
+ \setspread{\fp_use:N \l__eb_spread_footnote_fp}
+ \exp_args:NNNo \group_end:
+ \dim_set:Nn \footnotesep { \dim_use:N \box_ht:N \strutbox }
+ },
footnote .initial:n = 1.2,
caption-table .fp_set:N = \l__eb_spread_caption_table_fp,
caption-figure .fp_set:N = \l__eb_spread_caption_figure_fp,
@@ -2304,7 +2319,7 @@
}
%</package>
%<*tcolorbox>
-\ProvidesExplFile{eb-tcolorbox.cfg}{2024/02/08}{2024x}
+\ProvidesExplFile{eb-tcolorbox.cfg}{2024/02/08}{2024z}
{Customization of tcolorbox for easybook}
\cs_set_protected:Npn \addtotcbstyle #1#2
Modified: trunk/Master/texmf-dist/tex/latex/easybook/easybase.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/easybook/easybase.sty 2024-02-08 21:40:14 UTC (rev 69746)
+++ trunk/Master/texmf-dist/tex/latex/easybook/easybase.sty 2024-02-08 21:40:24 UTC (rev 69747)
@@ -20,7 +20,7 @@
%% This work has the LPPL maintenance status `maintained'.
\NeedsTeXFormat{LaTeX2e}[2021/11/15]
\RequirePackage{l3keys2e,etoolbox}
-\ProvidesExplPackage{easybase}{2024/02/08}{2024x}
+\ProvidesExplPackage{easybase}{2024/02/08}{2024z}
{Easily typesetting Chinese theses or books}
\cs_generate_variant:Nn \dim_set:Nn { NV }
@@ -571,10 +571,11 @@
{
fnfirstindent .dim_set:N = \fnfirstindent,
fnfirstindent .initial:n = 0.8em,
- fnafterindent .tl_set:N = \fnafterindent,
+ fnafterindent .dim_set:N = \fnafterindent,
fnafterindent .initial:n = 2em,
fnparskip .skip_set:N = \fnparskip,
fnparskip .initial:n = 0ex plus .1ex,
+ footnotesep .skip_set:N = \footnotesep,
fnpara-format .tl_set:N = \l__eb_fnpara_format_tl,
fntext-pos .tl_set:N = \l__eb_fntext_position_tl,
fntext-pos .initial:n = super,
@@ -612,11 +613,6 @@
\eb_at_end_preamble:n
{
- \group_begin:
- \footnotesize
- \setspread{\fp_use:N \l__eb_spread_footnote_fp}
- \exp_args:NNNo \group_end:
- \dim_set:Nn \footnotesep { \dim_use:N \box_ht:N \strutbox }
\bool_if:NT \l__eb_chap_counter_withpart_bool
{ \counterwithin*{chapter}{part} }
\str_case:VnT \l__eb_fnt_parent_counter_tl
@@ -674,7 +670,7 @@
}
\msg_new:nnn { easybase } { bottom-not-compatible }
{
- Not~compatible~with~the~'footmisc'~package, \\
+ Not~compatible~with~the~'footmisc'~package. \\
Please~use~the~'bottom'~option~of~'footmisc'~package.
}
@@ -784,6 +780,14 @@
\@footnotemark
\@footnotetext
}
+\cs_new_protected:Npn \eb_set_current_label:n #1
+ {
+ \protected at edef\@currentlabel
+ {
+ \exp_args:Nnv
+ \use:c { p@#1 } { the#1 }
+ }
+ }
\cs_set_protected:Npn \footnote
{
\peek_meaning:NTF [
@@ -790,7 +794,7 @@
{ \@xfootnote }
{
\exp_args:NV \stepcounter \@mpfn
- \eb_current_label:n { upfootnote }
+ \eb_set_current_label:n { upfootnote }
\protected at xdef\@thefnmark{\thempfn}
\protected at xdef\@the at up@fnmark{\theupfootnote}
\@footnotemark
@@ -921,24 +925,27 @@
\newcounter{bichapter}
\newcounter{bisection}[bichapter]
\newcounter{bisubsection}[bisection]
-\cs_new_protected:Npn \eb_current_label:n #1
+\NewDocumentCommand{\counteruse}{sO{}D(){}mo}
{
- \tl_set:Nx \@currentlabel
- {
- \exp_args:Nnv
- \use:c { p@#1 } { the#1 }
- }
+ \use:c { the#4 }
+ \msg_warning:nnn { easybase } { counteruse } {#4}
}
-\NewDocumentCommand{\counteruse}{sO{arabic}D(){.}mo}
+\msg_new:nnn { easybase } { counteruse }
{
- \IfBooleanF{#1}{\stepcounter{#4}}
- \tl_set:cn { theeb-#4 }
+ The~command~\string\counteruse{#1}\ is~deprecated. \\
+ Please~use~the~\string\the#1\ command.
+ }
+\RenewDocumentCommand{\counterwithin}{sO{\arabic}mO{.}m}
+ {
+ \@ifbothcounters{#3}{#5}
{
- \IfValueT{#5}{\use:c { the#5 }#3}
- \use:c {#2}{#4}
+ \@addtoreset{#3}{#5}
+ \IfBooleanF{#1}
+ {
+ \exp_args:Nc \cs_gset:Npn { the#3 }
+ { \use:c { the#5 }#4#2{#3} }
+ }
}
- \tl_use:c { theeb-#4 }
- \eb_current_label:n { eb-#4 }
}
\cs_new:Npn \eb_section_counter_prefix:n #1
{
@@ -1447,7 +1454,15 @@
table .initial:n = 1.354,
math .fp_set:N = \l__eb_spread_math_fp,
math .initial:n = 1.354,
- footnote .fp_set:N = \l__eb_spread_footnote_fp,
+ footnote .code:n =
+ {
+ \fp_set:Nn \l__eb_spread_footnote_fp {#1}
+ \group_begin:
+ \footnotesize
+ \setspread{\fp_use:N \l__eb_spread_footnote_fp}
+ \exp_args:NNNo \group_end:
+ \dim_set:Nn \footnotesep { \dim_use:N \box_ht:N \strutbox }
+ },
footnote .initial:n = 1.2,
caption-table .fp_set:N = \l__eb_spread_caption_table_fp,
caption-figure .fp_set:N = \l__eb_spread_caption_figure_fp,
Modified: trunk/Master/texmf-dist/tex/latex/easybook/easybook.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/easybook/easybook.cls 2024-02-08 21:40:14 UTC (rev 69746)
+++ trunk/Master/texmf-dist/tex/latex/easybook/easybook.cls 2024-02-08 21:40:24 UTC (rev 69747)
@@ -20,7 +20,7 @@
%% This work has the LPPL maintenance status `maintained'.
\NeedsTeXFormat{LaTeX2e}[2021/11/15]
\RequirePackage{l3keys2e}
-\ProvidesExplClass{easybook}{2024/02/08}{2024x}
+\ProvidesExplClass{easybook}{2024/02/08}{2024z}
{Easily typesetting Chinese theses or books}
\bool_set_false:N \l__eb_compile_draft_bool
Modified: trunk/Master/texmf-dist/tex/latex/easybook/eb-tcolorbox.cfg
===================================================================
--- trunk/Master/texmf-dist/tex/latex/easybook/eb-tcolorbox.cfg 2024-02-08 21:40:14 UTC (rev 69746)
+++ trunk/Master/texmf-dist/tex/latex/easybook/eb-tcolorbox.cfg 2024-02-08 21:40:24 UTC (rev 69747)
@@ -18,7 +18,7 @@
%% LaTeX version 2005/12/01 or later.
%%
%% This work has the LPPL maintenance status `maintained'.
-\ProvidesExplFile{eb-tcolorbox.cfg}{2024/02/08}{2024x}
+\ProvidesExplFile{eb-tcolorbox.cfg}{2024/02/08}{2024z}
{Customization of tcolorbox for easybook}
\cs_set_protected:Npn \addtotcbstyle #1#2
More information about the tex-live-commits
mailing list.