Skip to content

Latest commit

 

History

History
159 lines (98 loc) · 7.45 KB

README.md

File metadata and controls

159 lines (98 loc) · 7.45 KB
Raw

Fess: Servidor de Busca Empresarial

Java CI with Maven Maven Central License

Visão Geral

Fess é um servidor de busca empresarial muito poderoso e fácil de implantar. Você pode instalar e executar o Fess rapidamente em qualquer plataforma que suporte o Java Runtime Environment. O Fess é fornecido sob a Licença Apache 2.0.

O Fess é baseado no OpenSearch, mas não é necessário ter conhecimento ou experiência com OpenSearch. O Fess fornece uma interface de administração fácil de usar, que permite configurar o sistema através do seu navegador. O Fess também inclui um rastreador (Crawler), que pode rastrear documentos em um servidor web, sistema de arquivos ou Data Store (como CSV ou banco de dados). Muitos formatos de arquivos são suportados, incluindo (mas não limitado a): Microsoft Office, PDF e zip.

Fess Site Search é uma alternativa gratuita ao Google Site Search. Para mais detalhes, veja a documentação do FSS JS Generator.

Site

fess.codelibs.org

Problemas/Perguntas

discuss.codelibs.org

Como Começar

Existem duas maneiras de testar o Fess. A primeira é baixar e instalar você mesmo. A segunda é usar Docker.

Baixar e Instalar/Executar

O Fess 14.17 já está disponível e pode ser baixado na página de lançamentos. As opções de download incluem: deb, rpm, zip.

Os comandos a seguir mostram como usar o download em formato zip:

$ unzip fess-14.17.x.zip
$ cd fess-14.17.x
$ ./bin/fess

Para mais detalhes, veja o Guia de Instalação.

Docker

Nós fornecemos imagens Docker em ghcr.io. Também fornecemos um arquivo Docker Compose (YAML) neste repositório.

Interface do Navegador

Interface de Busca

Interface de Administração

Você pode registrar alvos de rastreamento na interface de administração nas páginas de configuração do rastreador (Web, Arquivo, Data Store), e iniciar manualmente o rastreador na página do Agendador.

Migração de Outro Provedor de Busca

Consulte MIGRATION.md.

Data Store

Atualmente, o Fess suporta o rastreamento dos seguintes locais de armazenamento e APIs:

Temas

Ingestão

Scripts

Informações de Desenvolvimento

Obter Código Fonte

  1. Clone o repositório do Fess:

    $ cd ~/workspace
$ git clone https://github.com/codelibs/fess.git

  2. Importe o repositório clonado como um projeto Maven no Eclipse ou em outro IDE.

Configuração de Plugins para OpenSearch

Execute antrun:run para baixar os plugins no diretório de plugins:

$ mvn antrun:run

Executar o Fess

Execute ou depure org.codelibs.fess.FessBoot no seu IDE, e depois acesse http://localhost:8080/

Criar Pacote

Execute o objetivo package e o arquivo de lançamento será criado em target/releases.

$ mvn package
$ mvn rpm:rpm   # pacote .rpm
$ mvn jdeb:jdeb # pacote .deb

Gerar Código Fonte

$ mvn dbflute:download # (comando executado uma vez)
$ mvn dbflute:freegen
$ mvn license:format

Testes de Integração

Inicie o servidor Fess e execute o seguinte comando:

$ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201"

Para executar um único caso de teste, você pode usar:

$ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201" -Dtest=SearchApiTests

Traduzir para o Seu Idioma

Fess é um software internacionalizado.

Se você quiser adicionar rótulos/mensagens para o seu idioma, por favor, traduza o arquivo de propriedades e renomeie-o para fess_*_[lang].properties.

Para o analisador de busca/índice, se doc.json contiver lang_[lang] para o seu idioma, por favor, modifique o analisador para o seu idioma. Para mais detalhes sobre Analisadores, veja a documentação do OpenSearch.

Aceitamos pull requests para o seu idioma.

Desenvolvido por