Menções de entidades e @

Referências e ligações

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 @

  1. Seleção em dois níveis
    Em 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.
  2. Ou pesquise diretamente
    Se já souber o nome, digite @palavra-chave para pesquisar em todos os tipos. Ambos os caminhos guardam a mesma referência estável.
  3. No próprio local
    A 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.