Keynote Builder 将您设计的 Keynote 模板转换为每位患者研究的自动化演示文稿。您只需准备一次模板——颜色、字体、布局、徽标和图像占位符——OrthoKit 就能在几秒钟内用真实数据填充它:姓名、年龄、临床照片、X 光片、头影测量描记、干预措施和预算。
本指南面向从零开始的用户,无需模板经验或技术知识。
您将能够实现什么
- 专属设计。 颜色、字体、背景、您诊所的徽标以及每张幻灯片的精确布局。
- 自动填充患者数据。 姓名、年龄、性别、ID、出生日期、过敏史、就诊原因和其他信息都会自动插入。
- 临床照片各就各位。 正面、侧面、微笑、咬合等。每种类型的照片都会占据您指定的位置。
- X 光片和头影测量。 包含日期、类型、分析和注释。
- 预算和治疗计划。 包含标题、日期、金额、接受状态和其他字段。
- 一键导出。 无需导入文件或配置幻灯片范围。
与旧版 PowerPoint 导出器的区别
OrthoKit 保留了旧版导出器以兼容现有研究,但不建议将其用于新患者。
之前 · PowerPoint / ODP
- 您在 PowerPoint 或 LibreOffice 中准备模板。
- 必须将其专门保存为
.odp格式(OpenDocument Presentation);不支持.pptx格式。 - 将
.odp文件拖入 OrthoKit 进行导入。 - 打开"区块配置器"并手动分配每个区块对应的幻灯片范围。
- 调整其他选项:X 光片替换模式、照片搜索条件、每张幻灯片的干预数量等。
- 任何更改都需要重新导出、重新导入文件并重新配置范围。
现在 · Keynote Builder
- 在 OrthoKit 中点击创建新模板。
- Keynote 会自动打开模板副本。
- 像编辑任何演示文稿一样编辑它,并按 ⌘S 保存。
- 无需额外步骤即可生效:无需导入、无需区块配置器、无需中间格式。
- 之后的任何调整只需打开模板、编辑并保存即可应用。后续研究将采用这些更改。
基本概念
整个指南中会反复出现三个术语。预先了解它们可以简化文档的其余部分。
区块
患者研究中的每个主题块:封面、初始照片、X 光片、治疗计划、预算等。OrthoKit 有十四个预定义区块,您可以在患者研究的导出视图中启用/禁用每一个,并自定义每个区块中显示的内容。每个区块会在最终演示文稿中生成一张或多张幻灯片。
母版幻灯片
Keynote 的内部模板,不会以其本身的形式出现在最终演示文稿中:它充当模具的作用。它定义了背景、颜色、字体以及文本框和图像的位置。
在 Keynote 中,通过 显示 › 编辑幻灯片版式 访问母版幻灯片。OrthoKit 以它们为起点来构建每位患者的研究。
替换代码
形如 {{ algo }} 的文本,写在幻灯片内,OrthoKit 在生成研究时会识别并将其替换为患者的真实数据。
存在文本代码(例如 {{ patient_name_lastname }})和图像代码(例如 {{ radiograph }})。
如何开始
OrthoKit 始终从默认模板的副本开始,并从该副本进行个性化设置。无需从头创建文件。
打开 OrthoKit。 前往设置 › Keynote Builder。
点击"创建新模板"。 OrthoKit 会复制默认模板,将其标记为活动状态,并直接在 Keynote 中打开。
在 Keynote 中进入母版幻灯片模式。 顶部菜单:显示 › 编辑幻灯片版式。左侧栏中会出现可用母版幻灯片的列表(封面、医疗数据、X 光片等)。
编辑每张母版幻灯片。 更改背景、字体、颜色以及文本框和图像的位置。两个要求:每张母版幻灯片必须保留将其与对应区块关联的名称(支柱 1),并且必须包含您希望填充的
{{ ... }}形式的代码(支柱 2 和 3)。按 ⌘S 保存并关闭 Keynote。 模板会自动生效。之后的任何导出都会使用它。
可以保存多个模板(例如,一个用于初步研究,另一个用于复查),并随时通过设置 › Keynote Builder › 活动模板在它们之间切换。
工作原理
导出研究时,OrthoKit 会遍历已启用的区块。对于每个区块,它会搜索名称中包含关联关键字的母版幻灯片,根据需要克隆它们多次(每张要显示的照片、X 光片或预算对应一次),并用患者的真实数据填充代码。
系统基于三大支柱:
- 支柱 1 · 母版幻灯片名称。 每个区块都有一个关键字(例如封面对应
Cover)。任何名称包含该关键字的母版幻灯片都会在生成该区块时被包含。 - 支柱 2 · 文本代码。 在文本框内写入
{{ código }},OrthoKit 会将其替换为患者的真实数据。 - 支柱 3 · 图像代码。 代码写在 Keynote 中每张图像的描述字段内(侧边检查器),OrthoKit 会将其替换为对应的真实图像。
支柱 1 · 母版幻灯片名称
OrthoKit 的十四个区块中的每一个都与一个英文关键字相关联,该关键字对应其内部标识符。母版幻灯片的名称必须包含该关键字,OrthoKit 才会将其与对应的区块关联起来。
如何在 Keynote 中重命名母版幻灯片
- 在编辑幻灯片版式模式下,点击左侧栏中母版幻灯片的名称(显示在缩略图上方)。
- 输入新名称(例如
Cover)并按 Intro。
各区块关键字表
| OrthoKit 中的区块 | 名称关键字 |
|---|---|
| 封面 | Cover |
| 个人与医疗数据 | Demographics |
| 文档(PDF、同意书等) | Documents |
| 初始照片 | Initial Photographs |
| 口外随访 | Extraoral Follow Up |
| 口内随访 | Intraoral Follow Up |
| 对比(治疗前 / 治疗后) | Comparative Photographs |
| X 光片 | Radiographs |
| 头影测量(描记) | Cephalometrics |
| 头影测量重叠 | Superimposition |
| 3D 模型 | 3D Models |
| 治疗计划 | Treatment Plan |
| 干预措施(就诊历史) | Interventions |
| 预算 | Budgets |
名称匹配规则
母版幻灯片的名称必须包含该关键字,区分大小写。以封面(关键字:Cover)为例:
- ✓
Cover· 完全匹配的名称,有效。 - ✓
Cover 1、Cover 2· 每当研究包含封面时,两者都会生成。 - ✓
Cover Minimalista、My Cover Dark· 有效;名称包含该关键字。 - ✗
Portada· 不包含该关键字;不会被使用。 - ✗
cover· 匹配区分大小写。
避免在同一名称中组合两个关键字。 像
Cover · Radiographs这样的名称会导致同一张母版幻灯片同时用于封面和 X 光片,这很少是期望的结果。
多张母版幻灯片等于多种变体。 要交替使用三种不同的封面设计,请创建三张名为
Cover、Cover Vertical和Cover Minimalista的母版幻灯片。在每项包含封面的研究中,这三张都会生成。
支柱 2 · 文本代码
在母版幻灯片内,添加 Keynote 文本框并在您希望 OrthoKit 插入真实数据的位置写入 {{ código }}。代码可以单独出现,也可以嵌入句子中。
示例
Paciente: {{ patient_name_lastname }}
Edad al inicio: {{ complete_age }}
Fase: {{ phase_title }} ({{ phase_idx }})
Documento emitido el {{ doc_creation }}
导出研究时,OrthoKit 会将该块转换为类似以下内容:
Paciente: Marta García Pérez
Edad al inicio: 8 años y 4 meses
Fase: Fase activa (1 de 2)
Documento emitido el 24 abr 2026
通用代码
在任何区块和任何母版幻灯片中均可用。
| 描述 | 代码 |
|---|---|
| 文档创建日期(今天) | {{ doc_creation }} |
| 诊所名称 | {{ clinic_title }} |
| 活动阶段标题 | {{ phase_title }} |
| 阶段索引(例如"1 of 3") | {{ phase_idx }} |
| 阶段开始日期 | {{ phase_creation }} |
患者代码
在封面、医疗数据、文档和治疗计划中可用。
| 描述 | 代码 |
|---|---|
| 名字 | {{ patient_onlyName }} |
| 姓氏 | {{ patient_onlyLastname }} |
| 名字和姓氏 | {{ patient_name_lastname }} |
| 摘要(姓名 · 年龄 · 性别) | {{ patient_summary }} |
| 患者标识符 | {{ patient_id }} |
| 性别 | {{ patient_gender }} |
| 标签 | {{ patient_tags }} |
| 出生日期 | {{ patient_birthdate }} |
| 完整年龄(例如"8 岁零 4 个月") | {{ complete_age }} |
| 带单位的年龄(例如"8 岁") | {{ patient_age }} |
| 仅年 | {{ age_years }} |
| 仅剩余月份 | {{ age_months }} |
| 患者登记日期 | {{ patient_creation }} |
各区块专属代码
每个区块还提供自己的专属代码。
封面 · 母版幻灯片:Cover
| 描述 | 代码 |
|---|---|
| 封面标题 | {{ cover_title }} |
| 医生姓名 | {{ cover_doctor }} |
| 医疗警报 | {{ patient_alert }} |
如果研究只有一个阶段,则 {{ phase_title }} 和 {{ phase_idx }} 在封面中留空,以避免出现没有信息的行。
医疗数据 · 母版幻灯片:Demographics
| 描述 | 代码 |
|---|---|
| 职业 | {{ patient_job }} |
| 活动 | {{ patient_activities }} |
| 习惯 | {{ patient_habits }} |
| 疾病 | {{ patient_diseases }} |
| 就诊原因 | {{ consulation_motiv }} |
| 过敏史 | {{ patient_allergies }} |
| 手术史 | {{ patient_surgeries }} |
| 用药 | {{ patient_medication }} |
| 其他信息 | {{ other_information }} |
| 电子邮件 | {{ patient_email }} |
| 地址 | {{ patient_address }} |
| 电话 | {{ patient_phone }} |
| 医疗警报 | {{ patient_alert }} |
文档 · 母版幻灯片:Documents
| 描述 | 代码 |
|---|---|
| 文件名 | {{ document_filename }} |
| 文件日期 | {{ document_date }} |
| 文档索引(例如"1 of 4") | {{ document_idx }} |
初始照片 · 母版幻灯片:Initial Photographs
| 描述 | 代码 |
|---|---|
| 会话日期 | {{ initials_date }} |
| 注释 | {{ initials_annotation }} |
口外和口内随访 · 母版幻灯片:Extraoral Follow Up、Intraoral Follow Up
| 描述 | 代码 |
|---|---|
| 随访时间描述 | {{ sequence_monthDescription }} |
| 序列日期 | {{ sequence_date }} |
| 序列注释 | {{ sequence_annotation }} |
| 随访索引(例如"2 of 5") | {{ tracking_idx }} |
X 光片 · 母版幻灯片:Radiographs
| 描述 | 代码 |
|---|---|
| X 光片类型 | {{ radio_title }} |
| 日期 | {{ radio_date }} |
| 注释 | {{ radio_annotation }} |
| X 光片索引(例如"1 of 4") | {{ radio_idx }} |
头影测量 · 母版幻灯片:Cephalometrics
| 描述 | 代码 |
|---|---|
| 描记标题 | {{ plot_title }} |
| 描记日期 | {{ plot_date }} |
| 分析作者 | {{ tracing_analysis }} |
| 关联 X 光片的注释 | {{ tracing_annotation }} |
| 描记索引 | {{ tracing_idx }} |
重叠 · 母版幻灯片:Superimposition
| 描述 | 代码 |
|---|---|
| 重叠方法 | {{ superimposition_title }} |
| 组合日期(基础 – 叠加) | {{ superimposition_date }} |
| 基础描记标题 | {{ superimposition_base_title }} |
| 叠加描记标题 | {{ superimposition_over_title }} |
| 基础描记日期 | {{ superimposition_base_date }} |
| 叠加描记日期 | {{ superimposition_over_date }} |
| 描记之间经过的时间 | {{ superimposition_elapsed }} |
3D 模型 · 母版幻灯片:3D Models
| 描述 | 代码 |
|---|---|
| 模型标题 | {{ model_title }} |
| 日期 | {{ model_date }} |
| 注释 | {{ model_annotation }} |
| 模型索引 | {{ model_idx }} |
| 自第一个模型以来经过的时间 | {{ model_elapsed }} |
治疗计划 · 母版幻灯片:Treatment Plan
| 描述 | 代码 |
|---|---|
| 目标 | {{ treatment_objectives }} |
| 诊断 | {{ treatment_diagnosis }} |
| 序列 | {{ treatment_sequence }} |
| 拔牙 | {{ treatment_extractions }} |
| 微种植钉 | {{ treatment_tads }} |
| 保持 | {{ treatment_retention }} |
干预措施 · 母版幻灯片:Interventions
| 描述 | 代码 |
|---|---|
| 干预页码 | {{ int_idx }} |
| 活动阶段标题 | {{ interventions_phase_title }} |
干预措施列表本身作为图像生成(见支柱 3 › {{ interventions }})。
预算 · 母版幻灯片:Budgets
| 描述 | 代码 |
|---|---|
| 公开标题(患者看到的) | {{ budget_public_title }} |
| 私有标题(内部) | {{ budget_private_title }} |
| 标题(私有的别名) | {{ budget_title }} |
| 日期 | {{ budget_date }} |
| 接受日期 | {{ budget_acceptation_date }} |
| 状态(未接受则为空) | {{ budget_accepted }} |
| 总金额(含货币) | {{ budget_total }} |
| 预算索引 | {{ budget_idx }} |
OrthoKit 内部的快捷方式: 在设置 › Keynote Builder › 可粘贴代码中可以找到这些相同的列表,并带有一个将每个代码复制到剪贴板的按钮。
支柱 3 · 图像代码
图像不是通过文件名识别,而是通过 Keynote 中每张图像的描述字段识别。
如何分配图像代码
- 在编辑幻灯片版式模式下,选择母版幻灯片中的图像。
- 打开侧边检查器(格式)并转到图像选项卡。
- 在描述字段中,用双大括号写入代码,例如
{{ radiograph }}。
放置在母版幻灯片中的图像仅用作参考占位符:它的位置、大小和比例会被保留,但内容在导出时会被替换。它可以是灰色填充图像或任何其他示例图像;重要的是占位符和描述。
各区块可用的图像
| 区块 | 插入内容 | 代码(在描述中) |
|---|---|---|
| 封面 · 医疗数据 | 主侧图 | {{ side_image }} |
| 文档 | 文档预览 | {{ document }} |
| X 光片 | 患者的 X 光片 | {{ radiograph }} |
| 头影测量 | 远程放射片上的描记图 | {{ radiograph }} |
| 头影测量 | 分析值表 | {{ tracing }} |
| 重叠 | 重叠渲染 | {{ superimposition }} |
| 干预措施 | 干预块渲染 | {{ interventions }} |
| 预算 | 预算渲染 | {{ budget }} |
{{ clinic_logo }}在任何母版幻灯片中都有效。 在导出过程结束时,OrthoKit 会检查所有生成的幻灯片,并将诊所徽标压印到任何描述为{{ clinic_logo }}的图像上。
临床照片(初始、随访和对比)
在这三个区块中,没有按区块固定的代码:每个占位符都由该类型照片自身的代码识别,该代码与 OrthoKit 为每张照片使用的内部标识符一致。
口外代码示例: {{ frontalResting }}、{{ frontalSmiling }}、{{ profileResting }}、{{ profileSmiling }}、{{ threeQuartersResting }}、{{ threeQuartersSmiling }}。
口内代码示例: {{ frontal }}、{{ right }}、{{ left }}、{{ upper }}、{{ lower }}、{{ openedFrontal }}、{{ overjetFrontal }}。
OrthoKit 内部的完整列表: 在设置 › Keynote Builder › 用于插入图像的代码 › 照片中,会显示可用代码的完整目录,并带有复制每个代码的按钮。
对比(治疗前 / 治疗后) · 后缀 _A 和 _B
在对比母版幻灯片中,每个占位符存在两次:一个用于左侧序列,另一个用于右侧序列。在基础代码上添加相应的后缀:
{{ frontalResting_A }}· 左侧序列(治疗前)的正面休息口外照片。{{ frontalResting_B }}· 右侧序列(治疗后)的正面休息口外照片。{{ frontal_A }}/{{ frontal_B }}、{{ upper_A }}/{{ upper_B }},依此类推。
仅后缀发生变化。照片的基础代码与初始照片中使用的相同。
示例块
可以直接粘贴到对应母版幻灯片内的文本框中。
封面
{{ cover_title }}
{{ patient_name_lastname }}
{{ complete_age }} · {{ patient_gender }}
{{ clinic_title }} · {{ doc_creation }}
医疗数据
Motivo de consulta: {{ consulation_motiv }}
Alergias: {{ patient_allergies }}
Medicación: {{ patient_medication }}
Hábitos: {{ patient_habits }}
随访标题
{{ sequence_monthDescription }} — {{ sequence_date }}
Seguimiento {{ tracking_idx }}
{{ sequence_annotation }}
预算页脚
{{ budget_public_title }}
Emitido el {{ budget_date }} — {{ budget_accepted }}
Total: {{ budget_total }}
常见问题
某些幻灯片显示为空白
- 检查母版幻灯片的名称是否包含该区块的精确关键字,注意区分大小写。
- 检查该区块是否在患者研究的导出面板中被启用。
- 如果该区块需要数据(照片、预算、X 光片等),而患者没有记录任何数据,则该区块不会生成幻灯片。
文本按字面显示({{ patient_name_lastname }})而不是真实数据
- 该代码不存在或书写有误。请查阅支柱 2 的列表。
- 代码对精确字符敏感:更改的重音符号、遗漏的下划线或大写字母都会阻止替换。
图像未被替换
- 代码必须写在图像的描述字段中(Keynote 检查器 › 图像选项卡),而不是文件名中或图像上方的文本框中。
- 检查描述是否包含两个大括号:
{{ radiograph }},而不是radiograph。
所有文档、干预措施或预算幻灯片显示相同的图像
此行为发生在 OrthoKit 的早期版本中,现已修复。请更新到最新版本。
我复制了一张母版幻灯片,它在每项研究中出现了两次
这是预期行为。如果两张母版幻灯片包含相同的关键字,则两者都会包含在该区块的每次导出中。为避免这种情况,请重命名其中一张,使其名称不包含该关键字。
如何恢复为默认模板
在设置 › Keynote Builder › 活动模板中,选择列表中的第一项(未标记为自定义的那一项)。自定义模板会被保留,并可以随时重新激活。
从母版幻灯片中删除 {{ ... }} 代码会发生什么
什么都不会发生:OrthoKit 只是没有地方写入该数据,会将其省略。幻灯片的其余部分将继续正常工作。
摘要
- 在 OrthoKit 中,设置 › Keynote Builder › 创建新模板。模板会自动在 Keynote 中打开。
- 在 Keynote 中,显示 › 编辑幻灯片版式。
- 为每张母版幻灯片分配一个包含其区块关键字的名称(支柱 1)。
- 在相应的文本框中写入
{{ ... }}文本代码(支柱 2)。 - 在每张图像的描述字段中分配图像代码(支柱 3)。
- 按 ⌘S 保存。之后的任何导出都将使用此模板。