# Guía de usuario de Cosimo

Cosimo te ayuda a estudiar pares de pregunta y respuesta con repetición
espaciada. Está diseñado para usarse con teclado y lectores de pantalla.

## Qué significa repetición espaciada

La repetición espaciada es un método de estudio basado en repasar el material
con intervalos cada vez mayores.

Cuando algo es nuevo, difícil o se ha fallado hace poco, debe volver pronto.
Cuando algo es fácil y se recuerda de forma constante, puede esperar más
tiempo. El objetivo es dedicar más tiempo al material que necesita atención y
menos tiempo a repetir lo que ya está asentado.

En Cosimo, cada cosa que aprendes es una carta:

- la pregunta es la cuestión, pista o frase que ves primero
- la respuesta es lo que compruebas después

Cosimo registra tus valoraciones después de cada repaso y usa ese historial
para decidir qué cartas están pendientes.

## Instalación y actualización

Cosimo es una aplicación portable. Para instalarlo, descomprime el archivo zip
de la versión publicada en la carpeta desde la que quieras ejecutar Cosimo y
después inicia `cosimo.exe` desde esa carpeta.

Para actualizar, cierra Cosimo, descomprime el nuevo zip sobre la carpeta
existente de Cosimo y permite que se sobrescriban los archivos del programa.
Los paquetes publicados no deberían sobrescribir datos de usuario como
`cosimo.ini`, mazos personales, bases de datos de repaso, informes o copias de
seguridad. Mantén copias de seguridad normales antes de actualizar, sobre todo
si guardas tus propios mazos en la carpeta de la aplicación.

## Mazos

Un mazo es un archivo que contiene cartas. Los archivos de mazo de Cosimo usan
la extensión `.cosimo-deck`.

Puedes editar cartas dentro de Cosimo o editar directamente el archivo del mazo
en un editor de texto. El archivo del mazo guarda preguntas, respuestas,
metadatos del mazo y marcas de cartas, como el estado no reversible. El
historial de repaso y las valoraciones se guardan por separado.

Los archivos de mazo también contienen un pequeño marcador numerado al final de
cada carta, como `=1=`. Deja ese número en su sitio cuando edites a mano. Permite
que Cosimo conserve el historial de repaso de la carta aunque cambies el texto
de la pregunta o de la respuesta.
Cuando Cosimo abre un mazo antiguo, guarda una copia de seguridad del original
según la configuración de copias del mazo y actualiza el archivo al formato
actual.

Usa `Archivo -> Propiedades del mazo` para ver la versión del formato del mazo
y los campos de metadatos opcionales: título, autoría, descripción y URL. Usa
`Archivo -> Editar metadatos del mazo` para editar esos campos de metadatos.

Cosimo puede usar un directorio con el mismo nombre base junto al archivo del
mazo para audio de repaso opcional en formato WAV. Por ejemplo,
`Indonesian.cosimo-deck` puede usar un directorio `Indonesian` con archivos como
`1.prompt.wav` y `1.response.wav`. Cosimo lee esos archivos durante el repaso
ordinario, y lee el audio de pregunta mientras respondes preguntas de examen, si
el audio está activado. En esta primera versión de audio no crea, edita ni copia
automáticamente archivos de audio.

El mazo predeterminado es `decks/deck.cosimo-deck`, junto al ejecutable de
Cosimo. En instalaciones portables de Windows, guarda tus mazos en la carpeta
`decks` junto a la aplicación. Si falta el mazo predeterminado, Cosimo crea uno
vacío. Puedes abrir otro mazo desde `Archivo -> Abrir mazo`. Si eliges un
archivo de mazo que no existe, Cosimo pregunta si quieres crear ahí un mazo
vacío.

Cuando Cosimo se cierra, recuerda el último mazo abierto y vuelve a abrirlo la
próxima vez. También conserva hasta ocho mazos abiertos recientemente en
`Archivo -> Mazos recientes`, omitiendo el mazo actual. Si solo hay otro mazo
reciente, Cosimo lo muestra directamente en el menú `Archivo`, sin colocarlo en
un submenú. Guarda esto y otras opciones de la aplicación en `cosimo.ini`, junto
al ejecutable. Cosimo también recuerda el filtro y el modo de ordenación de la
lista de cartas. Si Cosimo encuentra archivos antiguos `cosimo-settings.txt` o
`cosimo-last-open-deck.txt`, los migra a `cosimo.ini` y elimina los archivos
antiguos.

El cuadro de opciones también permite configurar avisos sonoros de
disponibilidad de repasos, audio de repaso, la regla de recuerdo usada por la
calibración del panel de aprendizaje y la minimización al área de notificación.
Los avisos
sonoros pueden configurarse como `Siempre`, `Cuando Cosimo esté visible`,
`Cuando Cosimo esté en el área de notificación` o `Nunca`. Cuando la política
elegida permite sonido, Cosimo reproduce un sonido breve si la actualización
automática de la pantalla inicial detecta que hay repasos disponibles, o que
hay más repasos disponibles que en la última actualización automática. Los
cambios provocados por el usuario, como añadir o eliminar cartas, y las
actualizaciones manuales con `F5` no reproducen este sonido. Cosimo también
permanece en silencio mientras hay una pasada de repaso activa, aunque haya más
cartas que pasen a estar disponibles durante esa pasada. Con la minimización al
área de notificación activada, la acción normal de minimizar la ventana oculta
Cosimo en el área de notificación en vez de dejarlo en la barra de tareas.
Activar el icono del área de notificación restaura la ventana, y el menú
contextual del icono contiene Restaurar y Salir. Cerrar Cosimo sigue saliendo
de la aplicación.

## Ayuda y enlaces del proyecto

El menú `Ayuda` abre la guía de usuario local, la wiki del proyecto y la página
de tickets nuevos para informar de errores. Los informes de error se gestionan
mediante tickets de Fossil en el sitio del proyecto.

## Copias de seguridad

Haz copia de seguridad tanto del archivo del mazo como de su base de datos de
repasos correspondiente. El archivo del mazo contiene tus cartas, metadatos del
mazo y marcas de cartas no reversibles. La base de datos de repasos contiene la
programación, las valoraciones y el historial de repaso.

Cosimo también crea copias automáticas del contenido del mazo. Antes de
sobrescribir un mazo existente, copia la versión actual en el directorio
`backups` de la aplicación, junto al ejecutable. Los archivos de copia usan
números crecientes, por ejemplo `backups/000001-deck.cosimo-deck`. El archivo
`backups/index.txt` registra cada nombre de copia y la ruta del mazo original.

Configura las copias automáticas del mazo en `Archivo -> Opciones`:

- `Completas`: conserva todas las copias automáticas del mazo.
- `Solo la última`: conserva solo la copia automática más reciente de cada ruta
  de mazo original.
- `Ninguna`: no crea copias automáticas del mazo.

Configura las copias de la base de datos de repasos en
`Archivo -> Opciones`:

- `Al comenzar sesión`: actualiza una copia retenida de la base de datos de
  repasos cuando comienza una pasada.
- `Desactivadas`: no crea ni actualiza copias de la base de datos de repasos.

Usa `Archivo -> Depurar base de datos de repaso` para eliminar de forma
permanente filas inactivas de la base de datos de repaso correspondientes a
cartas que ya no están en el mazo actual y a cartas inversas generadas que
están inactivas. Se conservan las cartas activas, las cartas inversas generadas
activas, los calendarios actuales, las suspensiones actuales y las marcas
actuales de cartas marcadas. Las marcas de carta no reversible se guardan en el
archivo del mazo, no en la base de datos de repaso. Si las copias de la base de
datos de repaso están desactivadas, Cosimo avisa de que la depuración es
irreversible. Si las copias están activadas, Cosimo actualiza la copia retenida
de la base de datos de repaso antes de depurar y avisa de que esa copia
retenida se sobrescribirá. Después de eliminar las filas inactivas, Cosimo
ejecuta una limpieza de la base de datos para que el archivo SQLite pueda
recuperar espacio sin usar.

Usa `Archivo -> Recuperar espacio de la base de datos` para ejecutar la misma
limpieza SQLite sin eliminar datos de repaso inactivos. Esto reescribe el
archivo de base de datos de repaso y puede tardar un tiempo en una base de
datos grande. Si las copias de la base de datos de repaso están activadas,
este comando no sobrescribe la copia retenida; si las copias están
desactivadas, Cosimo te recuerda que compruebes que tienes una copia si te
preocupa.

Para el mazo predeterminado, copia:

- `decks/deck.cosimo-deck`
- `decks/deck.reviews.sqlite3`, si existe

Para otro mazo, la base de datos de repasos está junto al mazo y usa el mismo
nombre base. Por ejemplo, `spanish.cosimo-deck` usa
`spanish.reviews.sqlite3`.

Cierra Cosimo antes de copiar o restaurar archivos de copia de seguridad.
Restaurar solo el archivo `.cosimo-deck` recupera las cartas, pero las deja sin
su historial de repaso anterior. Restaurar ambos archivos conserva las cartas y
su historial de programación.

Cosimo comprueba la integridad de la base de datos de repasos al abrir un
mazo. Si Cosimo indica que esa comprobación ha fallado, cierra Cosimo y
restaura el archivo `.reviews.sqlite3` correspondiente desde tu copia de
seguridad.

Las copias automáticas del mazo contienen solo el texto del mazo, no el
historial de repaso. Para restaurar una, cierra Cosimo y copia la copia elegida
encima del archivo `.cosimo-deck` activo. Para restaurar el historial de
programación, restaura el archivo `.reviews.sqlite3` correspondiente desde tu
propia copia de seguridad o desde la copia retenida de la base de datos de
repasos de Cosimo.

Usa `Archivo -> Opciones -> Eliminar copias antiguas` para conservar solo la
copia automática más reciente de cada ruta de mazo original. Cosimo pide
confirmación antes de eliminar o renumerar archivos de copia.

Para ayuda paso a paso con la recuperación, consulta
[Solución de problemas](troubleshooting-es.md).

## Pantalla inicial

Cuando Cosimo se inicia, se abre en la pantalla inicial. Esta pantalla muestra:

- cuántas cartas hay en el mazo
- cuántas cartas están pendientes ahora
- el mínimo de cartas por sesión
- el archivo de la base de datos de repasos
- una lista de preguntas de las cartas

Si el mínimo de cartas por sesión hace que Cosimo añada cartas adicionales que
todavía no están pendientes, el recuento de cartas programadas también muestra
entre paréntesis cuántas están pendientes. Por ejemplo, `Programadas ahora: 10
(6 pendientes)` significa que la pasada incluiría 6 cartas pendientes y 4
cartas adicionales para llegar al mínimo.

La barra de estado de la ventana principal también ofrece un resumen breve:
cartas totales, cartas pendientes ahora, y si hay un repaso pendiente ahora o
cuánto falta aproximadamente para el próximo repaso programado. Las duraciones
se redondean hacia arriba a unidades cómodas para voz sintetizada, como
`2 días`, `4 semanas` o `3 meses`.

Mientras la pantalla inicial está abierta, Cosimo actualiza el resumen, los
filtros de la lista y la barra de estado aproximadamente una vez por minuto.
Una carta que pase a estar pendiente mientras la aplicación está abierta
quedará disponible para `Comenzar` sin cerrar y volver a abrir el mazo.

Puedes añadir, editar o eliminar cartas antes de comenzar una pasada. Después
de mostrar una carta durante el repaso, también puedes editar esa carta actual
si encuentras un error en la pregunta o en la respuesta. `Cartas -> Editar
carta seleccionada` cambia a `Cartas -> Editar carta actual` en ese momento.

Para introducir varias cartas seguidas, usa `Cartas -> Añadir cartas en
bloque`. Escribe la pregunta y la respuesta, y pulsa `Ctrl+Enter` desde
cualquiera de los dos campos para añadir la carta y volver al campo de
pregunta. Al pulsar Tab desde el campo de respuesta también se añade la carta y
se vuelve al campo de pregunta cuando ambos campos contienen texto. Pulsa
Escape para cerrar el diálogo de entrada en bloque.

Teclas útiles en la pantalla inicial:

- `Alt-M`: comenzar la pasada programada
- `Alt-F`: forzar el comienzo con todas las cartas no suspendidas ni aplazadas
- `Alt-X`: comenzar una pasada de examen con una muestra aleatoria de cartas activas
- `Alt-L`: ir al filtro de texto de la lista de preguntas
- `F5`: actualizar el resumen inicial, los filtros de la lista y la barra de
  estado
- `Ctrl+L`: mostrar el panel de aprendizaje
- `Alt-S`: salir
- `Alt+Enter`: mostrar detalles y estadísticas de la carta seleccionada
- `Delete`: eliminar la carta seleccionada de la lista de preguntas
- `Ctrl+S`: suspender o reactivar la carta seleccionada
- `Ctrl+F`: marcar o desmarcar la carta seleccionada
- `Ctrl+D`: aplazar la carta seleccionada hasta mañana, o quitar su
  aplazamiento
- `Ctrl+R`: hacer reversible la carta seleccionada, o eliminar la carta
  inversa generada

El diálogo de detalles de carta muestra la pregunta, la respuesta, el ID de
carta, el estado actual de la carta, el número de repasos, el último repaso, el
estado de programación, el próximo repaso programado y el historial de repasos
de la carta seleccionada. El estado de carta combina en una sola línea marcas
visibles como suspendida, marcada, aplazada, inversa, tiene inversa y no
reversible. Las cartas inversas generadas muestran el ID de carta de la carta
principal, porque editar la carta principal en el mazo también cambia su
dirección inversa generada. Los campos de fecha del resumen, como último
repaso, último repaso de la programación y próximo repaso programado, se
muestran primero como una duración relativa completa, como `1 día, 1 hora, 1
minuto, 1 segundo`, seguida de la fecha y hora UTC exacta entre paréntesis. Las
fechas pasadas usan la misma duración relativa completa con la forma `hace
...`. La lista de historial de repasos del final usa solo fechas y horas UTC
exactas.

Usa `Archivo -> Panel de aprendizaje`, o pulsa `Ctrl+L`, para mostrar un
resumen de aprendizaje de todo el mazo. Informa de varios tipos de datos:

- recuentos de cartas por estado de programación: nuevas, en aprendizaje, en
  repaso y en reaprendizaje
- cartas disponibles ahora y cartas programadas y atrasadas, ignorando las
  cartas suspendidas y aplazadas
- estimaciones de recuerdo del modelo para cartas activas con datos de
  programación
- calibración de confianza, comparando tus predicciones antes de ver la
  respuesta con tus valoraciones posteriores del recuerdo
- ritmo de aprendizaje reciente, según cuántos repasos necesitaron las cartas
  antes de llegar por primera vez al estado de repaso
- actividad de repaso, incluyendo días con respuestas, respuestas almacenadas,
  respuestas en pasadas registradas y tiempo empleado en pasadas completadas

La sección de recuerdo es una estimación del modelo de programación de Cosimo,
no un resultado medido directamente. Para cada carta activa con datos de
programación que no esté suspendida ni aplazada, Cosimo usa la hora del último
repaso, la estabilidad almacenada y el intervalo programado real para estimar
la probabilidad de que recuerdes la carta ahora. Las cartas nuevas sin datos de
programación, las cartas suspendidas y las cartas aplazadas en ese momento no
se incluyen en esta estimación. Las cartas en aprendizaje y reaprendizaje usan
su intervalo corto programado como punto efectivo del 90%, de modo que una
carta pendiente tras un paso corto por fallo no parezca más segura de lo que
es.

`Disponibles ahora` cuenta las cartas activas no suspendidas ni aplazadas que
se pueden repasar inmediatamente. Esto incluye cartas nuevas y cartas
programadas cuya hora de repaso ya ha llegado. `Programadas y atrasadas` es el
recuento más estrecho de cartas programadas no suspendidas ni aplazadas cuya
hora de repaso ya está en el pasado, así
que no incluye cartas nuevas sin programación.

`Recuerdo medio estimado` es la media de esas estimaciones por carta. `Cartas
probablemente sabidas` cuenta las cartas estimadas con un recuerdo del 90% o
más. `Cartas en riesgo` cuenta las cartas estimadas por debajo del 70% de
recuerdo. Estos números son más útiles para orientar prioridades y observar
tendencias que como promesa de que se responderá correctamente exactamente ese
porcentaje de cartas en la próxima pasada.

La sección de calibración trata tu predicción antes de ver la respuesta como
un intervalo objetivo de si recordarás la respuesta, no como un porcentaje
preciso. `No lo sé` significa un objetivo de recuerdo del 0-5%,
`Probablemente no lo sé` del 5-32%, `Probablemente lo sé` del 68-95%, y `Lo sé
con seguridad` del 95-100%. El intervalo central queda deliberadamente sin
cubrir; revela sin valoración de confianza si no quieres hacer una predicción.
La regla de recuerdo se configura en `Archivo -> Opciones`. La regla flexible
cuenta `Difícil`, `Bien` y `Fácil` como recordadas, mientras que `Repetir`
cuenta como no recordada. La regla estricta solo cuenta `Bien` y `Fácil` como
recordadas. El panel muestra la regla activa antes de las cifras de
calibración. El intervalo de recuerdo objetivo es la media de los intervalos
objetivo para las valoraciones de confianza respondidas. La tasa de recuerdo
observada es lo que ocurrió realmente con la regla de recuerdo actual. La
calibración está dentro del intervalo si el recuerdo observado cae dentro del
intervalo objetivo, muestra falta de confianza si el recuerdo observado está
por encima del intervalo, y exceso de confianza si está por debajo. Las líneas
por confianza muestran la misma comparación para cada valoración de confianza.
Las cartas mostradas sin predicción se cuentan por separado.

La sección de actividad de repaso se basa en eventos de repaso registrados y
resúmenes de pasadas. `Respuestas almacenadas` cuenta respuestas individuales
almacenadas. `Días con respuestas` cuenta días UTC con al menos una respuesta
registrada. Los recuentos de pasadas, respuestas y tiempo etiquetados como
pasadas registradas vienen de resúmenes de pasadas completadas. Si hay datos
antiguos anteriores a los resúmenes de pasadas, el panel muestra `Respuestas
anteriores sin tiempo de pasada` para no confundir el total de respuestas
almacenadas con el total menor de pasadas con tiempo. Esa línea se oculta
cuando el valor es cero.

Usa el botón `Guardar informe` del panel para guardar el texto actual del panel
en el directorio `reports`. El nombre del informe usa el nombre del mazo y la
hora UTC en la que se abrió el panel, y el informe incluye las rutas completas
del mazo y de la base de datos de repaso.

Si el mazo tiene cartas inversas generadas, el panel muestra por separado
cartas estándar, cartas inversas y cartas totales, porque una dirección puede
ser mucho más fácil que la otra.

Usa `Ver -> Orden del mazo`, `Ver -> Próximo repaso programado` o
`Ver -> Último repaso`, `Ver -> Texto de pregunta`, `Ver -> Texto de
respuesta` o `Ver -> Recuerdo estimado` para elegir cómo se ordena la lista de
preguntas. Usa `Ver -> Ascendente` o `Ver -> Descendente` para elegir la
dirección. Las opciones marcadas del menú Ver muestran el criterio y la
dirección actuales. Último repaso usa descendente por defecto, poniendo primero
las cartas repasadas más recientemente y dejando las cartas nuevas al final;
último repaso ascendente pone primero las cartas repasadas hace más tiempo y
también deja las cartas nuevas al final. Recuerdo estimado usa la misma
estimación de programación que el panel de aprendizaje; recuerdo estimado
ascendente pone primero las cartas que se estiman menos probables de recordar y
deja al final las cartas sin estimación, como las nuevas. El filtro de texto
reduce la lista buscando en la pregunta o la respuesta. El cuadro combinado de
filtro controla qué tipo de cartas se muestran, incluidas cartas marcadas,
preguntas duplicadas, respuestas duplicadas, cartas no reversibles y cartas
aplazadas. Sus recuentos siguen el filtro de texto actual. El filtro de
respuestas duplicadas es especialmente útil antes de hacer cartas reversibles,
porque las respuestas duplicadas harían ambigua la pregunta inversa.

Usa `Cartas -> Suspender carta seleccionada`, el menú contextual de la lista de
preguntas, o `Ctrl+S` cuando la lista de preguntas tenga el foco, para conservar
la carta en el mazo pero impedir que aparezca en pasadas normales o forzadas.
La lista de preguntas marca las cartas suspendidas con `(suspendida)`. Las
cartas suspendidas pueden encontrarse con el filtro `Cartas suspendidas` y
reactivarse desde el mismo menú, menú contextual o atajo. Las cartas
suspendidas también se ignoran cuando la barra de estado indica si hay una
pasada pendiente ahora o cuándo será el próximo repaso.

Usa `Cartas -> Aplazar carta seleccionada hasta mañana`, o el menú contextual
de la lista de preguntas, para posponer temporalmente la carta seleccionada sin
cambiar su programación almacenada. Una carta aplazada permanece en el mazo y
vuelve automáticamente cuando vence el aplazamiento. Mientras está aplazada, se
marca con `(aplazada)`, aparece en el filtro `Cartas aplazadas`, y queda
excluida de pasadas programadas, pasadas forzadas, recuentos de la pantalla
inicial y cálculos de pendientes en la barra de estado. Usa `Cartas -> Quitar
aplazamiento de carta seleccionada`, o el menú contextual, para volver a
hacerla disponible inmediatamente.

Durante una pasada de repaso, antes de mostrar la respuesta, usa `Ctrl+D` o el
botón `Aplazar carta hasta mañana` para posponer la carta actual y continuar.
El aplazamiento no está disponible después de mostrar la respuesta. Si todas
las cartas de la pasada se aplazan antes de registrar ninguna respuesta, Cosimo
muestra un aviso indicando que no se repasó ninguna carta.

Usa `Cartas -> Marcar carta seleccionada`, el menú contextual de la lista de
preguntas, o `Ctrl+F` cuando la lista de preguntas tenga el foco para marcar o
desmarcar la carta seleccionada. Durante una pasada de repaso, `Ctrl+F` marca o
desmarca la carta actual. La pantalla de repaso también tiene un botón para
marcar o desmarcar después de los botones de confianza y después de los botones
de recuerdo. Las marcas sirven para revisión manual posterior: úsalas cuando
una carta pueda necesitar edición, resulte confusa o ambigua, tenga una
respuesta dudosa o requiera atención después de la pasada. Marcar una carta no
afecta a la programación ni a si la carta aparece en el repaso. Las cartas
marcadas aparecen con `(marcada)` en la lista de preguntas y pueden encontrarse
con el filtro `Cartas marcadas`.

Usa `Repasar marcadas` en la pantalla inicial, o
`Cartas -> Repasar cartas marcadas`, para iniciar una pasada no programada solo
con cartas marcadas. Esta pasada incluye cartas marcadas estén programadas o
no, pero excluye las cartas suspendidas o aplazadas. El orden es aleatorio, y
la pasada no quita las marcas; quita las marcas manualmente cuando esas cartas
ya no requieran revisión. El botón está desactivado cuando no hay cartas
marcadas disponibles para repasar.

Usa `Cartas -> Hacer carta seleccionada reversible`, o pulsa `Ctrl+R` cuando la
lista de preguntas tenga el foco, para añadir una carta inversa generada. Una
carta inversa pregunta por la respuesta original y espera la pregunta original.
Las cartas inversas tienen su propio estado de programación e historial de
repasos. Cosimo impide hacer reversible una carta cuando otra carta tiene la
misma respuesta, porque la pregunta inversa sería ambigua. Las cartas inversas
se marcan con `(inversa)` en la lista de preguntas y pueden encontrarse con el
filtro `Cartas inversas`. Eliminar una carta inversa elimina solo la dirección
inversa generada; no elimina la carta principal. Los datos de repaso de la
carta inversa permanecen en la base de datos y se vuelven a usar si haces
reversible de nuevo la carta principal. Cuando una carta inversa generada está
seleccionada, el menú de cartas y el menú contextual ofrecen eliminar esa
dirección inversa, no marcar la carta principal como no reversible.

Usa `Cartas -> Marcar carta seleccionada como no reversible` cuando una carta
no deba tener una dirección inversa generada. Esto escribe una marca en el
archivo del mazo, elimina cualquier carta inversa generada activa de esa carta
principal e impide que `Hacer cartas reversibles aptas` la vuelva a añadir más
adelante. Usa
`Cartas -> Permitir invertir la carta seleccionada` para quitar esa marca. La
carta vuelve a ser apta para inversión manual o en bloque, siempre que su
respuesta no esté duplicada. Las cartas no reversibles aparecen con
`(no reversible)` en la lista de preguntas, pueden encontrarse con el filtro
`Cartas no reversibles`, y muestran la marca no reversible en la línea de
estado de los detalles de la carta. Cuando una carta no reversible está
seleccionada, los menús ofrecen permitir invertirla de nuevo, no crear una carta
inversa directamente.

Usa `Cartas -> Hacer cartas reversibles aptas` para marcar como reversibles en
una sola operación todas las cartas que puedan serlo. Cosimo pide confirmación
e indica cuántas cartas pueden cambiarse. Se excluyen las cartas que ya son
reversibles, las cartas marcadas como no reversibles y las cartas cuyas
respuestas están duplicadas por otra carta. Si las copias de la base de datos
de repaso están activadas, esta operación actualiza la copia conservada antes
de escribir, y la confirmación avisa de que esa copia conservada se
sobrescribirá.

Usa `Cartas -> Deshacer última reversión en bloque` para eliminar solo las
cartas inversas creadas por la última reversión en bloque. Se conservan las
cartas inversas creadas manualmente y los lotes anteriores. Las cartas
originales y el historial de repaso inverso permanecen en la base de datos.

Eliminar una carta principal también elimina su carta inversa generada de la
lista de preguntas, porque la carta inversa se deriva de la carta principal. Los
datos de repaso inverso permanecen en la base de datos, pero solo vuelven a ser
útiles si restauras una copia de seguridad del mazo que contenga la carta
principal original.

Problema conocido: cuando entras en la lista de preguntas con tabulador o
mayúsculas+tabulador, algunas combinaciones de lector de pantalla y wxWidgets
anuncian dos veces el elemento seleccionado. Una vez dentro de la lista, la
navegación con las flechas debería funcionar normalmente.

## Comenzar una pasada

Hay tres formas principales de comenzar a repasar.

`Comenzar` usa la programación. Repasa primero las cartas pendientes. Si hay
menos cartas pendientes que el mínimo de cartas por sesión configurado, Cosimo
añade cartas adicionales al azar desde el resto del mazo.

`Forzar comienzo` ignora la programación. Pone todas las cartas no suspendidas
ni aplazadas en un orden aleatorio. Úsalo cuando quieras estudiar aunque no
haya cartas pendientes, o cuando quieras una sesión de práctica más larga.

`Comenzar examen` toma una muestra del mazo activo en vez de usar la
programación. Las cartas suspendidas y aplazadas se excluyen. Cosimo pregunta
si debe elegir un número de preguntas o un porcentaje de las cartas activas, y
después escoge y ordena esas cartas al azar para reducir las pistas producidas
por el orden del mazo.

Durante un examen, Cosimo muestra cada pregunta y te pide que escribas la
respuesta. No muestra la corrección mientras el examen está en curso. Las
respuestas exactas cuentan como correctas automáticamente. Al final, para cada
respuesta que no fue una coincidencia exacta, Cosimo muestra la pregunta, tu
respuesta y la respuesta esperada, y pregunta si la respuesta debe contar como
correcta.

Si la casilla `Exacto` está marcada al comenzar el examen, las respuestas no
exactas no se corrigen manualmente. Cuentan como incorrectas, y Cosimo muestra
cada una para revisión con la pregunta, tu respuesta y la respuesta esperada.
Elige `Siguiente` o pulsa `Alt-N` para seguir revisando respuestas inexactas, o
elige `Resumen` para ir directamente al resumen del examen.

El modo examen actualmente solo produce un informe. No registra eventos de
repaso, no cambia la programación de las cartas y no añade respuestas falladas
al final de la misma pasada. Esto es deliberado: la primera versión es una
herramienta de evaluación, no otra entrada para la programación.

Durante una pasada normal, pulsa `0` para terminarla antes de tiempo. Durante
una pasada de examen, elige `Terminar examen` para parar después de las
respuestas enviadas hasta ese momento. Si no se envió ninguna respuesta, Cosimo
muestra un aviso.

## Antes de ver la respuesta

Cuando se muestra una pregunta, puedes valorar qué probabilidad crees que
tienes de saber la respuesta:

- `1`: no la sé
- `2`: probablemente no la sé
- `3`: probablemente la sé
- `4`: seguro que la sé

Esta es tu predicción antes de ver la respuesta.

También puedes elegir `Mostrar respuesta`, o pulsar Espacio, para mostrar la
respuesta sin registrar una predicción. Esto se guarda como `Sin responder` en
las estadísticas de la pasada.

## Valorar después de ver la respuesta

Después de valorar tu predicción, o de mostrar directamente la respuesta,
Cosimo muestra la respuesta. Entonces valora lo que ha ocurrido realmente:

- `1`: De nuevo
- `2`: Difícil
- `3`: Bien
- `4`: Fácil

Esta valoración del recuerdo es lo que Cosimo usa de forma más directa para
programar la carta.

Si encuentras un error después de mostrar la respuesta, elige `Editar carta`,
usa `Cartas -> Editar carta actual`, o pulsa `e`. Cosimo abre el mismo editor
que se usa en el resto de la aplicación, guarda el texto de la carta y vuelve
al paso de valoración posterior a la respuesta. La decisión de programación se
toma solo cuando eliges la valoración del recuerdo.

## Audio de repaso

El audio de repaso es opcional y por ahora solo admite archivos WAV. Configúralo
en `Archivo -> Opciones -> Audio durante los repasos`:

- `Sin audio`: Cosimo ignora el audio de las cartas.
- `Manual`: si la pregunta o respuesta actual tiene audio, Cosimo lo indica y
  muestra un botón `Reproducir/detener audio`.
- `Automático`: Cosimo reproduce el audio de la pregunta cuando aparece una
  pregunta y el audio de la respuesta cuando aparece una respuesta durante el
  repaso ordinario. El mismo botón puede detener o volver a reproducir el audio
  actual.

`Ctrl+P` activa la misma acción de reproducir/detener cuando el audio de repaso
está disponible. Pasar a la carta siguiente, mostrar la respuesta, terminar la
pasada o cerrar la ventana detiene inmediatamente cualquier audio de carta que se
esté reproduciendo. En modo examen, el audio de la pregunta está disponible
mientras respondes la pregunta; el audio de la respuesta todavía no se usa
durante la corrección del examen.

Los archivos de audio viven en el directorio con el mismo nombre base junto al
mazo. Para la carta `1` de `Indonesian.cosimo-deck`, usa
`Indonesian/1.prompt.wav` para el lado de pregunta y
`Indonesian/1.response.wav` para el lado de respuesta. Las cartas inversas
generadas reutilizan los archivos de la carta principal con pregunta y respuesta
intercambiadas.

## Cómo funciona la programación

Cosimo guarda cada repaso completado en la base de datos de repasos. Para cada
carta, consulta el historial de repaso y estima cuándo debe volver la carta.

En general:

- las cartas sin historial de repaso están pendientes inmediatamente
- las cartas falladas o incorrectas vuelven antes
- las cartas correctas con dudas avanzan con más cautela que las cartas
  correctas fáciles
- las cartas correctas con seguridad esperan más tiempo

Cosimo usa un algoritmo de programación de estilo FSRS. Sigue la dificultad y
la estabilidad de cada carta. Las respuestas correctas repetidas hacen que la
carta sea más estable y alargan el intervalo, mientras que las respuestas
falladas o incorrectas devuelven la carta hacia el aprendizaje.
Las cartas marcadas como `Otra vez` se programan con un paso corto de
aprendizaje o reaprendizaje, tras unos 10 minutos. También aparecen una vez más
al final de la pasada actual. Cuando varias cartas necesitan repetirse, esas
repeticiones se ordenan al azar. Si la repetición se vuelve a marcar como `Otra
vez`, se registra con normalidad, pero no se añade otra vez a la misma pasada.

El intervalo exacto es automático. No necesitas gestionar fechas por tu cuenta.

El mínimo de cartas por sesión controla cuántas cartas intenta incluir Cosimo
cuando pulsas `Comenzar`. Por ejemplo:

- si el mínimo es `0`, Cosimo repasa solo las cartas pendientes
- si el mínimo es `10` y solo hay 6 cartas pendientes, Cosimo añade 4 cartas
  adicionales al azar
- si hay 20 cartas pendientes y el mínimo es `10`, Cosimo incluye las 20 cartas
  pendientes

El mínimo no es un máximo. Las cartas pendientes no se ocultan solo porque haya
más que el mínimo.

Cuando empieza una pasada, las cartas pendientes en aprendizaje y
reaprendizaje aparecen antes que las cartas normales de repaso. Después vienen
las cartas nuevas. Dentro de los grupos de aprendizaje/reaprendizaje y repaso,
aparecen primero las cartas que llevan más tiempo pendientes. Las cartas con la
misma fecha pendiente, o con fechas pendientes separadas por aproximadamente
una hora o menos, se ordenan al azar dentro de ese grupo. Las cartas nuevas
también se ordenan al azar, para que las cartas añadidas por grupos temáticos
no se repasen en el orden del mazo.

Configura el mínimo en `Archivo -> Opciones`.

## Estadísticas

Al final de una pasada, Cosimo muestra estadísticas de esa pasada:

- cuántas cartas únicas se han repasado, sin contar repeticiones
- cuántas preguntas se han respondido en total, incluidas las repeticiones
- tiempo total, tiempo por pregunta y tiempo por carta única
- recuentos y porcentajes de las valoraciones de predicción, incluidas las
  respuestas mostradas sin predicción
- recuentos y porcentajes de las valoraciones del recuerdo

Las cartas aplazadas antes de mostrar la respuesta no cuentan como preguntas
respondidas en las estadísticas de la pasada.

Las pasadas de examen muestran un resumen de examen separado. Indica el número
de preguntas seleccionadas, respuestas enviadas, respuestas correctas y
porcentaje, coincidencias exactas, respuestas no exactas aceptadas, respuestas
incorrectas, tiempo total, tiempo por pregunta, y si el examen terminó antes
de tiempo. Los resúmenes de examen no cambian la base de datos de repaso.

Elige `Guardar informe` para escribir una copia en texto de un resumen de
pasada normal o de examen en el directorio `reports` junto al ejecutable.
Cosimo crea el directorio si hace falta. Los nombres de informe normales usan
el nombre del archivo del mazo sin su extensión y la hora UTC en que terminó la
pasada; por ejemplo, `Indonesian-2026-05-03-06-04.txt`. Los informes de examen
añaden `-exam`, por ejemplo `Indonesian-exam-2026-05-03-06-04.txt`. Si ya
existe un informe con ese nombre, Cosimo añade un sufijo numérico en vez de
sobrescribirlo. El texto del informe incluye la ruta completa del mazo.

Elige `Continuar` para volver a la pantalla inicial.

## Idiomas y traducciones

Cosimo admite actualmente inglés, español y gallego. Cambia el idioma en
`Archivo -> Opciones`.

La elección de idioma se guarda y se usa la próxima vez. Si todavía no se ha
guardado ningún idioma, Cosimo usa español cuando la configuración regional del
sistema es española, gallego cuando es gallega y, en los demás casos, usa
inglés. Las configuraciones regionales desconocidas también usan inglés.

Las traducciones se mantienen en archivos `.po` de estilo gettext, con algunos
cambios pequeños en el código fuente para cada idioma nuevo. Si quieres trabajar
en una traducción, contacta primero con David Picón Álvarez en
`@modulux@node.isonomia.net` para coordinar el trabajo.

## Consejos

- Haz preguntas concretas. Una carta debe preguntar una sola cosa.
- Mantén las respuestas lo bastante cortas como para poder juzgarlas de forma
  constante.
- Usa `Forzar comienzo` para practicar más, no como sustituto de la pasada
  programada.
- Si una carta resulta confusa, edítala antes de la siguiente pasada. Si
  encuentras una errata o una respuesta incorrecta después de mostrar la carta,
  edítala antes de valorar el recuerdo.
- Usa `0` cuando quieras terminar una pasada antes de tiempo; los repasos
  completados se guardan igualmente.
