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 використовує їх як основу для побудови дослідження кожного пацієнта.
Код заміни
Текст у формі {{ щось }}, який записується всередині слайда і який 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) і натисніть Enter.
Таблиця ключових слів за секцією
| Секція в 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. Будь-який подальший експорт використовуватиме цей шаблон.