easybook (14mar21)

git-svn-id: svn://tug.org/texlive/trunk@58355 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 73 insertions, 34 deletions

diff --git a/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf b/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf
index 2cccc3ed380..0217ebec007 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf
+++ b/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook-demo.tex b/Master/texmf-dist/doc/latex/easybook/easybook-demo.tex
index 621c21ece2d..9ad0b579c1e 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/13\hskip\ccwd\relax v1.23p}
+\date{2021/03/14\hskip\ccwd\relax v1.23q}
 
 \frontmatter[roman]
 \maketitle
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook.pdf b/Master/texmf-dist/doc/latex/easybook/easybook.pdf
index 32776a80beb..25192edcd6e 100644
--- a/Master/texmf-dist/doc/latex/easybook/easybook.pdf
+++ b/Master/texmf-dist/doc/latex/easybook/easybook.pdf
diff --git a/Master/texmf-dist/doc/latex/easybook/easybook.tex b/Master/texmf-dist/doc/latex/easybook/easybook.tex
index 0b20284e284..b8b375c3335 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/13\hskip\ccwd\relax v1.23p\thanks{\url{https://gitee.com/texl3/easybook}}}
+\date{2021/03/14\hskip\ccwd\relax v1.23q\thanks{\url{https://gitee.com/texl3/easybook}}}
 
 \begin{document}
 \maketitle
@@ -98,7 +98,7 @@
   \tn{printindex}\oarg{索引名}
 \end{syntax}
 \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}{重新定义文档结构划分命令。}
+\changes{v1.23q}{2021/02/20}{重新定义文档结构划分命令。}
 \end{function}
 
 \section{接口选项}
@@ -132,8 +132,8 @@
 \end{syntax}
 \opt{style} 选项控制文章的风格。
 \changes{v1.10}{2021/01/08}{更改颜色实现方式与选项名。}
-\changes{v1.23p}{2021/02/02}{noto风格的数学字体独立出来，可自定义设置。}
-\changes{v1.23p}{2021/02/09}{增加控制页面横线粗细的选项。}
+\changes{v1.23q}{2021/02/02}{noto风格的数学字体独立出来，可自定义设置。}
+\changes{v1.23q}{2021/02/09}{增加控制页面横线粗细的选项。}
 \end{function}
 
 \begin{optdesc}
@@ -190,7 +190,7 @@
 \end{syntax}
 行距因子用于设置各种行距倍数，只能是浮点数，不能带有长度单位。\tn{ctexset} 原有的行距选项\opt{linespread}失效。各行距既可在导言区全局设置也可正文中设置对后面生效，行距的意义为
 \changes{v1.21}{2021/01/12}{增加脚注线间的距离选项。}
-\changes{v1.23p}{2021/02/09}{取消使用 \pkg{zhlineskip} 宏包设置数学间距。}
+\changes{v1.23q}{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.23p}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
+\changes{v1.23q}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
 \end{function}
 
 \begin{optdesc}
@@ -229,10 +229,10 @@
   bib-style = <(numerical)|authoryear|其它格式>
   cite-style = <标注风格>
   bibfile = <refs.bib>
-  \tn{printbibliography}\oarg{选项列表}
+  \tn{printbibliography}\oarg{键值列表}
 \end{syntax}
 \changes{v1.21}{2021/01/11}{增加 \opt{bibset} 选项，可以使用 \hologo{BibTeX} 或 \hologo{biber} 编译参考文献。}
-\changes{v1.23p}{2021/02/23}{使用 \opt{bibset} 选项时可设置标注风格。}
+\changes{v1.23q}{2021/02/23}{使用 \opt{bibset} 选项时可设置标注风格。}
 \end{function}
 
 \begin{optdesc}
@@ -260,7 +260,7 @@
   \tn{declaretheoremstyle}\oarg{键值列表}\marg{定理样式名}
 \end{syntax}
 \changes{v1.21}{2021/01/12}{增加配置定理环境样式的选项。}
-\changes{v1.23p}{2021/03/12}{重新定义了新定理环境命令 \tn{newtheorem}。}
+\changes{v1.23q}{2021/03/12}{重新定义了新定理环境命令 \tn{newtheorem}。}
 \end{function}
 
 \begin{optdesc}
@@ -285,7 +285,7 @@
 \end{optdesc}
 
 \subsubsection{新的定理样式}
-定理由 \pkg{thmtools} 设置，自带定理的样式为 \opt{mythm}，上述定理样式选项将对这个定理样式生效。如果使用这个样式而只是增加新的定理名称，可以这样
+定理由 \pkg{thmtools} 设置，预置定理的样式为 \opt{mythm}，上述定理样式选项将对这个定理样式生效。如果使用这个样式而只是增加新的定理名称，可以这样
 \begin{ctexexam}
     \newtheorem[style = mythm,name = 定理名]{定理环境名}
 \end{ctexexam}
@@ -324,15 +324,20 @@
 \end{function}
 
 \subsection{页眉页脚}
-\begin{function}[EXP,added = 2021-01-13,updated = 2021-03-08]{hdrset/head-foot,hdrset/chap-mark,hdrset/sec-mark,\easyhead,\easyfoot,...}
+\begin{function}[EXP,added = 2021-01-13,updated = 2021-03-14]{hdrset/head-foot,hdrset/chap-mark,hdrset/sec-mark,hdrset/headrule,hdrset/footrule,hdrset/footnoterule,\easyhead,\easyfoot,...}
 \begin{syntax}
   head-foot = <页眉页脚中的内容>
   chap-mark = <\tn{chaptermark} 标志命令 \tn{markboth} 中的内容>
   sec-mark = <\tn{sectionmark} 标志命令 \tn{markright} 中的内容>
+  headrule = <页眉横线格式>
+  footrule = <页脚横线格式>
+  footnoterule = <脚注横线格式>
   \tn{easyhead}\oarg{位置}\marg{内容}
   \tn{easyfoot}\oarg{位置}\marg{内容}
 \end{syntax}
 \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代表左、中、右部分。单面打印时，含有偶数的选项无效。
+
+\opt{headrule}、\opt{footrule} 和 \opt{footnoterule} 三个横线选项一般可以使用 \tn{hrule} width \meta{长度} height \meta{高度} 命令来绘制，脚注横线默认为空。当然，手动绘制横线时线条粗细选项 \opt{style/rulewidth} 会失效。
 \begin{ctexexam}
     \ctexset
       {
@@ -343,13 +348,16 @@
                 \easyhead[ER]{\leftmark}
                 \easyhead[OL]{\rightmark}
                 \easyhead[EL,OR]{\textbf{\thepage}}
-              }
+              },
+            sec-mark = {\CTEXthesection\hspace{0.5\ccwd}},
+            headrule = {\hrule width \textwidth height 1pt}
           }
       }
 \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} 选项。}
+\changes{v1.23q}{2021/03/08}{优化页眉页脚设置，增加 \opt{chap-mark} 和 \opt{sec-mark} 选项。}
+\changes{v1.23q}{2021/03/14}{可以手动绘制页眉、页脚和脚注的横线。}
 \end{function}
 
 \subsection{目录样式}
@@ -404,7 +412,7 @@
   \tn{item} <列表内容>
   \tn{end}\marg{环境名}
 \end{syntax}
-\pkg{enumitem} 宏包为系统自带的列表环境提供了更灵活的标签以及间距的控制，可使用 \tn{setlist} 命令设置原有的三种列表格式。已设置默认格式，若自定义标签可例如
+\pkg{enumitem} 宏包为系统预置的列表环境提供了更灵活的标签以及间距的控制，可使用 \tn{setlist} 命令设置原有的三种列表格式。已设置默认格式，若自定义标签可例如
 \begin{ctexexam}
     \begin{enumerate}[label = \arabic*(a),leftmargin = 1cm,resume]
     \begin{itemize}[label = \textbullet]
@@ -445,7 +453,7 @@
   <定理内容>
   \tn{end}\marg{环境名}
 \end{syntax}
-这些是默认自带的定理环境，定理环境除了注和证明跟随章编号并可带有边框，边框和习题标题盒子可使用 \opt{thmbox = false} 开启，证明末尾会自动添加证明结束符。
+这些是预置的定理环境，定理环境除了注和证明跟随章编号并可带有边框，边框和习题标题盒子可使用 \opt{thmbox = false} 开启，证明末尾会自动添加证明结束符。
 \end{function}
 
 \subsection{习题}
@@ -463,11 +471,11 @@
       \item 习题内容
     \end{exercise}
 \end{ctexexam}
-\changes{v1.23p}{2021/02/08}{增加准确的习题盒子标题目录锚点。}
+\changes{v1.23q}{2021/02/08}{增加准确的习题盒子标题目录锚点。}
 \end{function}
 
 \subsection{盒子}
-盒子以及小节 \ref{exercise} 中 \opt{exercise} 环境配置的选项由 \pkg{tcolorbox} 提供支持，具体选项可见宏包文档的 Option Keys 一节，一些配置会覆盖之前的默认设置。
+盒子以及小节 \ref{exercise} 中 \opt{exercise} 环境配置的选项由 \pkg{tcolorbox} 提供支持，具体选项可见宏包文档的 Option Keys 一节，可以进行边距、字体及背景颜色等各种个性化设置，一些配置会覆盖之前预置的设置。
 
 \subsubsection{摘要盒子}
 \begin{function}[added = 2021-01-05,updated = 2021-03-13]{outline}
@@ -511,7 +519,7 @@
 设置了两个参数选项相同的行内盒子，盒子 \opt{concise} 为抄录盒子有三个参数，行内盒子内容是必选参数其他可选。盒子 \opt{fuzzy} 也是抄录盒子，具有模糊边缘类似高亮的效果。
 \end{function}
 
-\section{其它格式}
+\section{其它用法}
 
 \subsection{代码}
 \begin{function}[added = 2021-01-05]{\lstinline,lstlisting,\listoflistings}
@@ -585,7 +593,35 @@
 \begin{syntax}
   \tn{marginnote}\oarg{左文本}\marg{右文本}\oarg{垂直偏移}
 \end{syntax}
-命令 \tn{marginnote} 可以生成简单的边注，如果只给定了\meta{右文本}，那么边注在奇偶数页文字相同。如果同时给定了\meta{左文本}，则偶数页使用\meta{左文本}的文字。
+命令 \tn{marginnote} 可以生成简单的边注，如果只给定了 \meta{右文本}，那么边注在奇偶数页文字相同。如果同时给定了 \meta{左文本}，则偶数页使用 \meta{左文本} 的文字。
+\end{function}
+
+\subsection{插入文档}
+\begin{function}[added = 2021-03-14]{\includepdf}
+\begin{syntax}
+  \tn{includepdf}\oarg{键值列表}\marg{文档名}
+\end{syntax}
+该命令由 \pkg{pdfpages} 提供，将其他 pdf 文档插入当前文档，可以指定插入页数、逻辑页和横向等，详情查看宏包文档。
+\end{function}
+
+\subsection{横向页面}
+\begin{function}[added = 2021-03-14]{sidewaysfigure,sidewaystable}
+\begin{syntax}
+  \tn{begin}\marg{环境名}\oarg{位置}
+  <插入图片或表格>
+  \tn{end}\marg{环境名}
+\end{syntax}
+该环境由 \pkg{rotfloat} 提供，用于横向插入宽大的图片或表格，用法与 \opt{figure} 和 \opt{table} 环境类似。
+\end{function}
+
+\subsection{指定行距的段落}
+\begin{function}[added = 2021-03-14]{spacing}
+\begin{syntax}
+  \tn{begin}\marg{spacing}\marg{浮点数}
+  <段落内容>
+  \tn{end}\marg{spacing}
+\end{syntax}
+该环境由 \pkg{setspace} 提供，可以指定环境内段落的行距，使用浮点数控制行距倍数。
 \end{function}
 
 \IndexLayout
diff --git a/Master/texmf-dist/tex/latex/easybook/easybook.cls b/Master/texmf-dist/tex/latex/easybook/easybook.cls
index a1a78fa8474..cfb30bc1caa 100644
--- a/Master/texmf-dist/tex/latex/easybook/easybook.cls
+++ b/Master/texmf-dist/tex/latex/easybook/easybook.cls
@@ -9,7 +9,7 @@
 %%   https://creativecommons.org/licenses/by/4.0/legalcode
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{l3keys2e}
-\ProvidesExplClass{easybook}{2021/03/13}{1.23p}{}
+\ProvidesExplClass{easybook}{2021/03/14}{1.23q}{}
 
 \cs_generate_variant:Nn \keys_define:nn {nx}
 \cs_generate_variant:Nn \int_to_arabic:n {v}
@@ -345,6 +345,21 @@
               \CTEXthesection\hspace{0.5\ccwd}
             \fi
           }
+      },
+    headrule      .tl_gset:N = \headrule,
+    headrule      .initial:n =
+      {
+        \color{ctex@frame}\vspace{1.5pt}
+        \hrule width \textwidth height \l__rule_width_dim
+      },
+    footrule      .tl_gset:N = \footrule,
+    footrule      .initial:n = {},
+    footnoterule  .tl_gset:N = \footnoterule,
+    footnoterule  .initial:n =
+      {
+        \color{ctex@frame}
+        \hrule width 0.35\columnwidth height \l__rule_width_dim
+        \vspace*{2.6pt}\color{black}
       }
   }
 \ctex_at_end_preamble:n
@@ -391,11 +406,6 @@
               {\text_titlecase_first:n {\l__fancyhf_sec_mark_tl#1}}
           }
       }
-    \cs_gset:Npn \headrule
-      {
-        \color{ctex@frame}\vspace{1.5pt}
-        \hrule width\textwidth height \l__rule_width_dim
-      }
     \bool_if:NT \l__draft_bool
       {
         \bool_if:NTF \l__page_twoside_bool
@@ -629,7 +639,6 @@
 \tl_new:N \l__font_figure_tl
 \tl_new:N \l__font_listing_tl
 \tl_new:N \l__font_footnote_tl
-\tl_new:N \l__font_marginpar_tl
 
 \__ctex_define:nn {elfont}
   {
@@ -641,7 +650,7 @@
     listing-cap .initial:n = \sffamily\small,
     footnote    .tl_set:N = \l__font_footnote_tl,
     footnote    .initial:n = \rmfamily,
-    marginpar   .tl_set:N = \l__font_marginpar_tl,
+    marginpar   .tl_set:N = \marginfont,
     marginpar   .initial:n = \rmfamily\footnotesize
   }
 
@@ -1135,11 +1144,6 @@
     \skip_gset:Nn \footnotesep{\ht\strutbox}
     \group_end:
     \cs_gset:Npn \hangfootparskip{0ex}
-    \cs_gset:Npn \footnoterule
-      {
-        \color{ctex@frame}\hrule width 0.35\columnwidth height \l__rule_width_dim
-        \vspace*{2.6pt}\color{black}
-      }
     \bool_if:NT \l__lang_chinese_bool
       {\cs_gset:Npn \hangfootparindent{2\ccwd}}
     \bool_if:NT \l__chap_withpart_bool
@@ -1163,7 +1167,6 @@
   {\def\baselinestretch{\fp_use:N \l__spread_footnote_fp}\l__font_footnote_tl}
 \__patch_cmd:Nnn \@makefnmark
   {\normalfont}{\l__font_footnote_tl}
-\cs_gset:Npn \marginfont{\l__font_marginpar_tl}
 
 \lstdefinestyle{mystyle}
   {