From 43fdac40ca8d222661d9071842db5e406f4aada5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 14 Mar 2021 22:56:20 +0000 Subject: easybook (14mar21) git-svn-id: svn://tug.org/texlive/trunk@58355 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/easybook/easybook-demo.pdf | Bin 287472 -> 287471 bytes .../doc/latex/easybook/easybook-demo.tex | 2 +- Master/texmf-dist/doc/latex/easybook/easybook.pdf | Bin 237329 -> 245151 bytes Master/texmf-dist/doc/latex/easybook/easybook.tex | 74 +++++++++++++++------ Master/texmf-dist/tex/latex/easybook/easybook.cls | 31 +++++---- 5 files changed, 73 insertions(+), 34 deletions(-) (limited to 'Master/texmf-dist') 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 Binary files a/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf and b/Master/texmf-dist/doc/latex/easybook/easybook-demo.pdf differ 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 Binary files a/Master/texmf-dist/doc/latex/easybook/easybook.pdf and b/Master/texmf-dist/doc/latex/easybook/easybook.pdf differ 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 = - \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} { -- cgit v1.2.3