diff options
author | Karl Berry <karl@freefriends.org> | 2021-07-01 21:35:55 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-07-01 21:35:55 +0000 |
commit | 9bbe89667b78619aa50dd3a4b62d55a187f47a37 (patch) | |
tree | 70801a746f5ec8bf813f5342dfdbfb16f8da78b1 /Master/texmf-dist/source/latex/easybook | |
parent | 77d5e4b2de7129a1afde87ff578040e74449959e (diff) |
easybook (1jul21)
git-svn-id: svn://tug.org/texlive/trunk@59794 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/easybook')
-rw-r--r-- | Master/texmf-dist/source/latex/easybook/easybook.dtx | 177 |
1 files changed, 101 insertions, 76 deletions
diff --git a/Master/texmf-dist/source/latex/easybook/easybook.dtx b/Master/texmf-dist/source/latex/easybook/easybook.dtx index 66e7ffba49d..a8f24a2dc64 100644 --- a/Master/texmf-dist/source/latex/easybook/easybook.dtx +++ b/Master/texmf-dist/source/latex/easybook/easybook.dtx @@ -28,7 +28,7 @@ % % \title{\sffamily easybook 文档类手册} % \author{瞿毅} -% \date{2021/06/30\hskip\ccwd\relax v1.26n\thanks{\url{https://gitee.com/texl3/easybook}}} +% \date{2021/07/01\hskip\ccwd\relax v1.26o\thanks{\url{https://gitee.com/texl3/easybook}}} % % \maketitle % \begin{abstract} @@ -40,7 +40,8 @@ % 使用 \cls{easybook} 文档类编写文档前您可能需要满足以下的条件: % \begin{itemize} % \item 使用 \hologo{XeLaTeX}(推荐)或 \hologo{LuaLaTeX} 两种编译方式。 -% \item 由于用到了一些 \LaTeX 和宏包较新的功能,建议安装最新的 \TeX 发行版,例如 \TeX Live 2021或 \hologo{MiKTeX} 21.2之后的版本。 +% \item 由于用到了一些 \LaTeX 和宏包较新的功能,建议安装最新的 \TeX 发行版,例如 \TeX Live 2021 或 \hologo{MiKTeX} 21.2 之后的版本。 +% \item 虽然手册对基本用法做了介绍,但这并不是入门教程,您应当具有一定的 \LaTeX 使用基础。 % \end{itemize} % % \subsection{基本用法} @@ -139,7 +140,7 @@ % % \begin{function}[rEXP,added = 2021-01-05,updated = 2021-01-13]{paper} % \begin{syntax} -% paper = <(a4paper)|b5paper|letterpaper|...> +% paper = <(a4paper)|b5paper|c5paper|letterpaper|...> % \end{syntax} % 设置页面大小,交给 \pkg{geometry} 宏包处理,可使用它支持的所有规格。建议选项 \opt{b5paper} 和 \opt{zihao = 5},选项 \opt{a4paper} 和 \opt{zihao = -4} 配合。 % \end{function} @@ -157,7 +158,7 @@ % floatpage = <true|(false)> % \end{syntax} % 开启这个选项后浮动环境 \env{table} 和 \env{figure} 的比例参数会使用默认值,关闭它则尽可能避免出现浮动页,使图表环境与正文段落更加紧凑,减少多余的空白版面。 -% \changes{v1.26n}{2021/06/15}{增加浮动环境比例参数选项 \opt{floatpage}。} +% \changes{v1.26o}{2021/06/15}{增加浮动环境比例参数选项 \opt{floatpage}。} % \end{function} % % \subsection{article 模式} @@ -179,7 +180,7 @@ % \tn{backmatter} % \tn{cleardoublepage}\oarg{页面风格|(empty)} % \end{syntax} -% \tn{frontmatter} 为前言区命令,章标题不编号,页码可设置为例如 \opt{roman}、\opt{Alph} 等格式,带有星号的命令 \tn{frontmatter*} 不使用清双页命令 \tn{cleardoublepage}。\tn{mainmatter} 为主文区命令,章标题正常编号且页码为从1开始计数的阿拉伯数字,\tn{mainmatter*} 命令不使用 \tn{cleardoublepage}。\tn{backmatter} 为后记区命令,页码格式与编号保持不变,章标题不编号。在奇数页使用命令 \tn{cleardoublepage} 时可选参数为下一页多出的空白偶数页的页面风格,默认为 \opt{empty} 即空的页眉页脚。 +% \tn{frontmatter} 为前言区命令,章标题不编号,页码可设置为例如 \opt{roman}、\opt{Alph} 等格式,带有星号的命令 \tn{frontmatter*} 不使用清双页命令 \tn{cleardoublepage}。\tn{mainmatter} 为主文区命令,章标题正常编号且页码为从 1 开始计数的阿拉伯数字,\tn{mainmatter*} 命令不使用 \tn{cleardoublepage}。\tn{backmatter} 为后记区命令,页码格式与编号保持不变,章标题不编号。在奇数页使用命令 \tn{cleardoublepage} 时可选参数为下一页多出的空白偶数页的页面风格,默认为 \opt{empty} 即空的页眉页脚。 % \changes{v1.23}{2021/02/20}{重新定义文档结构划分命令。} % \end{function} % @@ -191,7 +192,7 @@ % \tn{listoftables*+}\oarg{键值列表} % \tn{listoflstlistings*+}\oarg{键值列表} % \end{syntax} -% \tn{listoffigures} 命令输出图片目录,\tn{listoftables} 输出表格目录,\tn{listoflstlistings} 输出代码目录。带有星号的目录命令不将标题添加进主文档目录,带有+号的目录命令可以使当前标题编号。\tn{tableofcontents+} 的+号含义则是输出双语目录,需要与双语目录标题命令 \tn{bichapter} 等或设置图片、表格和代码等英文目录的标题配合使用,附加代码是中文与英文目录之间的代码,可以插入目录样式和换页等命令。可选参数的 \meta{键值列表} 如下: +% \tn{listoffigures} 命令输出图片目录,\tn{listoftables} 输出表格目录,\tn{listoflstlistings} 输出代码目录。带有星号的目录命令不将标题添加进主文档目录,带有 + 号的目录命令可以使当前标题编号。\tn{tableofcontents+} 的 + 号含义则是输出双语目录,需要与双语目录标题命令 \tn{bichapter} 等或设置图片、表格和代码等英文目录的标题配合使用,附加代码是中文与英文目录之间的代码,可以插入目录样式和换页等命令。可选参数的 \meta{键值列表} 如下: % \changes{v1.25}{2021/05/05}{命令 \tn{tableofcontents} 可以输出双语目录。} % \end{function} % @@ -239,7 +240,7 @@ % \tn{EBeforeAddBitoc*}\marg{加入目录英文标题前的代码} % \end{syntax} % \tn{appendix} 命令后的章节标题变为附录形式。英文目录中附录标题的格式用可选参数修改,英文附录目录前名字默认为 Appendix\tn{space},后名字默认为空,名字之间用一个半角逗号分开,也可以只有一部分,表示英文附录目录前名字。英文附录目录数字输出命令默认为 \tn{Alph}\{chapter\}。 -% \changes{v1.26n}{2021/06/13}{增加调整英文目录格式的钩子 \tn{EBeforeAddBitoc}。} +% \changes{v1.26o}{2021/06/13}{增加调整英文目录格式的钩子 \tn{EBeforeAddBitoc}。} % \end{function} % % \tn{EBeforeAddBitoc} 是一个作用于局部范围的英文目录钩子,可以插入标题或目录设置的命令改变英文目录中标题的显示格式,也可以覆盖上述的目录前后名字和编号等设置,带有星号的命令会重置之前的代码,放置在导言区或 \tn{bichapter} 等命令前生效。 @@ -254,10 +255,10 @@ % \ \oarg{水平偏移}\parg{下标代码} % \end{syntax} % 上标和下标的功能来自 \pkg{spbmark} 宏包,\tn{super}、\tn{sub} 和 \tn{supersub} 三个命令可以用于输出上标和下标。它们根据当前处于文本模式还是数学模式来匹配相应的模式,或者可以使用它们的星号变体命令来强制使用数学模式。也可以使用键值列表对偏移量进行全局设置,详情见小节 \ref{subsec:style}。 -% \changes{v1.26n}{2021/06/28}{增加可以调整相对位置和格式的上标和下标命令 \tn{super}、\tn{sub} 和 \tn{supersub}。} +% \changes{v1.26o}{2021/06/28}{增加可以调整相对位置和格式的上标和下标命令 \tn{super}、\tn{sub} 和 \tn{supersub}。} % \end{function} % -% 垂直和水平偏移默认值都是0 pt,\meta{对齐方式} 的参数与 \opt{supersubalign} 相同。\meta{格式代码} 用于格式化上标和下标,可以插入字体或颜色等命令。代码中的最后一个命令可以接受一个为上标或下标的参数。\tn{textsuperscript} 和 \tn{textsubscript} 命令已被重新定义并且分别等价于 \tn{super} 和 \tn{sub},如果您需要使用它们的原始定义创建新命令,则可以使用 \tn{spb@textsuperscript@save} 和 \tn{spb@textsubscript@save} 命令。 +% 垂直和水平偏移默认值都是 0 pt,\meta{对齐方式} 的参数与 \opt{supersubalign} 相同。\meta{格式代码} 用于格式化上标和下标,可以插入字体或颜色等命令。代码中的最后一个命令可以接受一个为上标或下标的参数。\tn{textsuperscript} 和 \tn{textsubscript} 命令已被重新定义并且分别等价于 \tn{super} 和 \tn{sub},如果您需要使用它们的原始定义创建新命令,则可以使用 \tn{spb@textsuperscript@save} 和 \tn{spb@textsubscript@save} 命令。 % % \section{接口选项} % \label{sec:interface options} @@ -313,10 +314,10 @@ % 主题颜色用到这三个颜色,可以使用 \tn{definecolor} 命令进行更改,类似地更改超链接颜色见小节 \ref{subsec:hyperlinks}。 % \changes{v1.10}{2021/01/08}{可以自定义主题颜色。} % \end{function} -% \item[color-all] 统一设置主题的各部分颜色,参数是6个十六进制数字组成的 HTML 颜色代码,任意颜色的代码可以在常见的图片处理工具拾色器中查看。 +% \item[color-all] 统一设置主题的各部分颜色,参数是 6 个十六进制数字组成的 HTML 颜色代码,任意颜色的代码可以在常见的图片处理工具拾色器中查看。 % \item[multoc] 开启多栏目录,与节 \ref{sec:document command} 中目录命令的同名选项有相同效果。 % \item[withpart] 使章跟随每一部分编号,默认不跟随。 -% \item[footwith] 使脚注跟随编号的计数器,默认跟随章,当开启新的一章时脚注编号从1开始。 +% \item[footwith] 使脚注跟随编号的计数器,默认跟随章,当开启新的一章时脚注编号从 1 开始。 % \item[rulewidth] 调整页眉、定理盒子以及代码框线条的粗细。 % \item[uppercase] 使用 \tn{rightmark} 及 \tn{leftmark} 获取标题内容设置页眉页脚时英文是否大小写。 % \item[figure-sep] 图片标题编号的连接符。 @@ -367,7 +368,7 @@ % 超链接颜色用到这三个颜色,可以使用 \tn{definecolor} 命令进行更改。 % \changes{v1.10}{2021/01/08}{可以自定义超链接颜色。} % \end{function} -% \item[linkcol-all] 统一设置超链接的各部分颜色,参数是6个十六进制数字组成的 HTML 颜色代码,任意颜色的代码可以在常见的图片处理工具拾色器中查看。 +% \item[linkcol-all] 统一设置超链接的各部分颜色,参数是 6 个十六进制数字组成的 HTML 颜色代码,任意颜色的代码可以在常见的图片处理工具拾色器中查看。 % \item[linktoc] 将目录中的超链接取消、置于标题上、置于页码上或置于标题和页码上。 % \end{optdesc} % @@ -441,7 +442,7 @@ % % \begin{optdesc} % \item[backend] 参考文献处理后端,默认用传统的 \hologo{BibTeX} 处理参考文献。 -% \item[bib-style] 参考文献格式为中国的参考文献推荐标准GB/T 7714-2015,有顺序编码制和著者-出版年制两种风格,理工科类一般使用顺序编码制,文科类一般使用著者-出版年制。若使用其它格式,使用 \hologo{BibTeX} 处理时需确保正确的 \opt{bst} 文件,使用 \hologo{biber} 处理可使用 \pkg{biblatex} 宏包支持的参考文献风格名称。 +% \item[bib-style] 参考文献格式为中国的参考文献推荐标准 GB/T 7714-2015,有顺序编码制和著者-出版年制两种风格,理工科类一般使用顺序编码制,文科类一般使用著者-出版年制。若使用其它格式,使用 \hologo{BibTeX} 处理时需确保正确的 \opt{bst} 文件,使用 \hologo{biber} 处理可使用 \pkg{biblatex} 宏包支持的参考文献风格名称。 % \item[cite-style] 标注参考文献的风格,\opt{backend = bibtex} 选项下可使用 \opt{super}(数字上标标注,默认)或 \opt{numbers}(数字标注)等 \pkg{natbib} 宏包带有的标注风格,\opt{backend = biblatex} 选项下可使用 \pkg{biblatex} 宏包支持的标注风格名称。 % \item[datafile] 参考文献数据库的文件名,可以是单个文件也可以是以括号包裹并以英文逗号分隔的文件列表,使用 \hologo{biber} 处理时要带有 \opt{bib} 后缀,若不在当前文件夹名称需要包含路径。只有设置数据库的文件名才会载入 \pkg{natbib} 或 \pkg{biblatex} 宏包,之后才可使用相关配置命令,否则需要手动载入相关宏包配置参考文献。 % \end{optdesc} @@ -469,7 +470,7 @@ % % \subsection{定理样式} % \label{subsec:theorem of style} -% \begin{function}[EXP,added = 2021-01-12,updated = 2021-06-16]{thmbox,within,headpunct,bodyfont,notefont,headfont,headindent,spaceabove,spacebelow,spacepost,headformat} +% \begin{function}[EXP,added = 2021-01-12,updated = 2021-07-01]{thmbox,within,headpunct,bodyfont,notefont,headfont,headindent,spaceabove,spacebelow,spacepost,headformat,brackets} % \begin{syntax} % thmbox = <true|(false)> % within = <(chapter)|section|其它环境|空置> @@ -482,9 +483,11 @@ % spacebelow = <弹性长度|(0.75ex plus .1ex)> % spacepost = <刚性长度|(\tn{ccwd})> % headformat = <(\tn{NAME}\tn{space}\tn{NUMBER}\tn{NOTE})> +% brackets = \{<左括号>,<右括号>\} % \end{syntax} % \ding{229} 以上选项路径为 \opt{thmset/...} % \changes{v1.21}{2021/01/12}{增加配置定理环境样式的选项。} +% \changes{v1.26o}{2021/07/01}{增加配置公式标签括号选项 \opt{brackets}。} % \end{function} % % \begin{optdesc} @@ -499,6 +502,7 @@ % \item[spacebelow] 定理环境后的间距。 % \item[spacepost] 定理标题后与第一段内容的间隔。 % \item[headformat] 定理开头部分各组成元素的排列和格式,这个选项一般不需要使用,其中 \tn{NAME}、\tn{NUMBER} 和 \tn{NOTE} 分别代表标题、编号和题注。 +% \item[brackets] 设置行间公式编号标签的括号,以英文逗号分隔,分别为左右括号。 % \end{optdesc} % % \begin{function}[added = 2021-01-12,updated = 2021-06-15]{\declaretheorem,\EBNewTheorem,\declaretheoremstyle} @@ -507,10 +511,10 @@ % \tn{EBNewTheorem}\marg{定理环境名}\oarg{英文标题}\marg{中文标题}\parg{盒子样式|(tc-theorem)}\oarg{键值列表} % \tn{declaretheoremstyle}\oarg{键值列表}\marg{定理样式名} % \end{syntax} -% 文档类已预置8个定理环境,环境名及对应的定理标题名见小节 \ref{subsec:theorem},如果需要新的定理标题名或定理样式可使用这两个命令,由 \pkg{thmtools} 提供支持,用法与它的同名命令一致。 +% 文档类已预置 8 个定理环境,环境名及对应的定理标题名见小节 \ref{subsec:theorem},如果需要新的定理标题名或定理样式可使用这两个命令,由 \pkg{thmtools} 提供支持,用法与它的同名命令一致。 % \changes{v1.23}{2021/03/12}{重新定义了新定理环境命令 \tn{newtheorem}。} % \changes{v1.24}{2021/04/25}{增加定义定理环境命令 \tn{EBNewTheorem}。} -% \changes{v1.26n}{2021/06/15}{定义新定理环境的命令调整为 \tn{declaretheorem}。} +% \changes{v1.26o}{2021/06/15}{定义新定理环境的命令调整为 \tn{declaretheorem}。} % \end{function} % % \begin{optdesc} @@ -616,10 +620,10 @@ % \tn{markrule}\oarg{长度|(\tn{textwidth})}\parg{颜色名}\marg{线宽|(0.75pt)}[<上间距>+<下间距>] % \end{syntax} % 命令 \tn{easyhead} 和 \tn{easyfoot} 的使用方法与 \tn{fancyhead} 和 \tn{fancyfoot} 完全相同,它们需要在 \opt{head-foot} 选项中使用,设置的是一个名为 \opt{fancy} 的页面风格。\pkg{fancyhdr} 将页眉页脚分成了左中右和奇数页(odd)、偶数页(even)共12个部分,可选参数中E、O代表偶数、奇数,L、C、R代表左、中、右部分。单面打印时,含有偶数的选项无效。 -% \changes{v1.26n}{2021/06/14}{增加页眉页脚的横线绘制命令 \tn{markrule}。} +% \changes{v1.26o}{2021/06/14}{增加页眉页脚的横线绘制命令 \tn{markrule}。} % \end{function} % -% 命令 \tn{markrule} 用于绘制页眉页脚横线,长度默认为页面文本区的宽度,上下间距为横线与上下方部件的间距,带有长度单位,间距长度之间用+号分开,若只有一部分则表示上间距,这个命令也可以在正文中绘制横线。下面举一个设置页眉内容的例子: +% 命令 \tn{markrule} 用于绘制页眉页脚横线,长度默认为页面文本区的宽度,上下间距为横线与上下方部件的间距,带有长度单位,间距长度之间用 + 号分开,若只有一部分则表示上间距,这个命令也可以在正文中绘制横线。下面举一个设置页眉内容的例子: % \begin{ctexexam} % \hdrset % { @@ -646,7 +650,7 @@ % afterfnmark = <脚注标记后的代码> % \end{syntax} % \ding{229} 以上选项路径为 \opt{hdrset/...} \\ -% 上面几个选项用于设置脚注格式,\opt{fnparskip} 和 \opt{fnparindent} 选项仅在 \opt{fnhang = true} 时有效。\opt{fnhang} 用于将脚注设置为悬挂缩进的格式,\opt{fnmark-pos} 选项设置脚注编号的位置,正常文本或是上标形式。\opt{fnmark-num} 选项设置脚注编号的格式,默认为原生样式 \opt{plain},还可以改为 \opt{pifont} 的各个版本,从左往右依次为普通版、阴文衬线版、阳文无衬线版和阴文无衬线版,缺点是它们的编号仅包括1-10。 +% 上面几个选项用于设置脚注格式,\opt{fnparskip} 和 \opt{fnparindent} 选项仅在 \opt{fnhang = true} 时有效。\opt{fnhang} 用于将脚注设置为悬挂缩进的格式,\opt{fnmark-pos} 选项设置脚注编号的位置,正常文本或是上标形式。\opt{fnmark-num} 选项设置脚注编号的格式,默认为原生样式 \opt{plain},还可以改为 \opt{pifont} 的各个版本,从左往右依次为普通版、阴文衬线版、阳文无衬线版和阴文无衬线版,缺点是它们的编号仅包括 1-10。 % \changes{v1.25}{2021/05/12}{增加脚注样式设置选项。} % \end{function} % @@ -715,14 +719,14 @@ % \end{function} % % \begin{optdesc} -% \item[lolskip] \opt{lolskip} 是代码目录中章之间的代码标题的距离,与 \CTeX 的表格目录和图片目录中章之间的标题距离选项 \opt{lotskip} 和 \opt{lofskip} 类似,它们的值均默认0.8 pc,在 article 模式中此选项失效。 +% \item[lolskip] \opt{lolskip} 是代码目录中章之间的代码标题的距离,与 \CTeX 的表格目录和图片目录中章之间的标题距离选项 \opt{lotskip} 和 \opt{lofskip} 类似,它们的值均默认 0.8 pc,在 article 模式中此选项失效。 % \item[belowoffset] \opt{belowoffset} 选项为主文档目录标题下方的间距补偿,一般为负值,用于抵消 \opt{format} 中额外的垂直间距。\opt{(level)} 中的 \opt{belowoffset} 与之意义类似,代表 figure、table 和 lstlisting 三个级别,也可以使用 \opt{list} 统一设置,一般为正值。 % \item[tocline] 目录标签整体使用 \opt{tocline} 设置,在图表标签的参数中 \#1 代表编号,代码标签中则是 \tn{thelstlisting} 代表编号,标签中还可包含标签名称,默认标签名称与图、表和代码环境的标题名称一致。下面举个设置标签的例子: % \begin{ctexexam} % \tocset % { % hang = false, -% tocline-fig = 图#1\hspace{\ccwd}, +% tocline-fig = 图 #1\hspace{\ccwd}, % tocline-lst = 代码\thelstlisting\hspace{\ccwd} % } % \end{ctexexam} @@ -824,7 +828,7 @@ % \ \tn{item} <习题内容> % \tn{end}\marg{exercise} % \end{syntax} -% 习题环境 \env{exercise} 的标题紧接上一节编号并加入目录与页眉,当使用星号参数时不进行编号,使用+号参数独立编号并启用 \pkg{tcolorbox} 支持生成标题,并使 \opt{color} 生效。第三个 \meta{键值列表} 的选项与小节 \ref{subsec:sort list} 排序列表相同,\opt{number} 的编号格式也是如此。第一个 \meta{键值列表} 中包含的选项如下: +% 习题环境 \env{exercise} 的标题紧接上一节编号并加入目录与页眉,当使用星号参数时不进行编号,使用 + 号参数独立编号并启用 \pkg{tcolorbox} 支持生成标题,并使 \opt{color} 生效。第三个 \meta{键值列表} 的选项与小节 \ref{subsec:sort list} 排序列表相同,\opt{number} 的编号格式也是如此。第一个 \meta{键值列表} 中包含的选项如下: % \changes{v1.23}{2021/02/08}{增加准确的习题盒子标题目录锚点。} % \end{function} % @@ -835,7 +839,7 @@ % number = <习题编号格式|(1.)> % numsep = <编号与标题的间距|(0.5\tn{ccwd})> % \end{syntax} -% 第二个 \meta{键值列表} 在是否使用+号参数时用法不同,使用+号参数时为 \pkg{tcolorbox} 的盒子选项,例如 \opt{boxrule} 和 \opt{fontupper}。不使用+号参数时相当于设置 \tn{ctexset}\{section = {\#1}\} 键值选项列表,例如 \opt{format} 和 \opt{beforeskip}。另外还可以使用 \tn{exerprologue} 命令在习题环境开始前插入一段内容,可以是文本或者代码,需要在每一个习题环境前使用。 +% 第二个 \meta{键值列表} 在是否使用 + 号参数时用法不同,使用 + 号参数时为 \pkg{tcolorbox} 的盒子选项,例如 \opt{boxrule} 和 \opt{fontupper}。不使用 + 号参数时相当于设置 \tn{ctexset}\{section = {\#1}\} 键值选项列表,例如 \opt{format} 和 \opt{beforeskip}。另外还可以使用 \tn{exerprologue} 命令在习题环境开始前插入一段内容,可以是文本或者代码,需要在每一个习题环境前使用。 % \end{function} % % \begin{ctexexam} @@ -936,6 +940,26 @@ % \qtyrange[unit-color = green]{1.5}{4}{kg} % \end{ctexexam} % +% \subsection{计数器} +% \begin{function}[added = 2021-06-30]{\newcounter,\EBUseCounter} +% \begin{syntax} +% \tn{newcounter}\marg{计数器}\oarg{父计数器} +% \tn{EBUseCounter*}\oarg{父计数器}\parg{编号|(arabic)}\marg{计数器}\marg{内容}\oarg{分隔符|(.)}\parg{数值} +% \end{syntax} +% \tn{newcounter} 是 \LaTeX 自带的创建计数器命令,\tn{EBUseCounter} 将会以一定的格式使用由它创建的计数器,将会以 \tn{the}\meta{父计数器}\meta{分隔符}\tn{the}\meta{计数器}\meta{内容} 输出当前内容。 +% \changes{v1.26o}{2021/06/30}{增加计数器使用命令 \tn{EBUseCounter}。} +% \end{function} +% +% 需要注意的是 \tn{EBUseCounter} 仅具有 \textbf{输出功能},并不会改变计数器原有的绑定关系。默认每使用一次命令 \meta{计数器} 的值增加 1,带有星号的命令使 \meta{计数器} 保持当前值,\meta{编号} 为 arabic 和 alpha 等格式,\meta{数值} 可以手动将 \meta{计数器} 设为指定值。 +% +% 在一定的场合下可能用到 \tn{EBUseCounter} 命令,比如通过新建快捷命令在一些位置使用定理环境的计数器,使用 \tn{labelformat} 设置计数器的引用标签需添加 eb@: +% \begin{ctexexam} +% \labelformat{eb@theorem}{定理 #1} +% \newcommand{\theoremhead}[1] +% {定理 \EBUseCounter[chapter]{theorem}{\hspace{\ccwd}#1}} +% \theoremhead{定理标题}\label{thm:theorem} +% \end{ctexexam} +% % \subsection{化学式} % \begin{function}[added = 2021-01-05]{\ch,\chemfig} % \begin{syntax} @@ -1015,24 +1039,6 @@ % 该环境由 \pkg{setspace} 提供,可以指定环境内段落的行距,使用浮点数控制行距倍数。 % \end{function} % -% \subsection{计数器} -% \begin{function}[added = 2021-06-30]{\newcounter,\EBUseCounter} -% \begin{syntax} -% \tn{newcounter}\marg{计数器}\oarg{父计数器} -% \tn{EBUseCounter*}\oarg{父计数器的值}\parg{编号|(arabic)}\marg{计数器}\marg{内容}\oarg{分隔符|(.)} -% \end{syntax} -% \tn{newcounter} 是 \LaTeX 自带的创建计数器命令,\tn{EBUseCounter} 将会以一定的格式使用由它创建的计数器,将会以 \tn{the}\meta{父计数器}\meta{分隔符}\meta{计数器}\meta{内容} 输出当前内容。带有星号的命令不会使计数器的值增加,所以可以使用当前 \tn{the}\meta{计数器} 的值,\meta{编号} 为 arabic 和 alpha 等格式。 -% \changes{v1.26n}{2021/06/30}{增加计数器使用命令 \tn{EBUseCounter}。} -% \end{function} -% -% 在一定的场合下可能用到 \tn{EBUseCounter} 命令,比如通过新建快捷命令在一些位置使用定理环境的计数器,使用 \tn{labelformat} 设置它的引用标签前缀需添加 eb@: -% \begin{ctexexam} -% \labelformat{eb@theorem}{定理#1} -% \newcommand{\theoremhead}[1] -% {定理\space\EBUseCounter[chapter]{theorem}{#1}} -% \theoremhead{定理标题}\label{thm:theorem} -% \end{ctexexam} -% % \subsection{下划线} % \begin{function}[added = 2021-04-03]{\uline,\uuline,\uwave} % \begin{syntax} @@ -1128,7 +1134,7 @@ %<*class> \NeedsTeXFormat{LaTeX2e}[2020/10/01] \RequirePackage{l3keys2e} -\ProvidesExplClass{easybook}{2021/06/30}{1.26n} +\ProvidesExplClass{easybook}{2021/07/01}{1.26o} {Typeset Chinese books or notes} \bool_set_false:N \l__eb_compile_draft_bool @@ -1376,7 +1382,7 @@ %<*package> \NeedsTeXFormat{LaTeX2e}[2020/10/01] \RequirePackage{etoolbox} -\ProvidesExplPackage{easybase}{2021/06/30}{1.26n} +\ProvidesExplPackage{easybase}{2021/07/01}{1.26o} {Typeset Chinese books or notes} \cs_generate_variant:Nn \eb_ctex_define:nn { nx } @@ -1828,19 +1834,10 @@ \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:VnF \l__eb_foot_counter_parent_choice_tl + \str_case:Vn \l__eb_foot_counter_parent_choice_tl { - { part } { \use_i:nn } - { page } { \use_ii:nn } - } - { \use_none:nn } - { - \counterwithout*{footnote}{chapter} - \counterwithin*{footnote}{part} - } - { - \counterwithout*{footnote}{chapter} - \counterwithin*{footnote}{page} + { part } { \counterwithin*{footnote}{part} } + { page } { \counterwithin*{footnote}{page} } } \bool_if:NTF \l__eb_footnote_hang_bool { \booltrue{FN@hangfoot} } @@ -2106,21 +2103,26 @@ \newcounter{bichapter} \newcounter{bisection}[bichapter] \newcounter{bisubsection}[bisection] -\NewDocumentCommand{\EBUseCounter}{soD(){arabic}mmO{.}} +\cs_set_protected:Npn \eb_current_label:n #1 + { + \tl_set:Nx \@currentlabel + { + \use:c { p@#1 } + \tl_use:c { the#1 } + } + } +\NewDocumentCommand{\EBUseCounter}{soD(){arabic}mmO{.}d()} { \IfBooleanF{#1}{\stepcounter{#4}} - \tl_set:cn { eb@the#4 } + \IfValueT{#7}{\setcounter{#4}{#7}} + \tl_set:cn { theeb@#4 } { \IfValueT{#2}{\use:c { the#2 }#6} \use:c {#3}{#4}\space #5 } - \tl_use:c { eb@the#4 } - \tl_remove_once:cn { eb@the#4 } {#5} - \tl_set:Nx \@currentlabel - { - \use:c { p@eb@#4 } - \use:c { eb@the#4 } - } + \tl_use:c { theeb@#4 } + \tl_remove_once:cn { theeb@#4 } {#5} + \eb_current_label:n { eb@#4 } } \cs_new:Npn \eb_arabic:n #1 { \int_to_arabic:v { c@#1 } } \cs_new:Npn \eb_section_counter_prefix:n #1 @@ -2161,8 +2163,7 @@ \def\CTEX@thechapter{\CTEX@bichapter@number} \def\CTEX@postchapter{\CTEX@postbichapter} \eb@before@addbitoc@hook - \addcontentsline{tec}{#1} - {\use:c { CTEX@#1@tocline }{#1}{#2}} + \addcontentsline{tec}{#1}{\use:c { CTEX@#1@tocline }{#1}{#2}} \group_end: } \seq_const_from_clist:Nn \c__eb_bitoc_title_level_seq @@ -2626,7 +2627,6 @@ \RenewDocumentCommand{\declaretheorem}{O{}m} {\AfterPreamble{\eb@declare@theorem@save[#1]{#2}}} \cs_set_eq:NN \newtheorem \declaretheorem - \prop_new:N \l__eb_thmtools_entry_prop \clist_const:Nn \c__eb_thmtools_entry_clist { @@ -2646,11 +2646,31 @@ \l__eb_thmtools_entry_prop \c__eb_thmtools_entry_clist \prop_map_inline:Nn \l__eb_thmtools_entry_prop { \eb_ctex_define:nn { thmset } { #1 .tl_set:N = #2 } } +\NewDocumentCommand{\eb_assign_tag_brackets:n} + {>{\SplitArgument{1}{,}}m} + {\eb_assign_tag_brackets_pos:nn #1} +\cs_new_protected:Npn \eb_assign_tag_brackets_pos:nn #1#2 + { + \tl_set:Nn \eb@tag@brackets@left {#1} + \tl_set:Nn \eb@tag@brackets@right {#2} + } +\cs_gset:Npn \tagform@ #1 + { + \maketag@@@ + { + \color{ctex@emph} + \eb@tag@brackets@left + \ignorespaces #1\unskip\@@italiccorr + \eb@tag@brackets@right + } + } \eb_ctex_define:nn { thmset } { thmbox .bool_set:N = \l__eb_thmbox_bool, thmbox .default:n = true, - thmbox .initial:n = false + thmbox .initial:n = false, + brackets .code:n = \eb_assign_tag_brackets:n {#1}, + brackets .initial:n = { (,) } } \ctex_set:nn { thmset } { @@ -2731,8 +2751,6 @@ \skip_set:Nn \abovedisplayshortskip { 0pt } \skip_set:Nn \belowdisplayshortskip { 5pt plus 1pt minus 1pt } } -\cs_gset:Npn \tagform@ #1 - { \maketag@@@{\color{ctex@emph}(\ignorespaces #1\unskip\@@italiccorr)} } \ctex_at_end_package:nn { unicode-math } { \msg_redirect_module:nnn { unicode-math } { warning } { info } } @@ -2744,7 +2762,7 @@ number .initial:n = { 1. }, title .tl_set:N = \eb@tc@exercise@title, title .initial:n = \c__eb_name_exercise_tl, - numsep .dim_set:N = \eb@tc@exercise@numsep, + numsep .dim_set:N = \eb@toc@exercise@numsep, numsep .initial:n = 0.5\ccwd } \ctex_at_end_package:nn { tcolorbox } @@ -2787,6 +2805,11 @@ \newtcbox[auto~counter]{\eb@tc@exercise@box}[1]{tc-exercise,#1} \tl_new:N \eb@tc@list@prologue \cs_new:Npn \exerprologue #1 { \tl_gset:Nn \eb@tc@list@prologue {#1} } + \cs_new:Npn \eb_tcb_toc_counter_numsep:n #1 + { + \thetcbcounter + \hspace{\use:c { eb@toc@#1@numsep }} + } \NewDocumentEnvironment{outline}{O{}D(){\abstractname}o+b} { \begin{tcolorbox}[tc-outline,title = #2,IfValueT = {#3}{#3}] @@ -2809,19 +2832,21 @@ { \markright { - \thetcbcounter - \hspace{\eb@tc@exercise@numsep} + \eb_tcb_toc_counter_numsep:n { exercise } \eb@tc@exercise@title } \addcontentsline{toc}{section} { - \thetcbcounter - \hspace{\eb@toc@section@numsep} + \eb_tcb_toc_counter_numsep:n { section } \eb@tc@exercise@title } } }{ - \IfBooleanF{#1}{\thetcbcounter\hspace{\eb@tc@exercise@numsep}} + \IfBooleanF{#1} + { + \eb_tcb_toc_counter_numsep:n { exercise } + \eb_current_label:n { tcbcounter } + } \eb@tc@exercise@title } }{ |