Keynote Builder

O Keynote Builder converte um modelo de Keynote desenhado por ti em apresentações automáticas do estudo de cada paciente. Preparas o modelo uma única vez — cores, tipografias, disposição, logótipos e espaços para imagens — e o OrthoKit preenche-o 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 modelos nem conhecimentos técnicos.

O que vais conseguir fazer

• Design próprio. Cores, tipografias, fundos, logótipos da tua clínica e disposição exacta de cada diapositivo.
• Dados do paciente automáticos. Nome, idade, género, ID, data de nascimento, alergias, motivo da consulta e restante informação são inseridos automaticamente.
• Fotografias clínicas no sítio certo. Frontal, perfil, sorriso, oclusais, etc. Cada tipo de fotografia ocupa o espaço que tu decidires.
• Radiografias e cefalometrias. Incluídas com data, tipo, análise e anotações.
• Orçamentos e plano de tratamento. Com título, data, montante, estado de aceitação e restantes campos.
• Exportação num clique. Sem ter de importar ficheiros nem configurar intervalos de diapositivos.

Diferença face ao antigo exportador para PowerPoint

O OrthoKit mantém o exportador antigo por compatibilidade com estudos existentes, mas a sua utilização é desaconselhada para novos pacientes.

Antes · PowerPoint / ODP

1. Preparavas o modelo em PowerPoint ou LibreOffice.
2. Guardava-lo obrigatoriamente no formato .odp (OpenDocument Presentation); o formato .pptx não era compatível.
3. Arrastavas o ficheiro .odp para o OrthoKit para o importar.
4. Abrias o «configurador de secções» e atribuías manualmente que intervalo de diapositivos correspondia a cada secção.
5. Ajustavas opções adicionais: modo de substituição de radiografias, critério de pesquisa de fotografias, número de intervenções por diapositivo, etc.
6. Qualquer alteração obrigava a exportar novamente, reimportar o ficheiro e reconfigurar os intervalos.

Agora · Keynote Builder

1. Carregas em Criar novo modelo no OrthoKit.
2. O Keynote abre automaticamente com uma cópia do modelo.
3. Editas como qualquer apresentação e guardas com ⌘S.
4. Fica activo sem passos adicionais: sem importação, sem configurador de secções, sem formato intermédio.
5. Qualquer ajuste posterior é aplicado abrindo o modelo, editando-o e guardando. Os estudos seguintes incorporam as alterações.

Conceitos essenciais

Três termos aparecem ao longo de todo o guia. Conhecê-los à partida simplifica o resto do documento.

Secçã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 secções predefinidas, podes activar/desactivar cada uma na vista de exportação do estudo do paciente, bem como personalizar o que aparece em cada uma. Cada uma gera um ou vários diapositivos na apresentação final.

Diapositivo mestre

Modelo interno do Keynote que não aparece como tal na apresentação final: funciona como molde. Define o fundo, as cores, as tipografias e a colocação das caixas de texto e imagens.

No Keynote, acede-se aos diapositivos mestres através de Visualizar › Editar esquemas de diapositivos. O OrthoKit parte deles para construir o estudo de cada paciente.

Código de substituição

Texto com a forma {{ algo }} que se escreve dentro de um diapositivo 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 modelo predefinido, que é personalizada a partir desse ponto. Não é necessário criar um ficheiro de raiz.

1. Abre o OrthoKit. Vai a Definições › Keynote Builder.

2. Carrega em «Criar novo modelo». O OrthoKit duplica o modelo predefinido, marca-o como activo e abre-o directamente no Keynote.

   

3. Entra no modo de diapositivos mestres no Keynote. Menu superior: Visualizar › Editar esquemas de diapositivos. Na barra lateral esquerda aparece a lista de diapositivos mestres disponíveis (Capa, Dados médicos, Radiografias, etc.).

   

4. Edita cada diapositivo mestre. Altera fundos, tipografias, cores e a colocação das caixas de texto e imagens. Dois requisitos: cada diapositivo mestre deve conservar um nome que o associe à sua secção (Pilar 1) e deve conter os códigos com a forma {{ ... }} que pretendas preencher (Pilares 2 e 3).

5. Guarda com ⌘S e fecha o Keynote. O modelo fica activo automaticamente. Qualquer exportação posterior utilizá-lo-á.

Podem manter-se vários modelos guardados (por exemplo, um para estudos iniciais e outro para revisões) e alternar entre eles a qualquer momento em Definições › Keynote Builder › Modelo activo.

Como funciona

Ao exportar um estudo, o OrthoKit percorre as secções activadas. Para cada secção procura os diapositivos mestres cujo nome contém a palavra-chave associada, clona-os tantas vezes quantas as necessárias (uma por cada fotografia, radiografia ou orçamento a mostrar) e preenche os códigos com os dados reais do paciente.

O sistema assenta em três pilares:

• Pilar 1 · Nomes dos diapositivos mestres. Cada secção tem uma palavra-chave (por exemplo Cover para a capa). Qualquer diapositivo mestre cujo nome contenha essa palavra é incluído ao gerar essa secção.
• Pilar 2 · Códigos de texto. Dentro de uma caixa de texto escreve-se {{ código }} e o OrthoKit substitui-o pelo dado real do paciente.
• Pilar 3 · Códigos de imagem. O código é escrito no campo Descrição de cada imagem (inspector lateral do Keynote), e o OrthoKit substitui-a pela imagem real correspondente.

Pilar 1 · Nomes dos diapositivos mestres

Cada uma das catorze secções do OrthoKit está associada a uma palavra-chave em inglês, que corresponde ao seu identificador interno. O nome de um diapositivo mestre deve conter essa palavra-chave para que o OrthoKit o associe à secção correspondente.

Como mudar o nome de um diapositivo mestre no Keynote

1. No modo Editar esquemas de diapositivos, clica sobre o nome do diapositivo mestre na barra lateral esquerda (aparece por cima da miniatura).
2. Escreve o novo nome (por exemplo, Cover) e carrega em Enter.

Tabela de palavras-chave por secção

Regra de correspondência do nome

O nome do diapositivo mestre deve conter a palavra-chave, respeitando maiúsculas e minúsculas. Usando a capa (palavra-chave: Cover) como exemplo:

• ✓ Cover · nome exacto, funciona.
• ✓ Cover 1, Cover 2 · ambos são gerados sempre que um estudo inclui 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 distingue maiúsculas e minúsculas.

Evita combinar duas palavras-chave no mesmo nome. Um nome como Cover · Radiographs faria com que o mesmo diapositivo mestre fosse utilizado tanto para capas como para radiografias, o que raramente é desejável.

Vários diapositivos mestres equivalem a várias variantes. Para alternar três designs de capa diferentes, cria três diapositivos mestres chamados Cover, Cover Vertical e Cover Minimalista. Os três serão gerados em cada estudo que inclua capa.

Diapositivo de capa de secção · palavra Title

Quando uma secção gera muitos diapositivos (radiografias, modelos 3D, seguimentos, orçamentos, etc.), costuma ser útil que o primeiro deles seja uma capa de secção —um cabeçalho a página inteira com o nome da secção— e que apareça uma única vez, não antes de cada radiografia ou de cada orçamento.

Para o conseguir, basta que o nome de um diapositivo mestre contenha, além da palavra-chave da secção, a palavra Title. O OrthoKit tratá-lo-á como capa de secção e adicioná-lo-á uma única vez no início da secção, mesmo que esta contenha muitos elementos.

Exemplos de nomes válidos:

• Radiographs Title · capa da secção de radiografias; aparece uma vez mesmo havendo 12 radiografias.
• 3D Models Title · capa da secção de modelos 3D.
• Documents Title, Treatment Plan Title, Budgets Title, etc.

Exemplo de exportação

Imagina um modelo com cinco diapositivos 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:

Radiographs Title aparece uma única vez mesmo havendo três radiografias, enquanto Radiographs é replicado para cada uma. A secção do plano de tratamento não itera, por isso Treatment Plan Title e Treatment Plan saem uma vez, seguidos.

Pilar 2 · Códigos de texto

Dentro de um diapositivo mestre, adiciona caixas de texto do Keynote e escreve {{ código }} onde queres que o OrthoKit insira o dado real. O código pode aparecer isolado ou integrado numa 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 secção e em qualquer diapositivo mestre.

Códigos do paciente

Disponíveis em Capa, Dados médicos, Documentos e Plano de tratamento.

Códigos específicos por secção

Cada secção fornece ainda códigos próprios.

Atalho dentro do OrthoKit: em Definições › Keynote Builder › Códigos prontos a colar encontras estas 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 ficheiro, mas sim pelo campo Descrição de cada imagem no Keynote.

Como atribuir um código de imagem

1. No modo Editar esquemas de diapositivos, selecciona a imagem dentro do diapositivo mestre.
2. Abre o inspector lateral (Formato) e vai ao separador Imagem.
3. No campo Descrição, escreve o código entre chavetas duplas, por exemplo {{ radiograph }}.

A imagem que está colocada no diapositivo mestre funciona apenas como espaço de referência: respeita-se a sua posição, tamanho e proporção, mas o seu conteúdo é substituído ao exportar. Pode tratar-se de uma imagem cinzenta de preenchimento ou de qualquer outra imagem de exemplo; o importante é o espaço e a descrição.

Imagens disponíveis por secção

{{ clinic_logo }} funciona em qualquer diapositivo mestre. No final do processo de exportação, o OrthoKit revê todos os diapositivos gerados e carimba o logótipo da clínica em qualquer imagem cuja descrição seja {{ clinic_logo }}.

Fotografias clínicas (iniciais, acompanhamento e comparativas)

Nestas três secções não existe um código fixo por secção: cada espaço é identificado pelo código próprio do tipo de fotografia, que coincide com o identificador interno que o OrthoKit utiliza 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 Definições › Keynote Builder › Códigos para inserir imagens › Fotografias é apresentado o catálogo íntegro de códigos disponíveis com um botão para copiar cada um.

Comparativas (antes / depois) · sufixos _A e _B

No diapositivo 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 esquerda (antes).
• {{ frontalResting_B }} · fotografia extraoral frontal em repouso da série direita (depois).
• {{ frontal_A }} / {{ frontal_B }}, {{ upper_A }} / {{ upper_B }}, e assim sucessivamente.

Só muda o sufixo. O código base da fotografia é o mesmo que seria utilizado em fotografias iniciais.

Blocos de exemplo

Podem ser colados directamente numa caixa de texto dentro do diapositivo 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é do orçamento

{{ budget_public_title }}
Emitido el {{ budget_date }} — {{ budget_accepted }}
Total: {{ budget_total }}

Problemas frequentes

Alguns diapositivos aparecem em branco

• Verifica que o nome do diapositivo mestre contém a palavra-chave exacta da secção, respeitando maiúsculas e minúsculas.
• Verifica que a secção está activada no painel de exportação do estudo do paciente.
• Se a secção precisa de dados (fotografias, orçamentos, radiografias, etc.) e não existe nenhum registado no paciente, a secção não gera diapositivos.

O texto aparece literal ({{ patient_name_lastname }}) em vez do dado real

• O código não existe ou está escrito com um erro. Consulta a lista do Pilar 2.
• Os códigos são sensíveis ao carácter exacto: um acento trocado, um underscore esquecido ou uma letra em maiúscula impedem a substituição.

A imagem não é substituída

• O código deve ser escrito no campo Descrição da imagem (inspector do Keynote › separador Imagem), não no nome do ficheiro nem numa caixa de texto colocada sobre a imagem.
• Verifica que a descrição inclui as duas chavetas: {{ radiograph }}, não radiograph.

Todos os diapositivos de documentos, intervenções ou orçamentos mostram a mesma imagem

Este comportamento ocorria em versões anteriores do OrthoKit e já está corrigido. Actualiza para a versão mais recente.

Dupliquei um diapositivo mestre e aparece duas vezes em cada estudo

É o comportamento esperado. Se dois diapositivos mestres contêm a mesma palavra-chave, ambos são incluídos em cada exportação dessa secção. Para o evitar, muda o nome de um deles para que o seu nome não contenha a palavra-chave.

Como voltar ao modelo predefinido

Em Definições › Keynote Builder › Modelo activo, selecciona a primeira entrada da lista (aquela que não aparece marcada como personalizada). Os modelos personalizados são mantidos e podem ser reactivados a qualquer momento.

O que acontece ao apagar um código {{ ... }} de um diapositivo mestre

Não acontece nada: o OrthoKit simplesmente não tem onde escrever esse dado e omite-o. O resto do diapositivo continua a funcionar normalmente.

Resumo

1. No OrthoKit, Definições › Keynote Builder › Criar novo modelo. O modelo abre automaticamente no Keynote.
2. No Keynote, Visualizar › Editar esquemas de diapositivos.
3. Atribui a cada diapositivo mestre um nome que contenha a palavra-chave da sua secção (Pilar 1).
4. Escreve os códigos de texto {{ ... }} nas caixas de texto correspondentes (Pilar 2).
5. Atribui os códigos de imagem no campo Descrição de cada imagem (Pilar 3).
6. Guarda com ⌘S. Qualquer exportação posterior utilizará este modelo.