一、适用场景
模板编辑页用于调整一个模板的名称、字段、正面展示、背面展示、CSS 样式和附加练习配置。模板会影响使用它的所有卡牌，所以修改前应先确认当前模板是否已经被大量卡牌使用。
如果只是修改某一张卡的文字、图片或音频，应回到卡牌编辑页修改字段内容；如果要改变同一类卡牌的展示方式，才适合修改模板。
二、页面结构
模板编辑页采用左侧编辑、右侧预览的结构。左侧包含基本信息、模板代码和底部操作按钮；右侧实时显示当前模板的预览效果。
- 基本信息区显示模板类型，可修改模板名，并进入测验设置或连连看设置。
- 模板代码区编辑 CSS、正面模板和背面模板，并从标题右侧进入字段管理。
- 右侧预览区用于检查字段引用、正背面切换和样式效果。
- 底部操作区提供导入、导出和保存。只读状态下不会显示会修改模板的入口。
三、基本信息
模板类型由创建模板时确定，编辑页只展示，不在这里切换。模板名可以修改，用于模板列表、卡牌编辑中的模板选择和后续管理。
测验设置和连连看设置属于模板能力配置，会影响学习或练习时可以生成哪些题型。相关操作请分别查看模板测验设置说明和模板连连看设置说明。
四、模板代码
模板代码由三部分组成：CSS 样式、正面模板和背面模板。三个输入区可以折叠，便于在复杂模板中聚焦当前正在编辑的部分。
字段管理入口位于模板代码区标题右侧。字段新增、删除、排序、权限、TTS、语言、必填和标题字段等操作，请查看字段管理说明。
| 区域 | 作用 | 注意事项 |
|---|---|---|
| CSS 样式 | 控制卡牌字体、颜色、间距、深色模式等视觉效果。 | 建议先用预览检查亮色和深色模式下的可读性。 |
| 正面模板 | 控制学习时卡牌正面显示什么内容。 | 可通过“插入引用”插入字段引用，避免手写出错。 |
| 背面模板 | 控制翻面后的答案、解析或补充内容。 | 背面可以引用正面内容，也可以引用字段和答题结果。 |
字段引用通常使用 {{@字段名}}。如果字段名发生变化，需要同步检查模板代码中的引用。
五、正反卡样式
正反模板会额外显示“反向卡牌样式”。它用于定义反向卡的 CSS、反向正面和反向背面。保存正反模板时，反向样式必须存在，否则模板无法通过校验。
常见做法是让正向卡从问题到答案，反向卡从答案回到问题。例如正向正面引用“英文”，正向背面引用“中文”；反向正面引用“中文”，反向背面引用“英文”。
六、预览和保存
右侧预览会随模板草稿刷新，用于检查字段引用、样式和正背面切换。预览失败时，页面会显示错误占位，通常需要检查字段引用、HTML 结构或 CSS 是否写错。
保存前系统会执行模板校验。校验失败时，应先根据错误提示修复字段、模板代码或正反卡反向样式，再重新保存。
七、导入导出
导出会生成模板配置文件，包含模板类型、名称、说明、字段、样式和选项，适合把模板结构迁移到其他牌组。它不包含卡牌内容。
导入配置时，配置文件必须是合法 JSON，并且模板类型需要与当前模板匹配。导入后建议先预览，再保存。
八、常见问题
- 预览没有显示某个字段：检查字段名是否和模板代码中的引用完全一致。
- 保存提示字段错误：检查字段名是否为空、包含非法字符或重复。
- 修改字段后测验异常：重新打开测验设置，确认问题字段和答案字段仍然有效。
- 连连看无法生成：确认连连看设置中已经选择两个不同字段，并且卡牌中这两个字段有内容。