Skip to main content

Section A.4 使用建议

如何选择合适的环境.

  • 展示概念应用:使用 <example>,并提供详细的 <solution>
  • 让学生练习:使用 <exercise>,可以隐藏解答让学生独立完成。
  • 引导探索:使用 <activity><exploration>,强调发现过程。
  • 陈述重要结果:使用 <theorem><lemma><corollary>
  • 引入新概念:使用 <definition>,用 <term> 标记术语。
  • 强调重点:使用 <assemblage><insight>
  • 提醒注意:使用 <warning>(常见错误)或 <note>(关键要点)。
  • 补充说明:使用 <remark>(深入讨论)或 <aside>(次要信息)。

常用属性.

大多数环境支持以下属性:
  • xml:id:唯一标识符,用于交叉引用(如 xml:id="thm-pythagorean")。
  • <title>:环境的标题(可选但推荐使用)。
  • <creator>:内容创作者(用于 exercise、project 等)。
  • <index>:索引条目,便于检索。

Remark A.4.1. 编号规则.

PreTeXt 自动为大多数环境编号。编号方案可以在 docinfo.ptx 中配置:
  • 章节编号:如"定理 3.2.1"(第3章第2节第1个定理)。
  • 全局编号:如"定理 25"(全书第25个定理)。
  • 分块编号:theorem、lemma、corollary 可以共享编号序列。

Note A.4.2. 解答可见性控制.

在 HTML 输出中,<hint><answer><solution> 默认隐藏,读者可以点击展开。这可以通过发布文件(publication file)配置:
  • solution/@inline: 控制解答是否默认显示。
  • solution/@divisional: 控制解答是否在各章节末尾汇总。