O Keynote Builder transforma um template do Keynote desenhado por você em apresentações automáticas do estudo de cada paciente. Você prepara o template uma única vez — cores, tipografias, distribuição, logos e espaços para imagens — e o OrthoKit o preenche em segundos com os dados reais: nome, idade, fotografias clínicas, radiografias, traçados cefalométricos, intervenções e orçamentos.
Este guia foi pensado para começar do zero, sem experiência prévia com templates nem conhecimentos técnicos.
O que você vai conseguir
- Design próprio. Cores, tipografias, fundos, logos da sua clínica e distribuição exata de cada slide.
- Dados do paciente automáticos. Nome, idade, gênero, ID, data de nascimento, alergias, motivo da consulta e demais informações são inseridos automaticamente.
- Fotografias clínicas no lugar certo. Frontal, perfil, sorriso, oclusais, etc. Cada tipo de fotografia ocupa o espaço que você decidir.
- Radiografias e cefalometrias. Incluídas com data, tipo, análise e anotações.
- Orçamentos e plano de tratamento. Com título, data, valor, status de aceitação e demais campos.
- Exportação em um clique. Sem precisar importar arquivos nem configurar intervalos de slides.
Diferença em relação ao antigo exportador para PowerPoint
O OrthoKit mantém o exportador antigo por compatibilidade com estudos existentes, mas seu uso é desaconselhado para novos pacientes.
Antes · PowerPoint / ODP
- Você preparava o template no PowerPoint ou LibreOffice.
- Salvava-o especificamente no formato
.odp(OpenDocument Presentation); o formato.pptxnão era compatível. - Arrastava o arquivo
.odppara o OrthoKit para importá-lo. - Abria o “configurador de seções” e atribuía manualmente qual intervalo de slides correspondia a cada seção.
- Ajustava opções adicionais: modo de substituição de radiografias, critério de busca de fotografias, número de intervenções por slide, etc.
- Qualquer mudança obrigava a exportar novamente, reimportar o arquivo e reconfigurar os intervalos.
Agora · Keynote Builder
- Você clica em Criar novo template no OrthoKit.
- O Keynote abre automaticamente com uma cópia do template.
- Você o edita como qualquer apresentação e salva com ⌘S.
- Ele fica ativo sem passos adicionais: sem importação, sem configurador de seções, sem formato intermediário.
- Qualquer ajuste posterior é aplicado abrindo o template, editando-o e salvando. Os estudos seguintes incorporam as mudanças.
Conceitos essenciais
Três termos aparecem ao longo de todo o guia. Conhecê-los antecipadamente simplifica o restante do documento.
Seção
Cada um dos blocos temáticos do estudo do paciente: Capa, Fotografias iniciais, Radiografias, Plano de tratamento, Orçamentos, entre outros. O OrthoKit tem catorze seções predefinidas; você pode ativar/desativar cada uma na visão de exportação do estudo do paciente, bem como personalizar o que aparece em cada uma. Cada seção gera um ou vários slides na apresentação final.
Slide mestre
Template interno do Keynote que não aparece como tal na apresentação final: atua como molde. Define o fundo, as cores, as tipografias e o posicionamento das caixas de texto e imagens.
No Keynote, os slides mestres são acessados em Visualização › Editar layouts de slides. O OrthoKit parte deles para construir o estudo de cada paciente.
Código de substituição
Texto no formato {{ algo }} que se escreve dentro de um slide e que o OrthoKit reconhece e substitui pelo dado real do paciente ao gerar o estudo.
Existem códigos de texto (por exemplo, {{ patient_name_lastname }}) e códigos de imagem (por exemplo, {{ radiograph }}).
Como começar
O OrthoKit parte sempre de uma cópia do template padrão, que é personalizado a partir desse ponto. Não é necessário criar um arquivo do zero.
Abra o OrthoKit. Vá em Ajustes › Keynote Builder.
Clique em “Criar novo template”. O OrthoKit duplica o template padrão, marca-o como ativo e abre-o diretamente no Keynote.
Entre no modo de slides mestres no Keynote. Menu superior: Visualização › Editar layouts de slides. Na barra lateral esquerda aparece a lista de slides mestres disponíveis (Capa, Dados médicos, Radiografias, etc.).
Edite cada slide mestre. Altere fundos, tipografias, cores e o posicionamento das caixas de texto e imagens. Dois requisitos: cada slide mestre deve conservar um nome que o associe à sua seção (Pilar 1) e deve conter os códigos no formato
{{ ... }}que você quiser preencher (Pilares 2 e 3).Salve com ⌘S e feche o Keynote. O template fica ativo automaticamente. Qualquer exportação posterior o utilizará.
Vários templates podem ser mantidos salvos (por exemplo, um para estudos iniciais e outro para revisões) e alternados a qualquer momento em Ajustes › Keynote Builder › Template ativo.
Como funciona
Ao exportar um estudo, o OrthoKit percorre as seções ativadas. Para cada seção, busca os slides mestres cujo nome contenha a palavra-chave associada, clona-os tantas vezes quantas forem necessárias (uma para cada fotografia, radiografia ou orçamento a exibir) e preenche os códigos com os dados reais do paciente.
O sistema se apoia em três pilares:
- Pilar 1 · Nomes dos slides mestres. Cada seção tem uma palavra-chave (por exemplo,
Coverpara a capa). Qualquer slide mestre cujo nome contenha essa palavra é incluído ao gerar essa seção. - Pilar 2 · Códigos de texto. Dentro de uma caixa de texto, escreve-se
{{ código }}e o OrthoKit o substitui pelo dado real do paciente. - Pilar 3 · Códigos de imagem. O código é escrito no campo Descrição de cada imagem (inspetor lateral do Keynote), e o OrthoKit a substitui pela imagem real correspondente.
Pilar 1 · Nomes dos slides mestres
Cada uma das catorze seções do OrthoKit está associada a uma palavra-chave em inglês, que corresponde ao seu identificador interno. O nome de um slide mestre deve conter essa palavra-chave para que o OrthoKit o associe à seção correspondente.
Como renomear um slide mestre no Keynote
- No modo Editar layouts de slides, clique sobre o nome do slide mestre na barra lateral esquerda (aparece acima da miniatura).
- Digite o novo nome (por exemplo,
Cover) e pressione Enter.
Tabela de palavras-chave por seção
| Seção no OrthoKit | Palavra-chave do nome |
|---|---|
| Capa | Cover |
| Filiação e dados médicos | Demographics |
| Documentos (PDF, consentimentos, etc.) | Documents |
| Fotografias iniciais | Initial Photographs |
| Acompanhamento extraoral | Extraoral Follow Up |
| Acompanhamento intraoral | Intraoral Follow Up |
| Comparativas (antes / depois) | Comparative Photographs |
| Radiografias | Radiographs |
| Cefalometrias (traçados) | Cephalometrics |
| Superposição cefalométrica | Superimposition |
| Modelos 3D | 3D Models |
| Plano de tratamento | Treatment Plan |
| Intervenções (histórico de consultas) | Interventions |
| Orçamentos | Budgets |
Regra de correspondência do nome
O nome do slide mestre deve conter a palavra-chave, respeitando maiúsculas e minúsculas. Usando a capa (palavra-chave: Cover) como exemplo:
- ✓
Cover· nome exato, funciona. - ✓
Cover 1,Cover 2· ambos são gerados sempre que um estudo incluir a capa. - ✓
Cover Minimalista,My Cover Dark· funcionam; o nome contém a palavra-chave. - ✗
Capa· não contém a palavra-chave; não será utilizado. - ✗
cover· a correspondência diferencia maiúsculas de minúsculas.
Evite combinar duas palavras-chave no mesmo nome. Um nome como
Cover · Radiographsfaria com que o mesmo slide mestre fosse usado tanto para capas quanto para radiografias, o que raramente é desejável.
Vários slides mestres equivalem a várias variantes. Para alternar três designs de capa diferentes, crie três slides mestres chamados
Cover,Cover VerticaleCover Minimalista. Os três serão gerados em cada estudo que incluir capa.
Slide de capa de seção · palavra Title
Quando uma seção gera muitos slides (radiografias, modelos 3D, acompanhamentos, orçamentos, etc.), costuma ser útil que o primeiro deles seja uma capa de seção —um cabeçalho em página inteira com o nome da seção— e que apareça uma única vez, não antes de cada radiografia ou de cada orçamento.
Para conseguir isso, basta que o nome de um slide mestre contenha, além da palavra-chave da seção, a palavra Title. O OrthoKit vai tratá-lo como capa de seção e adicioná-lo uma única vez no início da seção, mesmo que ela contenha muitos elementos.
Exemplos de nomes válidos:
Radiographs Title· capa da seção de radiografias; aparece uma vez mesmo havendo 12 radiografias.3D Models Title· capa da seção de modelos 3D.Documents Title,Treatment Plan Title,Budgets Title, etc.
Exemplo de exportação
Imagine um modelo com cinco slides mestres: Cover, Radiographs Title, Radiographs, Treatment Plan Title e Treatment Plan. Ao exportar um estudo com três radiografias, o OrthoKit produz a seguinte sequência:
| # | Slide mestre | Notas |
|---|---|---|
| 1 | Cover | capa do estudo |
| 2 | Radiographs Title | uma única vez |
| 3 | Radiographs | radiografia 1 |
| 4 | Radiographs | radiografia 2 |
| 5 | Radiographs | radiografia 3 |
| 6 | Treatment Plan Title | uma única vez |
| 7 | Treatment Plan | conteúdo do plano de tratamento |
Radiographs Title aparece uma única vez mesmo havendo três radiografias, enquanto Radiographs é replicado para cada uma. A seção do plano de tratamento não itera, por isso Treatment Plan Title e Treatment Plan saem uma vez, em sequência.
Pilar 2 · Códigos de texto
Dentro de um slide mestre, adicione caixas de texto do Keynote e escreva {{ código }} onde quiser que o OrthoKit insira o dado real. O código pode aparecer isolado ou integrado em uma frase.
Exemplo
Paciente: {{ patient_name_lastname }}
Edad al inicio: {{ complete_age }}
Fase: {{ phase_title }} ({{ phase_idx }})
Documento emitido el {{ doc_creation }}
Ao exportar o estudo, o OrthoKit converte esse bloco em algo como:
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
Códigos gerais
Disponíveis em qualquer seção e em qualquer slide mestre.
| Descrição | Código |
|---|---|
| Data de criação do documento (hoje) | {{ doc_creation }} |
| Nome da clínica | {{ clinic_title }} |
| Título da fase ativa | {{ phase_title }} |
| Índice da fase (por exemplo, “1 de 3”) | {{ phase_idx }} |
| Data de início da fase | {{ phase_creation }} |
Códigos do paciente
Disponíveis em Capa, Dados médicos, Documentos e Plano de tratamento.
| Descrição | Código |
|---|---|
| Nome | {{ patient_onlyName }} |
| Sobrenome | {{ patient_onlyLastname }} |
| Nome e sobrenome | {{ patient_name_lastname }} |
| Resumo (nome · idade · gênero) | {{ patient_summary }} |
| Identificador do paciente | {{ patient_id }} |
| Gênero | {{ patient_gender }} |
| Etiquetas | {{ patient_tags }} |
| Data de nascimento | {{ patient_birthdate }} |
| Idade completa (por exemplo, “8 anos e 4 meses”) | {{ complete_age }} |
| Idade com unidade (por exemplo, “8 anos”) | {{ patient_age }} |
| Apenas anos | {{ age_years }} |
| Apenas meses residuais | {{ age_months }} |
| Data de cadastro do paciente | {{ patient_creation }} |
Códigos específicos por seção
Cada seção oferece também códigos próprios.
Capa · slide mestre: Cover
| Descrição | Código |
|---|---|
| Título da capa | {{ cover_title }} |
| Nome do doutor | {{ cover_doctor }} |
| Alerta médico | {{ patient_alert }} |
Se o estudo tiver uma única fase, {{ phase_title }} e {{ phase_idx }} ficam vazios na capa para evitar linhas sem informação.
Dados médicos · slide mestre: Demographics
| Descrição | Código |
|---|---|
| Ocupação | {{ patient_job }} |
| Atividades | {{ patient_activities }} |
| Hábitos | {{ patient_habits }} |
| Doenças | {{ patient_diseases }} |
| Motivo da consulta | {{ consulation_motiv }} |
| Alergias | {{ patient_allergies }} |
| Cirurgias | {{ patient_surgeries }} |
| Medicação | {{ patient_medication }} |
| Outras informações | {{ other_information }} |
{{ patient_email }} | |
| Endereço | {{ patient_address }} |
| Telefone | {{ patient_phone }} |
| Alerta médico | {{ patient_alert }} |
Documentos · slide mestre: Documents
| Descrição | Código |
|---|---|
| Nome do arquivo | {{ document_filename }} |
| Data do arquivo | {{ document_date }} |
| Índice do documento (por exemplo, “1 de 4”) | {{ document_idx }} |
Fotografias iniciais · slide mestre: Initial Photographs
| Descrição | Código |
|---|---|
| Data da sessão | {{ initials_date }} |
| Anotações | {{ initials_annotation }} |
Acompanhamento extraoral e intraoral · slides mestres: Extraoral Follow Up, Intraoral Follow Up
| Descrição | Código |
|---|---|
| Descrição do momento de acompanhamento | {{ sequence_monthDescription }} |
| Data da sequência | {{ sequence_date }} |
| Anotação da sequência | {{ sequence_annotation }} |
| Índice de acompanhamento (por exemplo, “2 de 5”) | {{ tracking_idx }} |
Radiografias · slide mestre: Radiographs
| Descrição | Código |
|---|---|
| Tipo de radiografia | {{ radio_title }} |
| Data | {{ radio_date }} |
| Anotação | {{ radio_annotation }} |
| Índice de radiografia (por exemplo, “1 de 4”) | {{ radio_idx }} |
Cefalometrias · slide mestre: Cephalometrics
| Descrição | Código |
|---|---|
| Título do traçado | {{ plot_title }} |
| Data do traçado | {{ plot_date }} |
| Autor da análise | {{ tracing_analysis }} |
| Anotação da radiografia associada | {{ tracing_annotation }} |
| Índice do traçado | {{ tracing_idx }} |
Superposições · slide mestre: Superimposition
| Descrição | Código |
|---|---|
| Método de superposição | {{ superimposition_title }} |
| Datas combinadas (base – superposta) | {{ superimposition_date }} |
| Título do traçado base | {{ superimposition_base_title }} |
| Título do traçado superposto | {{ superimposition_over_title }} |
| Data do traçado base | {{ superimposition_base_date }} |
| Data do traçado superposto | {{ superimposition_over_date }} |
| Tempo decorrido entre traçados | {{ superimposition_elapsed }} |
Modelos 3D · slide mestre: 3D Models
| Descrição | Código |
|---|---|
| Título do modelo | {{ model_title }} |
| Data | {{ model_date }} |
| Anotações | {{ model_annotation }} |
| Índice do modelo | {{ model_idx }} |
| Tempo decorrido desde o primeiro modelo | {{ model_elapsed }} |
Plano de tratamento · slide mestre: Treatment Plan
| Descrição | Código |
|---|---|
| Objetivos | {{ treatment_objectives }} |
| Diagnóstico | {{ treatment_diagnosis }} |
| Sequência | {{ treatment_sequence }} |
| Extrações | {{ treatment_extractions }} |
| Microparafusos | {{ treatment_tads }} |
| Contenção | {{ treatment_retention }} |
Intervenções · slide mestre: Interventions
| Descrição | Código |
|---|---|
| Número da página de intervenção | {{ int_idx }} |
| Título da fase ativa | {{ interventions_phase_title }} |
A lista de intervenções em si é gerada como imagem (ver Pilar 3 › {{ interventions }}).
Orçamentos · slide mestre: Budgets
| Descrição | Código |
|---|---|
| Título público (o que o paciente vê) | {{ budget_public_title }} |
| Título privado (interno) | {{ budget_private_title }} |
| Título (alias do privado) | {{ budget_title }} |
| Data | {{ budget_date }} |
| Data de aceitação | {{ budget_acceptation_date }} |
| Status (vazio se não estiver aceito) | {{ budget_accepted }} |
| Valor total (com moeda) | {{ budget_total }} |
| Índice do orçamento | {{ budget_idx }} |
Atalho dentro do OrthoKit: em Ajustes › Keynote Builder › Códigos para colar encontram-se essas mesmas listas com um botão para copiar cada código para a área de transferência.
Pilar 3 · Códigos de imagem
As imagens não são identificadas pelo nome do arquivo, e sim pelo campo Descrição de cada imagem no Keynote.
Como atribuir um código de imagem
- No modo Editar layouts de slides, selecione a imagem dentro do slide mestre.
- Abra o inspetor lateral (Formato) e vá até a aba Imagem.
- No campo Descrição, escreva o código entre chaves duplas, por exemplo
{{ radiograph }}.
A imagem colocada no slide mestre atua apenas como espaço de referência: sua posição, tamanho e proporção são respeitados, mas seu conteúdo é substituído na exportação. Pode ser uma imagem cinza de preenchimento ou qualquer outra imagem de amostra; o importante é o espaço e a descrição.
Imagens disponíveis por seção
| Seção | O que é inserido | Código (na Descrição) |
|---|---|---|
| Capa · Dados médicos | Imagem lateral principal | {{ side_image }} |
| Documentos | Pré-visualização do documento | {{ document }} |
| Radiografias | Radiografia do paciente | {{ radiograph }} |
| Cefalometrias | Desenho do traçado sobre a telerradiografia | {{ radiograph }} |
| Cefalometrias | Tabela de valores da análise | {{ tracing }} |
| Superposições | Render da superposição | {{ superimposition }} |
| Intervenções | Render do bloco de intervenções | {{ interventions }} |
| Orçamentos | Render do orçamento | {{ budget }} |
{{ clinic_logo }}funciona em qualquer slide mestre. Ao final do processo de exportação, o OrthoKit revisa todos os slides gerados e estampa o logotipo da clínica em qualquer imagem cuja descrição seja{{ clinic_logo }}.
Fotografias clínicas (iniciais, acompanhamento e comparativas)
Nessas três seções não existe um código fixo por seção: cada espaço é identificado com o código próprio do tipo de fotografia, que coincide com o identificador interno que o OrthoKit usa para cada uma.
Exemplos de códigos extraorais: {{ frontalResting }}, {{ frontalSmiling }}, {{ profileResting }}, {{ profileSmiling }}, {{ threeQuartersResting }}, {{ threeQuartersSmiling }}.
Exemplos de códigos intraorais: {{ frontal }}, {{ right }}, {{ left }}, {{ upper }}, {{ lower }}, {{ openedFrontal }}, {{ overjetFrontal }}.
Lista completa dentro do OrthoKit: em Ajustes › Keynote Builder › Códigos para inserir imagens › Fotografias é exibido o catálogo completo de códigos disponíveis com um botão para copiar cada um.
Comparativas (antes / depois) · sufixos _A e _B
No slide mestre de comparativas, cada espaço existe duas vezes: um para a série da esquerda e outro para a série da direita. Ao código base é acrescentado o sufixo correspondente:
{{ frontalResting_A }}· fotografia extraoral frontal em repouso da série da esquerda (antes).{{ frontalResting_B }}· fotografia extraoral frontal em repouso da série da direita (depois).{{ frontal_A }}/{{ frontal_B }},{{ upper_A }}/{{ upper_B }}, e assim por diante.
Apenas o sufixo muda. O código base da fotografia é o mesmo que seria usado em fotografias iniciais.
Blocos de exemplo
Podem ser colados diretamente em uma caixa de texto dentro do slide mestre correspondente.
Capa
{{ cover_title }}
{{ patient_name_lastname }}
{{ complete_age }} · {{ patient_gender }}
{{ clinic_title }} · {{ doc_creation }}
Dados médicos
Motivo de consulta: {{ consulation_motiv }}
Alergias: {{ patient_allergies }}
Medicación: {{ patient_medication }}
Hábitos: {{ patient_habits }}
Cabeçalho de acompanhamento
{{ sequence_monthDescription }} — {{ sequence_date }}
Seguimiento {{ tracking_idx }}
{{ sequence_annotation }}
Rodapé de orçamento
{{ budget_public_title }}
Emitido el {{ budget_date }} — {{ budget_accepted }}
Total: {{ budget_total }}
Problemas comuns
Alguns slides saem em branco
- Verifique se o nome do slide mestre contém a palavra-chave exata da seção, respeitando maiúsculas e minúsculas.
- Verifique se a seção está ativada no painel de exportação do estudo do paciente.
- Se a seção precisa de dados (fotografias, orçamentos, radiografias, etc.) e não há nenhum registrado no paciente, a seção não gera slides.
O texto aparece literal ({{ patient_name_lastname }}) em vez do dado real
- O código não existe ou está escrito com algum erro. Consulte a lista do Pilar 2.
- Os códigos são sensíveis ao caractere exato: um acento trocado, um sublinhado esquecido ou uma letra maiúscula impedem a substituição.
A imagem não é substituída
- O código deve ser escrito no campo Descrição da imagem (inspetor do Keynote › aba Imagem), não no nome do arquivo nem em uma caixa de texto posicionada sobre a imagem.
- Verifique se a descrição inclui as duas chaves:
{{ radiograph }}, nãoradiograph.
Todos os slides de documentos, intervenções ou orçamentos mostram a mesma imagem
Esse comportamento ocorria em versões anteriores do OrthoKit e já está corrigido. Atualize para a versão mais recente.
Dupliquei um slide mestre e ele aparece duas vezes em cada estudo
Esse é o comportamento esperado. Se dois slides mestres contêm a mesma palavra-chave, os dois são incluídos em cada exportação dessa seção. Para evitar isso, renomeie um deles para que seu nome não contenha a palavra-chave.
Como voltar ao template padrão
Em Ajustes › Keynote Builder › Template ativo, selecione a primeira entrada da lista (a que não aparece marcada como personalizada). Os templates personalizados são conservados e podem ser reativados a qualquer momento.
O que acontece ao apagar um código {{ ... }} de um slide mestre
Nada acontece: o OrthoKit simplesmente não tem onde escrever esse dado e o omite. O restante do slide continua funcionando normalmente.
Resumo
- No OrthoKit, Ajustes › Keynote Builder › Criar novo template. O template abre automaticamente no Keynote.
- No Keynote, Visualização › Editar layouts de slides.
- Atribua a cada slide mestre um nome que contenha a palavra-chave da sua seção (Pilar 1).
- Escreva os códigos de texto
{{ ... }}nas caixas de texto correspondentes (Pilar 2). - Atribua os códigos de imagem no campo Descrição de cada imagem (Pilar 3).
- Salve com ⌘S. Qualquer exportação posterior utilizará este template.