summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/easybook/chapter3.tex2
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook-demo.pdfbin287458 -> 287472 bytes
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook-demo.tex2
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook.pdfbin235059 -> 237329 bytes
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook.tex86
5 files changed, 52 insertions, 38 deletions
diff --git a/Master/texmf-dist/doc/latex/easybook/chapter3.tex b/Master/texmf-dist/doc/latex/easybook/chapter3.tex
index 3790a3c47f8..a9e19e03f43 100644
--- a/Master/texmf-dist/doc/latex/easybook/chapter3.tex
+++ b/Master/texmf-dist/doc/latex/easybook/chapter3.tex
@@ -51,4 +51,4 @@ if __name__ == '__main__':
\section{行内盒子}
\index{h@行内盒子}
-阿司匹林及其复方制剂都能有效治疗某几种头痛,但对另外几 \concise[Aqua][fontupper = \rmfamily]{concise} 种则效果不明。因其他疾病或创伤导致的 \fuzzy[DarkSeaGreen][fontupper = \ttfamily,colupper = black]{fuzzy} 继发性头痛需要及时在医疗机构接受治疗。 \ No newline at end of file
+阿司匹林及其复方制剂都能有效治疗某几种头痛,但对另外几 \concise[Aqua]{concise}[fontupper = \rmfamily] 种则效果不明。因其他疾病或创伤导致的 \fuzzy[DarkSeaGreen]{fuzzy}[fontupper = \ttfamily,colupper = black] 继发性头痛需要及时在医疗机构接受治疗。 \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf b/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf
index 677660d9b8f..2cccc3ed380 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf
+++ b/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook-demo.tex b/Master/texmf-dist/doc/latex/easybook/easybook-demo.tex
index bed92304aae..621c21ece2d 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook-demo.tex
+++ b/Master/texmf-dist/doc/latex/easybook/easybook-demo.tex
@@ -97,7 +97,7 @@
\url{https://latexstudio.net} \\
\url{https://gitee.com/texl3/easybook}\thanks{Gitee为项目的主要发布地址。}
}
-\date{2021/03/12\hskip\ccwd\relax v1.23o}
+\date{2021/03/13\hskip\ccwd\relax v1.23p}
\frontmatter[roman]
\maketitle
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook.pdf b/Master/texmf-dist/doc/latex/easybook/easybook.pdf
index 9dd3ad1ad2d..32776a80beb 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook.pdf
+++ b/Master/texmf-dist/doc/latex/easybook/easybook.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook.tex b/Master/texmf-dist/doc/latex/easybook/easybook.tex
index 00de40fdd5e..0b20284e284 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook.tex
+++ b/Master/texmf-dist/doc/latex/easybook/easybook.tex
@@ -2,7 +2,7 @@
\title{\sffamily easybook书籍文档类}
\author{瞿毅}
-\date{2021/03/12\hskip\ccwd\relax v1.23o\thanks{\url{https://gitee.com/texl3/easybook}}}
+\date{2021/03/13\hskip\ccwd\relax v1.23p\thanks{\url{https://gitee.com/texl3/easybook}}}
\begin{document}
\maketitle
@@ -80,8 +80,8 @@
\begin{syntax}
font = <adobe|founder|mac|windows|linux|(overleaf)|noto|none>
\end{syntax}
-\changes{v1.21}{2021/01/12}{默认字体与\CTeX 一致,不再是自定义字体。}
传递给 \cls{ctexbook} 设置字体,最好不要使用原有的 \opt{fontset} 选项,默认情况下使用自定义字体而不开启这个选项,可根据安装的字体及电脑系统选取。\opt{noto} 与 \opt{none} 选项的相关描述见小节 \ref{font settings},\opt{overleaf} 是一个各系统通用选项,会检测系统环境选取对应字体。
+\changes{v1.21}{2021/01/12}{默认字体与\CTeX 一致,不再是自定义字体。}
\end{function}
\begin{function}[rEXP,added = 2021-01-05,updated = 2021-01-13]{paper}
@@ -97,8 +97,8 @@
\tn{frontmatter}\oarg{编号格式|(Roman)}
\tn{printindex}\oarg{索引名}
\end{syntax}
-\changes{v1.23o}{2021/02/20}{重新定义文档结构划分命令。}
\tn{frontmatter} 为前言区命令,章标题不编号,页码可设置为例如 \opt{roman}、\opt{Alph} 等格式,带有星号的命令 \tn{frontmatter*} 不使用 \tn{cleardoublepage}。\tn{mainmatter} 为主文区命令,章标题正常编号且页码为从1开始计数的阿拉伯数字,\tn{mainmatter*} 命令不使用 \tn{cleardoublepage}。\tn{backmatter} 为后记区命令,页码格式与编号保持不变,章标题不编号。\tn{listoffigures} 命令输出图片目录,\tn{listoftables} 命令输出表格目录,\tn{listoflistings} 命令输出代码目录。
+\changes{v1.23p}{2021/02/20}{重新定义文档结构划分命令。}
\end{function}
\section{接口选项}
@@ -113,8 +113,8 @@
\begin{syntax}
config = <配置文件名>
\end{syntax}
-\changes{v1.10}{2021/01/08}{加入载入用户配置选项。}
\opt{config}为载入用户配置选项,配置文件名不需加括号但需带有后缀名如 \opt{tex}、\opt{def} 和 \opt{cfg}。
+\changes{v1.10}{2021/01/08}{加入载入用户配置选项。}
\end{function}
\subsection{风格}
@@ -130,10 +130,10 @@
rulewidth = <(0.75pt)>
uppercase = <(true)|false>
\end{syntax}
-\changes{v1.10}{2021/01/08}{更改颜色实现方式与选项名。}
-\changes{v1.23o}{2021/02/02}{noto风格的数学字体独立出来,可自定义设置。}
-\changes{v1.23o}{2021/02/09}{增加控制页面横线粗细的选项。}
\opt{style} 选项控制文章的风格。
+\changes{v1.10}{2021/01/08}{更改颜色实现方式与选项名。}
+\changes{v1.23p}{2021/02/02}{noto风格的数学字体独立出来,可自定义设置。}
+\changes{v1.23p}{2021/02/09}{增加控制页面横线粗细的选项。}
\end{function}
\begin{optdesc}
@@ -142,8 +142,8 @@
\begin{syntax}
\tn{definecolor}\oarg{类型}\marg{名称}\marg{模式列表}\marg{参数列表}
\end{syntax}
- \changes{v1.10}{2021/01/08}{可以自定义主题颜色。}
主题颜色用到这三个颜色,可以使用 \tn{definecolor} 命令进行更改,类似地更改超链接颜色见小节 \ref{hyperlinks}。
+ \changes{v1.10}{2021/01/08}{可以自定义主题颜色。}
\end{function}
\item[capdash] 将图表代码标题风格由例如\textbf{图1.1}变为\textbf{图1\textendash 1}的形式。
\item[multoc] 开启双栏目录,可与 \opt{onecolumn} 和 \opt{twocolumn} 选项配合出单栏正文、单栏目录,双栏正文、单栏目录,单栏正文、双栏目录和双栏正文、双栏目录四种方式 。
@@ -173,8 +173,8 @@
\begin{syntax}
\tn{definecolor}\oarg{类型}\marg{名称}\marg{模式列表}\marg{参数列表}
\end{syntax}
- \changes{v1.10}{2021/01/08}{可以自定义超链接颜色。}
超链接颜色用到这三个颜色,可以使用 \tn{definecolor} 命令进行更改。
+ \changes{v1.10}{2021/01/08}{可以自定义超链接颜色。}
\end{function}
\item[linktopage] 将目录中的超链接置于页码上,默认是置于标题上。
\end{optdesc}
@@ -188,9 +188,9 @@
caption = <(1)>
footnote = <(1)>
\end{syntax}
-\changes{v1.21}{2021/01/12}{增加脚注线间的距离选项。}
-\changes{v1.23o}{2021/02/09}{取消使用 \pkg{zhlineskip} 宏包设置数学间距。}
行距因子用于设置各种行距倍数,只能是浮点数,不能带有长度单位。\tn{ctexset} 原有的行距选项\opt{linespread}失效。各行距既可在导言区全局设置也可正文中设置对后面生效,行距的意义为
+\changes{v1.21}{2021/01/12}{增加脚注线间的距离选项。}
+\changes{v1.23p}{2021/02/09}{取消使用 \pkg{zhlineskip} 宏包设置数学间距。}
\end{function}
\begin{optdesc}
@@ -211,7 +211,7 @@
marginpart = <\tn{rmfamily}\tn{footnotesize}>
\end{syntax}
\changes{v1.10}{2021/01/08}{加入自定义非正文字体选项。}
-\changes{v1.23o}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
+\changes{v1.23p}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
\end{function}
\begin{optdesc}
@@ -232,7 +232,7 @@
\tn{printbibliography}\oarg{选项列表}
\end{syntax}
\changes{v1.21}{2021/01/11}{增加 \opt{bibset} 选项,可以使用 \hologo{BibTeX} 或 \hologo{biber} 编译参考文献。}
-\changes{v1.23o}{2021/02/23}{使用 \opt{bibset} 选项时可设置标注风格。}
+\changes{v1.23p}{2021/02/23}{使用 \opt{bibset} 选项时可设置标注风格。}
\end{function}
\begin{optdesc}
@@ -244,7 +244,7 @@
\end{optdesc}
\subsection{定理样式}
-\begin{function}[EXP,added = 2021-01-12,updated = 2021-03-12]{thmset/thmbox,thmset/numberwith,thmset/headpunct,thmset/bodyfont,thmset/notefont,thmset/headfont,thmset/headindent,thmset/spaceabove,thmset/spacebelow,thmset/spacepost,\newtheorem}
+\begin{function}[EXP,added = 2021-01-12,updated = 2021-03-13]{thmset/thmbox,thmset/numberwith,thmset/headpunct,thmset/bodyfont,thmset/notefont,thmset/headfont,thmset/headindent,thmset/spaceabove,thmset/spacebelow,thmset/spacepost,\newtheorem, \declaretheoremstyle}
\begin{syntax}
thmbox = <true|(false)>
numberwith = <(chapter)|section|其它环境|空置>
@@ -257,14 +257,15 @@
spacebelow = <(0.75ex plus .1ex)>
spacepost = <(\tn{ccwd})>
\tn{newtheorem}\oarg{键值列表}\marg{定理环境名}
+ \tn{declaretheoremstyle}\oarg{键值列表}\marg{定理样式名}
\end{syntax}
\changes{v1.21}{2021/01/12}{增加配置定理环境样式的选项。}
-\changes{v1.23o}{2021/03/12}{增加定义新定理环境的命令 \tn{newtheorem}。}
+\changes{v1.23p}{2021/03/12}{重新定义了新定理环境命令 \tn{newtheorem}。}
\end{function}
\begin{optdesc}
\item[thmbox] 开启定理及习题环境的盒子边框。
- \item[numberwith] 定理编号格式,默认跟随章的编号,也可以与其它定理环境共享编号,空置时不跟随其它计数器编号。
+ \item[numberwith] 定理编号跟随的计数器,默认跟随章的编号,也可以跟随其它定理环境的编号,当计数器增加时定理编号会从零开始,空置时不跟随其它计数器。
\item[headpunct] 定理标题后的标记。
\item[bodyfont] 定理内容部分的字体。
\item[notefont] 定理标题内容的字体。
@@ -273,11 +274,18 @@
\item[spaceabove] 定理环境前的间距。
\item[spacebelow] 定理环境后的间距。
\item[spacepost] 定理标题后与内容的间距。
- \item[\tn{newtheorem}] 定义新的定理类环境,可选参数与 \pkg{thmtools} 宏包定理命令的参数一致。
+ \item[\tn{newtheorem}] 定义新的定理类环境,可选参数与 \pkg{thmtools} 宏包定理命令 \tn{declaretheorem} 的参数一致。常用的选项如下
+ \begin{description}
+ \item[name] 定理的标题。默认值是环境的名称,并且首字母大写(英文标题)。
+ \item[numbered] 值为 \opt{no}、\opt{yes} 或 \opt{unless unique}。定理将被编号,而不是编号,或者只有在文档中多次出现时才被编号。
+ \item[numberlike] 定理将使用此计数器进行编号,通常这是另一个定理环境的名称。
+ \item[style] 用 \tn{declaretheoremstyle} 定义的定理样式的名称,定理将使用这种样式的设置。
+ \end{description}
+ \item[\tn{declaretheoremstyle}] 定义新的定理样式,可选参数中除了包括上述定理样式选项,还包括 \tn{newtheorem} 的选项。
\end{optdesc}
\subsubsection{新的定理样式}
-定理由 \pkg{thmtools} 设置,自带定理的样式为 \opt{mythm},如果使用这个样式而只是增加新的定理名称,可以这样
+定理由 \pkg{thmtools} 设置,自带定理的样式为 \opt{mythm},上述定理样式选项将对这个定理样式生效。如果使用这个样式而只是增加新的定理名称,可以这样
\begin{ctexexam}
\newtheorem[style = mythm,name = 定理名]{定理环境名}
\end{ctexexam}
@@ -285,6 +293,10 @@
\begin{ctexexam}
\tcolorboxenvironment{定理环境名}{thmsty}
\end{ctexexam}
+定义一个新的定理样式可用于 \tn{newtheorem} 的 \opt{style} 选项。
+\begin{ctexexam}
+ \declaretheoremstyle[bodyfont = \rmfamily,spacepost = 0.5\ccwd]{定理样式名}
+\end{ctexexam}
\subsection{页面边距}
\begin{function}[EXP,added = 2021-01-13]{geoset/left,geoset/top,geoset/hmargin,geoset/textwidth,geoset/includehead,...}
@@ -295,7 +307,6 @@
textwidth = <长度>
includehead = <true|(false)>
\end{syntax}
-\changes{v1.21}{2021/01/13}{增加配置页面边距的选项。}
\opt{geoset} 将选项交给 \pkg{geometry} 宏包接口命令 \tn{geometry} 处理,并且选项的键值列表与之相同,支持的参数可查阅宏包帮助文档。当在此设置页面大小时,会覆盖 \opt{paper} 选项的设置。
\begin{ctexexam}
\ctexset
@@ -309,6 +320,7 @@
}
}
\end{ctexexam}
+\changes{v1.21}{2021/01/13}{增加配置页面边距的选项。}
\end{function}
\subsection{页眉页脚}
@@ -320,9 +332,6 @@
\tn{easyhead}\oarg{位置}\marg{内容}
\tn{easyfoot}\oarg{位置}\marg{内容}
\end{syntax}
-\changes{v1.21}{2021/01/11}{修复单面文档时页眉横线消失的问题。}
-\changes{v1.21}{2021/01/13}{增加配置页眉页脚的选项。}
-\changes{v1.23o}{2021/03/08}{优化页眉页脚设置,增加 \opt{chap-mark} 和 \opt{sec-mark} 选项。}
\opt{hdrset} 设置的命令由 \pkg{fancyhdr} 宏包提供支持,命令 \tn{easyhead} 和 \tn{easyfoot} 的含义与 \tn{fancyhead} 和 \tn{fancyfoot} 相同,它们用于 \opt{head-foot} 选项中,设置的是一个名为 \opt{fancy} 的页面风格。\pkg{fancyhdr} 将页眉页脚分成了左中右和奇数页(odd)、偶数页(even)共12个部分,可选参数中E、O代表偶数、奇数,L、C、R代表左、中、右部分。单面打印时,含有偶数的选项无效。
\begin{ctexexam}
\ctexset
@@ -338,6 +347,9 @@
}
}
\end{ctexexam}
+\changes{v1.21}{2021/01/11}{修复单面文档时页眉横线消失的问题。}
+\changes{v1.21}{2021/01/13}{增加配置页眉页脚的选项。}
+\changes{v1.23p}{2021/03/08}{优化页眉页脚设置,增加 \opt{chap-mark} 和 \opt{sec-mark} 选项。}
\end{function}
\subsection{目录样式}
@@ -351,7 +363,6 @@
belowoffset = <(-1pc)>
\tn{tocrule} = \oarg{引导点间距|(0.7pc)}\oarg{引导点大小|(1.2)}\marg{引导点}\oarg{页码格式}
\end{syntax}
-\changes{v1.21}{2021/01/13}{增加配置目录样式的选项。}
\opt{tocset} 将目录样式交给 \pkg{titletoc} 处理,预置了 \opt{part}、\opt{chapter}、\opt{section}、\opt{subsection} 和 \opt{lists} 五种级别的目录标题,键值列表中的...代表它们。\opt{lists} 为图片、表格和代码目录格式的级别。
\opt{lolskip} 是代码目录中章之间的代码标题的距离,使用刚性间距,与\CTeX 的 \opt{lotskip} 和 \opt{lofskip} 类似,它们的值均默认0.8pc。\opt{belowoffset} 选项为目录总标题 \tn{contentsname} 后的间距补偿,一般为负值,用于抵消 \opt{format} 中设置的间距。\opt{lists} 中的 \opt{belowoffset} 意义类似,但是一般为正值,在 \opt{lolskip = 0pc} 时使用。建议 \opt{lolskip+lists/format/addvspace = -belowoffset}。
@@ -371,6 +382,7 @@
}
}
\end{ctexexam}
+\changes{v1.21}{2021/01/13}{增加配置目录样式的选项。}
\end{function}
\section{常用环境}
@@ -433,17 +445,17 @@
<定理内容>
\tn{end}\marg{环境名}
\end{syntax}
-定理环境除了注和证明跟随章编号并可带有边框,边框和习题标题盒子可使用 \opt{thmbox = false} 开启,证明末尾会自动添加证明结束符。
+这些是默认自带的定理环境,定理环境除了注和证明跟随章编号并可带有边框,边框和习题标题盒子可使用 \opt{thmbox = false} 开启,证明末尾会自动添加证明结束符。
\end{function}
\subsection{习题}
-\begin{function}[added = 2021-01-05,updated = 2021-02-13]{exercise}
+\label{exercise}
+\begin{function}[added = 2021-01-05,updated = 2021-03-13]{exercise}
\begin{syntax}
- \tn{begin}\marg{exercise}\oarg{颜色名|(LightYellow)}\oarg{编号|(1.)}\oarg{标题|(习题)}
+ \tn{begin}\marg{exercise}\oarg{颜色名|(LightYellow)}\oarg{编号|(1.)}\oarg{标题|(习题)}\oarg{配置选项}
\tn{item} <习题内容>
\tn{end}\marg{exercise}
\end{syntax}
-\changes{v1.23o}{2021/02/08}{增加准确的习题盒子标题目录锚点。}
习题环境 \opt{exercise} 的标题紧接上一节编号并加入目录与页眉,当使用星号环境时不进行编号。三个可选参数中颜色为自定义或 \pkg{xcolor} 包含的颜色名称,正文编号格式与小节 \ref{sort list} 排序列表相同,标题名默认为摘要,参数只能\textbf{从右往左}省略。
\begin{ctexexam}
\begin{exercise}[LightYellow][1.][习题]
@@ -451,14 +463,16 @@
\item 习题内容
\end{exercise}
\end{ctexexam}
+\changes{v1.23p}{2021/02/08}{增加准确的习题盒子标题目录锚点。}
\end{function}
\subsection{盒子}
+盒子以及小节 \ref{exercise} 中 \opt{exercise} 环境配置的选项由 \pkg{tcolorbox} 提供支持,具体选项可见宏包文档的 Option Keys 一节,一些配置会覆盖之前的默认设置。
\subsubsection{摘要盒子}
-\begin{function}[added = 2021-01-05]{outline}
+\begin{function}[added = 2021-01-05,updated = 2021-03-13]{outline}
\begin{syntax}
- \tn{begin}\marg{outline}\oarg{标题名称}
+ \tn{begin}\marg{outline}\oarg{标题名称}\oarg{配置选项}
\tn{item} <摘要内容>
\tn{end}\marg{outline}
\end{syntax}
@@ -472,9 +486,9 @@
\end{function}
\subsubsection{段落盒子}
-\begin{function}[added = 2021-01-05,updated = 2021-02-13]{mybox}
+\begin{function}[added = 2021-01-05,updated = 2021-03-13]{mybox}
\begin{syntax}
- \tn{begin}\marg{mybox}\oarg{段落标题}\oarg{颜色名|(MintCream)}
+ \tn{begin}\marg{mybox}\oarg{段落标题}\oarg{颜色名|(MintCream)}\oarg{配置选项}
<盒子内容>
\tn{end}\marg{mybox}
\end{syntax}
@@ -489,12 +503,12 @@
\end{function}
\subsubsection{行内盒子}
-\begin{function}[added = 2021-01-05]{\concise,\fuzzy}
+\begin{function}[added = 2021-03-13]{\concise,\fuzzy}
\begin{syntax}
- \tn{concise}\oarg{颜色名}\oarg{配置}\marg{内容}
- \tn{fuzzy}\oarg{颜色名}\oarg{配置}\marg{内容}
+ \tn{concise}\oarg{颜色名}\marg{内容}\oarg{配置选项}
+ \tn{fuzzy}\oarg{颜色名}\marg{内容}\oarg{配置选项}
\end{syntax}
-设置了两个参数选项相同的行内盒子,盒子 \opt{concise} 可以为抄录盒子有三个参数,行内盒子内容是必选参数其他可选。盒子 \opt{fuzzy} 不是抄录盒子,具有模糊边缘类似高亮的效果。配置的选项由 \pkg{tcolorbox} 提供支持。
+设置了两个参数选项相同的行内盒子,盒子 \opt{concise} 为抄录盒子有三个参数,行内盒子内容是必选参数其他可选。盒子 \opt{fuzzy} 也是抄录盒子,具有模糊边缘类似高亮的效果。
\end{function}
\section{其它格式}
@@ -553,7 +567,7 @@
使用 \pkg{imakeidx} 生成索引,\tn{printindex} 命令用于生成索引目录。仅做了简单的设置如将索引设为双栏并加入目录,其他选项可另外配置。
\end{function}
-\subsubsection{脚注}
+\subsubsection{自定义脚注}
\begin{function}[added = 2021-01-05]{\Footnote,\Footnotetext,\Footnotemark}
\begin{syntax}
\tn{Footnote}\marg{标记}\marg{插入文本}