diff --git a/README.md b/README.md index c4990d4d..3db77f84 100644 --- a/README.md +++ b/README.md @@ -137,7 +137,7 @@ int main(){ * 之后通过 `latexmk -xelatex main.tex` 命令进行编译即可。 * VSCode 用户可以使用 LaTeX Workshop 中的 “Recipe: latexmk (latexmkrc)” 进行编译。 -目前模版最新的稳定版是 v2.6.0。您可以在 [发布页](https://github.com/sjtug/SJTUBeamer/releases) 查看修改日志和更多资料。通常来说，SJTUBeamer 的一个稳定版本包括如下内容： +目前模版最新的稳定版是 v2.8.0。您可以在 [发布页](https://github.com/sjtug/SJTUBeamer/releases) 查看修改日志和更多资料。通常来说，SJTUBeamer 的一个稳定版本包括如下内容： * `sjtubeamer.pdf`: **强烈推荐在使用前阅读一遍 👍👍👍** SJTUBeamer 用户文档。 * `sjtubeamerdevguide.pdf`: SJTUBeamer 开发指南。 diff --git a/README_en.md b/README_en.md index c21693eb..1a8b6f4c 100644 --- a/README_en.md +++ b/README_en.md @@ -132,7 +132,7 @@ Edit `main.tex` and start to use. * Run `latexmk -xelatex main.tex` to compile * VSCode LaTeX Workshop: use “Recipe: latexmk (latexmkrc)” to compile -The current stable version is v2.6.0。You could visit [the release page](https://github.com/sjtug/SJTUBeamer/releases) for the changelog and more details. Generally speaking, a release of SJTUBeamer has the following content: +The current stable version is v2.8.0。You could visit [the release page](https://github.com/sjtug/SJTUBeamer/releases) for the changelog and more details. Generally speaking, a release of SJTUBeamer has the following content: * `sjtubeamer.pdf`: SJTUBeamer User Guide。**HIGHLY RECOMMENDED TO READ BEFORE YOU START👍👍👍** * `sjtubeamerdevguide.pdf`: SJTUBeamer Development Guide. diff --git a/beamercolorthemesjtubeamer.sty b/beamercolorthemesjtubeamer.sty index a3118776..57d053a5 100644 --- a/beamercolorthemesjtubeamer.sty +++ b/beamercolorthemesjtubeamer.sty @@ -21,7 +21,7 @@ %% limitations under the License. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamercolorthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer color theme] +\ProvidesPackage{beamercolorthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer color theme] \RequirePackage{sjtuvi} \DefineOption{color}{color}{red} \DefineOption{color}{color}{blue} diff --git a/beamerfontthemesjtubeamer.sty b/beamerfontthemesjtubeamer.sty index 46efdb87..38c4c8a5 100644 --- a/beamerfontthemesjtubeamer.sty +++ b/beamerfontthemesjtubeamer.sty @@ -21,7 +21,7 @@ %% limitations under the License. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerfontthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer font theme] +\ProvidesPackage{beamerfontthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer font theme] \RequirePackage{silence} \WarningFilter{latexfont}{Font shape} \usefonttheme{professionalfonts} diff --git a/beamerinnerthemesjtubeamer.sty b/beamerinnerthemesjtubeamer.sty index bb2e7dcd..38b96fba 100644 --- a/beamerinnerthemesjtubeamer.sty +++ b/beamerinnerthemesjtubeamer.sty @@ -21,7 +21,7 @@ %% limitations under the License. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerinnerthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer inner theme] +\ProvidesPackage{beamerinnerthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer inner theme] \RequirePackage{sjtuvi} \RequirePackage{tcolorbox} \DefineOption{inner}{cover}{maxplus} diff --git a/beamerouterthemesjtubeamer.sty b/beamerouterthemesjtubeamer.sty index 8546554a..174f25dc 100644 --- a/beamerouterthemesjtubeamer.sty +++ b/beamerouterthemesjtubeamer.sty @@ -21,7 +21,7 @@ %% limitations under the License. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerouterthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer outer theme] +\ProvidesPackage{beamerouterthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer outer theme] \RequirePackage{sjtuvi} \DefineOption{outer}{nav}{miniframes} \DefineOption{outer}{nav}{infolines} diff --git a/beamerthemesjtubeamer.sty b/beamerthemesjtubeamer.sty index 8954c3e6..bafb3fc0 100644 --- a/beamerthemesjtubeamer.sty +++ b/beamerthemesjtubeamer.sty @@ -21,7 +21,7 @@ %% limitations under the License. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer parent theme] +\ProvidesPackage{beamerthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer parent theme] \DeclareOptionBeamer{maxplus}{ \def\sjtubeamer@cover{maxplus}\def\sjtubeamer@logopos{topright}} \DeclareOptionBeamer{max}{ diff --git a/contents/basis.tex b/contents/basis.tex index 77b3ebee..bcda1fe2 100644 --- a/contents/basis.tex +++ b/contents/basis.tex @@ -2,7 +2,7 @@ % !TeX root = ../main.tex %% ------------------------------------------------------------------------ -%% Copyright (C) 2021 SJTUG +%% Copyright (C) 2021,2022 SJTUG %% %% SJTUBeamer Example Document by SJTUG %% diff --git a/contents/introduction.tex b/contents/introduction.tex index e1508232..dd011f81 100644 --- a/contents/introduction.tex +++ b/contents/introduction.tex @@ -2,7 +2,7 @@ % !TeX root = ../main.tex %% ------------------------------------------------------------------------ -%% Copyright (C) 2021 SJTUG +%% Copyright (C) 2021,2022 SJTUG %% %% SJTUBeamer Example Document by SJTUG %% diff --git a/contents/summary.tex b/contents/summary.tex index 675f6fe7..8278d5b6 100644 --- a/contents/summary.tex +++ b/contents/summary.tex @@ -2,7 +2,7 @@ % !TeX root = ../main.tex %% ------------------------------------------------------------------------ -%% Copyright (C) 2021 SJTUG +%% Copyright (C) 2021,2022 SJTUG %% %% SJTUBeamer Example Document by SJTUG %% diff --git a/contents/thesis.tex b/contents/thesis.tex index 1e71cadb..40d2265e 100644 --- a/contents/thesis.tex +++ b/contents/thesis.tex @@ -2,7 +2,7 @@ % !TeX root = ../main.tex %% ------------------------------------------------------------------------ -%% Copyright (C) 2021 SJTUG +%% Copyright (C) 2021,2022 SJTUG %% %% SJTUBeamer Example Document by SJTUG %% diff --git a/main.tex b/main.tex index f048b117..760e79be 100644 --- a/main.tex +++ b/main.tex @@ -1,7 +1,7 @@ % !TeX encoding = UTF-8 %% ------------------------------------------------------------------------ -%% Copyright (C) 2021 SJTUG +%% Copyright (C) 2021,2022 SJTUG %% %% SJTUBeamer Example Document by SJTUG %% @@ -75,9 +75,11 @@ \def\TeXLive{\TeX{} Live} \let\TL=\TeXLive \newcommand{\SJTUThesis}{\textsc{SJTUThesis}} +\newcommand{\SJTUThesisVersion}{1.1.0} +\newcommand{\SJTUThesisDate}{2022/3/26} \newcommand{\SJTUBeamer}{\textsc{SJTUBeamer}} -\newcommand{\SJTUThesisVersion}{1.0.0rc7} -\newcommand{\SJTUThesisDate}{2020/7/31} +\newcommand{\SJTUBeamerVersion}{2.8.0} +\newcommand{\SJTUBeamerDate}{2022/5/11} \newcommand\link[1]{\href{#1}{\faLink}} \newcommand\pkg[1]{\texttt{#1}} @@ -157,8 +159,8 @@ \vspace*{2ex} \begin{itemize} - \item 本示例文档结构适用于简短的单次报告，仅展示 \beamer{} 文档类的通用功能。为完整发挥 \SJTUBeamer{} 的全部功能，详见发布区 \link{https://github.com/sjtug/SJTUBeamer/releases} 的使用手册与开发文档。 - \item 对于制作多次讲座内容，源码结构可以参考新讲座 \link{https://github.com/sjtug/sjtulib-latex-talk/tree/logcreative-2022}，使用了社区版主题的同时也展示了 \SJTUBeamer{} 的特殊用法。 + \item 本示例文档的源码结构适用于简短的单次报告，仅展示 \beamer{} 文档类的通用功能。为发挥 \SJTUBeamer{} 的全部功能，参见发布区 \link{https://github.com/sjtug/SJTUBeamer/releases} 的用户手册与开发文档。 + \item 就制作一组讲座而言，相关源码结构可以参考新讲座 \link{https://github.com/sjtug/sjtulib-latex-talk/tree/logcreative-2022}。新讲座使用了社区版主题的同时也展示了 \SJTUBeamer{} 的特殊用法。 \end{itemize} \end{frame} diff --git a/sjtucover.sty b/sjtucover.sty index da9026bf..9fc0f8a0 100644 --- a/sjtucover.sty +++ b/sjtucover.sty @@ -18,7 +18,7 @@ %% see https://vi.sjtu.edu.cn/index.php/articles/bulletin/16. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{sjtucover}[2022/05/10 v2.7.3 cover library for sjtubeamer] +\ProvidesPackage{sjtucover}[2022/05/11 v2.8.0 cover library for sjtubeamer] \RequirePackage{sjtuvi} \DefineOption{cover}{lang}{zh} \DefineOption{cover}{lang}{en} diff --git a/sjtuvi.sty b/sjtuvi.sty index 1da15672..d21e65bc 100644 --- a/sjtuvi.sty +++ b/sjtuvi.sty @@ -18,7 +18,7 @@ %% see https://vi.sjtu.edu.cn/index.php/articles/bulletin/16. %% ------------------------------------------------------------------------ \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{sjtuvi}[2022/05/10 v2.7.3 Visual Identity System library for sjtubeamer] +\ProvidesPackage{sjtuvi}[2022/05/11 v2.8.0 Visual Identity System library for sjtubeamer] \def\DefineOption#1#2#3{ % #1: package % #2: key diff --git a/src/doc/min.tex b/src/doc/min.tex index 91eddf6f..a392a10f 100644 --- a/src/doc/min.tex +++ b/src/doc/min.tex @@ -14,7 +14,7 @@ \begin{document} \institute[School of Mathematical Sciences]{数学科学学院} % 组织 % \logo{ -% \includegraphics{vi/zhlogored.pdf} % 重定义 logo +% \includegraphics{vi/zhlogo.pdf} % 重定义 logo % } \titlegraphic{ % 标题图像 \includegraphics{head.png} diff --git a/src/doc/sjtubeamer.tex b/src/doc/sjtubeamer.tex index 8210c1ed..48e20438 100644 --- a/src/doc/sjtubeamer.tex +++ b/src/doc/sjtubeamer.tex @@ -68,6 +68,10 @@ lineskip=-.1cm, breaklines } +\newcommand{\cmd}[1]{\textbackslash{}\texttt{#1}} +\newcommand{\cls}[1]{\texttt{#1}} +\newcommand{\env}[1]{\texttt{#1}} +\newcommand{\pkg}[1]{\texttt{#1}} \tcbuselibrary{skins,raster} \newtcbinputlisting[auto counter]{\beamerdemo}[2][1]{ @@ -130,20 +134,20 @@ \chapter*{\themename\ 介绍} \themename\ 是基于 \verb"beamer" 文档类的主题宏集。 \section*{何时应该使用这个主题？} -众所周知，\LaTeX\ 是一种非常专业的排版语言，而 \texttt{beamer} 是为了方便 \LaTeX\ 用户制作幻灯片而创造的宏包。为了获得专业的幻灯片文档，下面是可能需要使用 \texttt{beamer} 的时机： +众所周知，\LaTeX\ 是一种非常专业的排版语言，而 \cls{beamer} 是为了方便 \LaTeX{} 用户制作幻灯片而创造的宏包。为了获得专业的幻灯片文档，下面是可能需要使用 \cls{beamer} 的时机： \begin{enumerate} \item 重要正式的学术场合。 \item 大型文档的构建（上百页）。 - \item 已经使用 \LaTeX\ 写好稿子，需要基于此演说。 + \item 已经使用 \LaTeX{} 写好稿子，需要基于此演说。 \end{enumerate} -而 \themename\ 为上海交通大学的 \LaTeX\ 用户提供了一些内置功能，以快速构建交大主题的幻灯片文档。 +而 \themename{} 为上海交通大学的 \LaTeX{} 用户提供了一些内置功能，以快速构建交大主题的幻灯片文档。 \section*{何时不应该使用这个主题？} -遗憾的是，\LaTeX\ 不是可见即可得的，编译需要花费时间。学习 \LaTeX\ 也需要花费时间。下面就是一些不推荐使用的情况： +遗憾的是，\LaTeX{} 不是可见即可得的，编译需要花费时间。学习 \LaTeX{} 也需要花费时间。下面就是一些不推荐使用的情况： \begin{enumerate} - \item 幻灯片需要大量的美术，图形需要大量的动画。纵然 \LaTeX\ 支持矢量图的绘制，但是需要的编译时间也会成倍的增长，Ti\emph{k}Z 绘图更偏重于计算图形绘制。 - \item 文档较小，或者公式很少。这种情况使用 \texttt{beamer} 略显多余，造轮子花费的时间可能不够划算。 + \item 幻灯片需要大量的美术，图形需要大量的动画。纵然 \LaTeX{} 支持矢量图的绘制，但是需要的编译时间也会成倍的增长，Ti\emph{k}Z 绘图更偏重于计算图形绘制。 + \item 文档较小，或者公式很少。这种情况使用 \cls{beamer} 略显多余，造轮子花费的时间可能不够划算。 \end{enumerate} 遇到任何问题，欢迎前往 \href{https://github.com/sjtug/SJTUBeamer/issues}{Issues} 提问。并推荐附上本文档一直采用的最小工作集示例方式。 @@ -158,8 +162,8 @@ \section{运行环境} 为了使用 \themename\ 的全部功能，请使用下者之一： \begin{enumerate} - \item \href{https://miktex.org/}{MiK\TeX\ } - \item \href{https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/Images/texlive2021-20210325.iso}{\TeX\ Live} 2019 及以上版本 + \item \href{https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/win32/miktex/setup/windows-x64/}{MiK\TeX\ } + \item \href{https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/Images/}{\TeX\ Live} 或 \href{https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/mac/mactex/}{Mac\TeX{}} 2019 及以上版本 \end{enumerate} % 上传至 Overleaf 后添加对应在线步骤 @@ -171,28 +175,28 @@ \section{下载模板} \begin{verbatim}git clone https://mirror.sjtu.edu.cn/git/SJTUBeamer.git/\end{verbatim} 克隆本存储库。 \item 或者前往 GitHub 上的 \faGithub{}~\href{https://github.com/sjtug/SJTUBeamer}{sjtug/SJTUBeamer} 页面，点击 \xbutton[green]{Code} 按钮下载压缩文件，在解压后的主目录里新建 \TeX{} 源文件即可调用该模板。 - \item 或者点击进入存储库侧栏的 \href{https://github.com/sjtug/SJTUBeamer/releases}{\textsf{Releases}} 下载查看最新发布版本，并下载 \textsf{Assets} 栏的 \texttt{sjtubeamer-ctan.zip}。 + \item 或者点击进入存储库侧栏的 \href{https://github.com/sjtug/SJTUBeamer/releases}{\textsf{Releases}} 下载查看最新发布版本，并下载 \textsf{Assets} 栏的 \textsf{sjtubeamer-ctan.zip}。将该压缩包中的内容安装到发行版路径中，并刷新文件名数据库，即可全局使用。 \end{enumerate} \section{测试模板} \begin{enumerate} - \item[ \faApple\ \faLinux] *nix 系统采用 \hologo{XeLaTeX} 编译以获得中文支持。 + \item[ \faApple{} \faLinux] *nix 系统采用 \hologo{XeLaTeX} 编译以获得中文支持。 \item[ \faWindows] Windows 系统采用 \hologo{pdfLaTeX} 编译以获得更快的编译速度。 - \item[\faWrench] 也可以直接使用 \texttt{latexmk (latexmkrc)} 编译示例的主文档。 + \item[\faWrench] 也可以直接使用 \textsf{latexmk (latexmkrc)} 编译示例的主文档。 \end{enumerate} -下面的代码可以用于测试 \themename\ 是否可以正常使用。 +下面的代码可以用于测试 \themename{} 是否可以正常使用。 \beamerdemo[1]{step1} \begin{commentlist} - \item 第一行载入 \texttt{ctex} 宏包提供的 \texttt{ctexbeamer} 文档类。如果需要使用 16:9 的荧幕比例，可以参照示例 2 的相关参数。 - \item 如果不需要中文支持，可以直接使用 \texttt{beamer} 文档类。 - \item 第二行载入 \texttt{sjtubeamer} 主题。 - \item 使用 \texttt{document} 环境进入文档主体。 - \item 使用 \texttt{frame} 环境创建新的幻灯片（帧）。 + \item 第一行载入 \pkg{ctex} 宏包提供的 \cls{ctexbeamer} 文档类。如果需要使用 16:9 的荧幕比例，可以参照示例 2 的相关参数。 + \item 如果不需要中文支持，可以直接使用 \cls{beamer} 文档类。 + \item 第二行载入 \cls{sjtubeamer} 主题。 + \item 使用 \env{document} 环境进入文档主体。 + \item 使用 \env{frame} 环境创建新的幻灯片（帧）。 \item 在帧中输入文字即可在屏幕垂直居中位置产生文字。 \end{commentlist} @@ -200,7 +204,7 @@ \section{测试模板} \chapter{样式} -在开始填入内容前，应当首先确定需要使用的样式。\themename 目前提供了三种不同的主要主题、两种配色和明暗模式。 +在开始填入内容前，应当首先确定需要使用的样式。\themename{} 目前提供了三种不同的主要主题、两种配色和明暗模式。 \noindent{\ttfamily\hfil\hspace*{-.5cm} + maxplus \hfil\hfil\hspace*{-.5cm} + max \hfil\hfil + min \hfil}\par \vspace*{-.2cm} @@ -267,9 +271,9 @@ \chapter{封面} \begin{commentlist} \item 在载入模板时选择 \texttt{maxplus}, \texttt{max}, \texttt{min} 以使用不同的标题页结尾页模板。 - \item 组织（\texttt{\textbackslash{}institute}）可选，\texttt{min}会根据二级机构的处理方法排列徽标。 - \item \texttt{\textbackslash{}maketitle} 可以制作标题页，\texttt{\textbackslash{}makebottom} 可以制作结束页$^*$。 - \item$^*$ 标题页中 \texttt{\textbackslash{}thanks} 被禁用，\texttt{\textbackslash{}makebottom} 是 \themename\ 专有命令。 + \item 组织（\cmd{institute}）可选，\texttt{min}会根据二级机构的处理方法排列徽标。 + \item \cmd{maketitle} 可以制作标题页，\cmd{makebottom} 可以制作结束页$^*$。 + \item$^*$ 标题页中 \cmd{thanks} 被禁用，\cmd{makebottom} 是 \themename\ 专有命令。 \item[\faExclamationTriangle] 将元数据写在 \texttt{document} 中可能会产生警告，可无视。 \end{commentlist} @@ -285,16 +289,28 @@ \section{单页目录} \section{节次提示} -而新式的方法是使用 \themename\ 优化后的节次页。现在节次页也会随主题的不同而有不同的样式。节次页的编号支持在加载主题之后使用 \texttt{\textbackslash{}ctexset} 来更改格式，详见 \href{https://mirrors.sjtug.sjtu.edu.cn/CTAN/language/chinese/ctex/ctex.pdf#7}{\CTeX{} 宏集手册}。 +而新式的方法是使用 \themename\ 优化后的节次页。现在节次页也会随主题的不同而有不同的样式。节次页的编号支持在加载主题之后使用 \cmd{ctexset} 来更改格式，详见 \href{https://mirrors.sjtug.sjtu.edu.cn/CTAN/language/chinese/ctex/ctex.pdf#7}{\CTeX{} 宏集手册}。 + +\begin{beamerdemoraster}[1,2,3]{red}{step7s} +\end{beamerdemoraster} \beamerdemo[4]{step7+.tex} +\begin{commentlist} + \item \cmd{AtBeginSubsection} 用于指定每小节开始时的动作。 + \item 后文的 \cmd{AtBeginSection} 用于指定每节开始时的动作。 +\end{commentlist} + \section{分割部分} -如果内容过多，可以采用 \texttt{\textbackslash{}part} 将内容分割为多个部分。新建一个部分都会新建一个部分页$^*$。 +如果内容过多，可以采用 \cmd{part} 将内容分割为多个部分。新建一个部分都会新建一个部分页$^*$。 \beamerdemo[1]{step8+.tex} +\begin{commentlist} + \item \cmd{part} 在简短的演讲中应当较少使用，因为顶部的导航栏会在每一部分开始后重新开始，之前的节次目录将会清空。 +\end{commentlist} + \section{高亮节次} 使用传统目录也可以在每节开始新建一个目录高亮本节。 @@ -302,12 +318,13 @@ \section{高亮节次} \beamerdemo[1]{step9+.tex} \begin{commentlist} - \item 如果想要在幻灯片列表环境产生类似的“渐进切换”效果，可以在 \texttt{itemize} 环境的每一条后使用 \texttt{\textbackslash{}pause} 命令。或者是 \texttt{\textbackslash{}begin\{itemize\}[<+->]}。 + \item 如果想要在幻灯片列表环境产生类似的“渐进切换”效果，可以在 \texttt{itemize} 环境的每一条后使用 \cmd{pause} 命令。或者是 \cmd{begin\{itemize\}[<+->]}。 + \item \cmd{tableofcontents[currentsection, currentsubsection]} 用于小节页。 \end{commentlist} \chapter{播放} -制作的演示文稿推荐使用 Adobe Acrobat 播放，浏览器内置的阅读器不支持一些额外功能。在使用 \texttt{\textbackslash{}note} 添加幻灯片备注时，推荐使用 Pympress 软件。 +制作的演示文稿推荐使用 Adobe Acrobat 播放，浏览器内置的阅读器不支持一些额外功能。在使用 \cmd{note} 添加幻灯片备注时，推荐使用 Pympress 软件。 \section{Adobe Acrobat} @@ -336,11 +353,18 @@ \section{浏览器阅读器} \section{Pympress} \href{https://github.com/Cimbali/pympress}{Pympress} 是一个类似于 PowerPoint -演示者视图的阅读器，在导言区添加 +演示者视图的阅读器。在导言区添加 \begin{verbatim} \setbeameroption{show notes on second screen} \end{verbatim} -以展示备注幻灯片（幻灯片内使用 \texttt{\textbackslash{}note} 标记备注内容）于每页右侧。使用该软件以自动地识别备注区域展示在演示者屏幕上。 +以展示备注幻灯片（幻灯片内使用 \cmd{note} 标记备注内容）于每页右侧。使用该软件以自动地识别备注区域展示在演示者屏幕上。 + +\begin{figure}[h] + \centering + \includegraphics[width=0.7\textwidth]{tutorial/stepdual.pdf}\\ + 放映视图\hspace{6em}演示者视图 +\end{figure} + \part{进阶操作} @@ -355,9 +379,9 @@ \section{文字强调} \beamerdemo[1]{step10.tex} \begin{commentlist} - \item \texttt{\textbackslash{}alert} 会改变文字颜色为主题色。\texttt{\textbackslash{}emph} 会改变文字颜色的同时，还会将英文字体变为斜体$^*$。 - \item \texttt{\textbackslash{}paragraph} 和 \texttt{\textbackslash{}highlight} 都会在文字底部添加纯色方块$^*$，区别在于后者可以设置背景颜色。 - \item \texttt{\textbackslash{}stamptext} 可以用于生成以印记形为底的高亮小块$^*$，需要将高亮的文字数目控制在一个中文字或两个英文字。 + \item \cmd{alert} 会改变文字颜色为主题色。\cmd{emph} 会改变文字颜色的同时，还会将英文字体变为斜体$^*$。 + \item \cmd{paragraph} 和 \cmd{highlight} 都会在文字底部添加纯色方块$^*$，区别在于后者可以设置背景颜色。 + \item \cmd{stamptext} 可以用于生成以印记形为底的高亮小块$^*$，需要将高亮的文字数目控制在一个中文字或两个英文字。 \end{commentlist} \section{区块强调} @@ -382,7 +406,7 @@ \chapter{代码} \begin{commentlist} \item \texttt{codeblock} 提供了带行号的代码抄录环境$^*$，第一个可选参数可以用于设置语言与其他抄录选项，第二个必选参数可以设置代码块的标题。 \item 需要清理抄录代码在源文件中的缩进，顶格输入。如果想高亮某一行$^*$，设置 \verb"escapechar=|" 可选参数后，在该行开头顶格输入 \verb"|\highlightline|"。 - \item 你也可以直接使用 \texttt{\textbackslash{}codeblockinput}[选项]\{标题\}\{文件\} 用于抄录外部文件$^*$，但请通过 \verb"firstline" 和 \verb"lastline" 选项控制代码行数。 + \item 你也可以直接使用 \cmd{codeblockinput}[选项]\{标题\}\{文件\} 用于抄录外部文件$^*$，但请通过 \verb"firstline" 和 \verb"lastline" 选项控制代码行数。 \item 直接使用 \texttt{listings} 宏包提供的 \texttt{lstlisting} 环境与 \texttt{lstinputlisting} 命令依然可行，\themename\ 已经对其进行了一些预先的优化。 \item[\faExclamationTriangle] 使用代码块的页其 \texttt{frame} 环境必须添加 \texttt{fragile} 参数。 \end{commentlist} @@ -399,8 +423,8 @@ \section{Biber} \beamerdemo[1]{step14+-.tex} \begin{commentlist} - \item 使用 \texttt{\textbackslash{}footnote} 可以添加脚注。 - \item 使用 \texttt{\textbackslash{}footfullcite} 进行脚注引用（\texttt{biblatex} 提供的命令）。 + \item 使用 \cmd{footnote} 可以添加脚注。 + \item 使用 \cmd{footfullcite} 进行脚注引用（\texttt{biblatex} 提供的命令）。 \end{commentlist} \section{Bib\TeX{}} @@ -411,6 +435,7 @@ \section{Bib\TeX{}} \begin{commentlist} \item 对帧使用 \verb"allowframebreaks" 参数可以对过长的内容自动换页。 + \item Bib\TeX{} 的个性化样式并没有 \textsc{Biber} 丰富，如果可以使用 \hologo{XeLaTeX} 编译的情况下，尽可能使用 \textsc{Biber}。 \end{commentlist} \section{手动输入} @@ -420,10 +445,10 @@ \section{手动输入} \beamerdemo[1]{step16+-.tex} \begin{commentlist} - \item \LaTeX{} 本身提供了 \texttt{thebibliography} 环境，环境的强制参数用于指定排版最长的标签（这里是两位数占位符），配套 \texttt{\textbackslash{}bibitem[标签]\{主键\}}，在 \texttt{beamer} 中需要辅以 \texttt{\textbackslash{}newblock} 来分隔作者、文章标题、书目与其他内容。这里的主键可以在正文中引用。 + \item \LaTeX{} 本身提供了 \texttt{thebibliography} 环境，环境的强制参数用于指定排版最长的标签（这里是两位数占位符），配套 \cmd{bibitem[标签]\{主键\}}，在 \texttt{beamer} 中需要辅以 \cmd{newblock} 来分隔作者、文章标题、书目与其他内容。这里的主键可以在正文中引用。 \item 在 \texttt{beamer} 中可以通过设定 \texttt{bibliography item} 模板为对应预设来更改图标，这里是 \texttt{text} 预设用于排印编号。也可以改为文章图标 \texttt{article}，图书图标 \texttt{book} 或网络图标 \texttt{online} 等。 - \item 引入 \texttt{bibliolist} 环境$^*$以避免使用 \texttt{\textbackslash{}bibitem} 命令，对于每一条引用添加对应的 \texttt{\textbackslash{}articleitem}, \texttt{\textbackslash{}bookitem}, \texttt{\textbackslash{}onlineitem} 用于切换不同的图标$^*$，并保持与 \texttt{\textbackslash{}bibitem} 相同的用法（除了不能设定引用标签）。 - \item 在 \texttt{bibliolist} 环境中也可以直接使用 \texttt{\textbackslash{}item} 以不使用 \texttt{\textbackslash{}newblock} 来分割条目中的不同部分，正如 \textsc{SJTUThesis} 所做的那样。但请不要与上一条中的图标命令混用。 + \item 引入 \texttt{bibliolist} 环境$^*$以避免使用 \cmd{bibitem} 命令，对于每一条引用添加对应的 \cmd{articleitem}, \cmd{bookitem}, \cmd{onlineitem} 用于切换不同的图标$^*$，并保持与 \cmd{bibitem} 相同的用法（除了不能设定引用标签）。 + \item 在 \texttt{bibliolist} 环境中也可以直接使用 \cmd{item} 以不使用 \cmd{newblock} 来分割条目中的不同部分，正如 \textsc{SJTUThesis} 所做的那样。但请不要与上一条中的图标命令混用。 \end{commentlist} \chapter{图表} @@ -462,6 +487,10 @@ \section{缓存} \item[\faExclamationTriangle] 如果使用的是 Overleaf 这种在线 \LaTeX\ 编译器，您必须要在主文档内使用 \verb"\tikzexternalize[prefix=build/]" 命令，并且要在同级目录下新建 \verb"build/" 文件夹，其中应该还有一个占位文档（比如 \verb".gitkeep"）。可参见 \href{https://www.overleaf.com/learn/latex/Questions/I_have_a_lot_of_tikz%2C_matlab2tikz_or_pgfplots_figures%2C_so_I%27m_getting_a_compilation_timeout._Can_I_externalise_my_figures%3F}{相关说明}。 \end{commentlist} +\section{独立编译} + +还可以配合 \cls{standalone} 文档类对 Ti\emph{k}Z 文档独立编译，在使用时直接插入。这种方法需要做好一定的项目管理。 + % TODO: 以后的开发计划：Smart Diagram %\chapter{插图} @@ -490,8 +519,8 @@ \chapter{徽标} \beamerdemo[1]{step20.tex} \begin{commentlist} - \item 使用 \texttt{\textbackslash{}logo} 设定徽标。在主题处使用 \verb"topright" 或 \verb"bottomright" 选项强制指定徽标的位置为右上角（\verb"max"默认）或左下角（\verb"maxplus" 和 \verb"min"）。 - \item 可以使用自定义的徽标，可以使用外部图片，或参见\href{run:sjtubeamerdevguide.pdf}{开发指南}第 3.4 节创造可变颜色徽标$^*$。后者可以采用可选参数改变颜色，比如 \texttt{\textbackslash{}zhlogo[cprimary]}。 + \item 使用 \cmd{logo} 设定徽标。在主题处使用 \verb"topright" 或 \verb"bottomright" 选项强制指定徽标的位置为右上角（\verb"max"默认）或左下角（\verb"maxplus" 和 \verb"min"）。 + \item 可以使用自定义的徽标，可以使用外部图片，或参见\href{run:sjtubeamerdevguide.pdf}{开发指南}第 3.4 节创造可变颜色徽标$^*$。后者可以采用可选参数改变颜色，比如 \cmd{zhlogo[cprimary]}。 \end{commentlist} \chapter{头图} @@ -501,7 +530,7 @@ \chapter{头图} \beamerdemo[1]{step21.tex} \begin{commentlist} - \item 使用 \texttt{\textbackslash{}titlegraphic} 设定头图，需要在封面图输出前进行赋值。 + \item 使用 \cmd{titlegraphic} 设定头图，需要在封面图输出前进行赋值。 \item 每个主题的头图位置不同，特别要注意默认的 \texttt{max} 主题的头图是淡色背景图。 \item 对头图可以不设定大小，因为会自动填满占位符。 \end{commentlist} @@ -513,9 +542,9 @@ \chapter{背景} \beamerdemo[1]{step22.tex} \begin{commentlist} - \item \texttt{\textbackslash{}setbeamertemplate\{background\}\{\}} 可以设定背景图。如果设定为空，将会清除现在已经设定的背景图。请在主题加载完成后设定。 - \item \texttt{\textbackslash{}stamparray} 可以用于生成印记矩阵。$^*$ - \item \texttt{\textbackslash{}bgcenterbox} 命令可以用于居中背景图。$^*$ + \item \cmd{setbeamertemplate\{background\}\{\}} 可以设定背景图。如果设定为空，将会清除现在已经设定的背景图。请在主题加载完成后设定。 + \item \cmd{stamparray} 可以用于生成印记矩阵。$^*$ + \item \cmd{bgcenterbox} 命令可以用于居中背景图。$^*$ \item 作为文字的背景，其透明度应该较低或者颜色偏淡。 \end{commentlist} @@ -532,8 +561,8 @@ \section{样式} \examplecode{my.sty} \begin{commentlist} - \item 使用 \texttt{\textbackslash{}definecolor} 定义 \texttt{cprimary}、\texttt{csecondary}$^*$ 可以改变主题颜色。 - \item 使用 \texttt{\textbackslash{}setbeamertemplate} 可以直接设置对应的标题页、结束页、节次页等为已经定义的模板。 + \item 使用 \cmd{definecolor} 定义 \texttt{cprimary}、\texttt{csecondary}$^*$ 可以改变主题颜色。 + \item 使用 \cmd{setbeamertemplate} 可以直接设置对应的标题页、结束页、节次页等为已经定义的模板。 \item 更多设置请参见\href{run:sjtubeamerdevguide.pdf}{开发文档}第4.3节。 \end{commentlist} @@ -584,6 +613,7 @@ \section{迁移到其他主题} 我们更加推荐在本模板的基础上进行自定义修正来达到类似更换主题的效果（比如高级操作部分提到的方法）。 +关于 \themename{} 的讲座提供了一个 \href{https://github.com/sjtug/sjtulib-latex-talk/blob/logcreative-2022/beamerthemenosjtubeamer.sty}{\cls{nosjtubeamer}} 主题用于将这些命令重定向到普通的样式上，修改该样式文件以满足迁移需求。 \chapter{贡献} diff --git a/src/source/beamercolorthemesjtubeamer.dtx b/src/source/beamercolorthemesjtubeamer.dtx index 39a38eff..12725f0b 100644 --- a/src/source/beamercolorthemesjtubeamer.dtx +++ b/src/source/beamercolorthemesjtubeamer.dtx @@ -16,7 +16,7 @@ % \iffalse %<*package> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamercolorthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer color theme] +\ProvidesPackage{beamercolorthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer color theme] % % \fi % \CheckSum{0} diff --git a/src/source/beamerfontthemesjtubeamer.dtx b/src/source/beamerfontthemesjtubeamer.dtx index e82d0b42..1be2280b 100644 --- a/src/source/beamerfontthemesjtubeamer.dtx +++ b/src/source/beamerfontthemesjtubeamer.dtx @@ -16,7 +16,7 @@ % \iffalse %<*package> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerfontthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer font theme] +\ProvidesPackage{beamerfontthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer font theme] % % \fi % \CheckSum{0} diff --git a/src/source/beamerinnerthemesjtubeamer.dtx b/src/source/beamerinnerthemesjtubeamer.dtx index f0d1111a..116ce6e1 100644 --- a/src/source/beamerinnerthemesjtubeamer.dtx +++ b/src/source/beamerinnerthemesjtubeamer.dtx @@ -16,7 +16,7 @@ % \iffalse %<*package> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerinnerthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer inner theme] +\ProvidesPackage{beamerinnerthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer inner theme] % % \fi % \CheckSum{0} diff --git a/src/source/beamerouterthemesjtubeamer.dtx b/src/source/beamerouterthemesjtubeamer.dtx index 369f01ae..704d46a5 100644 --- a/src/source/beamerouterthemesjtubeamer.dtx +++ b/src/source/beamerouterthemesjtubeamer.dtx @@ -16,7 +16,7 @@ % \iffalse %<*package> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerouterthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer outer theme] +\ProvidesPackage{beamerouterthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer outer theme] % % \fi % \CheckSum{0} diff --git a/src/source/beamerthemesjtubeamer.dtx b/src/source/beamerthemesjtubeamer.dtx index bf46c650..f17133a2 100644 --- a/src/source/beamerthemesjtubeamer.dtx +++ b/src/source/beamerthemesjtubeamer.dtx @@ -37,7 +37,7 @@ % ------------------------------------------------------------------- \fi % \iffalse \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{beamerthemesjtubeamer}[2022/05/10 v2.7.3 sjtubeamer parent theme] +\ProvidesPackage{beamerthemesjtubeamer}[2022/05/11 v2.8.0 sjtubeamer parent theme] % \fi % % \subsection{Parent Theme} diff --git a/src/source/sjtucover.dtx b/src/source/sjtucover.dtx index d610c102..233412d2 100644 --- a/src/source/sjtucover.dtx +++ b/src/source/sjtucover.dtx @@ -13,7 +13,7 @@ % \iffalse %<*package> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{sjtucover}[2022/05/10 v2.7.3 cover library for sjtubeamer] +\ProvidesPackage{sjtucover}[2022/05/11 v2.8.0 cover library for sjtubeamer] % % \fi % \CheckSum{0} diff --git a/src/source/sjtuvi.dtx b/src/source/sjtuvi.dtx index 70141a25..a924dfee 100644 --- a/src/source/sjtuvi.dtx +++ b/src/source/sjtuvi.dtx @@ -13,7 +13,7 @@ % \iffalse %<*package> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{sjtuvi}[2022/05/10 v2.7.3 Visual Identity System library for sjtubeamer] +\ProvidesPackage{sjtuvi}[2022/05/11 v2.8.0 Visual Identity System library for sjtubeamer] % % \fi % \CheckSum{0} diff --git a/src/support/beamerthemenosjtubeamer.sty b/src/support/beamerthemenosjtubeamer.sty new file mode 100644 index 00000000..5414fbd8 --- /dev/null +++ b/src/support/beamerthemenosjtubeamer.sty @@ -0,0 +1,27 @@ +%% If you don't use SJTUBeamer theme, +%% Use this theme and redirect the macros to dummy ones. +%% What's more, you need to use XeLaTeX to compile. + +\usepackage{listingsutf8} +\lstset{columns=flexible} +\lstnewenvironment{codeblock}[2][]{\lstset{title=#2,#1}}{} +\newcommand<>{\highlightline}{} +\newcommand{\highlight}[2][]{\alert{#2}} +\newcommand{\paragraph}[1]{\bfseries #1\hspace{.5em}} +\usepackage{tikz} +\newcommand{\stamptext}[1][red]{#1} +\newenvironment{stampbox}[1][]{}{} +\newcommand{\makebottom}{ + \begin{frame} + \begin{center} + \Huge + Thank You! + \end{center} + \end{frame} +} +\newcommand{\stamparray}[3]{} +\newenvironment{bibliolist}[1]{\begin{thebibliography}{#1}}{\end{thebibliography}} +\newcommand{\articleitem}{\item} +\newcommand{\bookitem}{\item} +\newcommand{\onlineitem}{\item} +\newenvironment{shadedsection}{}{} \ No newline at end of file diff --git a/src/support/tutorial/step7s.tex b/src/support/tutorial/step7s.tex new file mode 100644 index 00000000..6678f497 --- /dev/null +++ b/src/support/tutorial/step7s.tex @@ -0,0 +1,11 @@ +\documentclass{ctexbeamer} +\usetheme{sjtubeamer} +\begin{document} +\setbeamertemplate{sectioning pages}[maxplus] +\part{maxplus} +\setbeamertemplate{sectioning pages}[max] +\part{max} +\setbeamertemplate{sectioning pages}[min] +\setbeamertemplate{background}{} +\part{min} +\end{document} \ No newline at end of file diff --git a/src/support/tutorial/stepdual.tex b/src/support/tutorial/stepdual.tex new file mode 100644 index 00000000..7bf9ad18 --- /dev/null +++ b/src/support/tutorial/stepdual.tex @@ -0,0 +1,14 @@ +\documentclass{ctexbeamer} +\usetheme{sjtubeamer} +\setbeameroption{show notes on second screen} +\begin{document} +\title{讲座} +\section{节} +\subsection{小节} +\begin{frame} + \frametitle{含有备注} + 这一页有一些备注。 + \note[item]{第一个备注。} + \note[item]{第二个备注。} +\end{frame} +\end{document} \ No newline at end of file