summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/easybook/easybook.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/easybook/easybook.tex')
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook.tex44
1 files changed, 24 insertions, 20 deletions
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook.tex b/Master/texmf-dist/doc/latex/easybook/easybook.tex
index 15507624965..f01e75319ee 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook.tex
+++ b/Master/texmf-dist/doc/latex/easybook/easybook.tex
@@ -3,7 +3,7 @@
\title{\sffamily easybook书籍文档类}
\author{瞿毅}
-\date{2021/02/21\hskip\ccwd\relax v1.23f\thanks{\url{https://gitee.com/texl3/easybook}}}
+\date{2021/02/23\hskip\ccwd\relax v1.23g\thanks{\url{https://gitee.com/texl3/easybook}}}
\begin{document}
\maketitle
@@ -81,7 +81,7 @@
\begin{syntax}
font = <adobe|founder|mac|windows|linux|(overleaf)|noto|none>
\end{syntax}
-\changes{v1.21b}{2021/01/12}{默认字体与\CTeX 一致,不再是自定义字体。}
+\changes{v1.21}{2021/01/12}{默认字体与\CTeX 一致,不再是自定义字体。}
传递给 \cls{ctexbook} 设置字体,最好不要使用原有的 \opt{fontset} 选项,默认情况下使用自定义字体而不开启这个选项,可根据安装的字体及电脑系统选取。\opt{noto} 与 \opt{none} 选项的相关描述见小节 \ref{font settings},\opt{overleaf} 是一个各系统通用选项,会检测系统环境选取对应字体。
\end{function}
@@ -98,6 +98,7 @@
\tn{frontmatter}\oarg{编号格式|(Roman)}
\tn{printindex}\oarg{索引名}
\end{syntax}
+\changes{v1.23g}{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} 命令输出代码目录。
\end{function}
@@ -130,8 +131,8 @@
rulewidth = <(0.75pt)>
\end{syntax}
\changes{v1.10}{2021/01/08}{更改颜色实现方式与选项名。}
-\changes{v1.23}{2021/02/02}{noto风格的数学字体独立出来,可自定义设置。}
-\changes{v1.23b}{2021/02/09}{增加控制页面横线粗细的选项。}
+\changes{v1.23g}{2021/02/02}{noto风格的数学字体独立出来,可自定义设置。}
+\changes{v1.23g}{2021/02/09}{增加控制页面横线粗细的选项。}
\opt{style} 选项控制文章的风格。
\end{function}
@@ -186,15 +187,15 @@
caption = <(1)>
footnote = <(1)>
\end{syntax}
-\changes{v1.21b}{2021/01/12}{增加脚注线间的距离选项。}
-\changes{v1.23b}{2021/02/09}{取消使用 \pkg{zhlineskip} 宏包设置数学间距。}
+\changes{v1.21}{2021/01/12}{增加脚注线间的距离选项。}
+\changes{v1.23g}{2021/02/09}{取消使用 \pkg{zhlineskip} 宏包设置数学间距。}
行距因子用于设置各种行距倍数,只能是浮点数,不能带有长度单位。\tn{ctexset} 原有的行距选项\opt{linespread}失效。各行距既可在导言区全局设置也可正文中设置对后面生效,行距的意义为
\end{function}
\begin{optdesc}
\item[line] 正文行距。
\item[table] 表格行距。
- \item[math] 数学环境行距。
+ \item[math] 数学环境行距,包括 \pkg{amsmath} 和 \pkg{mathtools} 宏包附带的环境,但并未加载 \pkg{mathtools} 宏包。
\item[caption] 图表代码标题行距。
\item[footnote] 脚注行距。
\end{optdesc}
@@ -209,7 +210,7 @@
marginpart = <\tn{rmfamily}\tn{footnotesize}>
\end{syntax}
\changes{v1.10}{2021/01/08}{加入自定义非正文字体选项。}
-\changes{v1.23a}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
+\changes{v1.23g}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
\end{function}
\begin{optdesc}
@@ -221,21 +222,22 @@
\end{optdesc}
\subsection{参考文献}
-\begin{function}[EXP,added = 2021-01-11]{bibset/backend,bibset/bibstyle,bibset/citestyle,bibset/bibfile,\printbibliography}
+\begin{function}[EXP,added = 2021-01-11,updated = 2021-02-23]{bibset/backend,bibset/bibstyle,bibset/citestyle,bibset/bibfile,\printbibliography}
\begin{syntax}
backend = <(bibtex)|biblatex>
- bibstyle = <(number)|authoryear|其它格式>
+ bibstyle = <(numerical)|authoryear|其它格式>
citestyle = <引用格式>
bibfile = <ref/refs.bib>
\tn{printbibliography}\oarg{选项列表}
\end{syntax}
\changes{v1.21}{2021/01/11}{增加 \opt{bibset} 选项,可以使用 \hologo{BibTeX} 或 \hologo{biber} 编译参考文献。}
+\changes{v1.23g}{2021/02/23}{使用 \opt{bibset} 选项时可设置标注风格。}
\end{function}
\begin{optdesc}
\item[backend] 参考文献处理后端,默认用传统的 \hologo{BibTeX} 处理参考文献。
\item[bibstyle] 参考文献格式为中国的参考文献推荐标准GB/T 7714-2015,有顺序编码制和著者-出版年制两种风格,理工科类一般使用顺序编码制,文科类一般使用著者-出版年制。若使用其它格式,使用 \hologo{BibTeX} 处理时需确保正确的 \opt{bst} 文件,使用 \hologo{biber} 处理可使用 \pkg{biblatex} 宏包支持的参考文献风格名称。
- \item[citestyle] 引用参考文献的格式,对 \opt{backend = bibtex} 选项\textbf{无效},可使用 \pkg{biblatex} 宏包支持的引用文献风格名称。
+ \item[citestyle] 标注参考文献的风格,\opt{backend = bibtex} 选项下可使用 \opt{super}(上标标注,默认)或 \opt{numbers}(普通标注)等 \pkg{natbib} 宏包带有的标注风格,\opt{backend = biblatex} 选项下可使用 \pkg{biblatex} 宏包支持的标注风格名称。
\item[bibfile] 参考文献的数据文件,使用 \hologo{biber} 处理时要带有 \opt{bib} 后缀,默认为一个在 \opt{ref} 文件夹中以 \opt{refs.bib} 命名的文件。
\item[\tn{printbibliography}] 两种方式\textbf{均使用}此命令打印参考文献,其中可选项仅在 \hologo{biber} 处理时有效。
\end{optdesc}
@@ -254,7 +256,7 @@
spacebelow = <(0.75ex plus .1ex)>
spacepost = <(\tn{ccwd})>
\end{syntax}
-\changes{v1.21b}{2021/01/12}{增加配置定理环境样式的选项。}
+\changes{v1.21}{2021/01/12}{增加配置定理环境样式的选项。}
\end{function}
\begin{optdesc}
@@ -286,7 +288,7 @@
textwidth = <长度>
includehead = <true|(false)>
\end{syntax}
-\changes{v1.21c}{2021/01/13}{增加配置页面边距的选项。}
+\changes{v1.21}{2021/01/13}{增加配置页面边距的选项。}
\opt{geoset} 将选项交给 \pkg{geometry} 宏包接口命令 \tn{geometry} 处理,并且选项的键值列表与之相同,支持的参数可查阅宏包帮助文档。当在此设置页面大小时,会覆盖 \opt{paper} 选项的设置。
\begin{ctexexam}
\ctexset
@@ -310,7 +312,7 @@
\tn{easyfoot}\oarg{位置}\marg{内容}
\end{syntax}
\changes{v1.21}{2021/01/11}{修复单面文档时页眉横线消失的问题。}
-\changes{v1.21c}{2021/01/13}{增加配置页眉页脚的选项。}
+\changes{v1.21}{2021/01/13}{增加配置页眉页脚的选项。}
\opt{hdrset} 设置的命令由 \pkg{fancyhdr} 宏包提供支持,命令 \tn{easyhead} 和 \tn{easyfoot} 的含义与 \tn{fancyhead} 和 \tn{fancyfoot} 相同,设置的是一个名为 \opt{fancy} 的页面风格。\pkg{fancyhdr} 将页眉页脚分成了左中右和奇数页(odd)、偶数页(even)共12个部分,可选参数中E、O代表偶数、奇数,L、C、R代表左、中、右部分。单面打印时,含有偶数的选项无效。
\begin{ctexexam}
\ctexset
@@ -336,7 +338,7 @@
belowoffset = <(-1pc)>
\tn{tocrule} = \oarg{引导点间距|(0.7pc)}\oarg{引导点大小|(1.2)}\marg{引导点}\oarg{页码格式}
\end{syntax}
-\changes{v1.21c}{2021/01/13}{增加配置目录样式的选项。}
+\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}。
@@ -428,12 +430,12 @@
\tn{item} <习题内容>
\tn{end}\marg{exercise}
\end{syntax}
-\changes{v1.23a}{2021/02/08}{增加准确的习题盒子标题目录锚点。}
+\changes{v1.23g}{2021/02/08}{增加准确的习题盒子标题目录锚点。}
习题环境 \opt{exercise} 的标题紧接上一节编号并加入目录与页眉,当使用星号环境时不进行编号。三个可选参数中颜色为自定义或 \pkg{xcolor} 包含的颜色名称,正文编号格式与小节 \ref{sort list} 排序列表相同,标题名默认为摘要,参数只能\textbf{从右往左}省略。
\begin{ctexexam}
\begin{exercise}[LightYellow][1.][习题]
- \item 习题内容
- \item 习题内容
+ \item 习题内容
+ \item 习题内容
\end{exercise}
\end{ctexexam}
\end{function}
@@ -496,17 +498,19 @@
\end{function}
\subsection{物理量}
-\begin{function}[added = 2021-01-05]{\num,\si,\SI}
+\begin{function}[added = 2021-01-05,updated = 2021-02-23]{\num,\si,\SI,\SIrange}
\begin{syntax}
\tn{num}\oarg{选项}\marg{数字}
\tn{si}\oarg{选项}\marg{单位}
\tn{SI}\oarg{选项}\marg{数字}\oarg{前缀}\marg{单位}
+ \tn{SIrange}\oarg{选项}\marg{数字1}\marg{数字2}\marg{单位}
\end{syntax}
-\pkg{siunitx} 宏包的 \tn{num} 命令可以输出科学计数法,而 \tn{SI} 命令可用来输出带有单位的量,\tn{si} 命令支持数学模式,可以代替数学行内公式输入。
+\pkg{siunitx} 宏包的 \tn{num} 命令可以输出科学计数法,\tn{si} 命令支持数学模式,可以代替数学行内公式输入,而 \tn{SI} 命令可用来输出带有单位的量,\tn{SIrange} 可以输出带有范围和单位的量。
\begin{ctexexam}
\num{-21x.3e5}
\si{mL.min^{-1}}
\SI{5}{\mole}
+ \SIrange[unit-color = green]{1.5}{4}{kg}
\end{ctexexam}
\end{function}