From d6ac6a6734f56dafac6d47e4a2d409d287fb668c Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 16 Aug 2021 03:00:42 +0000 Subject: CTAN sync 202108160300 --- macros/latex/contrib/easybook/easybook.dtx | 12 +-- macros/latex/contrib/easybook/easybook.pdf | Bin 583341 -> 586691 bytes macros/latex/contrib/easybook/easybook.tex | 140 ++++++++++++++--------------- 3 files changed, 74 insertions(+), 78 deletions(-) (limited to 'macros/latex/contrib/easybook') diff --git a/macros/latex/contrib/easybook/easybook.dtx b/macros/latex/contrib/easybook/easybook.dtx index 970c1d7f52..3672b124b9 100644 --- a/macros/latex/contrib/easybook/easybook.dtx +++ b/macros/latex/contrib/easybook/easybook.dtx @@ -15,7 +15,7 @@ %<*class> \NeedsTeXFormat{LaTeX2e}[2020/10/01] \RequirePackage{l3keys2e} -\ProvidesExplClass{easybook}{2021/08/13}{1.28o} +\ProvidesExplClass{easybook}{2021/08/15}{1.28p} {Typeset Chinese theses or books} \bool_set_false:N \l__eb_compile_draft_bool @@ -299,7 +299,7 @@ %<*package> \NeedsTeXFormat{LaTeX2e}[2020/10/01] \RequirePackage{l3keys2e,etoolbox} -\ProvidesExplPackage{easybase}{2021/08/13}{1.28o} +\ProvidesExplPackage{easybase}{2021/08/15}{1.28p} {Typeset Chinese theses or books} \cs_generate_variant:Nn \dim_add:Nn { NV,Nv } @@ -2403,7 +2403,7 @@ } % %<*tcolorbox> -\ProvidesExplFile{eb-tcolorbox.cfg}{2021/08/13}{1.28o} +\ProvidesExplFile{eb-tcolorbox.cfg}{2021/08/15}{1.28p} {Customization of tcolorbox for easybook} \tl_gset:Nn \eb@tc@line@skip { 0.5\baselineskip } @@ -2522,9 +2522,9 @@ \NewDocumentEnvironment{outline}{O{}D(){\abstractname}o+b} { \begin{eb@tc@outline@box}{#2}{IfValueT = {#3}{#3}} - \begin{eb@outline@list}[#1] - #4 - \end{eb@outline@list} + \begin{eb@outline@list}[#1] + #4 + \end{eb@outline@list} \end{eb@tc@outline@box} }{} \NewDocumentEnvironment{exercise}{st+od()O{}+b} diff --git a/macros/latex/contrib/easybook/easybook.pdf b/macros/latex/contrib/easybook/easybook.pdf index aa74f48edc..f18fa673d2 100644 Binary files a/macros/latex/contrib/easybook/easybook.pdf and b/macros/latex/contrib/easybook/easybook.pdf differ diff --git a/macros/latex/contrib/easybook/easybook.tex b/macros/latex/contrib/easybook/easybook.tex index 7ac6054a8a..7d57ff11e8 100644 --- a/macros/latex/contrib/easybook/easybook.tex +++ b/macros/latex/contrib/easybook/easybook.tex @@ -9,25 +9,22 @@ \colorlet{cnltxred}{violet} \setcnltx { - name = easybook, - title = EASYBOOK 使用手册, - version = v1.28o, - date = 2021/08/13, - authors = 瞿毅, - info = 排版简体中文学位论文和书籍, - email = quee123@foxmail.com, - url = https://gitee.com/texl3/easybook, - abstract = + name = easybook, + color-scheme = blue, + title = EASYBOOK 使用手册, + version = v1.28p, + date = 2021/08/15, + authors = 瞿毅, + info = 排版简体中文学位论文和书籍, + email = quee123@foxmail.com, + url = https://gitee.com/texl3/easybook, + abstract = { \cls*{easybook} 是基于 \cls*{ctexbook} 书籍文档类创建以极简为风格的模板,同时兼具 \cls*{book} 与 \cls*{article} 文档类的用途,它的基础宏包 \pkg*{easybase} 还可以搭配 C\TeX 和标准文档类使用。\cls*{easybook} 考虑了一些细节并载入一些几乎必备的宏包进行包装和改进,提供多个命令和接口可以使用户简便地进行设置。它适用于排版中英文学位论文、学术书籍或者是笔记。 }, - code-only, - arg-format = \normalfont\small\itshape, - abstract-format = \small, - color-scheme = blue, - title-format = \huge\sffamily, - add-frame-options = {innerleftmargin = 2em}, - listings-options = {numbers = none} + arg-format = \normalfont\small\itshape, + abstract-format = \small, + title-format = \huge\sffamily } \KOMAoptions{headsepline = 0.6pt,numbers = {noenddot}} \setfootnoterule[0.6pt]{0.4\columnwidth} @@ -46,7 +43,7 @@ \ExplSyntaxOn\makeatletter \NewDocumentCommand{\passto}{smm} {\IfBooleanF{#1}{\color{cnltxblue}}#3\ifblank{#2}{}{\ttfamily[#2]}} -\newcommand{\splitmeta}[2][\texttt{,}] +\newcommand{\splitmeta}[2][\code{,}] { \clist_clear:N \l_tmpa_clist \clist_map_inline:nn {#2} @@ -69,7 +66,7 @@ \newsplitarg{\splitoarg}{[}{]} \newsplitarg{\splitdarg}{(}{)} \newsplitarg{\splitmarg}{\{}{\}} -\newcommand{\spemmeta}{\splitmeta[\texttt{!}]} +\newcommand{\spemmeta}{\splitmeta[\code{!}]} \newsplitarg[\spemmeta]{\spemcoarg}{[}{]} \renewcommand{\cnltx@package@abstract@width}{0.85\linewidth} \newcommand{\noitemsep}{\setlength{\itemsep}{0ex}} @@ -244,7 +241,7 @@ \command{cleardoublepage}[\oarg{页面风格}]\Default{empty} 清双页命令可以确保下一页文本总在奇数页开始,在奇数页使用它会产生空白偶数页。文区命令 \cs{frontmatter} 和 \cs{mainmatter} 会用到清双页命令,在启用文类选项 \option*{openright} 时标题命令 \cs*{part} 和 \cs*{chapter} 也会用到清双页命令。 \command{blankpagestyle}[\marg{页面风格}] - 多出空白页的默认页面风格用空白页面风格命令 \cs{blankpagestyle} 全局指定,或使用可选参数局部指定。默认的风格为 \code{empty},即空的页眉页脚。 + 多出空白页的 \meta{页面风格} 用空白页面风格命令 \cs{blankpagestyle} 全局指定,或使用清双页命令的可选参数局部指定。空白页默认的风格为 \code{empty},即空的页眉页脚。 \end{commands} \subsection{目录命令} @@ -289,7 +286,7 @@ \code{subsection} 小节级别的双语目录标题命令,具有独立的 \code{bisubsection} 计数器。 \end{commands} -它们的星号变体命令使文中标题不编号,但是仍然加入双语目录,若英文标题参数空置那么仅加入中文目录而不加入英文目录,这一特点与 \cs*{chapter}\sarg{} 等命令的行为不太一样,在一些情况下会用到。可选参数是目录中的中文标题,默认与中文标题一致,正文标题过长时可用它设置在目录中显示的标题。默认情况下双语目录的格式是一致的,共享使用 \module*{tocset} 的设置,英文目录的章级别标题名及编号的修改方式如下: +它们的星号变体命令使文中标题不编号,但是仍然加入双语目录,若英文标题参数空置那么仅加入中文目录而不加入英文目录,这一特点与 \cs*{chapter}\sarg{} 等命令的行为不太一样,在一些情况下会用到。可选参数是目录中的中文标题,默认与中文标题一致,正文标题过长时可用它设置在目录中显示的标题。默认情况下双语目录的格式是一致的,共享使用 \module*{tocset} 模块的设置,英文目录的章级别标题名及编号的修改方式如下: \begin{options} \kvsplit{biname}{英文目录前名字,英文目录后名字}\Module{chapter}\Default{Chapter\cs*{space}} 更改英文目录 \code{chapter} 级别的标题编号前后名字,类似 C\TeX 的 \option*{name} 选项。 @@ -370,7 +367,7 @@ 统一调整页眉、定理盒子以及代码框等线条的粗细。 \keybool{uppercase}\Default{true} 使用 \cs*{rightmark} 及 \cs*{leftmark} 标题标记命令获取标题内容时英文是否大写。 - \kvsplit*{figurepath}{\meta{路径名1}\code{\}}\code{\{}\meta{路径名2}}\Default + \kvsplit*{figurepath}{\meta{路径名1}\code{\}\{}\meta{路径名2}}\Default 设置插入图片的文件夹路径名,可以有多个路径名,每个路径包含在括号分隔,只有一个路径时需要包含在两层括号内。 \end{options} @@ -517,27 +514,28 @@ \subsection{定理样式} \label{subsec:theorem of style} +文档类已预置 8 个定理环境,环境名及对应的定理标题见小节 \ref{subsec:theorem},它们均使用预置的定理样式 \code{easy-theorem}。下面 \module*{thmset} 模块的选项仅对这个定理样式生效,由 \pkg*{thmtools} 宏包提供支持。 \begin{options} \keybool{thmbox}\Module{thmset}\Default{false} 开启定理环境盒子的边框,需载入 \pkg*{tcolorbox} 宏包才生效。这个选项与 \pkg*{thmtools} 中并不一致,\pkg*{thmtools} 的同名选项包括 \code{L}、\code{M} 和 \code{S} 三个参数。 \keychoice{within}{chapter,section,其它环境,空置}\Default{chapter} 定理编号跟随的计数器,默认跟随章的编号,也可以跟随其它定理环境的编号,当计数器增加时定理编号会从零开始,空置时不跟随其它计数器编号。 - \keyval-{headpunct}{字体命令}\Default{false} - 定理标题末尾后的标记,在换行符或与第一段内容的间隔之前。 - \keyval-{bodyfont}{字体命令}\Default{chapter} + \keyval-{headpunct}{代码}\Default + 紧随定理标题末尾的标记代码,位于定理第一段内容的间距 \option{postheadspace} 之前,可以是字符或插入换行符 \cs*{newline} 等命令。 + \keyval-{bodyfont}{字体命令}\Default 定理内容部分的字体,包括字体族、字体系列、字体尺寸和字体形状命令。 \keyval-{notefont}{字体命令}\Default 定理题注部分的字体,包括字体族、字体系列、字体尺寸和字体形状命令。 - \keyval-{headfont}{字体命令}\Default + \keyval-{headfont}{字体命令}\Default{\cs*{color}\Marg{ctex@emph}\cs*{sffamily}} 定理标题部分的字体,包括字体族、字体系列、字体尺寸和字体形状命令。 \keyval-{headindent}{刚性长度}\Default{0em} 定理标题的缩进,默认无缩进,可用 \cs*{parindent} 命令设置为段落缩进。 \keyval-{spaceabove}{弹性长度}\Default{0.75ex plus .1ex} - 定理环境前的间距,使用 \pkg*{tcolorbox} 的环境包装后被覆盖。 + 定理环境前的间距,使用 \pkg*{tcolorbox} 的盒子环境包装后被覆盖。 \keyval-{spacebelow}{弹性长度}\Default{0.75ex plus .1ex} - 定理环境后的间距,使用 \pkg*{tcolorbox} 的环境包装后被覆盖。 - \keyval-{spacepost}{刚性长度}\Default{1em} - 定理标题后与第一段内容的间距。 + 定理环境后的间距,使用 \pkg*{tcolorbox} 的盒子环境包装后被覆盖。 + \keyval-{postheadspace}{刚性长度}\Default{1em} + 定理标题后与定理第一段内容的间距。 \keyval-{headformat}{标题格式}\Default{\cs*{NAME}\cs*{space}\cs*{NUMBER}\cs*{NOTE}} 定理开头部分各组成元素的排列和格式,这个选项一般不需要使用,其中 \cs*{NAME}、\cs*{NUMBER} 和 \cs*{NOTE} 分别代表标题、编号和题注。 \kvsplit{brackets}{左括号,右括号}\Default{\Marg{(,)}} @@ -545,56 +543,55 @@ \end{options} \subsubsection{新建定理样式} -文档类已预置 8 个定理环境,环境名及对应的定理标题名见小节 \ref{subsec:theorem},如果需要新的定理标题名或定理样式可使用这三个命令,由 \pkg*{thmtools} 提供支持。 \begin{commands} - \command{declaretheorem}[\oarg{键值列表1}\marg{定理环境名}\oarg{键值列表2}] - 声明新的定理环境命令,\cs{newtheorem} 命令与它等效。可选参数的 \meta{键值列表1} 与 \meta{键值列表2} 等效,用法与它们的同名命令一致。\meta{键值列表} 中常用的选项如下: + \command{declaretheorem}[\oarg{键值列表1}\marg{定理环境}\oarg{键值列表2}] + 声明新的定理环境命令,\cs{newtheorem} 命令与它等效。可选参数的 \meta{键值列表1} 与 \meta{键值列表2} 等效,用法与它们的同名命令一致。键值列表中常用的选项如下: \begin{options} - \keyval*-{name}{定理环境标题}\Default + \keyval*-{name}{定理标题} 定理标题的默认值是环境的名称,并且首字母大写(英文标题)。 - \keychoice*{numbered}{no,yes,unless unique}\Default + \keychoice*{numbered}{no,yes,unless unique}\Default{yes} 定理可以被编号、不被编号或者只有在文档中多次出现时才被编号。 - \keyval*-{numberlike}{定理环境名}\Default - 定理将使用此计数器进行编号,通常这是另一个定理环境的名称。 - \keyval*-{style}{定理样式名}\Default - 选项的值为 \cs{declaretheoremstyle} 新定义的 \meta{定理样式名} 或预置的 \code{easy-theorem} 定理样式,定理将使用这种样式的设置。 + \keyval*-{numberlike}{计数器}\Default + 定理将使用此 \meta{计数器} 进行编号,通常这是另一个定理环境的名称。 + \keyval*-{style}{定理样式}\Default + 选项的值为使用 \cs{declaretheoremstyle} 命令新定义的定理样式。 \end{options} \command{DeclareTheorem}[\marg{环境名}\oarg{英文标题}\marg{中文标题}\darg{盒子风格}\oarg{键值列表}] - 定理声明命令 \cs{DeclareTheorem} 更加便捷,它定义一个新的定理环境,与 \cs{declaretheorem} 命令 \meta{键值列表} 支持相同的选项,但它们的区别有: + 定理声明命令 \cs{DeclareTheorem} 更加便捷,同样定义一个新的定理环境,与 \cs{declaretheorem} 命令的键值列表支持相同的选项,但它们的区别有: \begin{itemize} \item 中英文模式下标题不同,英文标题为可选项,默认为首字母大写的 \meta{环境名}。 \item 自动定义交叉引用的格式,引用标签前缀为定理标题名称。 \item 定理盒子选项 \keyis-{thmbox}{true} 仍然生效,此时 \meta{盒子风格} 为定理盒子风格的名称,它需要由新建盒子风格命令 \cs{newtcbstyle} 定义,默认为 \code{tc-theorem}。 - \item 默认使用 \code{easy-theorem} 定理样式,可在最后一个选项使用 \option*{style} 更改样式。 + \item 新建定理环境默认使用的 \meta{定理样式} 为 \code{easy-theorem},而不是 \pkg*{thmtools} 默认样式。 \end{itemize} - \command{declaretheoremstyle}[\oarg{键值列表1}\marg{定理样式名}\oarg{键值列表2}] - 定义新的定理样式,\meta{键值列表} 中包括上述定理样式以及 \cs{declaretheorem} 的所有选项。可选参数的 \meta{键值列表1} 与 \meta{键值列表2} 等效,用法与它们的同名命令一致。 -\end{commands} + \command{declaretheoremstyle}[\oarg{键值列表1}\marg{定理样式}\oarg{键值列表2}] + 声明新的定理样式命令,键值列表支持上述 \module*{thmset} 模块中以及 \cs{declaretheorem} 的所有选项。可选参数的 \meta{键值列表1} 与 \meta{键值列表2} 等效,用法与它们的同名命令一致。 -下面简单列举定理命令的用法,预置定理的样式为 \code{easy-theorem},上述定理样式选项将仅对这个定理样式生效。如果使用这个样式增加新的定理环境可以这样: -\begin{ctexexam} - \DeclareTheorem{定理环境名}{中文标题}[style = easy-theorem] - \declaretheorem[style = easy-theorem,name = 定理名]{定理环境名} -\end{ctexexam} + 下面简单列举几个定理命令的用法,例如使用预置样式新建一个定理环境猜想: + \begin{ctexexam} + \DeclareTheorem{caixiang}{猜想}[style = easy-theorem] % 不需要指定预置样式 + \declaretheorem[style = easy-theorem,name = 猜想]{caixiang} + \end{ctexexam} -命令 \cs{declaretheorem} 定义的定理环境需要手动增加盒子边框: -\begin{ctexexam} - \tcolorboxenvironment{定理环境名}{tc-theorem} -\end{ctexexam} + 命令 \cs{declaretheorem} 定义的定理环境需要手动增加盒子边框: + \begin{ctexexam} + \tcolorboxenvironment{caixiang}{tc-theorem} + \end{ctexexam} -使用 \cs{addtcbstyle} 命令调整开启定理盒子时默认的样式,第一个参数为 \code{theorem},关于命令的介绍在小节 \ref{subsec:box}。 -\begin{ctexexam} + 使用 \cs{addtcbstyle} 命令调整开启定理盒子时默认的样式,第一个参数为 \code{theorem},关于命令的介绍在小节 \ref{subsec:box}。 + \begin{ctexexam} \addtcbstyle{theorem}{colback = GreenYellow} -\end{ctexexam} + \end{ctexexam} -定义一个新的定理样式可用于 \cs{declaretheorem} 的 \option*{style} 选项: -\begin{ctexexam} - \declaretheoremstyle[bodyfont = \rmfamily,spacepost = 0.5em]{定理样式名} -\end{ctexexam} + 定义一个名为 \code{mythm} 的定理样式用于 \cs{declaretheorem} 的 \option*{style} 选项: + \begin{ctexexam} + \declaretheoremstyle[bodyfont = \rmfamily,spacepost = 0.5em]{mythm} + \end{ctexexam} +\end{commands} \subsection{页面尺寸} \label{subsec:page margins} -预置的页面尺寸与 \cls*{Word} 的默认值接近,\module*{geoset} 会将前两个之外的选项交给 \pkg*{geometry} 宏包接口命令 \cs*{geometry} 处理,并且 \meta{键值列表} 的选项与之相同,下面的选项仅是一小部分,支持的参数可查阅宏包帮助文档。当在此设置页面大小时,会覆盖 \option{paper} 选项的设置。 +预置的页面尺寸与 \cls*{Word} 的默认值接近,模块 \module*{geoset} 会将前两个之外的选项交给 \pkg*{geometry} 宏包接口命令 \cs*{geometry} 处理,并且 \meta{键值列表} 的选项与之相同,下面的选项仅是一小部分,支持的参数可查阅宏包帮助文档。当在此设置页面大小时,会覆盖 \option{paper} 选项的设置。 \begin{options}\noitemsep \keyval-{headruleskip}{页眉线间距}\Module{geoset}\Default* \keyval-{footruleskip}{页脚线间距}\Default* @@ -959,10 +956,10 @@ \label{subsec:box} 使用盒子以及小节 \ref{subsec:exercise} 中的 \env{exercise} 环境需要在导言区\textbf{手动载入} \pkg*{tcolorbox} 宏包,它们 \meta{配置选项} 的键值列表同样由 \pkg*{tcolorbox} 提供支持,具体选项可见宏包文档的 Option Keys 一节,可以进行边距、字体及背景颜色等各种个性化设置,一些配置会覆盖预设。 \begin{commands} - \command{newtcbstyle}[\marg{风格名称}\marg{键值列表}] - 新建或重置一个名为 \code{tc-}\meta{风格名称} 的 \pkg*{tcolorbox} 宏包盒子风格,可以与 \cs{addtcbstyle} 命令联用。 - \command{addtcbstyle}[\marg{风格名称}\marg{键值列表}] - 修改已存在的 \pkg*{tcolorbox} 宏包盒子风格。这个命令可以调整以下即将介绍的预置盒子风格,对于预置盒子来说参数 \meta{风格名称} 即为它们对应的环境或命令名。 + \command{newtcbstyle}[\marg{盒子风格}\marg{键值列表}] + 新建或重置一个名为 \code{tc-}\meta{盒子风格} 的 \pkg*{tcolorbox} 宏包盒子风格,可以与 \cs{addtcbstyle} 命令联用。 + \command{addtcbstyle}[\marg{盒子风格}\marg{键值列表}] + 修改已存在的 \pkg*{tcolorbox} 宏包盒子风格。这个命令可以调整以下即将介绍的预置盒子风格,对于预置盒子来说参数 \meta{盒子风格} 即为它们对应的环境或命令名。 \begin{ctexexam} \newtcbstyle{mytcb} % 新建一个盒子风格tc-mytcb { @@ -1053,8 +1050,7 @@ 在一定的场合下可能用到 \cs{UseCounter} 命令,比如通过新建快捷命令在一些位置使用定理环境的计数器,使用 \cs{labelformat} 设置计数器的引用标签需添加 \code{eb@}: \begin{ctexexam} \labelformat{eb@theorem}{定理 #1} - \newcommand{\theoremhead}[1] - {定理 \UseCounter[chapter]{theorem}{\hspace{1em}#1}} + \newcommand{\theoremhead}[1]{定理 \UseCounter[chapter]{theorem}{\hspace{1em}#1}} \theoremhead{定理标题}\label{thm:theorem} \end{ctexexam} \end{commands} @@ -1177,7 +1173,7 @@ \appendix \section{依赖的宏包} -以下为 \pkg*{easybase} 直接调用的关键宏包,方括号内为宏包已使用的选项。蓝色的宏包表示截至当前在 \TeX Live 2021 中存在更新,旧版本并不影响使用。带有 \ding{81} 符号的宏包并未载入它们,仅做了一些预配置,可在导言区手动载入以实现相关的功能。 +以下为 \pkg*{easybase} 直接调用的关键宏包,方括号内为宏包已使用的选项。蓝色的宏包表示截至当前在 \TeX Live 2021 中存在更新,旧版本并不影响使用。带有 \ding{72} 符号的宏包并未载入它们,仅做了一些预配置,可在导言区手动载入以实现相关的功能。 \begin{description}[font = \normalfont\sffamily] \item[amsmath] 提供 \LaTeX 中的数学功能。 \item[\passto{heading}{ctex}] 提供中文排版的通用框架。 @@ -1201,11 +1197,11 @@ \item[titletoc] 设置目录中的标题格式。 \item[\passto*{normalem}{ulem}] 提供可断行多样式的下划线命令。 \item[\passto*{svgnames}{xcolor}] 提供任意颜色的设定与混合。 - \item[\ding{81} \passto{list = off}{bicaption}] 提供图表的双语题注。 - \item[\ding{81} imakeidx] 可以让文档同时生成和排版一个或多个索引。 - \item[\ding{81} mathtools] 增强 \pkg*{amsmath} 的数学功能。 - \item[\color{cnltxblue}\ding{81} \passto{many}{tcolorbox}] 为带有标题线的彩色和带框文本框提供了一个环境。 - \item[\ding{81} unicode-math] 处理使用 \code{unicode} 编码的数学字体。 + \item[\ding{72} \passto{list = off}{bicaption}] 提供图表的双语题注。 + \item[\ding{72} imakeidx] 可以让文档同时生成和排版一个或多个索引。 + \item[\ding{72} mathtools] 增强 \pkg*{amsmath} 的数学功能。 + \item[\color{cnltxblue}\ding{72} \passto{many}{tcolorbox}] 为带有标题线的彩色和带框文本框提供了一个环境。 + \item[\ding{72} unicode-math] 处理使用 \code{unicode} 编码的数学字体。 \end{description} \nocite{*} -- cgit v1.2.3