# Nós estruturados: descrição, personagem e diálogo

> Abra o menu de tipos, escolha com as teclas numéricas e veja o que o Enter continua.

Source: https://loomworld.ai/pt-pt/docs/editor-nodes

## Abrir o menu de tipos

Existem duas formas, consoante a mão que tiver livre: prima `Tab` em qualquer linha do manuscrito ou escreva `/` no início de uma linha vazia. O menu surge a flutuar a partir da linha atual como uma barra de etiquetas de tipos.

Enquanto estiver aberto, a linha fica intencionalmente só de leitura — é isso que mantém os dígitos premidos no menu, em vez de os inserir no texto. Cancele com `Esc` ou continue simplesmente a escrever.

## Escolher com as teclas numéricas ou com o rato

A ordem é fixa, pelo que as teclas de `1` a `9` correspondem diretamente: 1 Descrição, 2 Personagem, 3 Diálogo, 4 Comentário, 5 Ação do diálogo, 6 Narração, 7 Transição, 8 Tempo e lugar, 9 Cena. Mova o destaque com as teclas `↑` e `↓` (ou Tab) e confirme com `Enter`. Também pode clicar com o rato; os números apenas preservam o ritmo da escrita.

O nó mais fácil de usar incorretamente é Personagem: serve apenas para declarar quem profere as falas que se seguem. Alguém a entrar, a olhar pela janela sem dizer nada — isso é uma linha de descrição. Se usar Personagem como marcador de presença, as contagens de aparições ficarão distorcidas.

## Como o Enter e as setas continuam o texto

- Premir Enter numa linha de personagem cria o respetivo diálogo; premir Enter numa linha de diálogo mantém o tipo Diálogo, para que uma sequência de falas não exija nova seleção.
- Premir Enter em qualquer outro tipo regressa a uma linha de descrição.
- A ação é uma inserção no interior do diálogo: a sequência válida é personagem → (qualquer número de ações) → um ou mais diálogos. Uma ação não pode definir um interlocutor.
- Um comentário encerra o interlocutor atual — são palavras para si próprio, não fazem parte do diálogo.
- Em linhas simples, premir ↑ ou ↓ na primeira ou última linha salta para o nó anterior ou seguinte; os nós de cena e de tempo e lugar têm vários campos, pelo que o Enter percorre primeiro os campos e só abre uma nova linha após o último.
- Premir Enter numa linha vazia dentro de uma cena sai dessa cena; premir Backspace numa linha vazia elimina-a e devolve o foco.

## O que cada nó permite preencher

Assim que uma linha recebe um tipo, os campos disponíveis variam conforme a escolha — conhecê-los poupa tentativas e erros:

- Blocos de conteúdo (Descrição, Personagem, Diálogo, Comentário, Ação do diálogo, Narração, Transição): o texto em si mais uma linha de intenção. Uma linha de personagem também se liga a uma ficha real, e os nomes de objetos entre parênteses retos são registados nessa linha.
- Cena: local (escolhido da biblioteca de locais ou um novo nome que cria uma ficha), momento (texto livre), um título curto, um resumo da cena e ritmos numerados — são estes ritmos que alimentam a expansão posterior em prosa. Os resumos preservam a sua origem: os gerados por manutenção podem ser atualizados; os escritos por si nunca são substituídos.
- Tempo e lugar: local e momento, uma descrição e o índice, rótulo e nota que situam este instante na linha do tempo. O seu local só pode ser o próprio local da cena ou um descendente deste.
- Capítulo: título, intenção do capítulo e uma cor. A numeração dos capítulos provém da ordem atual e não do título — pelo que um novo capítulo a exibir «Capítulo 3» com o título vazio é o comportamento correto.

Cena e tempo e lugar são nós com múltiplos campos: o Enter avança primeiro pelos campos e só cria uma nova linha após o último, evitando o recurso ao rato.

## Definir o tipo nunca reescreve as suas palavras

Alterar o tipo apenas muda a marca semântica dessa linha; nada do que escreveu se move. Pode experimentar à vontade. O que muda é a estrutura: converter uma linha em cena atrai as linhas seguintes para essa cena, e eliminá-la remove a cena e renomeia as restantes.

Duas formas de retroceder: a anulação utiliza a pilha de projetos de toda a aplicação (`Cmd`/`Ctrl` + `Z`, até 30 passos em todo o projeto, com a digitação num intervalo de um segundo agrupada num único passo); além disso, cada edição é gravada localmente em primeiro lugar e só depois colocada na fila de sincronização, pelo que uma quebra de ligação nunca lhe custará palavras prontas.

## Limites e resolução de problemas

- O menu destina-se unicamente às linhas do manuscrito. Premir Tab no campo de uma ficha (nome de personagem, descrição de local) é um comportamento normal de introdução de texto e não abrirá o menu.
- Os tipos antigos de comentário, anotação entre parênteses e legenda foram removidos sem compatibilidade retroativa: esse conteúdo é hoje escrito como Comentário, Ação do diálogo ou Narração.
- Selecionar várias linhas e copiar gera texto simples — sem tipos de nós nem formatação. Copiar dentro de um único nó mantém o intervalo exato.
- Não encontra um determinado tipo? A fila desloca-se: as setas ← e → ou as teclas numéricas continuam a alcançá-lo.

A semântica completa e a disposição da página encontram-se na [Visão geral do editor do manuscrito](https://loomworld.ai/pt-pt/docs/editor-overview).