Menções de entidades e @
Uma gramática de referência: clique com o botão direito no rascunho, @ no texto longo. A deteção não substitui a ligação.
O que guarda uma referência
Todo o projeto utiliza uma única gramática de referências: uma referência guarda uma versão de protocolo, um âmbito, um tipo de objeto, um ID estável e o texto de apresentação. Assim, «a quem isto aponta» tem a mesma resposta no manuscrito, no mundo, na linha do tempo, nos prenúncios e numa mensagem do agente — não precisa de aprender cinco dialetos para cinco ecrãs.
Mudar o nome de um objeto mantém todas as referências na mesma ficha; objetos com o mesmo nome distinguem-se pelo tipo e pelo ID estável, e os pseudónimos servem apenas para ajudar na pesquisa — nunca definem a identidade. Se tiver uma personagem «Moonrise» e uma entrada de mundo «Moonrise», as opções mostram tipos diferentes e não podem ser confundidas.
Quando vale a pena criar uma ligação
Quando as palavras se referem de facto a uma ficha existente. O objetivo não é colorir uma palavra; é garantir que tanto o utilizador como a IA sabem a que ficha se refere — para que a continuação reúna o material certo, as estatísticas sejam atribuídas corretamente e um clique abra a ficha. Uma menção passageira a algo ainda não arquivado não precisa de ligação.
No manuscrito: Ligar a…
Arraste para selecionar e clique com o botão direito. A metade superior do menu contém Reescrever / Expandir / Condensar / Polir, além de uma linha para instruções adicionais; a metade inferior é «Ligar a…», que pesquisa em tudo no projeto — personagens, locais, objetos, entradas do mundo, capítulos, cenas, tempos e lugares, linhas do manuscrito, itens da linha do tempo, prenúncios e acessos aos módulos. Se não houver nada disponível, o sistema avisa; e se a pesquisa não devolver resultados, avisa igualmente.
Quando pretender criar uma ficha nova, a lista apresenta explicitamente as entradas «+ Criar personagem…», «+ Criar objeto…» e ligar. Essa é uma decisão sua, não uma suposição do sistema.
No texto longo: os dois caminhos do @
- Seleção em dois níveisEm descrições do mundo, notas de prenúncios e descrições da linha do tempo, digite @, escolha uma categoria (personagens / locais e mapas / objetos / mundo / estrutura do manuscrito / linha do tempo / prenúncios / acessos aos módulos) e, em seguida, o objeto exato. As opções nunca são truncadas dentro de uma categoria: percorra a lista completa e continue a escrever para filtrar.
- Ou pesquise diretamenteSe já souber o nome, digite @palavra-chave para pesquisar em todos os tipos. Ambos os caminhos guardam a mesma referência estável.
- No próprio localA citação surge como uma etiqueta reconhecível onde a digitou e remete para a ficha; não existe uma segunda caixa de pré-visualização por baixo.
A correspondência abrange nomes formais e pseudónimos, com as correspondências exatas ordenadas acima de prefixos e partes de texto. Nomes e caminhos são comparados separadamente, pelo que pesquisar o título de uma cena não lista todas as linhas dentro dessa cena.
O que acontece ao criar a ligação
- As ligações a personagens, objetos e locais no manuscrito continuam a contar para o número habitual de presenças e utilizações; outros destinos são ligações informativas que saltam e contextualizam, nunca reescrevendo o módulo de destino.
- Uma referência nunca cria uma ficha em falta, e ligar a um acesso de módulo não transfere esse módulo inteiro para o contexto da IA — trata-se apenas de navegação.
- Uma referência não concede permissões de escrita: qualquer alteração da IA continua a passar pelo cartão de confirmação.
A deteção não é uma referência formal
O editor reconhece nomes de personagens, locais, objetos e entradas do mundo, mas apenas os assinala com um sublinhado pontilhado muito ténue; passar o cursor adiciona um sombreado mais suave do que uma seleção, e clicar não abre os detalhes. Em personagens e objetos, clicar oferece a opção «converter em ligação», que é onde a verdadeira referência é criada. As linhas de intervenção de personagens ignoram esta camada — já indicam claramente quem está a falar.
Apenas as referências ligadas alimentam a contagem e a composição da IA; a marcação ténue é apenas um lembrete.
Limites e resolução de problemas
- A sintaxe antiga [[nome]] e as grafias anteriores de personagens e objetos continuam a ser lidas. Quando um nome antigo corresponde a um único objeto, é apresentado sem problemas; havendo vários, é marcado como ambíguo em vez de escolher silenciosamente o primeiro, e um objeto inexistente é marcado como inválido.
- Após a eliminação de um objeto, a referência mantém o texto de apresentação original; nada mais é colocado no seu lugar.
- As referências entre projetos não estão disponíveis nesta versão — transfira o trabalho utilizando o pacote de projeto.
- A tecla Tab dentro de um campo não abre o menu de tipos do manuscrito; essa tecla pertence às linhas do manuscrito.
O sentido e os efeitos secundários encontram-se em Ligações entre módulos.