练习

题目和答案写在Markdown里；印出来是什么样子，由练习样式决定。

一道练习是章节中写在:::exercise和:::之间的一个块。块里写题目要求、各个小题、选项、填空和它们的答案，有解题过程时也写在里面。Postext从文字中读出答案，给学生印出题目（空着的横线、空的方框、打乱顺序的项目），生成答案表，再把答案放到书中指定的位置。题号的样子、选项的序号、填空处的样子和书写区的格线来自exerciseStyles；答案放在哪里、印哪一种版本来自exercises。因此，同一份Markdown可以生成学生用书、教师用书和屏幕上的互动版本。

练习排成一个由普通段落、行内标签和绘制图形组成的框，所以它的放置、跨栏跨页的拆分、在无障碍PDF中的标签以及在各种输出中的绘制，都和其他框一样。没有:::exercise的书，排版结果与以前相同。

#练习块

:::exercise
中国的首都是哪座城市？
 
- [ ] 上海
- [x] 北京
- [ ] 广州
:::

练习开头的段落，直到第一个列表、填空或词库为止，是题目要求。它排在题号之后，用样式中题目要求的字体（默认粗体）。其后的内容是题目本身。

块的起始行接受以下属性：

练习里还可以放两种块。:::solution……:::写解题过程或参考答案，可以用任何Markdown；它从不印在练习里面，而是放到答案所在的位置。:::hint……:::写提示，屏幕版本在读者需要时显示，印刷版不印。

#题型

打乱顺序用的是固定的随机种子：同一道练习在Canvas、PDF、HTML阅读器、EPUB和答案表中的顺序都一样。修改exercises.seed，就能印出同一份试卷的另一个版本。

#选择题与判断题

选择题

一个任务列表，勾上正确的选项：

:::exercise
离太阳最近的行星是哪一颗？
 
- [ ] 金星
- [x] 水星
- [ ] 火星
:::

选项每行一个，标为A. B. C.，转行的文字悬挂在选项文字下面。一道练习有几个小题时，写成有序列表，每一项是一个题干，题干下面缩进写它的任务列表；题干编号为1.、2.，选项排在题干下面：

:::exercise{columns=3}
选择正确的答案。
 
1. 植物的根从土壤里吸收
   - [x] 水分
   - [ ] 阳光
   - [ ] 种子
2. 叶子利用什么制造养料？
   - [ ] 土壤
   - [ ] 风
   - [x] 阳光
:::

columns=3让选项每行排三个。序号和它后面的符号随文档语言而定：中文为A.，英文和罗曼语族语言为a)，日文为ア イ ウ，阿拉伯文为أ) ب) ج)。样式可以在每个选项前加一个供勾选的方框或圆圈（options.marker），也可以像中文和日文试卷那样，在题干末尾加一对括号（　），让学生把字母填进去（options.bracket）。

判断题

:::exercise{type=truefalse}
判断对错。
 
- [x] 太阳是一颗恒星。
- [ ] 月亮是一颗行星。
:::

每个句子都编号，行末印两个答案，各带一个方框：√ □ × □。勾选的项为正确。两个符号随语言而定：中文为√/×，英文为T/F，西班牙文、加泰罗尼亚文、法文、意大利文和葡萄牙文为V/F，德文为R/F，日文为○/×，阿拉伯文为صح/خطأ。样式也可以改为在句末只留一个空，让学生写“√”或“×”（trueFalse.look: 'bracket'）。

#填空题与词库

[[答案]]是一个空，印成一条供书写的横线：

:::exercise{bank}
选词填空。
 
1. 植物的根从土壤里吸收[[水分]]。
2. 叶子为植物制造[[养料]]。
3. 花朵吸引[[昆虫 | 蜜蜂]]来传粉。
 
::bank[石头 | 风]
:::

• [[马铃薯 | 土豆]]：一个空接受几种答案。答案表印第一种。
• [[的 | (地) | 得]]：行内选择。选项印在句中，写作(的 / 地 / 得)，括号里的那个是正确的，读者把它圈出来。
• [[秋天]]{width=6}：宽六个em的空。
• \|是答案中的竖线本身，\[[是两个方括号本身。

一道练习中的每个空都和最长的答案一样宽，再加1.5 em，这样横线的长短不会泄露答案（用blank.width修改）。bank把答案打乱后印在题目要求下面的词库框里。写一行::bank[石头 | 风]，词库就印在这一行所在的位置，并加入行中的干扰项；只写这一行也会生成词库。[[…]]只在练习里才被识别：书中其他地方的两个方括号照原样保留。

开头直接是题目文字、没有题目要求的练习，题号接在第一段的开头：

:::exercise
一个星期有[[七]]天，一年有[[十二]]个月。
:::

#连线题与分类题

连线题

用->（或→）写成的配对：

:::exercise
把动物和它的家连起来。
 
- 蜜蜂 -> 蜂巢
- 小鸟 -> 鸟窝
- 蜘蛛 -> 蛛网
- 兔子 -> 洞穴
- -> 鱼缸
:::

左栏按书写顺序印出，右栏打乱顺序，每一项旁边有一个圆点，供学生连线。- -> 鱼缸往右栏添加一个不与任何项配对的项。设match.look: 'letters'时，右栏各项标上字母，左栏每一项旁边留一个填字母的空。shuffle=false让右栏保持书写顺序。

分类题

:::exercise{type=sort}
按食用的部分给下面的蔬菜和水果分类。
 
- 根：胡萝卜、萝卜
- 叶：生菜、菠菜
- 果实：西红柿、苹果
:::

所有的项打乱后放进一个词库，每个类别占一栏（最多四栏），栏头是类别名，下面是书写横线。各项之间可以用逗号、分号、、、，或،分隔。

#排序

排序题

:::exercise{type=order}
按植物生长的先后排一排。
 
1. 种子发芽了。
2. 茎长高了。
3. 花开了。
4. 结出了果实。
:::

列表按正确的顺序书写，印出时打乱，每一项带一个填序号的方框。

连词成句

:::exercise{type=scramble}
连词成句。
 
- 植物 / 需要 / 水
- 太阳 / 给我们 / 光和热
:::

每个句子在斜线处切开（没有斜线时在空格处切开），打乱后印出，各块之间用斜线隔开，下面留一条横线写整句。中文句子词与词之间没有空格，所以要用斜线切分。

#圈画题

:::exercise{type=mark}
圈出表示动作的词：小女孩[[浇]]花，太阳[[照]]着花朵。
:::

文字照原样印出；[[…]]中的词是要标出的词。答案中这些词被圈出；在起始行写mark=box|underline|highlight，就改为加框、加下划线或加底色；也可以逐个词设定，例如[[浇]]{mark=underline}。

#问答题与书写区

:::exercise{type=open lines=4}
植物为什么需要阳光？
 
:::solution
植物要靠阳光制造养料。
:::
:::

题目要求后面是供书写的横线：默认三行，这里用lines=4。正文是列表时，每一项各有自己的横线。area改变格线：lines（横线）、dots（点线）、grid（方格纸）、seyes（法国学校的Seyès格线）、tianzige（田字格，小学生写汉字用的格子）、box（空框，供画图）或none。:::solution是参考答案，印在答案中，在教师用书里写在横线上。

#找词游戏与填字游戏

找词游戏

:::exercise{type=wordsearch size=6 directions="across down"}
在方阵中找出下面的词语。
 
- 春天
- 小草
- 花朵
- 燕子
:::

词语排进一个字的方阵，词表印在方阵下面（hidden不印词表）。方阵会放大到能容下最长的词；size设定它的边长。directions接受across、down、diagonal和backwards；默认是横向、纵向和斜向。拉丁字母默认排成大写，除非样式另有规定；汉字不受影响。放不进去的词会被报告。

填字游戏

:::exercise{type=crossword}
根据提示填成语。
 
- 一心一意：做事专心，没有别的念头
- 心想事成：心里想的事都能办到
- 意气风发：精神振奋，气概豪迈
- 风和日丽：风很柔和，阳光明媚
:::

每一条是一个词和它的提示，冒号可以用:或：。引擎排出方格，在每个词的第一格标上编号，把提示印在方格下面，分成两组，组名用文档语言（中文为“横向”和“纵向”，英文为Across和Down，日文为ヨコのカギ和タテのカギ）。

#竖式计算

:::exercise{type=arithmetic}
用竖式计算。
 
- 345 + 278
- 902 − 456
- 124 × 3
- 864 ÷ 4
:::

每道算式按学生书写的样子排在格子里：数字按位对齐，运算符号在左边，下面一条横线，横线下是填写得数的空格，每行最多四道。在从右往左排的页面上，每道算式的数字仍从左往右写，各道算式则从右往左排列。识别的符号有+、-、−、×、x、*、·、⋅、÷、:和/，数都是整数。除法竖式按文档语言所在地区的学校习惯排，arithmetic.division可以换成另一种：

• bracket：除数在左，被除数在“厂”字形的除号下面，商写在上方。中文、英文、日文和阿拉伯文书籍用这种。
• potence：被除数在左，除数在右边的L形线下，商写在除数下面，余数在最下面。西班牙文、加泰罗尼亚文、法文、意大利文和葡萄牙文书籍用这种。
• inline：864 : 4 =和商的格子排在同一行，计算步骤写在下面。德文书籍用这种。

#第一题作示范

example把第一小题作为已解答的示范印出，用答案的颜色：第一个空已填好，第一题的正确选项已圈出，第一对已连线，第一个句子已写好。屏幕上不要求作答这一题，它的答案也不放进词库。

#编号、引用与难度

练习在每一章里编为1、2、3。其余由样式决定：题号可以是带句点的粗体数字（默认），也可以放在圆形、方形或圆角方形里（number.shape）；题号前可以加一个词（设number.label: true时，用文档语言的词，中文印作“练习 3.”）；数字的写法（number.format）；加上章号的模板（'{h1}.{n}'）；以及从哪里重新计数（number.resetOn：每章、每节或从不）。中文试卷常见的大题号“一、二、”写作number: { format: 'simp-chinese-informal', suffix: '、' }。number.counter相同的样式共用一个计数，全书从一章延续到下一章。

起始行写n=12时，这道练习的题号为12，后面的练习从13接着数。#id让练习成为:ref的目标，引用处印出它的名称“练习 3”（样式在number.label里设了词就用该词，否则用文档语言的词）。style=number印出3，style=title印出起始行的title（没有时印名称），style=page印出页码。引用也能指向书中其他章的练习。level和icon印在题号后面，分别是样式规定的难度记号和活动图标。

#答案与解答

#答案表

每道需要评分的练习都有一份由答案生成的答案表：正确的选项（B. 水星），按顺序列出的空（1 水分 · 2 养料 · 3 昆虫），每个句子的√或×，配对，顺序，句子，填字游戏的词及其编号，各道算式的得数。在full版式（默认）中，答案表后面接着这道练习的:::solution。问答题没有答案表：它的参考答案就是解答。

#答案印在哪里

由exercises.solutions.placement为全书决定；样式可以为自己的练习另设。

用directive时，一行:::solutions印出它前面尚未印过的各道练习的答案；title="…"改变它的标题。:::solutions{scope="book"}放在书末单独的一章里，按章印出全书每道练习的答案表和解答：

# 参考答案
 
:::solutions{scope="book"}

#教师用书

{ "exercises": { "edition": "teacher" } }

把每个答案印在它的位置上，用答案的颜色（品红，除非样式设了answers.color）：空已填好，正确的选项已圈出或方框已涂满，判断题的√或×方框已涂满，连线已画好，排序框里写好了序号，句子和分好类的词写在横线上，问答题的参考答案写在横线上，填字游戏的词和算式的得数写在格子里。

#检查

沙盒的检查面板和collectContentWarnings会报告引擎读不懂的地方：

• exerciseUnknownType：type不是十二种题型之一。
• exerciseUnknownStyle：style没有对应的练习样式（改用第一种样式）。
• exerciseNoAnswer：需要评分的练习没有可评的答案：选择题没有勾选的选项，填空题没有[[…]]，连线题没有配对。
• exerciseUnreadItem：列表中有一项读不出，例如连线题的一项没有->，或者一道算式不是两个整数加一个运算符号。
• exerciseWordUnplaced：找词游戏或填字游戏有放不进去的词。
• exerciseNested：练习里套了另一道练习。
• solutionOutside：:::solution或:::hint写在练习外面。它什么也不印。

#HTML与EPUB中的练习

在HTML阅读器和EPUB电子书中，练习可以直接作答。读者在空里输入，点击选项、句子、要连线的圆点和方格中的格子，然后核对答案、查看解答或重做。答对和答错用颜色和记号表示（digital.correctColor、digital.wrongColor），读屏软件也会读出结果。答案按书保存在浏览器中，读者下次打开时还在（exercises.digital.persist）。设exercises.digital.check: 'instant'时，每填一个答案就立即核对；设exercises.digital.interactive: false时，页面与印刷版相同。不论印刷版把答案放在哪里，EPUB里总带有答案表，所以不运行脚本的阅读系统也能看到答案。

屏幕版本可以通过htmlViewer.overrides给练习另设样子：它在HTML阅读器排版之前合并到书的配置上，印刷版保持不变：

const config: PostextConfig = {
  exercises: { solutions: { placement: 'chapterEnd' } },
  htmlViewer: {
    overrides: {
      exercises: { solutions: { placement: 'none' } },
      exerciseStyles: [
        { id: 'exercise', blank: { minWidth: { value: 6, unit: 'em' } }, area: { kind: 'none' } },
      ],
    },
  },
};

#练习样式

const config: PostextConfig = {
  exerciseStyles: [
    {
      id: 'activity',
      number: { format: 'simp-chinese-informal', suffix: '、' },
      instruction: { fontFamily: 'Noto Sans SC' },
      options: { bracket: true },
      trueFalse: { look: 'bracket' },
      blank: { look: 'dots' },
      area: { kind: 'tianzige' },
    },
  ],
};

这种样式把题号排成“一、二、”，题目要求用黑体，选择题在题干末尾留括号，判断题在句末留一个空，填空处是点线，书写区是田字格。样式的每个字段、它的类型和默认值见配置 › 练习。样式的框取自一种标注框样式（box），所以练习可以像书中其他框一样，放在带底色和色条的框里。智能体技能移植教科书或练习册中的练习时，也按同样的步骤处理。