Esta página é apenas uma tradução para o português do conteúdo que se encontrava em https://github.com/voyanttools/VoyantServer/wiki/VoyantServer-Desktop no dia 24 de março de 2024. Periodicamente consultaremos o endereço em referência e atualizaremos -- se necessário -- o conteúdo desta página aqui. Os conteúdos das páginas apontadas pelos links não estão traduzidos.

A tradução foi feita com a ajuda do tradudor do Google, que você pode usar caso queira consultar páginas com conteúdo técnico em inglês. A qualidade da tradução automática inicial é muito boa. Em alguns pouco pontos alterei a tradução.

Desktop VoyantServer

Andrew MacDonald editou esta página em 19 de janeiro de 2024 ·
4 revisões

O VoyantServer pode ser executado como um aplicativo de desktop local para uso pessoal. Se você estiver interessado em fornecer uma instância disponível para outras pessoas, consulte as instruções do VoyantServer Server.

Se você não possui Java, precisará baixá-lo e instalá-lo.
VoyantServer requer Java 11, que está disponível aqui. Procure por 11.0.2.

Depois que o Java estiver instalado, a próxima etapa é baixar a versão mais recente do VoyantServer.

O próximo passo vai depender um pouco do seu sistema operacional, como Mac OS X, Windows ou Linux.

Mac OS X

Clique duas vezes no arquivo .zip baixado para descompactá-lo. Isso deve criar um diretório na mesma pasta do arquivo zip com um nome semelhante ao arquivo baixado. Você pode entrar no diretório e verá um arquivo chamado VoyantServer.jar.

O Mac OS X agora possui um mecanismo de segurança que força você a confirmar que deseja iniciar aplicativos baixados da Internet. Na primeira vez que você executar o VoyantServer, clique com o botão direito ou clique com a tecla Control pressionada no arquivo VoyantServer.jar, escolha Abrir e clique no botão Abrir (não padrão).

Isto é necessário apenas na primeira vez, para usos subsequentes do VoyantServer, basta clicar duas vezes no arquivo VoyantServer.jar.

Se aparecer um aviso de exceção ou erro sobre o Jova, você provavelmente resolverá o problema baixando uma outra versão do Java (11) e tentando de novo.

Windows

Em vez de simplesmente clicar duas vezes no arquivo .zip baixado (que às vezes cria apenas uma visualização virtual do conteúdo), é melhor clicar com o botão direito no arquivo e extraí-lo para uma pasta de sua escolha. Em seguida, vá para a pasta extraída e clique duas vezes em VoyantServer.jar para iniciar o VoyantServer. Se você vir uma caixa de diálogo de aviso ou erro sobre Java, pode ser necessário baixar uma versão diferente do Java (11) e tentar novamente.

Linux

Configurações

Embora em muitos casos o VoyantServer deva funcionar bem quando você o inicia com as instruções acima, há situações em que você pode precisar ou desejar alterar as configurações padrão. Quando tudo corre bem (ou seja, sem erros), às vezes você pode fazer isso através da janela do aplicativo VoyantServer (por exemplo, parar o servidor se estiver em execução,
altere o valor da RAM e inicie o servidor novamente), mas você também pode editar o arquivo server_settings.txt que está na mesma pasta que VoyantServer.jar.

Na maioria dos casos, você pode simplesmente clicar duas vezes no arquivo server-settings.txt para abri-lo em um editor (provavelmente TextEdit no Mac ou Notepad no Windows).

Se você fizer alterações, lembre-se de salvar o arquivo, e reinicie o servidor (fechando o aplicativo VoyantServer e reiniciando, se necessário).

No VoyantServer Desktop, estas são as configurações principais:

Porta
porta = 8888

Se você já tem algo rodando nessa porta, você pode especificar uma porta diferente, como 8889

Memória
memória = 1024

Esta é a RAM em MB (deve ser expressa em MB). Se você vir um java.lang.OutOfMemoryError ao iniciar o VoyantServer, você pode tentar reduzi-lo para 512 ou mesmo 256.

Se você estiver trabalhando com corpora muito grandes, você pode querer aumentar para 2.048, 4.096 ou mais (dependendo dos recursos da sua máquina).

Hospedeiro
#host = 127.0.0.1

Embora VoyantServer seja um aplicativo de desktop, também é um servidor e é possível que outras pessoas possam acessá-lo. Se você deseja limitar o acesso apenas à sua máquina local, retire o comentário desta linha (remova o símbolo de hash e o espaço no início).

Sobre dados
Todos os dados criados no VoyantServer devem ser persistentes, em outras palavras, você deve ser capaz de iniciar o VoyantServer, criar um corpus, marcar o corpus, sair do VoyantServer, reiniciá-lo e retornar ao corpus previamente marcado.