Centro de Ayuda
Encuentra respuestas, tutoriales y soporte para sacar el máximo partido a hesiOX
¿Cómo creo mi primer proyecto?
1. Haz clic en Proyectos → Crear Proyecto en la barra de navegación
2. Completa los campos:
- Nombre: Un identificador único (ej: "Prensa del Sirio")
- Descripción: Breve explicación del contenido (opcional)
- Tipo: Hemerografía, Libros, Archivos o Mixto
3. Haz clic en Crear Proyecto
El proyecto se activará automáticamente y podrás empezar a agregar artículos.
¿Puedo tener varios proyectos simultáneamente?
Sí, hesiOX soporta múltiples proyectos independientes. Cada proyecto mantiene sus propios artículos, publicaciones e imágenes separadas.
Solo puedes tener un proyecto activo a la vez. Para cambiar:
- Ve a Proyectos → Ver Proyectos
- Haz clic en Abrir Proyecto del proyecto deseado
¿Qué tipo de proyecto debo seleccionar?
- Hemerografía: Para artículos de prensa y periódicos históricos
- Libros: Para libros y monografías académicas
- Archivos: Para documentos de archivo, manuscritos
- Mixto: Para proyectos que combinan varios tipos
Nota: El tipo es solo organizativo y no afecta la funcionalidad.
¿Qué campos son obligatorios al crear un artículo?
Los campos obligatorios son:
- Título: Título del artículo
- Medio: Nombre del periódico/revista
- Fecha: Fecha de publicación (formato DD/MM/AAAA)
Todos los demás campos son opcionales, pero se recomienda completar el máximo posible para mejor catalogación.
¿Cómo edito un artículo existente?
Hay dos formas:
- Método 1: Haz clic en el título del artículo en el listado
- Método 2: Haz clic en el icono de lápiz junto al artículo
Modifica los campos necesarios y haz clic en Actualizar.
Tip: Usa Ctrl+S para guardar rápidamente.
¿Puedo eliminar varios artículos a la vez?
Sí, usando la eliminación masiva:
- Marca los checkboxes de los artículos que deseas eliminar
- El botón Lotes (N) se habilitará mostrando el número seleccionado
- Haz clic en el botón y selecciona Borrar seleccionados
- Confirma la eliminación
Esta acción es irreversible.
¿Qué es el OCR y cómo funciona?
OCR (Optical Character Recognition) es una tecnología que convierte imágenes de texto en texto editable.
hesiOX usa Tesseract.js 4.1.1 para:
- Recibir una imagen escaneada (periódico, documento)
- Analizar la imagen y reconocer caracteres
- Extraer el texto automáticamente (2-3 segundos/imagen)
- Copiar el texto al editor para que lo revises
¿Qué formatos de imagen soporta el OCR?
Formatos soportados:
- JPG/JPEG: Más común para escaneos
- PNG: Buena calidad sin compresión
- GIF: Compatible pero no recomendado
- TIFF: Formato de archivo profesional
Recomendación: Usa JPG con resolución mínima de 300 DPI para mejores resultados.
El OCR tiene errores, ¿qué hago?
El OCR no es 100% preciso, especialmente con:
- Fuentes antiguas o góticas
- Imágenes borrosas o de baja calidad
- Manchas o deterioro del papel
- Texto en columnas complejas
Solución:
- Revisa siempre el texto extraído
- Corrige manualmente en el editor TinyMCE
- Guarda la versión corregida
El texto original OCR se guarda con cada imagen para referencia.
¿Puedo subir varias imágenes a la vez?
Sí, hesiOX soporta carga múltiple de imágenes:
- En el formulario de artículo, haz clic en "Seleccionar archivos"
- Selecciona múltiples archivos (Ctrl+Clic o Shift+Clic)
- O arrastra varias imágenes al área de carga
- El OCR procesará cada imagen automáticamente
- El texto se concatenará en el editor
Cada imagen toma 2-3 segundos, sé paciente con lotes grandes.
¿Cuál es la diferencia entre búsqueda normal y semántica?
Búsqueda Normal (campo superior):
- Busca palabras exactas en: título, medio, contenido, palabras clave
- Rápida y en tiempo real
- No distingue mayúsculas/minúsculas
- Ejemplo: "naufragio" solo encuentra ese término
Búsqueda Semántica (menú Acciones):
- Entiende el significado de tu consulta
- Encuentra contenido relacionado aunque no tenga las palabras exactas
- Usa inteligencia artificial (NLP)
- Ejemplo: "tragedia marítima" encuentra "naufragio", "hundimiento", "accidente naval"
¿Cómo funcionan los filtros avanzados?
Los filtros se pueden combinar para búsquedas precisas:
- Haz clic en Filtros para mostrar opciones
- Selecciona criterios:
- Fecha: Rango, año específico o década
- Ciudad: Una o varias ciudades
- País: Filtra por país
- Medio: Periódico específico
- Idioma: Uno o varios idiomas
- Haz clic en Aplicar Filtros
Todos los filtros actúan como "Y" (AND) - el artículo debe cumplir todos.
¿Qué formato de cita debo usar?
Depende del área académica:
- ISO 690: Universal, por defecto
- APA 7: Psicología, Educación, Ciencias Sociales
- MLA 9: Literatura, Humanidades, Artes
- Chicago 17: Historia, Humanidades
- Harvard: Ciencias, Medicina (sistema autor-fecha)
- Vancouver: Medicina, Ciencias de la Salud
- Hemerográfico: Especializado para prensa histórica
Tip: Consulta la guía de estilo de tu universidad o revista.
¿Cómo exporto a Zotero/Mendeley?
Usa el formato RIS:
- Menú Acciones → Exportar
- Selecciona RIS
- Se descarga archivo
.ris - En Zotero: Archivo → Importar → Selecciona el .ris
- En Mendeley: Arrastra el archivo a la biblioteca
También funciona con EndNote, RefWorks y otros gestores.
¿Puedo exportar solo algunos artículos?
Sí, usando exportación selectiva:
- Marca los checkboxes de los artículos deseados
- Haz clic en Lotes (N)
- Selecciona Exportar seleccionados
- Elige el formato (BibTeX, RIS, CSV, JSON)
Si no marcas ninguno, se exportan TODOS los artículos del proyecto activo.
No veo el botón para eliminar un proyecto
Esto puede deberse a:
- Es el proyecto activo: No puedes eliminar el proyecto en uso. Solución: Activa otro proyecto primero.
- Es el único proyecto: Debes tener al menos un proyecto. Solución: Crea otro proyecto antes de eliminar este.
Las imágenes no se cargan o aparecen rotas
Soluciones:
- Limpia la caché del navegador: Ctrl + Shift + R
- Verifica que el servidor esté ejecutándose
- Comprueba que la carpeta
static/uploads/tenga permisos de lectura - Revisa el espacio disponible en disco
La búsqueda semántica es muy lenta
Causas posibles:
- Primera búsqueda: La indexación inicial puede tardar
- Muchas pestañas abiertas: Cierra otras pestañas
- Conexión lenta: Verifica tu internet
Solución: Espera 5-10 segundos en la primera búsqueda. Las siguientes serán más rápidas (<1 segundo).
¿Cómo reporto un error?
Si encuentras un problema:
- Abre la consola del navegador: F12
- Toma captura de pantalla del error
- Anota los pasos para reproducirlo
- Contacta al desarrollador con:
- Descripción del problema
- Pasos para reproducir
- Navegador y versión
- Captura de consola
Enlaces Rápidos
Contacto
Desarrollador: David García Pascual
Versión: hesiOX v1.5.0
Última actualización: 26/11/2025
Manual de Usuario Completo
Guía detallada de todas las funcionalidades de hesiOX
Manual en Markdown
Versión completa en formato Markdown para leer en línea o descargar.
• 15 capítulos
• Ejemplos paso a paso
• Capturas de pantalla
• Solución de problemas
Versión PDF
Próximamente: Manual en PDF optimizado para impresión.
• Formato profesional
• Índice interactivo
• Para imprimir
• Disponible en v1.2.0
Contenidos del Manual
- Introducción
- Primeros Pasos
- Gestión de Proyectos
- Gestión de Artículos
- Gestión de Publicaciones
- OCR Automático
- Búsqueda y Filtrado
- Búsqueda Semántica
- Generador de Citas
- Análisis y Estadísticas
- Visualizaciones
- Exportación de Datos
- Temas Visuales
- Atajos de Teclado
- Solución de Problemas
Video Tutoriales
Próximamente: Tutoriales en video paso a paso de todas las funcionalidades.
📹 Videos Planificados para v1.2.0
- ✓ Crear tu primer proyecto (3 min)
- ✓ Agregar artículos con OCR (5 min)
- ✓ Búsqueda semántica avanzada (4 min)
- ✓ Generar citas bibliográficas (3 min)
- ✓ Exportar a Zotero/Mendeley (4 min)
- ✓ Análisis y visualizaciones (6 min)
Atajos Globales
| Ctrl + S | Guardar formulario actual |
| Ctrl + F | Buscar en página |
| Esc | Cerrar modal activo |
| F5 | Recargar página |
| Ctrl + Shift + R | Recargar sin caché |
| F12 | Abrir consola de desarrollador |
Editor TinyMCE
| Ctrl + B | Negrita |
| Ctrl + I | Cursiva |
| Ctrl + U | Subrayado |
| Ctrl + Z | Deshacer |
| Ctrl + Y | Rehacer |
| Ctrl + K | Insertar enlace |
Selección Múltiple
| Clic + Shift + Clic | Seleccionar rango de artículos |
| Ctrl + Clic | Seleccionar múltiples no consecutivos |
| Ctrl + A | Seleccionar todo el texto |
Tips Útiles
- Usa Tab para navegar entre campos del formulario
- Presiona Enter en el buscador para ejecutar búsqueda
- Doble clic en un artículo para editarlo rápidamente
- Arrastra imágenes directamente al área de carga OCR
- Usa las teclas de flecha en dropdowns para navegar