# 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.

## 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.