Solução de problemas

Instalação#

O Windows mostra “editor desconhecido”#

Enquanto o instalador não estiver assinado com o certificado definitivo, o SmartScreen avisa na primeira execução. Se você baixou o arquivo da área de clientes da Neo, escolha Mais informações › Executar assim mesmo.

O Gatekeeper do macOS bloqueia o aplicativo#

Abra Ajustes do Sistema › Privacidade e Segurança e escolha Abrir mesmo assim.

O NeoMath não é o programa padrão dos arquivos .eps#

O Windows não permite que um programa se defina como padrão de um tipo que já tem dono. Use Configurações › Aplicativos padrão do Windows, que o instalador abre já no produto, ou clique com o botão direito num EPS e escolha Abrir com.

Licença e atualização#

“Chave de licença inválida: a atualização não foi baixada”#

O servidor não reconheceu a chave. Confira se ela foi colada inteira, sem espaços, se a licença está ativa e se cobre o produto. O aplicativo continua funcionando; só a atualização para. Veja Ativar a licença.

A atualização não aparece no Linux ou no macOS#

Nesses sistemas o aplicativo só avisa no rodapé que há versão nova; instale o .deb ou o .dmg novo manualmente.

Equações e arquivos#

O arquivo abre, mas sem as fontes e os tamanhos originais#

Se o arquivo foi alterado por outro programa, o NeoMath pode abrir a equação sem o estilo original. Refaça o arquivo a partir do original ou aplique o estilo de novo.

O estilo em lote ignorou arquivos#

O relatório diz o motivo de cada um: sem_dados (PNG ou SVG sem os dados do NeoMath), de_terceiros (EPS de outro programa), somente_leitura ou mudou_durante_a_execucao. Nada é alterado em silêncio. Veja Estilo em lote.

Uma fonte do estilo não existe no computador#

O NeoMath usa a fonte instalada e cai nas fontes de reserva (Liberation e STIX Two Math). A preferência aceita fontes que faltam, com aviso. Instale a fonte para o desenho sair como no original.

A construção LaTeX não é suportada#

O NeoMath avisa que não suporta a construção, e diz qual (na API, código 422). Reescreva com o comando equivalente da lista de Comandos LaTeX suportados.

Word#

O PNG não reabre com o estilo original#

O PNG inserido no Word pode perder o estilo ao reabrir. Prefira Imagem SVG ou Equação do Word.

Os atalhos de envio não funcionam#

Eles exigem o Word aberto, no Windows. Confira no perfil de atalhos que Ctrl+Enter, Ctrl+Shift+Enter e Ctrl+Shift+W não foram desligados no atalhos.json.

O suplemento não recupera o código da equação#

Isso exige o Word com a API WordApi 1.4. Sem ela, o painel lê a equação pelo OMML e perde macros e \ce{}.

InDesign#

“Documento não salvo”#

Salve o documento antes de inserir equações.

Não conecta ao NeoMath#

Deixe a API local ligada (NeoMath --servidor, ou a opção do instalador) e use Ler do servidor.json no painel. Se mudou a porta, confira-a no servidor.json. Veja Adobe InDesign.

O InDesign não grava os arquivos#

Confira se você tem permissão de escrita na pasta escolhida. A mensagem mostra o caminho tentado.

Atalhos e OCR#

Ctrl+Shift+A abre a busca de abas do navegador#

Isso acontece no navegador. No aplicativo, o atalho de OCR é registrado no sistema (Windows) e funciona com qualquer programa na frente. Se outro programa já usar a combinação, a barra de status avisa; troque o atalho.

Meu atalho personalizado não funciona#

O atalhos.json é lido uma vez por execução. Reabra o aplicativo. Combinações inválidas, ações desconhecidas e conflitos são ignorados, e os avisos aparecem na janela de ajuda de atalhos. Lembre que o atalho do NeoScript nunca dispara numa combinação que o perfil já usa.

O OCR não reconhece bem a equação#

Selecione só a equação, com margem pequena, e em boa resolução. Veja NeoCR para trocar de provedor.

API local e MCP#

Resposta	Causa	O que fazer
401	sem token ou token errado	leia o token do servidor.json e envie em Authorization: Bearer
403	origem de navegador não autorizada ou pasta fora da raiz	passe --origem URL ou ajuste --raiz
413	corpo maior que 16 MB	divida o pedido (64 MB só em /v1/lote-zip)
421	Host diferente de 127.0.0.1 ou localhost	use um desses endereços
422	construção não suportada ou imagem sem equação	veja a mensagem de erro
501	rota que só existe no aplicativo	use NeoMath --servidor

reading outside the allowed folders is blocked (MCP)#

O caminho está fora de NEOMATH_MCP_ROOTS. Inclua a pasta na variável do cliente MCP (separada por ; no Windows e : nos demais).

O MCP se recusa a sobrescrever#

Por segurança, nada é sobrescrito sem overwrite: true; um lote pula os arquivos que já existem.

NeoScript#

“sem permissão”#

A pasta não está liberada para o script. Em Permissões, libere a pasta (só leitura ou leitura e escrita). Na linha de comando, use --permitir.

O script não termina#

Parar interrompe o script mesmo em um laço infinito. Estourar o tempo limite também o termina, e isso não pode ser contornado com try/catch.

import, fetch ou require não existem#

O script é isolado de propósito. Use as funções do objeto neo e, para dados externos, neo.arquivo.ler.

Ainda precisa de ajuda?#

Fale com a nossa equipe e conte a versão do produto, o sistema operacional e a mensagem exata que aparece.