TodoRelatos para NVDA - Manual de Usuario

Descripción General

TodoRelatos es un complemento para NVDA que permite acceder de forma completamente accesible a la web TodoRelatos.com, un portal de relatos para adultos organizados por categorías.

Con este complemento podrás:

• Navegar por todas las categorías de relatos
• Buscar relatos por palabras clave con múltiples modos de ordenación
• Leer los relatos con NVDA o en una ventana navegable
• Guardar relatos favoritos para acceso rápido
• Consultar tu historial de lectura
• Exportar relatos a archivos de texto
• Todo sin necesidad de navegador web ni registro en la página

Cómo Abrir el Complemento

Hay dos formas de abrir TodoRelatos:

1. Menú de NVDA: Ve a NVDA → Herramientas → TodoRelatos para NVDA
2. Atajo de teclado: Puedes asignar un gesto personalizado en NVDA → Preferencias → Gestos de entrada, buscando "TodoRelatos"

Interfaz Principal

La ventana principal se organiza en cuatro pestañas accesibles con las teclas de función:

Pestaña General

Aquí puedes explorar los relatos organizados por categorías:

• Categoría: Selecciona una categoría del cuadro desplegable
• Lista de relatos: Muestra los relatos de la categoría seleccionada
• Página: Navega entre las páginas de resultados (20 relatos por página)

Pestaña Buscador

Permite buscar relatos por palabras clave:

• Modo de ordenación: Elige cómo ordenar los resultados (por fecha, título, categoría, lecturas o valoración)
• Campo de búsqueda: Escribe las palabras a buscar y pulsa Enter
• Resultados: Lista con los relatos encontrados

Pestaña Favoritos

Accede rápidamente a los relatos que has marcado como favoritos. Puedes:

• Hacer doble clic o pulsar Enter para leer un favorito
• Pulsar Suprimir para eliminar un favorito de la lista

Pestaña Historial

Consulta los últimos relatos que has leído. El historial se guarda automáticamente.

Atajos de Teclado en las Listas de Relatos

Cuando estés en una lista de relatos (General o Buscador), puedes usar estos atajos:

Menú de Acciones

Al pulsar Enter sobre un relato, se abre un menú con las siguientes opciones:

• Leer relato: Abre el relato en una ventana navegable con el texto completo
• Leer con NVDA: NVDA lee el relato en voz alta
• Ver detalles: Muestra información completa del relato (título, autor, visitas, valoración, descripción)
• Abrir en navegador: Abre la página web del relato en tu navegador predeterminado
• Añadir/Quitar de favoritos: Gestiona tus relatos favoritos
• Buscar saga relacionada: Busca automáticamente todas las partes de una saga (ver sección Detección de Sagas)
• Guardar en archivo TXT: Exporta el relato a un nuevo archivo de texto
• Agregar a archivo TXT existente: Añade el relato al final de un archivo existente (útil para compilar sagas)

Detección de Sagas

El complemento incluye un sistema avanzado de detección de sagas que identifica automáticamente todas las partes de una serie de relatos. Este sistema es accesible desde el menú contextual de cualquier relato (Buscar saga relacionada) y desde el menú Herramientas → Sagas detectadas.

¿Cómo funciona?

El sistema detecta múltiples formatos de numeración de sagas:

• Con separador: "Título - Parte 1", "Título: Capítulo 2", "Título – Episodio III"
• Entre paréntesis: "Título (Parte 1)", "Título (2)", "Título (1/3)"
• Con símbolos: "Título #1", "Título Nº 2", "Título [3]"
• Con guiones: "Título -1-", "Título -2-"
• Números romanos: "Título II", "Título IV", "Título - Cap. IX"
• Sin separador: "Título Capítulo 2", "Título 3"
• Formato invertido: "Capítulo 67: Subtítulo", "Parte 3 - Subtítulo"
• Palabras especiales: "Título - Continuación", "Título - Final"
• Sin numeración: Si el primer relato de la saga no tiene número, se detecta automáticamente como la primera entrega

Estrategia de búsqueda en 3 fases

Cuando se busca una saga, el sistema ejecuta hasta 3 fases para maximizar los resultados:

1. Fase 1 - Búsqueda por autor: Recorre todas las páginas de resultados del autor, filtrando por similitud de título. Esto es especialmente útil para sagas largas con cientos de capítulos.
2. Fase 2 - Búsqueda por título: Busca el nombre base de la saga directamente. Se omite si el título es genérico (solo "Capítulo" o "Parte").
3. Fase 3 - Búsqueda por variaciones: Si hay pocos resultados, busca combinaciones de las palabras más significativas del título.

Ventana de resultados de saga

Cuando se encuentra una saga, se muestra una ventana con todos los capítulos ordenados. En esta ventana puedes:

Además dispones de los botones:

• Leer: Abre el capítulo seleccionado para lectura
• Guardar saga: Guarda la saga para acceso posterior desde Herramientas → Sagas detectadas
• Actualizar: Busca nuevos capítulos que el autor haya publicado desde la última vez
• Descargar todo: Abre el diálogo de exportación masiva para descargar todos los capítulos

Exportación Masiva

El diálogo de exportación masiva permite descargar múltiples relatos a la vez. Se accede desde el botón Descargar todo en la ventana de saga, o desde Herramientas → Sagas detectadas → Descargar todo.

Opciones de exportación

• Guardar en caché offline: Almacena los relatos localmente para lectura sin conexión
• Guardar como archivos TXT: Crea un archivo de texto por cada relato en el directorio seleccionado
• Generar archivo EPUB: Crea un libro electrónico EPUB con todos los capítulos ordenados, incluyendo tabla de contenidos navegable. Ideal para leer sagas completas en lectores de ebooks.

Cuando se marca la opción TXT o EPUB, es obligatorio seleccionar un directorio destino usando el botón Examinar.

Herramientas

El menú Herramientas de la ventana principal proporciona acceso a funcionalidades adicionales:

Sagas detectadas

Muestra todas las sagas que has guardado previamente. Puedes:

• Ver relatos: Abre la lista de capítulos de la saga
• Actualizar saga: Busca nuevos capítulos publicados
• Descargar todo: Exportación masiva de todos los capítulos
• Eliminar saga: Quita la saga de la lista de guardadas

Colecciones

Permite crear colecciones personalizadas de relatos agrupados por temas que tú definas.

Caché Offline

Gestiona los relatos descargados para lectura sin conexión a Internet.

Marcadores de lectura

Los marcadores te permiten guardar tu posición de lectura en un relato para continuar exactamente donde lo dejaste. El sistema funciona de forma automática e integrada:

Guardar un marcador

• Mientras lees un relato, pulsa Ctrl+M o el botón Marcador para guardar la posición actual del cursor
• Se anuncia el porcentaje de avance (ej: "Marcador guardado al 35.2%")
• Si ya existía un marcador para ese relato, se actualiza con la nueva posición

Restaurar un marcador

• Al abrir un relato que tiene un marcador guardado, el cursor se posiciona automáticamente donde lo dejaste
• Se anuncia "Marcador restaurado al X%" para confirmarte la posición

Gestionar marcadores

Desde Herramientas → Marcadores de lectura puedes:

• Ver todos los marcadores guardados con su porcentaje de avance
• Eliminar marcadores que ya no necesites

Estadísticas

Muestra estadísticas de tu uso del complemento: relatos leídos, tiempo de lectura, rachas de lectura, categorías y autores favoritos.

Sincronización

Permite exportar e importar favoritos e historial en formato JSON para respaldo o transferencia entre equipos.

Exportación masiva

Permite descargar todos los relatos de la pestaña actual (General o Buscador) a la vez, con las mismas opciones de caché, TXT y EPUB descritas en la sección Exportación Masiva.

Backup de datos

Crea una copia de seguridad completa de todos los datos del complemento en un archivo ZIP. Esto incluye:

• Favoritos e historial de lectura
• Sagas guardadas
• Colecciones personalizadas
• Marcadores de lectura
• Estadísticas de uso
• Caché offline de relatos
• Configuración del complemento

El archivo de backup se genera con un nombre que incluye la fecha y hora actual (ej: TodoRelatos_backup_20260511_193000.zip).

Restaurar backup

Restaura un backup creado previamente. Al restaurar:

• Se reemplazan todos los datos actuales con los del backup
• Se valida que el archivo ZIP contenga datos válidos de TodoRelatos
• Se pide confirmación antes de proceder
• Se recomienda reiniciar NVDA después de restaurar para asegurar que todos los módulos recarguen sus datos

Restablecer complemento

Elimina todos los datos del complemento, dejándolo exactamente como si se hubiese instalado por primera vez. Borra favoritos, historial, sagas, colecciones, marcadores, estadísticas, caché y configuración.

Se pide doble confirmación antes de proceder, ya que esta acción no se puede deshacer. Después del restablecimiento se recomienda reiniciar NVDA.

Ventana de Lectura

Cuando abres un relato para leer, se muestra en una ventana con estas opciones:

• Copiar todo: Copia el texto completo al portapapeles
• Guardar como: Guarda el texto en un archivo
• Marcador (Ctrl+M): Guarda la posición actual del cursor como marcador de lectura
• Escape: Cierra la ventana

Si el relato tiene un marcador guardado previamente, al abrirlo el cursor se posiciona automáticamente donde lo dejaste y se anuncia el porcentaje de avance.

Configuración

Pulsa el botón Configuración para acceder a las opciones:

• Sonidos de feedback: Activa o desactiva los sonidos durante las operaciones
• Máximo de historial: Cantidad de relatos a recordar en el historial (10-500)
• Máximo de favoritos: Cantidad máxima de favoritos (10-1000)
• Formato de exportación: Formato preferido para guardar relatos
• Limpiar historial/favoritos: Botones para vaciar las listas

Atajos de Teclado en las Listas de Relatos

Cuando estés en una lista de relatos (General o Buscador), puedes usar estos atajos:

Atajos Globales

Atajos en la Ventana de Lectura

Atajos en la Vista de Saga

Requisitos

• NVDA 2024.1 o superior
• Conexión a Internet (excepto para contenido en caché offline)

Registro de Cambios

Versión 2026.05.11

• Detección avanzada de sagas: Sistema completo de búsqueda por autor con recorrido de todas las páginas disponibles
• Matching difuso: Tolerancia a errores ortográficos y variaciones en títulos de sagas
• Soporte para títulos invertidos: Detecta formatos como "Capítulo 67: Subtítulo" donde el keyword va antes del número
• Detección de primera entrega sin número: Reconoce relatos sin numeración como la primera parte de la saga
• Patrones ampliados: Nuevos formatos detectados: -X- (entre guiones), "Título Capítulo X" (sin separador), y más
• Reordenamiento de capítulos: Mueve capítulos con Alt+Flechas y elimina con Suprimir en la vista de saga
• Exportación a EPUB: Genera libros electrónicos EPUB multi-capítulo con tabla de contenidos
• Exportación masiva mejorada: Validación de directorio, campo multilínea para rutas largas, opciones TXT+EPUB+Caché
• Corrección de duplicados: Normalización de URLs para evitar duplicados al actualizar sagas
• Backup y restauración: Sistema completo para respaldar y restaurar todos los datos del complemento en un archivo ZIP
• Saga manual: La saga solo se guarda cuando el usuario pulsa explícitamente "Guardar saga", no automáticamente al buscar
• Restablecer complemento: Opción para borrar todos los datos y dejar el complemento como recién instalado
• Marcadores integrados: Ctrl+M en la ventana de lectura para guardar posición, restauración automática al reabrir el relato

Versión 1.0.0

• Versión inicial completamente reescrita
• Nuevo sistema de favoritos persistente
• Nuevo historial de lectura
• Interfaz mejorada con cuatro pestañas
• Sin dependencias de librerías externas
• Parser HTML propio para mayor estabilidad
• Configuración de usuario persistente
• Compatibilidad con NVDA 2024.1+
• Código modular y fácil de mantener

Créditos y Licencia

Este complemento está desarrollado por Héctor J. Benítez Corredera y está cubierto por la Licencia Pública General de GNU (GPL).

Basado en el complemento original zErotic, completamente reescrito con código moderno y nuevas funcionalidades.