hnuexam - version 5.0.cls

\NeedsTeXFormat{LaTeX2e}
%The command \NeedsTeXFormat{LaTeX2e} sets the LATEX version for the class to work. Additionally, a date can be added within brackets to specify the minimal release date required.
\ProvidesClass{hnuexam}[2019/12/15 HengYang Normal University Exam Document Class]
%2019/05/27 version 1.1 能自己用，但编译慢
%2019/06/15 version 1.2
%2019/09/29 version 1.3 （迟到）国庆节前完成可用的初稿
%2019/10/7  version 2.0 将抬头的表格自动生成，采用LaTeX3方式。
%2019/10/17 version 2.1 将\makepart{}[]{}命令写成了可选参数形式
%2019/12/15 version 3.0 将试卷前面的信息有些字体加粗了,判断题设置为括号且放置在最前面。
%2019/12/19 version 3.1 将不连续题序标号为新的一个文件，可按照需要选择不同的文件模拟来出题。
%2021/01/03 version 4.0 加入装订线
%2021/06/27 version 4.1 将表格中的阿拉伯数字替换成中文的
%2022/04/22 version 5.0 加入课程目标
%The command ProvidesClass{exampleclass}[...] identifies this class as exampleclass and, inside the brackets, the release date and some additional information is included. The date should be in the form YYYY/MM/DD

\LoadClass{exam}
\RequirePackage{amsmath,amssymb,amsthm}	%美国数学学会系列
\RequirePackage{mathtools}	%amsmath增强包
\RequirePackage{tikz}	%tikz用于画图包
\RequirePackage{xeCJK,zhnumber} %支持中文，中文数字包
\RequirePackage{geometry}	%设置页边距等
\RequirePackage{indentfirst}	%设置首段缩进
\RequirePackage{xhfill,xcolor}	%评分标准右对齐，颜色包
\RequirePackage{expl3,xparse}	%LaTeX3
\RequirePackage{etoolbox,xinttools,xfp,totcount} %一些有用的宏包
\RequirePackage{multirow,makecell,tabu,diagbox,ragged2e} %表格包，表格多行合并包
\RequirePackage{bbding,pifont}	%对错符号包
\RequirePackage{siunitx} % 国际单位制宏包（典型的一个LaTeX3实现的宏包）
\RequirePackage{nicematrix,extarrows,enumerate} % 增广矩阵等矩阵扩展
\RequirePackage{bm}%加粗包
%\RequirePackage is very similar to the well-known \usepackage

\DeclareOption{answer}{\printanswers}
\DeclareOption{addtable}{\addpoints}
%The command \DeclareOption{}{} handles a given option. It takes two parameters, the first one is the name of the option and the second one is the code to execute if the option is passed.
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
%\PassOptionsToClass{}{}. Passes the option inside the first pair of braces to the document class set inside the second pair of braces. 

\PassOptionsToPackage{tbtags}{amsmath}
\ProcessOptions\relax
%The command \ProcessOptions\relax executes the code fore each option and must be inserted after all the option-handling commands were typed. There's a starred version of this command that will execute the options in the exact order specified by the calling commands.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%宏包前言%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


%%%%%%%%%%%%%%%%%%%%%%%%%%%中英文字体设置%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% 中文字体设置
\setCJKfamilyfont{zhsong}[AutoFakeBold = {2.17}]{SimSun}
% 以上设置可以实现宋体加粗不了的问题~
\newcommand*{\songti}{\CJKfamily{zhsong}}
\newCJKfontfamily[hei]\heiti{SimHei}
% 英文字体设置
% 设置英文主字体
\setmainfont{Times New Roman}
% 设置英文无衬线字体
\setsansfont{Arial}
% 定义默认字体大小和行距
\renewcommand{\normalsize}{\fontsize{12pt}{\baselineskip}\selectfont}
% 其它比较常见的字体字号设置
\newcommand{\chuhao}{\fontsize{42pt}{\baselineskip}\selectfont}
\newcommand{\xiaochuhao}{\fontsize{36pt}{\baselineskip}\selectfont}
\newcommand{\yihao}{\fontsize{28pt}{\baselineskip}\selectfont}
\newcommand{\erhao}{\fontsize{21pt}{\baselineskip}\selectfont}
\newcommand{\xiaoerhao}{\fontsize{18pt}{\baselineskip}\selectfont}
\newcommand{\sanhao}{\fontsize{15.75pt}{\baselineskip}\selectfont}
\newcommand{\sihao}{\fontsize{14pt}{\baselineskip}\selectfont}
\newcommand{\xiaosihao}{\fontsize{12pt}{\baselineskip}\selectfont}
\newcommand{\wuhao}{\fontsize{10.5pt}{\baselineskip}\selectfont}
\newcommand{\xiaowuhao}{\fontsize{9pt}{\baselineskip}\selectfont}
\newcommand{\liuhao}{\fontsize{7.875pt}{\baselineskip}\selectfont}
\newcommand{\qihao}{\fontsize{5.25pt}{\baselineskip}\selectfont}


% 试卷纸张设置，16开的纸（两页合成一个大页的方式）
\geometry{paperheight=270mm,paperwidth=195mm} 
% 设置试卷的页眉页脚与页边距的距离
\geometry{vmargin={1.5cm,2cm},footskip=0.5cm,marginparsep=0.5cm}
\geometry{inner=2cm,outer=1cm}

% 设置首行缩进
\setlength{\parindent}{0em}

% 重新设置表格放缩为2
\renewcommand\arraystretch{2}

% 新版装订线
\reversemarginpar
\newsavebox{\zdx}%装订线

\newcommand{\putzdx}{\marginpar{
	\rotatebox{90}{\usebox{\zdx}}
	}
}

\AtBeginDocument{%
	\sbox{\zdx}{
		\parbox{\paperheight}{
			\begin{center}
				\mbox{}\quad\quad 学院 \underline{\hspace{15ex}} \quad
				专业 \underline{\hspace{15ex}} \quad
				班级 \underline{\hspace{15ex}} \quad
				学号 \underline{\hspace{15ex}} \quad
				姓名 \underline{\hspace{15ex}} \quad\\
				\vspace{1mm}
				\dotfill{} 密 \dotfill{} 封 \dotfill{} 线 \dotfill{}
			\end{center}%
		}%
	}%
	\putzdx%
}

% 打印右边学生信息命令
\newcommand{\studentTable}{%
  \smash{\makebox[0pt][r]{%
  	\wuhao\songti\textbf{% 五号宋体加粗
    \begin{tabular}[t]{|p{2cm}<{\centering}|}
    \multicolumn{1}{c}{} \\[2in] % lower the box
    \hline
    学\hfil 院\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    专\hfil 业\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    班\hfil 级\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    学\hfil 号\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    姓\hfil 名\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    \end{tabular}\hspace{0.5em} 
    \normalsize
  }}}%
  \gdef\studentTable{}%
}

% 打印右边学生信息命令
\newcommand{\NstudentTable}{%
  \smash{\makebox[0pt][r]{%
  	\wuhao\songti\textbf{% 五号宋体加粗
    \begin{tabular}[t]{|p{2cm}<{\centering}|}
    \multicolumn{1}{c}{} \\[2in] % lower the box
    \hline
    系\hfil 别\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    专\hfil 业\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    班\hfil 级\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    学\hfil 号\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    姓\hfil 名\\
    \hline
    \\[2\normalbaselineskip]
    \hline
    \end{tabular}\hspace{0.5em} 
    \normalsize
  }}}%
  \gdef\NstudentTable{}%
}


% 衡阳师范学院试卷开头信息
\newcommand{\examinformation}[5]{%
	\begin{center}%
		{\fontsize{18pt}{2\baselineskip}\selectfont\heiti\bfseries #1\\\vspace{0.5ex}
			#2\\\vspace{0.5ex}
			#3\\
			\ifprintanswers
				参考答案及评分标准\\
			\fi
			\vspace{0.2em}			
		}{\wuhao\songti
		考核类型:~#4\hspace{1cm}考核时量：#5~分钟%
		}
	\end{center}
}

% 定义大题、总分计数器并初始化为0
\newtotcounter{examSection}	% 一共有几个大题的计数器
\newtotcounter{sumpoints}	% 总分计数器

%%%%%%%%%%%%%%%%%%%%%%%%% LaTeX3 部分
% 开启LaTeX3语法
\ExplSyntaxOn
\clist_new:N \g_grades_clist	% 
\clist_new:N \g_grades_aux_clist	%  


%% 开始一个大题的命令
\str_set:Nn \g_tmpa_str{判断题}	%如果是判断题，添加一些文字描述，打勾或打叉！！
\NewDocumentCommand{\makepart}{ m o m }{
  % 使用举例 \makepart{选择题}[3]{15}
  % #1：题型，如“选择题”
  % #2：当分值一样时，每小题多少分，是可选参数，使用方括号。如果每小题的分值不同，则这个参数省略。
  % #3：这个大题的总分是多少，显示写出来，没有使用自动计算。 
  \setcounter{question}{0}
  \stepcounter{examSection} % 每开始一个大题，将大题计数器加一
  \addtocounter{sumpoints}{#3}  % 统计总分
	% 由于要在开头展示出每个大题的总分，所以需要将每个大题的总分写出辅助文件，我们采用的方式是先写入到一个“列表”这样的数据结构中。最后在文档结束时，写入辅助文件。
  \__add_to_grades_list:n  { #3 }	% 将参数3的分值加到\g_grades_clist这个列表变量右边去。
  % exam文档类中定义的EnvFullwidth环境
  \str_set:Nn \g_tmpb_str{#1}	% 将大题的题型置入LaTeX3系统自带的临时变量里。
  
  %%%%%%%%%%%%%%%%% 以上是前期准备
  %%%%%%%%%%%%%%%%% 以下是正式输出大题题头：
	\begin{EnvFullwidth}
		\sihao	% 四号字体
		\renewcommand\arraystretch{2} % 表格缩放1.3倍
		\begin{tabular}{|c|c|c}
			\cline{1-2}
			得分 & \phantom{100} & {\heiti\bfseries\zhnum{examSection}、#1(
			\str_if_eq:NNTF{\g_tmpa_str}{\g_tmpb_str}{正确打\cmark，错误打\xmark，}{}% 通过判定是不是判断题来决定是不是多输出一些文字。
			\IfNoValueF {#2} {每小题~#2~分，} 共~#3~分)} \\% 判断是否每个题分值一样，通过看是否有可选参数来实现~
			\cline{1-2}
		\end{tabular}
		\normalsize	% 将字体变成默认的
		\vspace{0.5em}	% 下面留白一点点
	\end{EnvFullwidth}
}% \makepart{}[]{}命令结束

% 在新增一个大题时将这个大题的总分写入\g_grades_clist这个列表数据结构变量
\cs_new:Nn \__add_to_grades_list:n {
  \clist_gput_right:Nx \g_grades_clist { #1 }	
  % 第四大题时会产生这样的效果(15,15,10)->(15,15,10,60)
}
% 按题型打印表格（目前的实现方式是一定要有表格，可以修改为不一定要有表格）
\NewDocumentCommand{\sectiongradetable}{}{
    \if@addpoints
        \@ifundefined{exam@numpoints}{%
                \ClassWarning{exam}{%
                    You~must~run~LaTeX~again~to~produce~the~table.\MessageBreak
                }%
                \fbox{Please Run \LaTeX{} again to produce the table}%
             }%
            {\constructionTable}%
    \else
        \ClassError{exam}{%
              You must give the command \protect\addpoints\MessageBreak
              \space\space in order to create a grade table.\MessageBreak
          }{%
              If you don't give the command \protect\addpoints\MessageBreak
              \space\space then we're not keeping track of point values.
              \MessageBreak
          }%
  \fi
}


% 新建这个与大题分数列表相关的命令，在第二次运行时由于将执行命令定入了辅助文件，所以第二次会执行
\NewDocumentCommand\SetGradeList{m}{	% set grade list from the aux file
	\clist_gset:Nn \g_grades_aux_clist {#1}
}

% 写入辅助文件，在结束文档时写入
\AtEndDocument{
  \iow_now:cx { @auxout } {	%LaTeX3的读写文件的函数
	\token_to_str:N \SetGradeList { \g_grades_clist  } ^^J
	% ^^J表示一个回车。
  }
}

% 实际输出表格的命令，使用xinittools包来循环
\NewDocumentCommand{\constructionTable}{}{
	\fontsize{10.5pt}{1.5\baselineskip}\selectfont %表格内文字字体设置
	\renewcommand\arraystretch{1.5}
	\begin{table}[h]	%表格输入实体部分，可以不用浮动体，用h表示强制要放在抬头部分
		\centering
		{\heiti\bfseries\begin{tabular}{|*{\inteval{2+\totvalue{examSection}}}{p{1.5cm}<{\centering}|}}
			\hline
			题\quad 号 \xintFor* ##1 in {\xintSeq {1}{\totvalue{examSection}}} \do {&\,\zhnumber{##1}\,} & 总分\\
			\hline
			分\quad 值 \xintFor ##1 in  \g_grades_aux_clist \do {& ##1} & \total{sumpoints}\\
			\cline{1-\inteval{2+\totvalue{examSection}}}
			得\quad 分  \xintFor* ##1 in {\xintSeq {1}{\inteval{1+\totvalue{examSection}}}} \do{&}\\
			\hline
		\end{tabular}}
	\end{table}
	\normalsize	%恢复默认字体设置
	\renewcommand\arraystretch{1}
}


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% 一个实际的表格的样子
% \begin{tabular}{|c|c|c|c|c|c|}
% 	\hline
% 	题 号 & 一 & 二 & 三 & 四 & 总分 \\
% 	\hline
% 	分 值 & 15 & 15 & 10 & 60 & 100\\
% 	\cline{1-6}
% 	得 分 &    &    &    &    & \\
% 	\hline
% \end{tabular}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%



%%% 判断题（按是不是设置了答案选项来执行）
\NewDocumentCommand{\tfblank}{}{(\qquad)}	%正式试卷的判断题输出
\NewDocumentCommand{\tfans}{m}{(#1)}	%参考答案的判断题输出	
\NewDocumentCommand {\torf} { o }{
	\IfNoValueTF {#1}
	{\tfblank}
	{ 
		\ifprintanswers
			\tfans{#1}
		\else
			\tfblank
		\fi
	}
}
%%% 选择题右对齐的括号
\newlength\mylen
\settowidth\mylen{\qquad}
\NewDocumentCommand{\chblank}{}{\hfill (\qquad)}
\NewDocumentCommand{\chans}{m}{\hfill (\makebox[\mylen]{#1})}
\NewDocumentCommand {\chABCD} { o }{
	\IfNoValueTF {#1}
	{\chblank}
	{ 
		\ifprintanswers
			\chans{#1}
		\else
			\chblank
		\fi
	}
}
\ExplSyntaxOff
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LaTeX3部分结束

% 表，分，页等中文个性化输出
\renewcommand{\tablename}{表}
\pointname{分}
\renewcommand{\thepartno}{\Roman{partno}}
\cfoot{第\thepage~页~,~共\numpages~页}
\renewcommand{\solutiontitle}{\noindent\textbf{解:}\noindent}


\newcommand{\cdotfill}{\leavevmode\xleaders\hbox to 0.5em{\hss$\cdot$\hss}\hfill\kern0pt\relax}
% 显示分数
\newcommand{\myscore}[1]{\textcolor{blue}{#1\kern0.2em 分}}
% 非数学环境使用此文本环境输出评分标准
\newcommand{\scoretext}[1]{\cdotfill\myscore{#1}\par\noindent\ignorespaces }
% 数学环境使用此输出评分标准
\newcommand{\scoreeqno}[1]{\eqno{\cdots\cdots\text{\myscore{#1}}}}
\newcommand{\scoretag}[1]{\tag*{$\cdots\cdots$\myscore{#1}}}
\newrobustcmd{\score}[1]{%
  \ifbool{mmode}{%
    \ifdefstrequal{\tag}{\dft@tag}{\scoreeqno{#1}}{\scoretag{#1}}%
  }{%
    \scoretext{#1}%
  }%
}


% 判断题的答案输出（exam包自带的方式，以修改为上面的。）
\newcommand{\tf}[1][{}]{%
\fillin[#1][0.25in]%
}


% 定义输出大小写罗马数字的命令
\newcommand{\rmnum}[1]{\romannumeral #1}
\newcommand{\Rmnum}[1]{\expandafter\@slowromancap\romannumeral #1@}

% 重定义勾叉符号
\newcommand{\cmark}{\ding{51}}%
\newcommand{\xmark}{\ding{55}}%



% 答案显示相关
\shadedsolutions %设置答案显示在阴影区域
\definecolor{SolutionColor}{rgb}{0.8,0.9,1} % 设置阴影的颜色

% |v|,绝对值 ，范数等符号（利用mathtools宏包构造）
\DeclarePairedDelimiter\abs{\lvert}{\rvert}
%\DeclarePairedDelimiter\norm{\lVert}{\rVert}
\DeclarePairedDelimiterX\norm[1]\lVert\rVert{
\ifblank{#1}{\:\cdot\:}{#1}
}
\DeclarePairedDelimiterX\innerp[2]{\langle}{\rangle}{#1,#2}

% 定义数学符号
\DeclareMathOperator{\Pro}{Pro}
\DeclareMathOperator{\Corr}{\rho}
\DeclareMathOperator{\Cov}{Cov}
\DeclareMathOperator{\grad}{grad}
\DeclareMathOperator{\Prj}{Prj}
\DeclareMathOperator{\Var}{Var}

% 向量相关的简写命令（参考自jnu）
\newcommand{\va}{\vec{a}}
\newcommand{\vb}{\vec{b}}
\newcommand{\vc}{\vec{c}}
\newcommand{\vd}{\vec{d}}
\newcommand{\ve}{\vec{e}}
\newcommand{\vi}{\vec{i}}
\newcommand{\vj}{\vec{j}}
\newcommand{\vk}{\vec{k}}
\newcommand{\vn}{\vec{n}}
\newcommand{\vs}{\vec{s}}
\newcommand{\vv}{\vec{v}}
\newcommand\vect[1]{\bm{#1}}
\let\ov=\overrightarrow

% 课程目标指示器
\newcounter{counterindex} 
\setcounter{counterindex}{1}
\newcommand{\qnum}{\zhnum{counterindex}、\addtocounter{counterindex}{1}}