Keynote Builder는 여러분이 디자인한 Keynote 템플릿을 각 환자의 스터디 자동 프레젠테이션으로 변환합니다. 색상, 폰트, 레이아웃, 로고, 이미지 슬롯 등 템플릿을 한 번만 준비하면, OrthoKit이 몇 초 만에 실제 데이터(이름, 나이, 임상 사진, 방사선 사진, 세팔로메트리 트레이싱, 인터벤션, 견적)로 채웁니다.
이 가이드는 템플릿 경험이나 기술적 지식 없이 처음부터 시작할 수 있도록 구성되어 있습니다.
무엇을 달성할 수 있는가
- 나만의 디자인. 색상, 폰트, 배경, 클리닉 로고, 각 슬라이드의 정확한 레이아웃.
- 환자 데이터 자동 입력. 이름, 나이, 성별, ID, 생년월일, 알레르기, 상담 사유 및 기타 정보가 자동으로 삽입됩니다.
- 임상 사진이 제자리에. 정면, 측면, 미소, 교합면 등. 각 사진 유형은 여러분이 결정한 슬롯을 차지합니다.
- 방사선 사진과 세팔로메트리. 날짜, 유형, 분석, 주석 포함.
- 견적과 치료 계획. 제목, 날짜, 금액, 승인 상태 및 기타 필드 포함.
- 원클릭 내보내기. 파일 가져오기나 슬라이드 범위 구성 필요 없음.
이전 PowerPoint 내보내기와의 차이
OrthoKit은 기존 스터디와의 호환성을 위해 예전 내보내기 기능을 유지하지만, 새 환자에게는 사용을 권장하지 않습니다.
이전 · PowerPoint / ODP
- PowerPoint나 LibreOffice에서 템플릿을 준비했습니다.
- 특별히
.odp(OpenDocument Presentation) 형식으로 저장해야 했으며,.pptx형식은 지원되지 않았습니다. .odp파일을 OrthoKit에 드래그해서 가져왔습니다.- “섹션 구성기"를 열고 각 섹션에 해당하는 슬라이드 범위를 수동으로 할당했습니다.
- 추가 옵션 조정: 방사선 사진 교체 모드, 사진 검색 기준, 슬라이드당 인터벤션 수 등.
- 어떤 변경이든 다시 내보내기, 파일 재가져오기, 범위 재구성이 필요했습니다.
지금 · Keynote Builder
- OrthoKit에서 새 템플릿 만들기를 누릅니다.
- Keynote가 템플릿 사본과 함께 자동으로 열립니다.
- 일반 프레젠테이션처럼 편집하고 ⌘S로 저장합니다.
- 추가 단계 없이 활성 상태가 됩니다. 가져오기, 섹션 구성기, 중간 형식 없음.
- 이후 수정 사항은 템플릿을 열어 편집하고 저장하면 적용됩니다. 이후 스터디에 변경 사항이 반영됩니다.
핵심 개념
세 가지 용어가 가이드 전반에 등장합니다. 미리 알아두면 나머지 문서가 간단해집니다.
섹션
환자 스터디의 각 주제 블록: 표지, 초기 사진, 방사선 사진, 치료 계획, 견적 등. OrthoKit에는 14개의 사전 정의된 섹션이 있으며, 환자 스터디 내보내기 뷰에서 각각을 활성화/비활성화할 수 있고, 각 섹션에 무엇이 표시될지 커스터마이즈할 수 있습니다. 각 섹션은 최종 프레젠테이션에서 하나 이상의 슬라이드를 생성합니다.
마스터 슬라이드
최종 프레젠테이션에는 그대로 나타나지 않는 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 · 텍스트 코드. 텍스트 상자 안에
{{ código }}를 작성하면 OrthoKit이 이를 실제 환자 데이터로 치환합니다. - 기둥 3 · 이미지 코드. 코드는 각 이미지의 설명 필드(Keynote 사이드 인스펙터)에 작성되며, OrthoKit이 해당하는 실제 이미지로 교체합니다.
기둥 1 · 마스터 슬라이드 이름
OrthoKit의 14개 섹션 각각은 영어 키워드와 연결되어 있으며, 이는 내부 식별자에 해당합니다. 마스터 슬라이드의 이름은 해당 섹션과 연결되기 위해 해당 키워드를 포함해야 합니다.
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이 실제 데이터를 삽입하기를 원하는 곳에 {{ 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 }} |
방사선 사진 · 마스터 슬라이드: Radiographs
| 설명 | 코드 |
|---|---|
| 방사선 사진 유형 | {{ radio_title }} |
| 날짜 | {{ radio_date }} |
| 주석 | {{ radio_annotation }} |
| 방사선 사진 인덱스 (예: “1 of 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로 저장합니다. 이후의 모든 내보내기는 이 템플릿을 사용합니다.