Introduction

This template is primarily designed to help Chinese university, primary, middle and high school teachers or students in creating exams or handouts.

Usage

#import "@preview/ezexam:0.2.2": *
#show: setup.with(
  mode: EXAM,
  paper: a3,
  font: ROMAN
)

#title[XX试卷]

= 选择
#question[
  $(1 + 5i)i$ 的虚部为 #paren[]
  #choices([$-1$], [$0$], [$1$], [$6$])
]

......

= 填空
#question[
  一个箱子里有 5 个球，分别以 1$~$5 标号，若有放回取三次，记至少取出一次的球的个数 $X$，则 $E(X) =$#fillin[].
]

......

= 解答题
#question(points: 15)[
  设数列 ${a_n}$ 满足 $a_1 = 3"， "a_(n+1) / n = a_n / (n+1) + 1 / (n(n+1))$.
  + 证明：${n a_n}$ 为等差数列；
  + 设 $f(x) = a_1x + a_2x^2 + dots.c + a_m x^m，求 f'(-2)$.
]

......

more details see Online Documentation

Changelog

0 . 2 . 2

• 调整正文默认字体，由原来的 Source Han Serif 修改为 Noto Serif SC 、 Noto Serif CJK SC （二者效果一样，主要是后者压缩后更小，方便上传网盘进行安装）。黑体添加 Noto Sans SC 和 Noto Sans CJK SC ；修复在 typst app 中应用模板时，字体显示的问题
• 添加常量 ROMAN ，方便修改字体为新罗马风格的字体，更加符合常见的试卷排版格式
• 调整代码逻辑，使得在字体调整时，其它所有西文字体统一进行修改
• 精简 setup 方法的参数，删除 font-math ；使用 font 参数即可完成正文字体和西文字体的设置
• 调整 π 在罗马字体下显示的样式
• 修改平行符号为倾斜
• 修复 choices 某个选项有多行时，后续行的缩进和第一行不一致的bug
• 重写 fillin 方法， 实现根据长度生成空线，并根据长度自动换行
• 修复 subject 方法以字符串传入时的bug
• 优化题号和题干之间的间距

0 . 2 . 1

• 修复试卷模式下，生成 pdf 后的书签会显示题目大标题的问题，确保只显示章节
• 西文字体新增 Times New Roman 字体风格；前提是安装了 STIX 2 系列字体。如未安装则默认使用 New Computer Modern Math
• 优化代码

0 . 2 . 0

• 添加 cover 方法；该方法可以生成一个封面。上个版本忘记添加进去了（🤡）
• 添加 underdot 方法；在一些场景下，可以为文本添加着重号

0 . 1 . 9

• 优化 text-figure 方法；考虑到文本内容较多，为了书写方便，将参数 text 修改为位置参数；新增参数 figure 、style 、gap
• 优化 question 方法；修复当一个文档中组多套试卷时，会报警告的问题
• 优化 title 、score-box 、scoring-box 方法
• 优化代码

0 . 1 . 8

• 为 mode 添加新值 SOLUTION，当答案解析独立于试题存在时，使用此值可快速统一格式
• 优化 choices 方法；将其参数 column 更名为 columns，做到和官方的 columns 参数一致
• 废弃 inline-square 方法，推荐使用内置的 table 方法
• 修复 color-box 方法报错的 bug
• 优化 secret 、zh-arabic 方法
• 优化 question 的编号实现方式；修改 setup 方法的参数 enum-numbering 的默认值为 （1.i.a）
• 优化 notice 方法；新增参数 indent 、hanging-indent

0 . 1 . 7

• 优化代码，确保 heading-size 只修改一级标题；并将其更名为 h1-size
• 为 title 方法新增参数 color
• 修复 solution 方法，当启用 title 时，如果解析内容过多，一页放不下，标题会跑到下一页的 bug；并将其参数 above 更名为 top；参数 below 更名为 bottom；统一参数名；添加参数 padding-top、padding-bottom
• 去除 question 方法参数 line-height；该参数会影响题干之间的距离；该参数原本用于设置题目内容的行高，当题目中的公式比较高时，题号和题目内容会错位，这时可以通过该参数来微调。但是会造成内容每一行与行之间的间隔变大。可参考新增的参数 padding-top、padding-bottom 代替
• 修复 choices 方法，调整其上下外边距导致选项之间的距离会跟着影响的 bug

0 . 1 . 6

• 修复有序列表,内容带有 box 时，编号和内容对不齐的 bug
• 新增化学方程式的单线桥、双线桥的支持；原子、离子结构示意图的支持。使用详情查看 化学相关

0 . 1 . 5

• 修复水印被图片遮挡的 bug

0 . 1 . 4

• 将 LECTURE 修改为 HANDOUTS，更加符合语义
• 将 explain 方法名修改为 solution，更加符合语义
• 修复当修改弥封线类型时，试卷最后一页没有更改的 bug
• 添加水印功能，setup 方法新增参数 watermark，watermark-size，watermark-color，watermark-font，watermark-rotate

0 . 1 . 3

• 优化 choices 方法
• 将 question 方法的参数名 points-separate-par 修改为 points-separate
• 增加英文完型填空、7选5题型的支持，让 paren 和 fillin 方法可以使用题号作为占位符。使用详情查看 paren 和 fillin 方法
• setup 方法新增参数 heading-numbering，heading-hanging-indent，enum-spacing，enum-indent 提供更多自定义设置
• 修复 question 个数超过9个时，内容对不齐的问题

0 . 1 . 2

• 将 secret 修改为方法，可以自定义显示内容
• 优化 choices 方法，当选项过长时，选项从第二行开始进行缩进。修复选项中既有文字又有图表时，标签和内容对不齐的问题
• 将 question 方法的参数 with-heading-label 的默认值修改为 false
• explain 方法新增参数 show-number 、修改参数 title 的默认值为 none，默认不显示
• setup 方法新增参数 enum-numbering

0 . 1 . 1

• 修复 choices 方法中，若选项为图片时，设置宽度为百分比时，图片宽度无效的问题

0 . 1 . 0

• 初版发布