Keynote Builder превращает разработанный вами шаблон Keynote в автоматические презентации исследования каждого пациента. Вы готовите шаблон один раз — цвета, шрифты, расположение, логотипы и места для изображений — а OrthoKit за секунды заполняет его реальными данными: имя, возраст, клинические фотографии, рентгеновские снимки, цефалометрические анализы, вмешательства и сметы.
Это руководство рассчитано на тех, кто начинает с нуля, без предыдущего опыта работы с шаблонами и технических знаний.
Что вы сможете получить
- Собственный дизайн. Цвета, шрифты, фоны, логотипы вашей клиники и точное расположение каждого слайда.
- Автоматические данные пациента. Имя, возраст, пол, ID, дата рождения, аллергии, причина обращения и другая информация вставляются автоматически.
- Клинические фотографии на своих местах. Фронтальные, профильные, с улыбкой, окклюзионные и т. д. Каждый тип фотографии занимает то место, которое вы определили.
- Рентгеновские снимки и цефалометрии. Включены с датой, типом, анализом и аннотациями.
- Сметы и план лечения. С названием, датой, суммой, статусом принятия и другими полями.
- Экспорт в один клик. Без импорта файлов и настройки диапазонов слайдов.
Отличие от старого экспортера в PowerPoint
OrthoKit сохраняет старый экспортер для совместимости с существующими исследованиями, но его использование не рекомендуется для новых пациентов.
Раньше · PowerPoint / ODP
- Вы готовили шаблон в PowerPoint или LibreOffice.
- Сохраняли его специально в формате
.odp(OpenDocument Presentation); формат.pptxне поддерживался. - Перетаскивали файл
.odpв OrthoKit для импорта. - Открывали «конфигуратор разделов» и вручную назначали, какой диапазон слайдов соответствует каждому разделу.
- Настраивали дополнительные параметры: режим замены рентгеновских снимков, критерий поиска фотографий, количество вмешательств на слайд и т. д.
- Любое изменение вынуждало заново экспортировать, повторно импортировать файл и перенастраивать диапазоны.
Сейчас · Keynote Builder
- Вы нажимаете Создать новый шаблон в OrthoKit.
- Keynote автоматически открывается с копией шаблона.
- Вы редактируете его как любую презентацию и сохраняете с помощью ⌘S.
- Он остаётся активным без дополнительных действий: без импорта, без конфигуратора разделов, без промежуточного формата.
- Любая последующая корректировка применяется путём открытия шаблона, редактирования и сохранения. Следующие исследования учитывают изменения.
Основные понятия
Три термина встречаются на протяжении всего руководства. Знание их заранее упрощает остальную часть документа.
Раздел
Каждый из тематических блоков исследования пациента: Обложка, Начальные фотографии, Рентгеновские снимки, План лечения, Сметы и другие. В OrthoKit четырнадцать предопределённых разделов, каждый из которых можно включить/отключить в представлении экспорта исследования пациента, а также настроить, что появляется в каждом из них. Каждый раздел создаёт один или несколько слайдов в итоговой презентации.
Мастер-слайд
Внутренний шаблон Keynote, который не отображается как таковой в итоговой презентации: он действует как форма. Определяет фон, цвета, шрифты и расположение текстовых полей и изображений.
В Keynote доступ к мастер-слайдам осуществляется через Вид › Изменить макеты слайдов. OrthoKit использует их для построения исследования каждого пациента.
Код замены
Текст в форме {{ algo }}, который пишется внутри слайда и который OrthoKit распознаёт и заменяет реальными данными пациента при создании исследования.
Существуют текстовые коды (например, {{ patient_name_lastname }}) и коды изображений (например, {{ radiograph }}).
Как начать
OrthoKit всегда отталкивается от копии шаблона по умолчанию, которая затем персонализируется. Нет необходимости создавать файл с нуля.
Откройте OrthoKit. Перейдите в Настройки › Keynote Builder.
Нажмите «Создать новый шаблон». OrthoKit дублирует шаблон по умолчанию, помечает его как активный и открывает непосредственно в Keynote.
Войдите в режим мастер-слайдов в Keynote. Верхнее меню: Вид › Изменить макеты слайдов. В левой боковой панели появляется список доступных мастер-слайдов (Обложка, Медицинские данные, Рентгеновские снимки и т. д.).
Отредактируйте каждый мастер-слайд. Меняйте фоны, шрифты, цвета и расположение текстовых полей и изображений. Два требования: каждый мастер-слайд должен сохранять имя, связывающее его с разделом (Столп 1), и содержать коды в форме
{{ ... }}, которые вы хотите заполнять (Столпы 2 и 3).Сохраните с помощью ⌘S и закройте Keynote. Шаблон автоматически становится активным. Любой последующий экспорт будет его использовать.
Можно хранить несколько сохранённых шаблонов (например, один для начальных исследований и другой для повторных осмотров) и переключаться между ними в любое время через Настройки › Keynote Builder › Активный шаблон.
Как это работает
При экспорте исследования OrthoKit проходит по активированным разделам. Для каждого раздела он ищет мастер-слайды, имя которых содержит связанное ключевое слово, клонирует их столько раз, сколько необходимо (по одному на каждую фотографию, рентгеновский снимок или смету для отображения) и заполняет коды реальными данными пациента.
Система опирается на три столпа:
- Столп 1 · Имена мастер-слайдов. Каждый раздел имеет ключевое слово (например,
Coverдля обложки). Любой мастер-слайд, имя которого содержит это слово, включается при генерации данного раздела. - Столп 2 · Текстовые коды. Внутри текстового поля пишется
{{ код }}, и 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 |
| Рентгеновские снимки | 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приведёт к тому, что один и тот же мастер-слайд будет использоваться как для обложек, так и для рентгеновских снимков, что редко желательно.
Несколько мастер-слайдов равнозначны нескольким вариантам. Чтобы чередовать три разных дизайна обложки, создайте три мастер-слайда с именами
Cover,Cover VerticalиCover Minimalista. Все три будут сгенерированы в каждом исследовании, включающем обложку.
Столп 2 · Текстовые коды
Внутри мастер-слайда добавляйте текстовые поля Keynote и пишите {{ код }} там, где хотите, чтобы OrthoKit вставил реальные данные. Код может стоять отдельно или быть встроен во фразу.
Пример
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 из 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 из 4») | {{ document_idx }} |
Начальные фотографии · мастер-слайд: Initial Photographs
| Описание | Код |
|---|---|
| Дата сессии | {{ initials_date }} |
| Аннотации | {{ initials_annotation }} |
Экстраоральное и интраоральное наблюдение · мастер-слайды: Extraoral Follow Up, Intraoral Follow Up
| Описание | Код |
|---|---|
| Описание момента наблюдения | {{ sequence_monthDescription }} |
| Дата последовательности | {{ sequence_date }} |
| Аннотация последовательности | {{ sequence_annotation }} |
| Индекс наблюдения (например, «2 из 5») | {{ tracking_idx }} |
Рентгеновские снимки · мастер-слайд: Radiographs
| Описание | Код |
|---|---|
| Тип рентгеновского снимка | {{ radio_title }} |
| Дата | {{ radio_date }} |
| Аннотация | {{ radio_annotation }} |
| Индекс снимка (например, «1 из 4») | {{ radio_idx }} |
Цефалометрии · мастер-слайд: Cephalometrics
| Описание | Код |
|---|---|
| Заголовок трассировки | {{ plot_title }} |
| Дата трассировки | {{ plot_date }} |
| Автор анализа | {{ tracing_analysis }} |
| Аннотация связанного снимка | {{ 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 }} |
| Рентгеновские снимки | Рентгеновский снимок пациента | {{ 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 }}
Частые проблемы
Некоторые слайды выходят пустыми
- Убедитесь, что имя мастер-слайда содержит точное ключевое слово раздела с соблюдением регистра.
- Убедитесь, что раздел активирован в панели экспорта исследования пациента.
- Если разделу нужны данные (фотографии, сметы, рентгеновские снимки и т. д.), а у пациента ничего не зарегистрировано, раздел не создаёт слайдов.
Текст появляется буквально ({{ patient_name_lastname }}) вместо реальных данных
- Код не существует или написан с ошибкой. Смотрите список в Столпе 2.
- Коды чувствительны к точным символам: изменённый акцент, забытое нижнее подчёркивание или буква в верхнем регистре препятствуют замене.
Изображение не заменяется
- Код должен быть записан в поле Описание изображения (инспектор Keynote › вкладка Изображение), а не в имени файла и не в текстовом поле над изображением.
- Убедитесь, что описание включает обе скобки:
{{ radiograph }}, а неradiograph.
Все слайды документов, вмешательств или смет показывают одно и то же изображение
Это поведение встречалось в более ранних версиях OrthoKit и уже исправлено. Обновитесь до последней версии.
Я продублировал мастер-слайд, и он появляется дважды в каждом исследовании
Это ожидаемое поведение. Если два мастер-слайда содержат одно и то же ключевое слово, оба включаются в каждый экспорт этого раздела. Чтобы этого избежать, переименуйте один из них так, чтобы его имя не содержало ключевого слова.
Как вернуться к шаблону по умолчанию
В Настройки › Keynote Builder › Активный шаблон выберите первую запись в списке (ту, которая не помечена как пользовательская). Пользовательские шаблоны сохраняются и могут быть повторно активированы в любой момент.
Что происходит при удалении кода {{ ... }} из мастер-слайда
Ничего не происходит: OrthoKit просто не имеет места, куда записать эти данные, и опускает их. Остальная часть слайда продолжает работать нормально.
Резюме
- В OrthoKit: Настройки › Keynote Builder › Создать новый шаблон. Шаблон автоматически открывается в Keynote.
- В Keynote: Вид › Изменить макеты слайдов.
- Назначьте каждому мастер-слайду имя, содержащее ключевое слово его раздела (Столп 1).
- Напишите текстовые коды
{{ ... }}в соответствующих текстовых полях (Столп 2). - Назначьте коды изображений в поле Описание каждого изображения (Столп 3).
- Сохраните с помощью ⌘S. Любой последующий экспорт будет использовать этот шаблон.