|
|
@@ -0,0 +1,159 @@
|
|
|
+# Fess: Servidor de Búsqueda Empresarial
|
|
|
+[](https://github.com/codelibs/fess/actions/workflows/maven.yml)
|
|
|
+[](https://maven-badges.herokuapp.com/maven-central/org.codelibs.fess/fess)
|
|
|
+[](https://github.com/gitbucket/gitbucket/blob/master/LICENSE)
|
|
|
+
|
|
|
+## Resumen
|
|
|
+
|
|
|
+Fess es un servidor de búsqueda empresarial muy potente y fácil de desplegar. Puedes instalar y ejecutar Fess rápidamente en cualquier plataforma que sea capaz de ejecutar el entorno de ejecución de Java (Java Runtime Environment). Fess se distribuye bajo la [Licencia Apache 2.0](LICENSE).
|
|
|
+
|
|
|
+Fess está basado en [OpenSearch](https://github.com/opensearch-project/OpenSearch), pero no se requiere conocimiento o experiencia en OpenSearch. Fess proporciona una GUI de administración fácil de usar para configurar el sistema a través de tu navegador.
|
|
|
+Fess también incluye un rastreador (crawler), que puede rastrear documentos en un [servidor web](https://fess.codelibs.org/14.17/admin/webconfig-guide.html), [sistema de archivos](https://fess.codelibs.org/14.17/admin/fileconfig-guide.html), o [almacenamiento de datos](https://fess.codelibs.org/14.17/admin/dataconfig-guide.html) (como un archivo CSV o base de datos). Se admiten muchos formatos de archivos, incluidos (pero no limitados a): Microsoft Office, PDF y zip.
|
|
|
+
|
|
|
+*[Fess Site Search](https://github.com/codelibs/fess-site-search)* es una alternativa gratuita a [Google Site Search](https://enterprise.google.com/search/products/gss.html). Para más detalles, consulta la [documentación de FSS JS Generator](https://fss-generator.codelibs.org/docs/manual).
|
|
|
+
|
|
|
+## Sitio web
|
|
|
+
|
|
|
+[fess.codelibs.org](https://fess.codelibs.org/)
|
|
|
+
|
|
|
+## Problemas/Preguntas
|
|
|
+
|
|
|
+[discuss.codelibs.org](https://discuss.codelibs.org/c/FessEN/)
|
|
|
+
|
|
|
+## Cómo Empezar
|
|
|
+
|
|
|
+Hay dos maneras de probar Fess. La primera es descargar e instalarlo tú mismo. La segunda es usar [Docker](https://www.docker.com/products/docker-engine).
|
|
|
+
|
|
|
+### Descargar e Instalar/Ejecutar
|
|
|
+
|
|
|
+Fess 14.17 ya está disponible y se puede descargar en la [página de lanzamientos](https://github.com/codelibs/fess/releases "download"). Las descargas están disponibles en 3 formatos: deb, rpm y zip.
|
|
|
+
|
|
|
+Los siguientes comandos muestran cómo usar la descarga en formato zip:
|
|
|
+
|
|
|
+ $ unzip fess-14.17.x.zip
|
|
|
+ $ cd fess-14.17.x
|
|
|
+ $ ./bin/fess
|
|
|
+
|
|
|
+Para más detalles, consulta la [Guía de Instalación](https://fess.codelibs.org/14.17/install/index.html).
|
|
|
+
|
|
|
+### Docker
|
|
|
+
|
|
|
+Proporcionamos imágenes de Docker en [ghcr.io](https://github.com/orgs/codelibs/packages). También proporcionamos un archivo Docker Compose (YAML) en [este repositorio](https://github.com/codelibs/docker-fess/tree/master/compose).
|
|
|
+
|
|
|
+### Interfaz de Usuario en el Navegador
|
|
|
+
|
|
|
+- Interfaz de búsqueda: http://localhost:8080/
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+- Interfaz de administración: http://localhost:8080/admin/ (el nombre de usuario/contraseña por defecto es admin/admin)
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+Puedes registrar los objetivos de rastreo en la interfaz de administración en las páginas de configuración del rastreador (Web, Archivo, Almacenamiento de Datos), y luego iniciar el rastreador manualmente en la [página del Programador](https://fess.codelibs.org/14.17/admin/scheduler-guide.html).
|
|
|
+
|
|
|
+## Migración desde otro proveedor de búsqueda
|
|
|
+
|
|
|
+Consulta [MIGRATION.md](MIGRATION.md).
|
|
|
+
|
|
|
+## Almacenamiento de Datos
|
|
|
+
|
|
|
+Actualmente, Fess admite el rastreo de las siguientes [ubicaciones de almacenamiento y APIs](https://fess.codelibs.org/14.17/admin/dataconfig-guide.html):
|
|
|
+
|
|
|
+ - [Confluence/Jira](https://github.com/codelibs/fess-ds-atlassian)
|
|
|
+ - [Box](https://github.com/codelibs/fess-ds-box)
|
|
|
+ - [CSV](https://github.com/codelibs/fess-ds-csv)
|
|
|
+ - [Database](https://github.com/codelibs/fess-ds-db)
|
|
|
+ - [Dropbox](https://github.com/codelibs/fess-ds-dropbox)
|
|
|
+ - [Elasticsearch](https://github.com/codelibs/fess-ds-elasticsearch)
|
|
|
+ - [Git](https://github.com/codelibs/fess-ds-git)
|
|
|
+ - [Gitbucket](https://github.com/codelibs/fess-ds-gitbucket)
|
|
|
+ - [G Suite](https://github.com/codelibs/fess-ds-gsuite)
|
|
|
+ - [JSON](https://github.com/codelibs/fess-ds-json)
|
|
|
+ - [Office 365](https://github.com/codelibs/fess-ds-office365)
|
|
|
+ - [S3](https://github.com/codelibs/fess-ds-s3)
|
|
|
+ - [Salesforce](https://github.com/codelibs/fess-ds-salesforce)
|
|
|
+ - [SharePoint](https://github.com/codelibs/fess-ds-sharepoint)
|
|
|
+ - [Slack](https://github.com/codelibs/fess-ds-slack)
|
|
|
+
|
|
|
+## Tema
|
|
|
+
|
|
|
+ - [Simple](https://github.com/codelibs/fess-theme-simple)
|
|
|
+ - [Classic](https://github.com/codelibs/fess-theme-classic)
|
|
|
+
|
|
|
+## Ingesta
|
|
|
+
|
|
|
+ - [Logger](https://github.com/codelibs/fess-ingest-logger)
|
|
|
+ - [NDJSON](https://github.com/codelibs/fess-ingest-ndjson)
|
|
|
+
|
|
|
+## Script
|
|
|
+
|
|
|
+ - [Groovy](https://github.com/codelibs/fess-script-groovy)
|
|
|
+ - [OGNL](https://github.com/codelibs/fess-script-ognl)
|
|
|
+
|
|
|
+## Información de Desarrollo
|
|
|
+
|
|
|
+### Obtener el Código Fuente
|
|
|
+
|
|
|
+1. Clona el repositorio de Fess:
|
|
|
+ ```
|
|
|
+ $ cd ~/workspace
|
|
|
+ $ git clone https://github.com/codelibs/fess.git
|
|
|
+ ```
|
|
|
+
|
|
|
+2. Importa el repositorio clonado como un proyecto [Maven](https://maven.apache.org/) en [Eclipse](https://www.eclipse.org/eclipseide/) u otro IDE.
|
|
|
+
|
|
|
+### Configuración de Plugins para OpenSearch
|
|
|
+
|
|
|
+Ejecuta antrun:run para descargar los plugins en el directorio de plugins:
|
|
|
+
|
|
|
+ $ mvn antrun:run
|
|
|
+
|
|
|
+### Ejecutar Fess
|
|
|
+
|
|
|
+Ejecuta o depura `org.codelibs.fess.FessBoot` en tu IDE, y luego accede a http://localhost:8080/
|
|
|
+
|
|
|
+### Construir el Paquete
|
|
|
+
|
|
|
+Ejecuta el objetivo `package` y luego se creará el archivo de lanzamiento en target/releases.
|
|
|
+
|
|
|
+ $ mvn package
|
|
|
+ $ mvn rpm:rpm # Paquete .rpm
|
|
|
+ $ mvn jdeb:jdeb # Paquete .deb
|
|
|
+
|
|
|
+### Generar Código Fuente
|
|
|
+
|
|
|
+ $ mvn dbflute:download # (comando ejecutado una sola vez)
|
|
|
+ $ mvn dbflute:freegen
|
|
|
+ $ mvn license:format
|
|
|
+
|
|
|
+### Pruebas de Integración
|
|
|
+
|
|
|
+Inicia el servidor Fess y ejecuta el siguiente comando:
|
|
|
+
|
|
|
+ $ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201"
|
|
|
+
|
|
|
+Para ejecutar un único caso de prueba, puedes usar:
|
|
|
+
|
|
|
+ $ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201" -Dtest=SearchApiTests
|
|
|
+
|
|
|
+### Traducir a Tu Idioma
|
|
|
+
|
|
|
+Fess es un software internacionalizado.
|
|
|
+
|
|
|
+Si deseas agregar etiquetas/mensajes para tu idioma, por favor traduce el archivo de propiedades y renómbralo a fess\_\*\_[lang].properties.
|
|
|
+
|
|
|
+* [fess_label_en.properties](https://github.com/codelibs/fess/blob/master/src/main/resources/fess_label_en.properties)
|
|
|
+* [fess_message_en.properties](https://github.com/codelibs/fess/blob/master/src/main/resources/fess_message_en.properties)
|
|
|
+
|
|
|
+Para el analizador de búsqueda/índices, si [doc.json](https://github.com/codelibs/fess/blob/master/src/main/resources/fess_indices/fess/doc.json) contiene lang\_[lang] para tu idioma, por favor modifica el analizador para tu idioma. Para más detalles sobre los analizadores, consulta la [documentación de OpenSearch](https://opensearch.org/docs/latest/analyzers/search-analyzers/).
|
|
|
+
|
|
|
+Damos la bienvenida a pull requests para tu idioma.
|
|
|
+
|
|
|
+## Impulsado por
|
|
|
+
|
|
|
+* [Lasta Di](https://github.com/lastaflute/lasta-di "Lasta Di"): Contenedor DI
|
|
|
+* [LastaFlute](https://github.com/lastaflute/lastaflute "LastaFlute"): Framework Web
|
|
|
+* [Lasta Job](https://github.com/lastaflute/lasta-job "Lasta Job"): Programador de Tareas
|
|
|
+* [Fess Crawler](https://github.com/codelibs/fess-crawler "Fess Crawler"): Rastreador Web
|
|
|
+* [OpenSearch](https://opensearch.org/ "OpenSearch"): Motor de Búsqueda
|
Shinsuke Sugaya