# Guía de usuario de Cosimo

Cosimo axúdache a estudar pares de pregunta e resposta con repetición
espazada. Está deseñado para usarse co teclado e con lectores de pantalla.

## Que significa repetición espazada

A repetición espazada é un método de estudo baseado en repasar o material con
intervalos cada vez maiores.

Cando algo é novo, difícil ou se fallou hai pouco, debe volver pronto. Cando
algo é fácil e se recorda de forma constante, pode esperar máis tempo. O
obxectivo é dedicar máis tempo ao material que necesita atención e menos tempo
a repetir o que xa está asentado.

En Cosimo, cada cousa que aprendes é unha carta:

- a pregunta é a cuestión, pista ou frase que ves primeiro
- a resposta é o que comprobas despois

Cosimo rexistra as túas valoracións despois de cada repaso e usa ese historial
para decidir que cartas están pendentes.

## Instalación e actualización

Cosimo é unha aplicación portable. Para instalalo, descomprime o ficheiro zip
da versión publicada no cartafol desde o que queiras executar Cosimo e despois
inicia `cosimo.exe` desde ese cartafol.

Para actualizar, pecha Cosimo, descomprime o novo zip sobre o cartafol
existente de Cosimo e permite que se sobrescriban os ficheiros do programa. Os
paquetes publicados non deberían sobrescribir datos de usuario como
`cosimo.ini`, mazos persoais, bases de datos de repaso, informes ou copias de
seguridade. Mantén copias de seguridade normais antes de actualizar, sobre
todo se gardas os teus propios mazos no cartafol da aplicación.

## Mazos

Un mazo é un ficheiro que contén cartas. Os ficheiros de mazo de Cosimo usan a
extensión `.cosimo-deck`.

Podes editar cartas dentro de Cosimo ou editar directamente o ficheiro do mazo
nun editor de texto. O ficheiro do mazo garda preguntas, respostas, metadatos
do mazo e marcas de cartas, como o estado non reversible. O historial de repaso
e as valoracións gárdanse por separado.

Os ficheiros de mazo tamén conteñen un pequeno marcador numerado ao final de
cada carta, como `=1=`. Deixa ese número no seu sitio cando edites á man.
Permite que Cosimo conserve o historial de repaso da carta aínda que cambies o
texto da pregunta ou da resposta.
Cando Cosimo abre un mazo antigo, garda unha copia de seguranza do orixinal
segundo a configuración de copias do mazo e actualiza o ficheiro ao formato
actual.

Usa `Arquivo -> Propiedades do mazo` para ver a versión do formato do mazo e os
campos de metadatos opcionais: título, autoría, descrición e URL. Usa
`Arquivo -> Editar metadatos do mazo` para editar eses campos de metadatos.

Cosimo pode usar un directorio co mesmo nome base xunto ao ficheiro do mazo para
audio de repaso opcional en formato WAV. Por exemplo,
`Indonesian.cosimo-deck` pode usar un directorio `Indonesian` con ficheiros como
`1.prompt.wav` e `1.response.wav`. Cosimo le eses ficheiros durante o repaso
ordinario, e le o audio da pregunta mentres respondes preguntas de exame, se o
audio está activado. Nesta primeira versión de audio non crea, edita nin copia
automaticamente ficheiros de audio.

O mazo predeterminado é `decks/deck.cosimo-deck`, xunto ao executable de
Cosimo. En instalacións portables de Windows, garda os teus mazos no cartafol
`decks` xunto á aplicación. Se falta o mazo predeterminado, Cosimo crea un
baleiro. Podes abrir outro mazo desde `Arquivo -> Abrir mazo`. Se escolles un
ficheiro de mazo que non existe, Cosimo pregunta se queres crear alí un mazo
baleiro.

Cando Cosimo se pecha, recorda o último mazo aberto e volve abrilo a próxima
vez. Tamén conserva ata oito mazos abertos recentemente en `Arquivo -> Mazos
recentes`, omitindo o mazo actual. Se só hai outro mazo recente, Cosimo móstrao
directamente no menú `Arquivo`, sen colocalo nun submenú. Garda isto e outras
opcións da aplicación en `cosimo.ini`, xunto ao executable. Cosimo tamén
recorda o filtro e o modo de ordenación da lista de cartas. Se Cosimo atopa
ficheiros antigos `cosimo-settings.txt` ou `cosimo-last-open-deck.txt`, mígraos
a `cosimo.ini` e elimina os ficheiros antigos.

O cadro de opcións tamén permite configurar avisos sonoros de dispoñibilidade
de repasos, audio de repaso, a regra de recordo usada pola calibración do panel
de aprendizaxe e a minimización á área de notificación. Os avisos sonoros poden
configurarse como
`Sempre`, `Cando Cosimo estea visible`, `Cando Cosimo estea na área de
notificación` ou `Nunca`. Cando a política escollida permite son, Cosimo
reproduce un son breve se a actualización automática da pantalla inicial
detecta que hai repasos dispoñibles, ou que hai máis repasos dispoñibles que na
última actualización automática. Os cambios feitos pola persoa usuaria, como
engadir ou eliminar cartas, e as actualizacións manuais con `F5` non reproducen
este son. Cosimo tamén permanece en silencio mentres hai unha pasada de repaso
activa, aínda que haxa máis cartas que pasen a estar dispoñibles durante esa
pasada. Coa minimización á área de notificación activada, a acción normal de
minimizar a xanela oculta Cosimo na área de notificación en vez de deixalo na
barra de tarefas. Activar a icona da área de notificación restaura a xanela, e
o menú contextual da icona contén Restaurar e Saír. Pechar Cosimo segue saíndo
da aplicación.

## Axuda e ligazóns do proxecto

O menú `Axuda` abre a guía de usuario local, a wiki do proxecto e a páxina de
tickets novos para informar de erros. Os informes de erro xestiónanse mediante
tickets de Fossil no sitio do proxecto.

## Copias de seguridade

Fai copia de seguridade tanto do ficheiro do mazo como da súa base de datos de
repasos correspondente. O ficheiro do mazo contén as túas cartas, metadatos do
mazo e marcas de cartas non reversibles. A base de datos de repasos contén a
programación, as valoracións e o historial de repaso.

Cosimo tamén crea copias automáticas do contido do mazo. Antes de sobrescribir
un mazo existente, copia a versión actual no directorio `backups` da
aplicación, xunto ao executable. Os ficheiros de copia usan números crecentes,
por exemplo `backups/000001-deck.cosimo-deck`. O ficheiro `backups/index.txt`
rexistra cada nome de copia e a ruta do mazo orixinal.

Configura as copias automáticas do mazo en `Arquivo -> Opcións`:

- `Completas`: conserva todas as copias automáticas do mazo.
- `Só a última`: conserva só a copia automática máis recente de cada ruta de
  mazo orixinal.
- `Ningunha`: non crea copias automáticas do mazo.

Configura as copias da base de datos de repasos en `Arquivo -> Opcións`:

- `Ao comezar a sesión`: actualiza unha copia retida da base de datos de
  repasos cando comeza unha pasada.
- `Desactivadas`: non crea nin actualiza copias da base de datos de repasos.

Usa `Arquivo -> Limpar base de datos de repaso` para eliminar de forma
permanente filas inactivas da base de datos de repaso correspondentes a cartas
que xa non están no mazo actual e a cartas inversas xeradas que están
inactivas. Consérvanse as cartas activas, as cartas inversas xeradas activas,
os calendarios actuais, as suspensións actuais e as marcas actuais de cartas
marcadas. As marcas de carta non reversible gárdanse no ficheiro do mazo, non
na base de datos de repaso. Se as copias da base de datos de repaso están
desactivadas, Cosimo avisa de que a limpeza é irreversible. Se as copias están
activadas, Cosimo actualiza a copia retida da base de datos de repaso antes de
limpar e avisa de que esa copia retida se sobrescribirá. Despois de eliminar as
filas inactivas, Cosimo executa unha limpeza da base de datos para que o
ficheiro SQLite poida recuperar espazo sen usar.

Usa `Arquivo -> Recuperar espazo da base de datos` para executar a mesma
limpeza SQLite sen eliminar datos de repaso inactivos. Isto reescribe o
ficheiro de base de datos de repaso e pode tardar un tempo nunha base de datos
grande. Se as copias da base de datos de repaso están activadas, Cosimo
non sobrescribe a copia retida con este comando; se as copias están
desactivadas, Cosimo recórdache que comprobes que tes unha copia se che
preocupa.

Para o mazo predeterminado, copia:

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

Para outro mazo, a base de datos de repasos está xunto ao mazo e usa o mesmo
nome base. Por exemplo, `galician.cosimo-deck` usa
`galician.reviews.sqlite3`.

Pecha Cosimo antes de copiar ou restaurar ficheiros de copia de seguridade.
Restaurar só o ficheiro `.cosimo-deck` recupera as cartas, pero déixaas sen o
seu historial de repaso anterior. Restaurar ambos ficheiros conserva as cartas
e o seu historial de programación.

Cosimo comproba a integridade da base de datos de repasos ao abrir un mazo. Se
Cosimo indica que esa comprobación fallou, pecha Cosimo e restaura o ficheiro
`.reviews.sqlite3` correspondente desde a túa copia de seguridade.

As copias automáticas do mazo conteñen só o texto do mazo, non o historial de
repaso. Para restaurar unha, pecha Cosimo e copia a copia escollida por riba do
ficheiro `.cosimo-deck` activo. Para restaurar o historial de programación,
restaura o ficheiro `.reviews.sqlite3` correspondente desde a túa propia copia
de seguridade ou desde a copia retida da base de datos de repasos de Cosimo.

Usa `Arquivo -> Opcións -> Eliminar copias antigas` para conservar só a copia
automática máis recente de cada ruta de mazo orixinal. Cosimo pide confirmación
antes de eliminar ou renumerar ficheiros de copia.

Para axuda paso a paso coa recuperación, consulta
[Troubleshooting](troubleshooting.md).

## Pantalla inicial

Cando Cosimo se inicia, ábrese na pantalla inicial. Esta pantalla mostra:

- cantas cartas hai no mazo
- cantas cartas están pendentes agora
- o mínimo de cartas por sesión
- o ficheiro da base de datos de repasos
- unha lista de preguntas das cartas

Se o mínimo de cartas por sesión fai que Cosimo engada cartas adicionais que
aínda non están pendentes, o reconto de cartas programadas tamén mostra entre
parénteses cantas están pendentes. Por exemplo, `Programadas agora: 10 (6
pendentes)` significa que a pasada incluiría 6 cartas pendentes e 4 cartas
adicionais para chegar ao mínimo.

A barra de estado da xanela principal tamén ofrece un resumo breve: cartas
totais, cartas pendentes agora, e se hai un repaso pendente agora ou canto
falta aproximadamente para o próximo repaso programado. As duracións
redondéanse cara arriba a unidades cómodas para voz sintetizada, como `2 días`,
`4 semanas` ou `3 meses`.

Mentres a pantalla inicial está aberta, Cosimo actualiza o resumo, os filtros
da lista e a barra de estado aproximadamente unha vez por minuto. Unha carta
que pase a estar pendente mentres a aplicación está aberta quedará dispoñible
para `Comezar` sen pechar e volver abrir o mazo.

Podes engadir, editar ou eliminar cartas antes de comezar unha pasada. Despois
de mostrar unha carta durante o repaso, tamén podes editar esa carta actual se
atopas un erro na pregunta ou na resposta. `Cartas -> Editar carta
seleccionada` cambia a `Cartas -> Editar carta actual` nese momento.

Para introducir varias cartas seguidas, usa `Cartas -> Engadir cartas en
bloque`. Escribe a pregunta e a resposta, e preme `Ctrl+Enter` desde calquera
dos dous campos para engadir a carta e volver ao campo de pregunta. Ao premer
Tab desde o campo de resposta tamén se engade a carta e vólvese ao campo de
pregunta cando ambos campos conteñen texto. Preme Escape para pechar o diálogo
de entrada en bloque.

Teclas útiles na pantalla inicial:

- `Alt-M`: comezar a pasada programada
- `Alt-F`: forzar o comezo con todas as cartas non suspendidas nin adiadas
- `Alt-X`: comezar unha pasada de exame cunha mostra aleatoria de cartas activas
- `Alt-L`: ir ao filtro de texto da lista de preguntas
- `F5`: actualizar o resumo inicial, os filtros da lista e a barra de estado
- `Ctrl+L`: mostrar o panel de aprendizaxe
- `Alt-S`: saír
- `Alt+Enter`: mostrar detalles e estatísticas da carta seleccionada
- `Delete`: eliminar a carta seleccionada da lista de preguntas
- `Ctrl+S`: suspender ou reactivar a carta seleccionada
- `Ctrl+F`: marcar ou desmarcar a carta seleccionada
- `Ctrl+D`: adiar a carta seleccionada ata mañá, ou quitar o seu adiamento
- `Ctrl+R`: facer reversible a carta seleccionada, ou eliminar a carta inversa
  xerada

O diálogo de detalles de carta mostra a pregunta, a resposta, o ID de carta, o
estado actual da carta, o número de repasos, o último repaso, o estado de
programación, o próximo repaso programado e o historial de repasos da carta
seleccionada. O estado de carta combina nunha soa liña marcas visibles como
suspendida, marcada, adiada, inversa, ten inversa e non reversible. As cartas
inversas xeradas mostran o ID de carta da carta principal, porque editar a
carta principal no mazo tamén cambia a súa dirección inversa xerada. Os campos
de data do resumo, como último repaso, último repaso da programación e próximo
repaso programado, móstranse primeiro como unha duración relativa completa,
como `1 día, 1 hora, 1 minuto, 1 segundo`, seguida da data e hora UTC exacta
entre parénteses. As datas pasadas usan a mesma duración relativa completa coa
forma `hai ...`. A lista de historial de repasos do final usa só datas e horas
UTC exactas.

Usa `Arquivo -> Panel de aprendizaxe`, ou preme `Ctrl+L`, para mostrar un
resumo de aprendizaxe de todo o mazo. Informa de varios tipos de datos:

- recontos de cartas por estado de programación: novas, en aprendizaxe, en
  repaso e en reaprendizaxe
- cartas dispoñibles agora e cartas programadas e atrasadas, ignorando as
  cartas suspendidas e adiadas
- estimacións de recordo do modelo para cartas activas con datos de
  programación
- calibración de confianza, comparando as túas predicións antes de ver a
  resposta coas túas valoracións posteriores do recordo
- ritmo de aprendizaxe recente, segundo cantos repasos necesitaron as cartas
  antes de chegar por primeira vez ao estado de repaso
- actividade de repaso, incluíndo días con respostas, respostas almacenadas,
  respostas en pasadas rexistradas e tempo empregado en pasadas completadas

A sección de recordo é unha estimación do modelo de programación de Cosimo, non
un resultado medido directamente. Para cada carta activa con datos de
programación que non estea suspendida nin adiada, Cosimo usa a hora do último
repaso, a estabilidade almacenada e o intervalo programado real para estimar a
probabilidade de que recordes a carta agora. As cartas novas sen datos de
programación, as cartas suspendidas e as cartas adiadas nese momento non se
inclúen nesta estimación. As cartas en aprendizaxe e reaprendizaxe usan o seu
intervalo curto programado como punto efectivo do 90%, de modo que unha carta
pendente tras un paso curto por fallo non pareza máis segura do que é.

`Dispoñibles agora` conta as cartas activas non suspendidas nin adiadas que se
poden repasar inmediatamente. Isto inclúe cartas novas e cartas programadas
cuxa hora de repaso xa chegou. `Programadas e atrasadas` é o reconto máis
estreito de cartas programadas non suspendidas nin adiadas cuxa hora de repaso
xa está no pasado, así que non inclúe cartas novas sen programación.

`Recordo medio estimado` é a media desas estimacións por carta. `Cartas
probablemente sabidas` conta as cartas estimadas cun recordo do 90% ou máis.
`Cartas en risco` conta as cartas estimadas por baixo do 70% de recordo. Estes
números son máis útiles para orientar prioridades e observar tendencias que
como promesa de que se responderá correctamente exactamente esa porcentaxe de
cartas na próxima pasada.

A sección de calibración trata a túa predición antes de ver a resposta como
un intervalo obxectivo de se recordarás a resposta, non como unha porcentaxe
precisa. `Non o sei` significa un obxectivo de recordo do 0-5%,
`Probablemente non o sei` do 5-32%, `Probablemente o sei` do 68-95%, e `Seino
con seguridade` do 95-100%. O intervalo central queda deliberadamente sen
cubrir; revela sen valoración de confianza se non queres facer unha predición.
A regra de recordo configúrase en `Arquivo -> Opcións`. A regra laxa conta
`Difícil`, `Ben` e `Fácil` como recordadas, mentres que `Repetir` conta como
non recordada. A regra estrita só conta `Ben` e `Fácil` como recordadas. O
panel mostra a regra activa antes das cifras de calibración. O intervalo de
recordo obxectivo é a media dos intervalos obxectivo para as valoracións de
confianza respondidas. A taxa de recordo observada é o que ocorreu realmente
coa regra de recordo actual. A calibración está dentro do intervalo se o
recordo observado cae dentro do intervalo obxectivo, mostra falta de confianza
se o recordo observado está por enriba do intervalo, e exceso de confianza se
está por baixo. As liñas por confianza mostran a mesma comparación para cada
valoración de confianza. As cartas mostradas sen predición cóntanse por
separado.

A sección de actividade de repaso baséase en eventos de repaso rexistrados e
resumos de pasadas. `Respostas almacenadas` conta respostas individuais
almacenadas. `Días con respostas` conta días UTC con polo menos unha resposta
rexistrada. Os recontos de pasadas, respostas e tempo etiquetados como pasadas
rexistradas veñen de resumos de pasadas completadas. Se hai datos antigos
anteriores aos resumos de pasadas, o panel mostra `Respostas anteriores sen
tempo de pasada` para non confundir o total de respostas almacenadas co total
menor de pasadas con tempo. Esa liña ocúltase cando o valor é cero.

Usa o botón `Gardar informe` do panel para gardar o texto actual do panel no
directorio `reports`. O nome do informe usa o nome do mazo e a hora UTC na que
se abriu o panel, e o informe inclúe as rutas completas do mazo e da base de
datos de repaso.

Se o mazo ten cartas inversas xeradas, o panel mostra por separado cartas
estándar, cartas inversas e cartas totais, porque unha dirección pode ser
moito máis fácil que a outra.

Usa `Ver -> Orde do mazo`, `Ver -> Próximo repaso programado` ou
`Ver -> Último repaso`, `Ver -> Texto da pregunta`, `Ver -> Texto da resposta`
ou `Ver -> Recordo estimado` para escoller como se ordena a lista de preguntas.
Usa `Ver -> Ascendente` ou `Ver -> Descendente` para escoller a dirección. As
opcións marcadas do menú Ver mostran o criterio e a dirección actuais. Último
repaso usa descendente por defecto, poñendo primeiro as cartas repasadas máis
recentemente e deixando as cartas novas ao final; último repaso ascendente pon
primeiro as cartas repasadas hai máis tempo e tamén deixa as cartas novas ao
final. Recordo estimado usa a mesma estimación de programación que o panel de
aprendizaxe; recordo estimado ascendente pon primeiro as cartas que se estiman
menos probables de lembrar e deixa ao final as cartas sen estimación, como as
novas. O filtro de texto reduce a lista buscando na pregunta ou na resposta. O
cadro combinado de filtro controla que tipo de cartas se mostran, incluídas
cartas marcadas, preguntas duplicadas, respostas duplicadas, cartas non
reversibles e cartas adiadas. Os seus recontos seguen o filtro de texto actual.
O filtro de respostas duplicadas é especialmente útil antes de facer cartas
reversibles, porque as respostas duplicadas farían ambigua a pregunta inversa.

Usa `Cartas -> Suspender carta seleccionada`, o menú contextual da lista de
preguntas, ou `Ctrl+S` cando a lista de preguntas teña o foco, para conservar a
carta no mazo pero impedir que apareza en pasadas normais ou forzadas. A lista
de preguntas marca as cartas suspendidas con `(suspendida)`. As cartas
suspendidas poden atoparse co filtro `Cartas suspendidas` e reactivarse desde o
mesmo menú, menú contextual ou atallo. As cartas suspendidas tamén se ignoran
cando a barra de estado indica se hai unha pasada pendente agora ou cando será
o próximo repaso.

Usa `Cartas -> Adiar carta seleccionada ata mañá`, ou o menú contextual da
lista de preguntas, para pospoñer temporalmente a carta seleccionada sen
cambiar a súa programación almacenada. Unha carta adiada permanece no mazo e
volve automaticamente cando vence o adiamento. Mentres está adiada, márcase con
`(adiada)`, aparece no filtro `Cartas adiadas`, e queda excluída de pasadas
programadas, pasadas forzadas, recontos da pantalla inicial e cálculos de
pendentes na barra de estado. Usa `Cartas -> Quitar adiamento da carta
seleccionada`, ou o menú contextual, para facela dispoñible de novo
inmediatamente.

Durante unha pasada de repaso, antes de mostrar a resposta, usa `Ctrl+D` ou o
botón `Adiar carta ata mañá` para pospoñer a carta actual e continuar. O
adiamento non está dispoñible despois de mostrar a resposta. Se todas as cartas
da pasada se adían antes de rexistrar ningunha resposta, Cosimo mostra un aviso
indicando que non se repasou ningunha carta.

Usa `Cartas -> Marcar carta seleccionada`, o menú contextual da lista de
preguntas, ou `Ctrl+F` cando a lista de preguntas teña o foco para marcar ou
desmarcar a carta seleccionada. Durante unha pasada de repaso, `Ctrl+F` marca
ou desmarca a carta actual. A pantalla de repaso tamén ten un botón para marcar
ou desmarcar despois dos botóns de confianza e despois dos botóns de recordo.
As marcas serven para revisión manual posterior: úsaas cando unha carta poida
necesitar edición, resulte confusa ou ambigua, teña unha resposta dubidosa ou
requira atención despois da pasada. Marcar unha carta non afecta á programación
nin a se a carta aparece no repaso. As cartas marcadas aparecen con `(marcada)`
na lista de preguntas e poden atoparse co filtro `Cartas marcadas`.

Usa `Repasar marcadas` na pantalla inicial, ou
`Cartas -> Repasar cartas marcadas`, para iniciar unha pasada non programada só
con cartas marcadas. Esta pasada inclúe cartas marcadas estean programadas ou
non, pero exclúe as cartas suspendidas ou adiadas. A orde é aleatoria, e a
pasada non quita as marcas; quita as marcas manualmente cando esas cartas xa
non requiran revisión. O botón está desactivado cando non hai cartas marcadas
dispoñibles para repasar.

Usa `Cartas -> Facer carta seleccionada reversible`, ou preme `Ctrl+R` cando a
lista de preguntas teña o foco, para engadir unha carta inversa xerada. Unha
carta inversa pregunta pola resposta orixinal e espera a pregunta orixinal. As
cartas inversas teñen o seu propio estado de programación e historial de
repasos. Cosimo impide facer reversible unha carta cando outra carta ten a
mesma resposta, porque a pregunta inversa sería ambigua. As cartas inversas
márcanse con `(inversa)` na lista de preguntas e poden atoparse co filtro
`Cartas inversas`. Eliminar unha carta inversa elimina só a dirección inversa
xerada; non elimina a carta principal. Os datos de repaso da carta inversa
permanecen na base de datos e volven usarse se fas reversible de novo a carta
principal. Cando unha carta inversa xerada está seleccionada, o menú de cartas
e o menú contextual ofrecen eliminar esa dirección inversa, non marcar a carta
principal como non reversible.

Usa `Cartas -> Marcar carta seleccionada como non reversible` cando unha carta
non deba ter unha dirección inversa xerada. Isto escribe unha marca no ficheiro
do mazo, elimina calquera carta inversa xerada activa desa carta principal e
impide que `Facer cartas reversibles aptas` a volva engadir máis adiante. Usa
`Cartas -> Permitir inverter a carta seleccionada` para quitar esa marca. A
carta volve ser apta para inversión manual ou en bloque, sempre que a súa
resposta non estea duplicada. As cartas non reversibles aparecen con
`(non reversible)` na lista de preguntas, poden atoparse co filtro `Cartas non
reversibles`, e mostran a marca non reversible na liña de estado dos detalles
da carta. Cando unha carta non reversible está seleccionada, os menús ofrecen
permitir inverter de novo esa carta, non crear unha carta inversa directamente.

Usa `Cartas -> Facer cartas reversibles aptas` para marcar como reversibles
nunha soa operación todas as cartas que poidan selo. Cosimo pide confirmación e
indica cantas cartas poden cambiarse. Exclúense as cartas que xa son
reversibles, as cartas marcadas como non reversibles e as cartas cuxas
respostas están duplicadas por outra carta. Se as copias da base de datos de
repaso están activadas, esta operación actualiza a copia conservada antes de
escribir, e a confirmación avisa de que esa copia conservada se sobrescribirá.

Usa `Cartas -> Desfacer última reversión en bloque` para eliminar só as cartas
inversas creadas pola última reversión en bloque. Consérvanse as cartas
inversas creadas manualmente e os lotes anteriores. As cartas orixinais e o
historial de repaso inverso permanecen na base de datos.

Eliminar unha carta principal tamén elimina a súa carta inversa xerada da lista
de preguntas, porque a carta inversa deriva da carta principal. Os datos de
repaso inverso permanecen na base de datos, pero só volven ser útiles se
restauras unha copia de seguranza do mazo que conteña a carta principal
orixinal.

Problema coñecido: cando entras na lista de preguntas co tabulador ou con
maiúsculas+tabulador, algunhas combinacións de lector de pantalla e wxWidgets
anuncian dúas veces o elemento seleccionado. Unha vez dentro da lista, a
navegación coas frechas debería funcionar normalmente.

## Comezar unha pasada

Hai tres formas principais de comezar a repasar.

`Comezar` usa a programación. Repasa primeiro as cartas pendentes. Se hai menos
cartas pendentes que o mínimo de cartas por sesión configurado, Cosimo engade
cartas adicionais ao azar desde o resto do mazo.

`Forzar comezo` ignora a programación. Pon todas as cartas non suspendidas nin
adiadas nunha orde aleatoria. Úsao cando queiras estudar aínda que non haxa
cartas pendentes, ou cando queiras unha sesión de práctica máis longa.

`Comezar exame` toma unha mostra do mazo activo en vez de usar a programación.
As cartas suspendidas e adiadas exclúense. Cosimo pregunta se debe escoller un
número de preguntas ou unha porcentaxe das cartas activas, e despois escolle e
ordena esas cartas ao azar para reducir as pistas producidas pola orde do mazo.

Durante un exame, Cosimo mostra cada pregunta e pídeche que escribas a
resposta. Non mostra a corrección mentres o exame está en curso. As respostas
exactas contan como correctas automaticamente. Ao final, para cada resposta que
non foi unha coincidencia exacta, Cosimo mostra a pregunta, a túa resposta e a
resposta esperada, e pregunta se a resposta debe contar como correcta.

Se a caixa `Exacto` está marcada ao comezar o exame, as respostas non exactas
non se corrixen manualmente. Contan como incorrectas, e Cosimo mostra cada unha
para revisión coa pregunta, a túa resposta e a resposta esperada. Escolle
`Seguinte` ou preme `Alt-N` para seguir revisando respostas inexactas, ou
escolle `Resumo` para ir directamente ao resumo do exame.

O modo exame actualmente só produce un informe. Non rexistra eventos de repaso,
non cambia a programación das cartas e non engade respostas falladas ao final
da mesma pasada. Isto é deliberado: a primeira versión é unha ferramenta de
avaliación, non outra entrada para a programación.

Durante unha pasada normal, preme `0` para rematala antes de tempo. Durante
unha pasada de exame, escolle `Rematar exame` para parar despois das respostas
enviadas ata ese momento. Se non se enviou ningunha resposta, Cosimo mostra un
aviso.

## Antes de ver a resposta

Cando se mostra unha pregunta, podes valorar que probabilidade cres que tes de
saber a resposta:

- `1`: non a sei
- `2`: probablemente non a sei
- `3`: probablemente a sei
- `4`: seguro que a sei

Esta é a túa predición antes de ver a resposta.

Tamén podes escoller `Mostrar resposta`, ou premer Espazo, para mostrar a
resposta sen rexistrar unha predición. Isto gárdase como `Sen responder` nas
estatísticas da pasada.

## Valorar despois de ver a resposta

Despois de valorar a túa predición, ou de mostrar directamente a resposta,
Cosimo mostra a resposta. Entón valora o que ocorreu realmente:

- `1`: Repetir
- `2`: Difícil
- `3`: Ben
- `4`: Fácil

Esta valoración do recordo é o que Cosimo usa de forma máis directa para
programar a carta.

Se atopas un erro despois de mostrar a resposta, escolle `Editar carta`, usa
`Cartas -> Editar carta actual`, ou preme `e`. Cosimo abre o mesmo editor que
se usa no resto da aplicación, garda o texto da carta e volve ao paso de
valoración posterior á resposta. A decisión de programación tómase só cando
escollas a valoración do recordo.

## Audio de repaso

O audio de repaso é opcional e polo momento só admite ficheiros WAV. Configúrao
en `Arquivo -> Opcións -> Audio durante os repasos`:

- `Sen audio`: Cosimo ignora o audio das cartas.
- `Manual`: se a pregunta ou resposta actual ten audio, Cosimo indícao e mostra
  un botón `Reproducir/deter audio`.
- `Automático`: Cosimo reproduce o audio da pregunta cando aparece unha pregunta
  e o audio da resposta cando aparece unha resposta durante o repaso ordinario.
  O mesmo botón pode deter ou volver reproducir o audio actual.

`Ctrl+P` activa a mesma acción de reproducir/deter cando o audio de repaso está
dispoñible. Pasar á carta seguinte, mostrar a resposta, rematar a pasada ou
pechar a xanela detén inmediatamente calquera audio de carta que se estea
reproducindo. En modo exame, o audio da pregunta está dispoñible mentres
respondes a pregunta; o audio da resposta aínda non se usa durante a corrección
do exame.

Os ficheiros de audio viven no directorio co mesmo nome base xunto ao mazo. Para
a carta `1` de `Indonesian.cosimo-deck`, usa `Indonesian/1.prompt.wav` para o
lado de pregunta e `Indonesian/1.response.wav` para o lado de resposta. As
cartas inversas xeradas reutilizan os ficheiros da carta principal con pregunta
e resposta intercambiadas.

## Como funciona a programación

Cosimo garda cada repaso completado na base de datos de repasos. Para cada
carta, consulta o historial de repaso e estima cando debe volver a carta.

En xeral:

- as cartas sen historial de repaso están pendentes inmediatamente
- as cartas falladas ou incorrectas volven antes
- as cartas correctas con dúbidas avanzan con máis cautela que as cartas
  correctas fáciles
- as cartas correctas con seguridade esperan máis tempo

Cosimo usa un algoritmo de programación de estilo FSRS. Segue a dificultade e a
estabilidade de cada carta. As respostas correctas repetidas fan que a carta
sexa máis estable e alongan o intervalo, mentres que as respostas falladas ou
incorrectas devolven a carta cara á aprendizaxe. As cartas marcadas como
`Repetir` prográmanse cun paso curto de aprendizaxe ou reaprendizaxe, tras uns
10 minutos. Tamén aparecen unha vez máis ao final da pasada actual. Cando
varias cartas necesitan repetirse, esas repeticións ordénanse ao azar. Se a
repetición se volve marcar como `Repetir`, rexístrase con normalidade, pero non
se engade outra vez á mesma pasada.

O intervalo exacto é automático. Non necesitas xestionar datas pola túa conta.

O mínimo de cartas por sesión controla cantas cartas intenta incluír Cosimo
cando premes `Comezar`. Por exemplo:

- se o mínimo é `0`, Cosimo repasa só as cartas pendentes
- se o mínimo é `10` e só hai 6 cartas pendentes, Cosimo engade 4 cartas
  adicionais ao azar
- se hai 20 cartas pendentes e o mínimo é `10`, Cosimo inclúe as 20 cartas
  pendentes

O mínimo non é un máximo. As cartas pendentes non se ocultan só porque haxa
máis que o mínimo.

Cando empeza unha pasada, as cartas pendentes en aprendizaxe e reaprendizaxe
aparecen antes que as cartas normais de repaso. Despois veñen as cartas novas.
Dentro dos grupos de aprendizaxe/reaprendizaxe e repaso, aparecen primeiro as
cartas que levan máis tempo pendentes. As cartas coa mesma data pendente, ou
con datas pendentes separadas por aproximadamente unha hora ou menos,
ordénanse ao azar dentro dese grupo. As cartas novas tamén se ordenan ao azar,
para que as cartas engadidas por grupos temáticos non se repasen na orde do
mazo.

Configura o mínimo en `Arquivo -> Opcións`.

## Estatísticas

Ao final dunha pasada, Cosimo mostra estatísticas desa pasada:

- cantas cartas únicas se repasaron, sen contar repeticións
- cantas preguntas se responderon en total, incluídas as repeticións
- tempo total, tempo por pregunta e tempo por carta única
- recontos e porcentaxes das valoracións de predición, incluídas as respostas
  mostradas sen predición
- recontos e porcentaxes das valoracións do recordo

As cartas adiadas antes de mostrar a resposta non contan como preguntas
respondidas nas estatísticas da pasada.

As pasadas de exame mostran un resumo de exame separado. Indica o número de
preguntas seleccionadas, respostas enviadas, respostas correctas e porcentaxe,
coincidencias exactas, respostas non exactas aceptadas, respostas incorrectas,
tempo total, tempo por pregunta, e se o exame rematou antes de tempo. Os
resumos de exame non cambian a base de datos de repaso.

Escolle `Gardar informe` para escribir unha copia en texto dun resumo de
pasada normal ou de exame no directorio `reports` xunto ao executable. Cosimo
crea o directorio se fai falta. Os nomes de informe normais usan o nome do
ficheiro do mazo sen a súa extensión e a hora UTC en que rematou a pasada; por
exemplo, `Indonesian-2026-05-03-06-04.txt`. Os informes de exame engaden
`-exam`, por exemplo `Indonesian-exam-2026-05-03-06-04.txt`. Se xa existe un
informe con ese nome, Cosimo engade un sufixo numérico en vez de sobrescribilo.
O texto do informe inclúe a ruta completa do mazo.

Escolle `Continuar` para volver á pantalla inicial.

## Idiomas e traducións

Cosimo admite actualmente inglés, español e galego. Cambia o idioma en
`Arquivo -> Opcións`.

A elección de idioma gárdase e úsase a próxima vez. Se aínda non se gardou
ningún idioma, Cosimo usa español cando a configuración rexional do sistema é
española, galego cando é galega e, nos demais casos, usa inglés. As
configuracións rexionais descoñecidas tamén usan inglés.

As traducións mantéñense en ficheiros `.po` de estilo gettext, con algúns
cambios pequenos no código fonte para cada idioma novo. Se queres traballar
nunha tradución, contacta primeiro con David Picón Álvarez en
`@modulux@node.isonomia.net` para coordinar o traballo.

## Consellos

- Fai preguntas concretas. Unha carta debe preguntar unha soa cousa.
- Mantén as respostas o bastante curtas como para poder xulgalas de forma
  constante.
- Usa `Forzar comezo` para practicar máis, non como substituto da pasada
  programada.
- Se unha carta resulta confusa, edítaa antes da seguinte pasada. Se atopas
  unha errata ou unha resposta incorrecta despois de mostrar a carta, edítaa
  antes de valorar o recordo.
- Usa `0` cando queiras rematar unha pasada antes de tempo; os repasos
  completados gárdanse igualmente.
