Vox-p - guia do usuário

#>
1. Introdução

Fazer o buscador Google funcionar no Dosvox tem sido bastante difícil.
Seguindo outros desenvolvedores que programaram soluções alternativas para esse problema, trazemos o Vox-p.

O Vox-p é um aplicativo para Dosvox que usa o motor do Brave Search para pesquisar na Web.
Ele não pretende ser a solução definitiva, nem pretende ser concorrente com outras soluções já existentes.
Ele pretende sim, ser mais uma alternativa, ampliando as possibilidades de escolha dos usuários de Dosvox.

Escolhemos usar o Brave Search por ser um buscador que se apresentou bastante satisfatório, trazendo bons resultados nos testes de pesquisa e, por ser possível através de sua api, criar uma interface direta dentro do Dosvox.

Este guia mostra como usar o vox-p. Para informações sobre download e instalação, veja vox-p - guia de instalação.txt.

#>
2. Utilização

Ao abrir o programa, será apresentada uma mensagem de boas vindas seguida do identificador de versão.
Surge então a pergunta: "Vox-p, o que deseja buscar"?
Digite o que deseja buscar e pressione enter.
Teclando Esc ou deixando o campo de pesquisa vazio, o programa é fechado.
Será mostrado na tela o resultado da busca.

São mostrados 20 ítens por página, com um limite de até 10 páginas por pesquisa.

Na primeira página, a lista pode ser maior que 20, porque o vox-p tentará aproveitar alguns conteúdos adicionais que costumam aparecer na página 1.

Observe porem o seguinte:
1. A lista de resultados pode ser menor que 20.
Esse comportamento é normal, e é previsto na documentação da api.
2. Nem sempre haverão 10 páginas por resultado.

O Vox-p busca enquanto não receber conteúdo vazio.
 Quando o conteúdo vier vazio, o limite é automaticamente definido para a última página com conteúdo.

#>
2.1. Opções para a lista de resultados

Para selecionar um resultado, use as setas para cima e para baixo.
A tecla f1 mostra a ajuda.
A tecla enter confirma a seleção de um resultado da lista.
A tecla tab avança uma página.
A tecla backspace volta uma página.
A tecla Esc fecha a lista de resultados e permite fazer uma nova pesquisa.

#>
2.2. Opções para um resultado

Ao teclar enter sobre um resultado selecionado, ficam disponíveis as seguintes opções:
w:abre o resultado selecionado com o Webvox.
Enter: Abre o resultado selecionado com o navegador padrão do Windows.
CTRL+Enter: Abre o resultado selecionado com qualquer outro programa ou navegador que você tenha instalado.
Para isso, basta informar o caminho completo ou o nome do executável, por exemplo:
digitando  chrome, caso você tenha o google chrome instalado, instrui o chrome a abrir o site referente ao resultado selecionado no vox-p.
r: fala o resumo do resultado selecionado.
l: fala o link do site referente ao resultado selecionado.
t: fala o título do resultado selecionado.
f: fala a fonte do resultado selecionado.
CTRL+C: Copia resumo, fonte, título e link do resultado selecionado para a área de transferência.
Ctrl+r: copia somente o resumo.
CTRL+l: copia somente o link.
CTRL+t: copia somente o título.
CTRL+F: copia somente a fonte.
Shift+r: permite ler o resumo por caracter.
Use as setas esquerda e direita para ler.
Escape ou enter retiram o campo de leitura.
Shift+f: permite ler a fonte por caracter.
Shift+l: permite ler o link por caracter.
Shift+t: permite ler o título por caracter.
Esc: volta à lista de resultados.

#>
3. Opções da linha de comando

O vox-p pode receber dois parâmetros na linha de comando.
Eles não são obrigatórios e, normalmente, chamamos o vox-p sem parâmetros.

#>
3.1. di (diretório de inicialização).

Para informar em qual diretório o vox-p deve iniciar, você deve chamá-lo assim:
vox-p di=c:\programas\vox-p

Neste exemplo, o vox-p foi descompactado na pasta c:\programas, onde foi criada automaticamente a pasta vox-p.
Isso é muito útil quando você usa o vox-p em um local diferente de \winvox e da raiz do disco c.

Quando o vox-p é chamado sem o parâmetro "di", o comportamento é o seguinte:
Primeiro, verifica se a pasta vox-p existe dentro de c:\winvox.
Se não existir, verifica então se existe na raiz do disco c.
Se não encontrar, devolve um erro de inicialização e encerra.

Você pode, por exemplo, criar um arquivo .bat, que chama o vox-p, passando o parâmetro "di" e o diretório de inicialização como argumento.
Veja mais sobre isso no arquivo vox-p - guia de instalação.txt.

#>
3.2 . db (ativar debug).

Em caso de erro, é útil fazer com que o vox-p gere um arquivo de log, mostrando o diálogo entre ele e o servidor.

Mesmo sem ativar o debug, quando há algum erro na requisição, é gerado na pasta vox-p\logs, um arquivo mostrando a mensagem de erro que o servidor devolveu.

Ativando o debug, todo o tráfego http é gravado.

Para executar o vox-p com o debug ativado, você pode chamá-lo assim:
vox-p db=1

Se o parâmetro "db" não for especificado, assume o valor padrão que é 0, ou seja, debug desativado.

----
Programa e manual escritos por Fabiano Ferreira.

Volta Redonda, 12/06/2026
