Tipos de verbete

Sua Wiki do livro inclui três tipos de verbete integrados: Personagem, Local e Linha narrativa. Porém, histórias têm mais que pessoas e lugares: facções, sistemas de magia, artefatos, casas, criaturas e tecnologias. Os Tipos de verbete permitem definir seus próprios tipos de verbete da wiki, com seus próprios campos, para que as partes estruturadas do seu universo fiquem na wiki, em vez de espalhadas em notas.

Um tipo personalizado funciona como um tipo integrado em todo o aplicativo: seus verbetes têm os mesmos cartões, a mesma pesquisa, a mesma Lixeira e recuperação e a mesma ajuda opcional da IA. Você molda a wiki para sua história, sem precisar aprender a usar um banco de dados.

Onde gerenciar os tipos

Abra Gerenciar tipos de verbete pelo botão no painel Wiki do livro ou execute o comando Gerenciar tipos de verbete na paleta de comandos. O gerenciador abre em uma aba própria chamada Tipos de verbete.

Os tipos pertencem ao projeto: um tipo definido por você fica disponível em todos os livros do projeto, para que o vocabulário do seu universo seja configurado uma só vez. Os verbetes em si continuam pertencendo a um único livro.

As alterações são salvas automaticamente enquanto você trabalha. Se uma edição ainda não puder ser salva, a aba manterá a marca de não salva e explicará o motivo; nada se perde em silêncio.

Criar um tipo personalizado

No Gerenciador de tipos, escolha Novo tipo e defina:

Um nome exibido — o nome do tipo, como Facção ou Artefato. Escreva-o exatamente como deve aparecer; ele será exibido da mesma forma, independentemente do idioma da interface do aplicativo.
Um ícone escolhido em um conjunto de símbolos voltados para histórias, como pessoas, lugares, facções, artefatos e elementos de ambientação.
Uma cor, escolhida na mesma paleta das etiquetas, se desejar.
Um conjunto de campos, descrito abaixo.

Ao criar o tipo, você também recebe uma chave do tipo, um identificador interno curto gravado em todos os arquivos de verbete desse tipo. A chave fica fixa depois que o tipo existe; apenas o nome exibido continua editável. Mudar a chave exigiria reescrever todos os verbetes, por isso o aplicativo a protege. O nome exibido pode ser alterado a qualquer momento.

Tipos personalizados funcionam da mesma forma que os tipos integrados Personagem e Local: além de fatos estruturados e descrição, um tipo pode ter vínculos com cenas, para marcar onde seus verbetes aparecem, e mídia, como avatar e imagens de referência. Você ativa esses recursos em cada tipo, portanto uma Facção ou um Artefato pode aparecer em cenas como um personagem. Os mesmos controles existem nos tipos integrados: se sua história nunca precisar de retratos de personagens ou se você quiser que um Local deixe de contar como nome nas menções, desative esse recurso no Gerenciador de tipos; Usar valores padrão do modelo restaura o tipo integrado à configuração original. Desativar um recurso apenas oculta suas áreas: nenhum dado armazenado é excluído, e tudo reaparece quando você ativa o recurso novamente.

Campos

Todos os verbetes já têm a base comum — Nome, Nomes alternativos, Resumo e Descrição — e todos têm Etiquetas, definidas nas Propriedades. Campos são os espaços extras e específicos do tipo que você acrescenta a essa base.

Cada campo tem:

Um nome do campo — como ele aparece no verbete, editável a qualquer momento.
Um tipo, entre:
- Texto — um único valor livre, como Lema.
- Opções — um valor escolhido de uma lista fixa que você define, como Lealdade: leal, neutra ou hostil. Um campo de opções precisa ter pelo menos um valor.
- Lista — vários valores livres, como Membros conhecidos.
Um controle Preenchível por IA — veja IA e seus campos.

Assim como a chave do tipo, a chave do campo fica fixa depois que o campo é criado; o nome ainda pode mudar. Isso mantém seus verbetes estáveis no disco enquanto você continua aperfeiçoando seus nomes exibidos.

Ampliar um tipo integrado

Você não precisa criar um tipo inteiro para adicionar estrutura. No Gerenciador de tipos, pode acrescentar seus próprios campos a Personagem, Local ou Linha narrativa, como uma Música-tema em Personagem ou Fundado em em Local.

O novo campo aparece imediatamente como um espaço vazio em todos os verbetes existentes desse tipo, sem mudar nada que já esteja escrito neles. Preencha-o quando chegar a cada verbete e deixe-o em branco onde não se aplicar. Nada do conteúdo anterior é alterado.

Os campos centrais de um tipo integrado, como a função de um personagem ou o tipo de um local, não podem ser removidos. Porém, você pode ocultá-los, como explicado abaixo, se nunca os usar.

Ocultar e reordenar campos

Qualquer tipo, integrado ou personalizado, permite organizar o verbete:

Ocultar remove um campo do verbete. Isso preserva o valor do campo: se você voltar a exibi-lo depois, o valor continuará lá. Ocultar só muda o que você vê, não o que fica armazenado.
Reordenar move para o início os campos mais importantes para você. A reordenação muda apenas o layout do verbete; ela nunca reescreve seus dados.

Tanto a ocultação quanto a ordem são lembradas no projeto e persistem depois de fechar e abrir o aplicativo. Como afetam apenas a visualização, os arquivos dos verbetes e seu Histórico de versões permanecem exatamente como estavam.

Excluir um tipo

Você pode excluir um tipo personalizado, mas apenas quando nada mais o usar. Se ainda houver algum verbete desse tipo em qualquer lugar do projeto, inclusive na Lixeira, a exclusão será bloqueada por uma mensagem que informa quantos verbetes ainda o usam:

Número de verbetes que ainda usam este tipo: N. Exclua-os definitivamente, inclusive os que estão na Lixeira, para excluir o tipo.

Remova esses verbetes, esvazie-os da Lixeira e o tipo poderá ser excluído. Essa proteção é intencional: um tipo nunca é removido enquanto ainda há verbetes que dependem dele.

Tipos integrados (Personagem, Local e Linha narrativa) nunca podem ser excluídos por nenhum caminho. Se você não usa um deles, oculte seus campos em vez de tentar removê-lo.

IA e seus campos

O assistente de IA trabalha com tipos personalizados com o mesmo cuidado usado nos tipos integrados: ele pode sugerir um novo verbete de qualquer tipo definido por você, e você confirma ou rejeita a sugestão; nada entra na wiki sem sua confirmação. O assistente nunca inventa um novo tipo por conta própria.

Nos campos personalizados, você decide até onde o assistente pode atuar. Ative Preenchível por IA em um campo para permitir que o assistente proponha um valor como parte de uma sugestão; deixe a opção desativada e o campo será apenas seu, sem possibilidade de escrita pelo assistente. Os campos da base — nome, nomes alternativos, resumo e descrição — estão sempre disponíveis para uma sugestão; seus campos particulares exigem permissão.

Seu arquivo

A definição dos tipos — tipos personalizados, campos acrescentados aos tipos integrados e escolhas de ocultação e ordem — fica em um arquivo de texto simples dentro do projeto, em .internal/wiki/types.yaml. Ele acompanha o projeto, é incluído em backups e pode ser lido ou editado manualmente fora do aplicativo, se você quiser.

Se esse arquivo for danificado ou editado até ficar inválido, o aplicativo não falhará em silêncio: ele abrirá o livro com os tipos integrados intactos e mostrará um erro claro, para que você corrija o arquivo e recupere os tipos personalizados. E se uma edição manual remover um tipo que ainda tenha verbetes no disco, o aplicativo avisará claramente em vez de esconder esses verbetes para sempre: restaure o tipo no arquivo e os verbetes voltarão a ser lidos.

Veja também: Wiki do livro · Personagens e locais · Linhas narrativas · Pesquisa e etiquetas · Assistente de IA · Segurança de dados