summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-03-14 22:56:20 +0000
committerKarl Berry <karl@freefriends.org>2021-03-14 22:56:20 +0000
commit43fdac40ca8d222661d9071842db5e406f4aada5 (patch)
treef24cf125114069f9a8062071706feb42e46d5a21
parent4f5a21b32667151c499a9e989e2a393373cf3ff7 (diff)
easybook (14mar21)
git-svn-id: svn://tug.org/texlive/trunk@58355 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook-demo.pdfbin287472 -> 287471 bytes
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook-demo.tex2
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook.pdfbin237329 -> 245151 bytes
-rw-r--r--Master/texmf-dist/doc/latex/easybook/easybook.tex74
-rw-r--r--Master/texmf-dist/tex/latex/easybook/easybook.cls31
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
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 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
Binary files 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 = <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}
{