diff options
author | Norbert Preining <norbert@preining.info> | 2022-01-09 03:00:53 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-01-09 03:00:53 +0000 |
commit | fbacb8167ccd172bb0b177974778f228ad41691d (patch) | |
tree | 8ad1c76a4dabddbc25abf75b1bc14238e811e9c4 /macros/latex/contrib/easybook/easybook.tex | |
parent | cd2e7ab7ef89a5c3c1935281009729bff0f357e2 (diff) |
CTAN sync 202201090300
Diffstat (limited to 'macros/latex/contrib/easybook/easybook.tex')
-rw-r--r-- | macros/latex/contrib/easybook/easybook.tex | 86 |
1 files changed, 12 insertions, 74 deletions
diff --git a/macros/latex/contrib/easybook/easybook.tex b/macros/latex/contrib/easybook/easybook.tex index c5aacaa0e1..259bbd6bd4 100644 --- a/macros/latex/contrib/easybook/easybook.tex +++ b/macros/latex/contrib/easybook/easybook.tex @@ -4,7 +4,7 @@ \usepackage { enumitem,newtxmath,indentfirst,tabularray, - fancyvrb,geometry,hologo,pifont + fancyvrb,geometry,hologo,pifont,changelog } \definecolorscheme{blue} { @@ -20,8 +20,8 @@ name = easybook, color-scheme = blue, title = EASYBOOK 使用手册, - version = v1.43, - date = 2022/01/06, + version = v1.44, + date = 2022/01/08, authors = 瞿毅, info = 排版简体中文学位论文和书籍, email = q1jx@foxmail.com, @@ -935,6 +935,7 @@ \command*{newlist}[\marg{列表名}\marg{列表类型}\marg{最大级别}] 克隆基本的 \meta{列表类型} 在其基础上新建一个名为 \meta{列表名} 的列表环境。不要将 \meta{最大级别} 设置过大以避免创建过多的计数器和相关宏。 \begin{ctexexam} + \setlist{} % 清除所有列表共享的格式 \setlist[1]{labelindent = \parindent} \setlist[itemize,1]{label = $\triangleleft$} \setlist[enumerate]{labelsep = *,leftmargin = 1.5pc} @@ -1029,56 +1030,9 @@ 代码目录名与代码环境题注名选项 \option*{lstlistlistingname} 和 \option*{lstlistingname} 用法与 C\TeX 使用手册标题汉化一节类似,可以看作对这节的扩展。 \end{options} -\subsection{习题} -\label{subsec:exercise} -\begin{environments} - \environment{exercise}[\sarg\harg\oarg{键值列表1}\darg{键值列表2}\oarg{键值列表3}] - 习题环境的标题使用 \cs*{tcbox} 行内盒子包装样式,内容则使用 \env*{enumerate} 列表环境。它有 5 个可选参数,应当注意用法。当使用星号参数时标题不进行编号,使用 \harg{} 号参数时不显示标题,此时 \meta{键值列表1} 除了 \option{label} 选项失效。 - - \meta{键值列表2} 包括 \pkg*{tcolorbox} 的盒子样式选项,例如 \option*{boxsep} 和 \option*{fontupper} 等,也可以使用下述 \option{tcolorbox} 选项。在这里可以使用 \cs{addtotcbstyle} 命令设置标题选项 \meta{键值列表2} 的值,第一个参数为 \code{tc-exercise}。 - \begin{ctexexam} - \tcphantomifname{\markright{\counteruse{tcbcounter}\quad 习题}}{} - \addtotcbstyle{tc-exercise}{boxsep = 5pt} - \exerprologue{习题前的一段文本} - \begin{exercise}*[color = LightSkyBlue](after skip = 2pc)[itemsep = 1ex] - \item 第一题 - \item 第二题 - \end{exercise} - \end{ctexexam} -\end{environments} - -\begin{commands} - \command{setexercise}[\marg{键值列表1}] - 配置命令 \cs{setexercise} 用于全局设置上述习题环境 \env{exercise} 标题样式可选参数中 \meta{键值列表1} 的默认值,包含的选项如下: - \begin{options} - \keyval-{color}{标题背景颜色名}\Default{DeepSkyBlue} - 习题标题盒子背景颜色,可以使用 \pkg*{xcolor} 自定义颜色或使用色库。 - \keyval-{title}{环境标题} - 习题的标题,可以匹配中英文模式,习题环境使用 \harg{} 号参数时无效。也可以使用 \option{exercisename} 选项设置习题环境标题的默认值。 - \keyval-{number}{习题编号类型}\Default{1.} - 标题编号输出选项 \option{number} 为短编号形式,应当包含 \code{A}、\code{a}、\code{I}、\code{i}、或 \code{1} 其中一个符号。 - \keyval-{numsep}{编号与标题的间距}\Default{0.5em} - 习题标题编号与后方标题文本的间距,习题环境使用星号参数时无效。 - \keyval-{tocnumsep}{目录编号与标题的间距}\Default{1em} - 目录中习题标题编号与后方标题文本的间距,习题环境使用星号参数时无效。 - \keyval-{tcolorbox}{键值列表2} - 局部传递 \pkg*{tcolorbox} 宏包的格式选项给习题标题(如果存在)。 - \keyval-{enumitem}{键值列表3} - 局部传递 \pkg*{enumitem} 宏包的格式选项给习题条目列表。 - \keyval-{label}{标签内容} - 设置习题环境的引用标签,它与标签格式命令 \cs{labelformat} 对应的计数器是 \code{exercise}。 - \end{options} - \command{setexerlist}[\marg{键值列表3}] - 命令 \cs{setexerlist} 用于全局设置习题条目选项 \meta{键值列表3} 的值。\meta{键值列表3} 的选项与 \pkg*{enumitem} 的排序列表相同,也可以使用下述 \option{enumitem} 选项,不过第一个选项无法是短编号形式,这被 \option{number} 选项代替。 - \command{exerprologue}[\sarg\marg{序言内容}] - 序言命令 \cs{exerprologue} 在习题环境开始前插入一段内容,可以是文本或者代码,需要在每一个习题环境前使用。带有星号参数的命令会使序言在习题环境一直有效。 - \command{tcphantomifname}[\marg{编号代码}\marg{不编号代码}] - 命令 \cs{tcphantomifname} 根据使用 \pkg*{tcolorbox} 生成的习题标题是否编号,在超链接锚点的位置加入代码,比如使用 \cs*{addcontentsline} 命令将习题标题加入目录。 -\end{commands} - \subsection{盒子} \label{subsec:box} -使用盒子以及\ref{subsec:exercise} 中的 \env{exercise} 环境需要在导言区\textbf{手动载入} \pkg*{tcolorbox} 宏包,它们 \meta{配置选项} 的键值列表同样由 \pkg*{tcolorbox} 提供支持,具体选项可见宏包文档的 Option Keys 一节,可以进行边距、字体及背景颜色等各种个性化设置,一些配置会覆盖预设。 +文档类预置了两个行间盒子环境和两个行内盒子命令,需要在导言区\textbf{手动载入} \pkg*{tcolorbox} 宏包提供支持。它们 \meta{配置选项} 的键值列表可见宏包文档的 Option Keys 一节,可以进行边距、字体及背景颜色等各种个性化设置。如果 \meta{配置选项} 较长且希望在原有基础上改为全局固定的样式,可以使用 \cs{addtotcbstyle} 命令设置,第一个参数为 \code{tc-}\meta{环境或命令名}。 \begin{commands} \command{deftcbstyle}[\marg{盒子风格}\marg{键值列表}] 新建或重置一个名称为 \meta{盒子风格} 的 \pkg*{tcolorbox} 宏包盒子风格,可以与 \cs{addtotcbstyle} 命令联用。 @@ -1102,29 +1056,12 @@ \end{ctexexam} \end{commands} -\subsubsection{摘要盒子} -\begin{environments} - \environment{outline}[\oarg{键值列表1}\darg{标题名称}\oarg{键值列表2}] - 摘要盒子 \env{outline} 可用于章前摘要,它的标题是可选参数,默认标题是摘要。\meta{键值列表2} 是摘要盒子样式选项,可以使用 \cs{addtotcbstyle} 命令对它进行全局设置,第一个参数为 \code{tc-outline}。 -\end{environments} - -\begin{commands} - \command{setoutlinelist}[\marg{键值列表1}] - \meta{键值列表1} 与 \pkg*{enumitem} 宏包中列表配置选项相同,可以设置摘要条目的各种距离,要对它进行全局设置可以使用 \cs{setoutlinelist} 命令。 - \begin{ctexexam} - \addtotcbstyle{tc-outline}{arc = 6pt} - \begin{outline}[leftmargin = *](摘要标题) - \item 摘要内容1 - \item 摘要内容2 - \end{outline} - \end{ctexexam} -\end{commands} - -\subsubsection{段落盒子} +\subsubsection{行间盒子} \begin{environments} \environment{easybox}[\sarg\oarg{颜色名}\darg{段落标题}\oarg{配置选项}] - 环境 \env{easybox} 创建一个带有三个可选参数的扁平盒子。使用星号参数时给盒子添加边框,\meta{颜色名} 选项设置背景颜色,\meta{段落标题} 选项可以设置标题,默认无标题。如果 \meta{配置选项} 较长且希望在原有基础上改为全局固定的样式,可以使用 \cs{addtotcbstyle} 命令设置,第一个参数为 \code{tc-easybox}。 + 环境 \env{easybox} 创建一个带有三个可选参数的扁平盒子。使用星号参数时给盒子添加边框,\meta{颜色名} 选项设置背景颜色,\meta{段落标题} 选项可以设置标题,默认无标题。 \begin{ctexexam} + \addtotcbstyle{tc-easybox}{arc = 6pt} \begin{easybox}*[DarkCyan](段落标题) 上半盒子内容 \tcblower % 盒子上下部分分界线 @@ -1137,10 +1074,8 @@ \subsubsection{行内盒子} \begin{commands} - \command{eblink}[\oarg{颜色名}\marg{内容}\oarg{配置选项}] - 使用 \pkg*{tcolorbox} 预置了三个参数选项相同的行内盒子,它们均为抄录命令。盒子 \cs{eblink} 具有类似超链接边框的效果。 \command{ebemph}[\oarg{颜色名}\marg{内容}\oarg{配置选项}] - 盒子 \cs{ebemph} 具有模糊边缘类似高亮的效果。 + 行内盒子均为抄录命令。盒子 \cs{ebemph} 具有模糊边缘类似高亮的效果。 \command{ebfbox}[\oarg{颜色名}\marg{内容}\oarg{配置选项}] 盒子 \cs{ebfbox} 则有直角边缘和四周框线,效果类似带颜色的 \cs*{fbox} 盒子。 \end{commands} @@ -1302,6 +1237,9 @@ \end{commands} \appendix +\begin{changelog}[title = 更新日志] + \shortversion{v = 1.44,date = 2022/01/08,changes = 经过前期各模块的功能调整和错误修复,稳定版本正式发布。} +\end{changelog} \nocite{*} \end{document}
\ No newline at end of file |