Como criar uma conta no Gumroad?

Vá para gumroad.com e clique no botão “Log in” no canto superior direito. Na página seguinte, clique no link “Sign up” no topo da página. Agora preencha seu endereço de email e senha nos campos mais abaixo na página e clique no botão “Create account”.

Comprei uma versão mais antiga do DocFetcher Pro ou DocFetcher Server, onde posso baixar a versão mais recente?

Para obter os arquivos da versão mais recente, faça login na conta do gumroad.com com a qual você comprou o DocFetcher Pro ou DocFetcher Server.

Se você fez a compra sem criar uma conta, ainda pode criar uma conta posteriormente, desde que saiba o endereço de email com o qual fez a compra.

Uma vez dentro da sua conta, clicar em “Library” à esquerda levará você a uma lista dos produtos que comprou no Gumroad. Entre esses produtos deve estar o DocFetcher Pro ou DocFetcher Server, e clicar neles levará você aos arquivos da versão mais recente.

Se não conseguir ver o DocFetcher Pro ou DocFetcher Server na sua Library, pode ter “arquivado” eles. Nesse caso, pode trazê-los de volta marcando a caixa de seleção “Show archived only”.

Ao atualizar o DocFetcher Pro portátil ou o DocFetcher Server, como posso manter minhas configurações e índices?

Ao atualizar de uma versão do DocFetcher Pro portátil ou de uma versão do DocFetcher Server para uma versão mais nova, não descompacte a nova versão por cima da versão antiga. Isso misturará os arquivos do programa, causando potencialmente comportamento anormal do programa. Aqui está a maneira correta de atualizar o programa e também manter suas configurações e índices:

1. Descompacte a nova versão do programa em um local novo.
2. Copie apenas as pastas conf e indexes da pasta do programa antigo para a pasta do programa novo.
3. Copie da pasta do programa antigo para a pasta do programa novo quaisquer arquivos que você modificou manualmente.

Nota: Se você está usando o DocFetcher Pro não-portátil, então no Windows (e apenas no Windows) você pode instalar com segurança a nova versão do programa na mesma pasta da versão existente (por exemplo, C:\Program Files\DocFetcher Pro). Isso é seguro porque o instalador removerá automaticamente a versão existente antes de instalar a nova. O instalador também manterá quaisquer configurações e índices existentes. Em plataformas diferentes do Windows, o DocFetcher Pro não-portátil deve ser descompactado em um local novo. Ele então reutilizará quaisquer configurações e índices existentes na sua pasta home.

Quanto ao DocFetcher Server, todos os arquivos de versão do DocFetcher Server são portáteis, então o procedimento de atualização acima para versões portáteis se aplica.

Como posso transferir minhas configurações e índices da versão demo para a versão completa?

DocFetcher Pro

Como as configurações e índices da versão demo do DocFetcher Pro podem ser transferidos para a versão completa depende da versão do DocFetcher Pro que você está usando:

• Windows, não-portátil (instalado): Abra a pasta C:\Users\[Seu Nome de Usuário]\AppData\Local. Nessa pasta, você encontrará uma pasta chamada DocFetcher Pro Demo. Faça uma cópia dela no mesmo local selecionando-a e pressionando Ctrl+C e depois Ctrl+V. Renomeie a cópia para DocFetcher Pro. Se já havia uma pasta chamada DocFetcher Pro, então renomeie esta última para algo diferente ou remova-a antes de renomear a pasta copiada.
• Linux e macOS, não-portátil: Na sua pasta home, renomeie a pasta .docfetcherprodemo para .docfetcherpro. Renomeie ou remova uma pasta .docfetcherpro existente antes, se houver uma.
• Qualquer plataforma, portátil: Copie apenas as pastas conf e indexes da pasta do programa demo para a pasta do programa da versão completa.

Note que as instruções acima assumem que você deseja transferir configurações e índices de uma demo não-portátil para uma versão completa não-portátil, ou de uma demo portátil para uma versão completa portátil. Transferir entre não-portátil e portátil também é possível e essencialmente se resume a localizar as pastas conf e indexes e copiá-las para o local correto.

DocFetcher Server

Para transferir as configurações e índices da versão demo do DocFetcher Server para a versão completa, copie apenas as pastas conf e indexes da pasta do programa demo para a pasta do programa da versão completa.

Como posso alterar a localização dos índices?

O DocFetcher tem um arquivo misc/paths.txt que permite personalizar a localização dos índices. No DocFetcher Pro, o arquivo misc/paths.txt foi removido sem substituição por razões técnicas (nomeadamente bugs conhecidos e instabilidade do programa), então realocar os índices dessa forma não é possível com o DocFetcher Pro. No entanto, ainda há outra maneira: Nas versões portáteis do DocFetcher Pro, os índices estão dentro da pasta do programa, e essa pasta pode ser movida livremente.

Quanto ao DocFetcher Server, é essencialmente um aplicativo portátil em todas as plataformas, então para realocar os índices você pode simplesmente mover toda a pasta do programa.

Como posso pausar e retomar a indexação?

Pausar e retomar a indexação é possível tanto no DocFetcher Pro quanto no DocFetcher Server, mas a funcionalidade pode não ser óbvia: Simplesmente aborte o processo de indexação atual. No caso de criação de índice e reconstrução de índice, você será perguntado se quer manter ou descartar o índice parcialmente criado. Selecione “Mantenha”. Quando quiser retomar a indexação, selecione esse índice parcial e execute uma atualização de índice nele. Pode levar algum tempo para o aplicativo encontrar o ponto onde a indexação foi abortada anteriormente.

Por que a consulta de pesquisa *cao*.pdf não encontra os nomes de arquivo esperados?

Suponha que há um arquivo “gato-cao-rato.pdf” entre seus arquivos indexados. Ao inserir a consulta de pesquisa “*cao*.pdf” (sem as aspas), você esperaria que o aplicativo encontrasse o arquivo “gato-cao-rato.pdf”, mas ele não encontra. Para entender por que, e para entender como contornar o problema, é necessário um entendimento mais profundo do processo de indexação.

Para começar, há uma configuração de aplicativo chamada “Segmentação de palavras”. Ela determina como os fluxos de texto que são inseridos no mecanismo de indexação são divididos em palavras individuais e pesquisáveis.

O valor padrão da configuração de segmentação de palavras é chamado “Padrão” e funciona bem para o tipo de texto que você normalmente encontraria em documentos escritos em uma linguagem natural como o português. A segmentação de palavras “Padrão” divide o texto em espaços, hífens (ou seja, “-”) e outros caracteres. Ela não divide em pontos (“.”) ou sublinhados.

Este comportamento — em particular a divisão em hífens — faz sentido para texto de documento, mas pode ser contra-intuitivo para nomes de arquivo. No exemplo acima, o nome do arquivo “gato-cao-rato.pdf” seria dividido em “gato”, “cao” e “rato.pdf”. É por isso que a consulta “*cao*.pdf” não encontra.

Há basicamente duas maneiras de contornar este problema:

1) Alterar a configuração de segmentação de palavras, especificamente para “Espaço em branco”. Como o nome sugere, a opção “Espaço em branco” divide o texto apenas em caracteres de espaço em branco, nada mais. Assim, o nome do arquivo “gato-cao-rato.pdf” seria deixado intacto quando passado para o mecanismo de indexação. No entanto, alterar a segmentação de palavras pode ter um impacto significativo e possivelmente indesejável em todas as suas pesquisas. Além disso, requer reconstruir todos os seus índices.

2) Usar uma consulta de pesquisa diferente. No exemplo acima, as seguintes consultas funcionariam:

• *cao*
• *rato*.pdf
• "gato-cao-rato.pdf"

Além disso, a consulta “gato-cao-rato.pdf” sem aspas também funcionaria. Isso se deve a outro detalhe de como o mecanismo de pesquisa funciona: Não apenas o texto indexado, mas também a própria consulta é dividida usando o algoritmo de segmentação de palavras escolhido, que no presente exemplo resulta em “gato”, “cao” e “rato.pdf”.

Finalmente, note que há um painel de Tipos de Documentos no lado esquerdo da interface. Este painel oferece uma maneira muito mais confiável de restringir a pesquisa a tipos de arquivo específicos, comparado ao método acima de incluir a extensão de arquivo na consulta de pesquisa.

DocFetcher Pro: A interface gráfica permanece lenta e sem resposta após a indexação, o que posso fazer?

Há duas razões prováveis: Primeiro, a opção “Pesquisa ao digitar” nas preferências pode ter um impacto significativo no desempenho. Se estiver habilitada, tente desabilitá-la.

Segundo, é possível que você tenha indexado uma ou mais pastas muito grandes, e que essas pastas estejam sendo frequentemente modificadas em segundo plano, desencadeando atualização contínua de índice no DocFetcher Pro e assim tornando-o mais lento. Nesse caso, tente desligar a atualização automática de índice em todos os índices. Para fazer isso em um único índice, clique com o botão direito nele no painel de Âmbito de Pesquisa e desmarque “Atualizar índice automaticamente”. Alternativamente, você pode desabilitar a atualização automática de índice em todos os índices de uma vez iniciando o programa com um argumento --disable-auto-index-update.

A página “Atualizações de índice” no manual do usuário explica como funciona a atualização automática de índice do DocFetcher Pro, e quais são as alternativas quando a atualização automática de índice não está disponível.

DocFetcher Pro: Podem trazer de volta a tecla de atalho global do DocFetcher?

Não, mas há uma solução alternativa. Para contexto: No Windows e Linux, o DocFetcher gratuito tem uma tecla de atalho global (por padrão Ctrl + F8) para trazer a janela do programa para frente. Esta funcionalidade não foi transferida para o DocFetcher Pro pois a tecla de atalho é conhecida por causar problemas de estabilidade. No entanto, é possível emular a tecla de atalho com software adicional, conforme explicado abaixo. Como emular a tecla de atalho no macOS não será explicado aqui, mas pode ser feito com Automator e AppleScript.

No Windows

1. Baixe o software de código aberto AutoHotkey daqui e instale-o. Depois, reinicie o Windows.
2. Pressione a tecla Windows + R, digite shell:startup, depois pressione Enter. Isso abre sua pasta de aplicativos de inicialização.
3. Clique com o botão direito nessa pasta e selecione New > AutoHotkey Script. Dê um nome ao novo arquivo .ahk, por exemplo, DocFetcher Pro Hotkey.ahk. O arquivo .ahk é um script que será executado toda vez que o Windows iniciar.
4. Clique com o botão direito no arquivo .ahk, depois selecione Edit Script.
5. Substitua todo o texto no arquivo .ahk por isto:

^F8::
if WinActive("DocFetcher Pro") {
    WinMinimize, DocFetcher Pro
} else {
    WinActivate, DocFetcher Pro
}

6. Salve e feche o arquivo .ahk.
7. Reinicie o Windows.
8. De agora em diante, você pode pressionar Ctrl + F8 para trazer uma instância em execução do DocFetcher Pro para frente. Após pressionar Ctrl + F8, você pode ainda pressionar Ctrl + F para focar o campo de pesquisa no DocFetcher Pro. Se você pressionar Ctrl + F8 enquanto o DocFetcher Pro já é a janela ativa, ele será minimizado.
9. A linha ^F8:: no script .ahk acima é o que vincula o script à tecla de atalho Ctrl + F8. Para outras teclas de atalho, veja esta página na documentação do AutoHotkey.
10. Para aprender mais sobre AutoHotkey, veja a documentação do AutoHotkey, e o tutorial em particular.

No Linux

1. Instale o AutoKey. Em distribuições baseadas no Debian como Ubuntu, execute este comando no terminal: sudo apt install autokey-gtk
2. Se não estiver já instalado, instale as seguintes dependências: wmctrl e xdotool.
3. Inicie o AutoKey.
4. No AutoKey, crie um novo script: File > New > Script
5. Cole o seguinte código no editor de código:

output = system.exec_command("wmctrl -lx", getOutput=True)
if "DocFetcher Pro.DocFetcher Pro" in output:
    winClass = window.get_active_class()
    if winClass == "DocFetcher Pro.DocFetcher Pro":
        system.exec_command("xdotool windowminimize $(xdotool getactivewindow)")
    else:
        system.exec_command("wmctrl -x -a "DocFetcher Pro.DocFetcher Pro"")

6. Abaixo do editor de código, atribua uma tecla de atalho, por exemplo, Ctrl + F8.
7. Adicione o AutoKey aos seus aplicativos de inicialização. Você pode fazer isso de dentro do AutoKey: Edit > Preferences > Automatically start AutoKey at login
8. Salve o script e feche a janela do AutoKey. Ele continuará executando em segundo plano.
9. De agora em diante, você pode pressionar Ctrl + F8 para trazer uma instância em execução do DocFetcher Pro para frente. Após pressionar Ctrl + F8, você pode ainda pressionar Ctrl + F para focar o campo de pesquisa no DocFetcher Pro. Se você pressionar Ctrl + F8 enquanto o DocFetcher Pro já é a janela ativa, ele será minimizado.

DocFetcher Server: Por que não consigo me conectar à minha instância do DocFetcher Server do exterior?

Vamos assumir que você seguiu as instruções de configuração na documentação e conseguiu executar o DocFetcher Server ao ponto de poder acessá-lo localmente, ou seja, na máquina do servidor, via uma URL como esta: http://localhost:31190/

No entanto, quando você tenta acessá-lo do exterior usando o endereço da sua máquina servidor, por exemplo, http://192.255.234.105:31190/, seu navegador apenas exibe uma mensagem de erro.

Possíveis explicações:

• Se sua máquina servidor está em uma rede local e se conecta ao mundo exterior através de um roteador, você precisa configurar encaminhamento de porta no roteador.
• O acesso à instância do DocFetcher Server pode estar bloqueado por um firewall. Pode ser um firewall no seu roteador, um firewall do seu provedor de hospedagem web, ou um firewall na própria máquina servidor (por exemplo, Windows Firewall, UFW).

DocFetcher Server: Por que o servidor conta o número de usuários por sessão do navegador em vez de endereço IP?

Os usuários que são contados para o limite de clientes de uma instância do DocFetcher Server não são identificados por endereços IP, mas por sessões do navegador. Isso tem as seguintes implicações não óbvias:

• Acessar o servidor de dois navegadores diferentes no mesmo computador — conta como 2 usuários.
• Acessar o servidor de uma aba privada e uma aba não-privada no mesmo navegador — conta como 2 usuários.

De uma perspectiva do usuário, isso é reconhecidamente não ideal, já que acessar o servidor do mesmo computador de várias maneiras deveria idealmente ser contado como um único “assento”. No entanto, a alternativa, contar por endereços IP, é tecnicamente inviável porque endereços IP geralmente não são uma maneira confiável de identificar usuários.

Em particular, se dois usuários acessam um servidor por trás de um firewall NAT ou um servidor proxy, o servidor sendo acessado veria ambos os usuários como tendo o mesmo endereço IP. Assim, o limite de clientes do DocFetcher Server poderia ser facilmente contornado usando um servidor proxy.

Para uma discussão técnica estendida sobre a questão endereços IP vs. sessões do navegador, por favor veja esta página e esta página no Stack Overflow.

O DocFetcher Server oferece uma solução alternativa chamada roubo de sessão que torna mais conveniente alternar entre diferentes navegadores no mesmo computador, bem como alternar entre diferentes computadores. Roubo de sessão significa que quando o limite de clientes é atingido, novos usuários são capazes de assumir sessões existentes, assim expulsando seus proprietários anteriores da interface web. O uso pretendido é para usuários se expulsarem a si mesmos para alternar mais facilmente entre navegadores e/ou computadores. Para instâncias do DocFetcher Server com um limite de clientes maior que 1, o roubo de sessão está desabilitado por padrão e deve ser habilitado na Área de administração na aba Acesso.

DocFetcher Server: Na interface web, posso abrir resultados de pesquisa diretamente ao invés de baixá-los?

Resposta curta: Não, mas há uma solução alternativa (um pouco desajeitada).

Resposta longa: Por razões de segurança, navegadores modernos são projetados para executar aplicações web em uma sandbox. A interface web do DocFetcher Server é uma aplicação web desse tipo, e é por isso que ela não pode acessar o sistema de arquivos local fora do navegador e abrir arquivos, e ao invés disso permite que você os baixe.

A solução alternativa: Na interface web, copie o caminho do arquivo do resultado da pesquisa para a área de transferência, depois cole-o no seu gerenciador de arquivos ou alguma outra aplicação que possa lidar com o caminho do arquivo. Por exemplo, no Windows Explorer você pode abrir um arquivo colando seu caminho na barra de caminho.

O DocFetcher Server tem duas funcionalidades para apoiar esta cópia e colagem de caminhos de arquivo. Primeiro, na Área de administração, vá para a aba Diversos, depois na configuração “Clique no ícone nos resultados da pesquisa”, selecione “Copiar caminho”. Isso permite aos clientes convenientemente copiar o caminho do arquivo de um resultado de pesquisa clicando no seu ícone.

Segundo, dependendo da sua configuração, os caminhos de arquivo que a instância do DocFetcher Server vê podem não ser necessariamente idênticos aos caminhos de arquivo que os clientes vêem. Por exemplo, a instância do DocFetcher Server pode estar executando no Linux e indexando arquivos sob /caminho/para/arquivos, enquanto os clientes podem estar executando no Windows, vendo os arquivos indexados em uma unidade de rede montada em X:\. A solução para esta incompatibilidade de caminho: Na Área de administração, vá para a aba Indexes, selecione um índice, depois clique no botão “Caminho do cliente” sob a tabela de índices, depois insira um caminho personalizado para mostrar aos clientes. Faça isso para cada índice afetado.

Vocês têm um roteiro de funcionalidades planejadas para os vários produtos DocFetcher?

Não há roteiro, apenas uma montanha de solicitações de funcionalidades e uma ideia vaga de onde o projeto pode ir no futuro. Muitos anos de experiência com DocFetcher mostraram que planos concretos de funcionalidades raramente se concretizam, frequentemente devido a puras dificuldades técnicas e/ou porque muitas outras funcionalidades também estão competindo pela atenção do desenvolvedor.

Por exemplo, uma interface web do DocFetcher foi “planejada” lá em 2008, mas só em 2022 é que o DocFetcher Server 1.0 veio à luz, após um ano completo de desenvolvimento.

Posso obter um reembolso da minha compra?

Por favor veja a política de reembolso.