Skip to content

setup 方法

该方法用于模板的全局设置

示例

typst
#show: setup.with(mode: EXAM, paper: a3, ..)

参数

mode

类型: str

默认值: HANDOUTS ^0.1.4 LECTURE 0.1.0~0.1.3

可选值: EXAMSOLUTION ^0.1.8

该参数用于设置模板的显示模式

EXAM : 试卷模式;SOLUTION : 解析模式;HANDOUTS : 讲义模式

TIP

HANDOUTS 模式和 EXAM 模式二者仅在题号的显示方式、目录显示方式、页码显示上有所不同。若你只想组卷则只用 EXAM 模式即可!SOLUTION 模式仅当答案独立于内容时,使用该模式。该模式为预定义好的格式,如果不满意可不用该模式自行调整!

paper

类型: dictionary

默认值: a4

可选值: a3

该参数用于设置模板的页面类型、边距、是否翻转、分页

typst
   // a3 和 a4 的默认值
    #let a3 = (
      paper: "a3",
      margin: 1in,
      columns: 2,
      flipped: true,
    )

    #let a4 = (
      paper: "a4",
      margin: 1in,
      columns: 1,
      flipped: false,
    )

a3a4 是内部预定义的两个变量,若需要自定义页面类型,则需要使用字典覆盖默认值

WARNING

本模板仅在 a3a4 尺寸下测试过;修改该参数可能会导致页面布局混乱。

page-numbering

类型: str | function

该参数用于设置模板的页码显示方式

EXAM 模式下默认显示为: XX试题 第X页(共X页)

SOLUTION 模式下默认显示为: XX试题答案 第X页(共X页)

HANDOUTS 模式下默认显示为: X / X

TIP

若要修改显示格式可参考官方文档 numbering 的参数设置。

page-align

类型: alignment

默认值: center

该参数用于设置模板的页码对齐方式

TIP

  1. 若要修改对齐方式可参考官方文档 alignment 的参数设置。

  2. 若想实现奇数页在右侧显示,偶数页在左侧显示的效果,可忽略该参数,修改 footer-is-separate 参数为 false 即可。

类型: boolean

默认值: true

该参数用于设置在页面多列显示时,页脚的页码是否在每一列中都显示

outline-page-numbering

类型: str | function

默认值: "I"

该参数用于设置目录的页码显示

TIP

若要修改显示格式可参考官方文档 numbering 的参数设置。

gap

类型: length

默认值: 1in

该参数用于设置多列显示时,列之间的间距

show-gap-line

类型: boolean

默认值: false

该参数用于设置多列显示时,列之间是否显示分隔线

font-size

类型: length

默认值: 11pt

该参数用于设置页面字体大小

font

类型: str | array

默认值: ("New Computer Modern Math", "Source Han Serif", "SimSun")

默认值: ("STIX Two Math", "New Computer Modern Math", "Source Han Serif", "SimSun") 0.2.1

默认值: ("New Computer Modern Math", "Noto Serif SC", "Noto Serif CJK SC") ^0.2.2

默认值: ("New Computer Modern Math", "Noto Serif CJK SC") ^0.2.5

该参数用于设置页面的字体

TIP

由于宋体不支持加粗,故本包中文默认字体为思源宋体;在本地使用该模板时,自行下载 思源宋体 (密码:666)并安装在对应的操作系统中(安装后需要重启系统)即可。通过 TypstApp 在线使用时,无需安装。为了较少字体警告,从 0.2.5 开始,去掉 Noto Serif SC ,使用新版本时需重新安装思源宋体。见上述链接!

font-math

类型: str | array

默认值: ("New Computer Modern Math", "Source Han Serif", "SimSun")

默认值: ("STIX Two Math", "New Computer Modern Math", "Source Han Serif") 0.2.1

该参数用于设置数学公式下的字体

WARNING

该参数从 0.2.2 开始已弃用;使用 font 参数即可完成数学字体的修改。详情参考 字体设置

TIP

若想使用新罗马风格的字体,需要自行 下载新罗马风格的字体 (密码:666) 并安装在对应的操作系统中(安装后需要重启系统)。通过 TypstApp 在线使用时,无需进行安装。

为了方便使用新罗马风格的字体,从 0.2.2 版本开始,新增常量 roman = ((name: "Times New Roman", covers: "latin-in-cjk"), "TeX Gyre Termes Math", "Noto Serif SC", "Noto Serif CJK SC") ,本地使用时需要安装 TeX Gyre Termes Math 字体后才能生效。在线使用则无需安装。从 0.2.5 版本开始,roman 去除字体 Noto Serif SC !

若安装的是其它受支持的数学字体,安装字体后需要自行修改 font 参数的值才能生效!该值必须为数组,且该数组中至少有2个元素,西文字体在前,中文字体在后;可参考 roman 的值。特别的,当使用 STIX Two Math 字体时,在线使用或 Mac 用户本地使用时无需安装字体就能生效!

WARNING

使用本模板时,会报 unknown font family 字体警告,原因是相同效果的字体,名字不同,却出现多次。之所以出现多次是为了确保不管是本地使用还是在线使用时,字体都能显示相同的效果。目前官方暂时没有压制该警告的方法。若排版的试卷显示正常,忽略该警告即可!

line-height

类型: length

默认值: 2em

该参数用于设置行高

par-spacing

类型: length

默认值: 2em

该参数用于设置段落间距

first-line-indent

类型: length

默认值: 0em

该参数用于设置首行缩进

heading-numbering ^0.1.3

类型: str | function

默认值: auto

该参数用于设置节标题前的编号方式

heading-hang-indent ^0.1.3

类型: length

默认值: auto

该参数用于设置节标题非首行的缩进

heading-font

类型: str | array

默认值: ("New Computer Modern Math", "SimHei")

该参数用于设置节标题的字体

h1-size ^0.1.7

类型: length

默认值: auto

该参数用于设置一级标题的字体大小

WARNING

0.1.7 版本之前,该参数名为 heading-size 且会改变所有级别的节标题。

heading-color

类型: color

默认值: black

该参数用于设置节标题的字体颜色

heading-top

类型: length

默认值: 10pt

该参数用于设置节标题的上间距

heading-bottom

类型: length

默认值: 15pt

该参数用于设置节标题的下间距

enum-numbering ^0.1.2

类型: str | function

默认值: "(1.i.a)" ^0.1.8 (1.1.i.a) 0.1.0~0.1.7

该参数用于设置有序列表的编号方式

enum-spacing ^0.1.3

类型: length

默认值: 2em

该参数用于设置有序列表的之间的间距

enum-indent ^0.1.3

类型: length

默认值: 0pt

该参数用于设置有序列表的缩进

watermark ^0.1.4

类型: none | content | image

默认值: none

该参数用于设置水印的内容

watermark-color ^0.1.4

类型: color

默认值: rgb("f666")

该参数用于设置水印的颜色

WARNING

该参数对图片水印无效。在修改该参数时,一定要修改颜色的透明度,否则水印将覆盖在文字之上。(这是由于水印的实现是基于前景色)详情设置参考 color

watermark-font ^0.1.4

类型: str | array

默认值: ("New Computer Modern Math", "Source Han Serif")

该参数用于设置水印的字体

WARNING

该参数对图片水印无效。

watermark-size ^0.1.4

类型: length

默认值: 88pt

该参数用于设置水印的字体大小

WARNING

该参数对图片水印无效,但可以通过传入图片时设置宽高调整图片大小。

watermark-rotate ^0.1.4

类型: angle

默认值: -45deg

该参数用于设置水印的旋转角度

show-answer

类型: boolean

默认值: false

该参数用于设置是否显示答案

answer-color

类型: color

默认值: blue

该参数用于设置答案的颜色

show-seal-line

类型: boolean

默认值: true

该参数用于设置是否显示弥封线

seal-line-student-info

类型: dictionary

默认值:

typst
 (
    姓名: underline[~~~~~~~~~~~~~],
    准考证号: table(columns: 14, inset: .8em,[]),
    考场号: table(columns: 2, inset: .8em,[]),
    座位号: table(columns: 2, inset: .8em,[])
 )

该参数用于设置考生信息

seal-line-type

类型: str | none | auto | array | dictionary

默认值: "dashed"

该参数用于设置弥封线的样式

TIP

此设置的可选值参考官方文档 线的类型

seal-line-supplement

类型: str

默认值: "弥封线内不得答题"

该参数用于设置弥封线内的补充信息

Released under the MIT License.