apkg2forms

Convierte un mazo de Anki (.apkg) o un PDF de test en un script de Google Apps Script que crea Formularios de Google en modo test (con respuestas correctas y 1 punto por pregunta). Sin IA, sin APIs, solo Python estándar.

Uso

python apkg2forms.py            # interfaz gráfica (macOS, Windows, Linux)
python apkg2forms.py mazo.apkg  # línea de comandos -> mazo.gs

1. Abre el .apkg, elige los mazos y pulsa Copiar script (al portapapeles, listo para pegar) o Guardar script… (archivo .gs, informe .csv e imágenes).
2. En https://script.google.com crea un proyecto, pega el .gs, elige crearFormularios y pulsa Ejecutar.
3. Los enlaces salen en el registro. Si quedan formularios, ejecútala otra vez.

Requisitos

• Python 3.9+ con tkinter (Windows/macOS de python.org ya lo traen; Homebrew: brew install python-tk; Debian/Ubuntu: sudo apt install python3-tk).
• .apkg nuevos (zstd): Python 3.14+ o pip install zstandard; si no, exporta en Anki con "Compatible con versiones antiguas".

PDF de test

El tipo de archivo se detecta solo (.apkg o PDF). En un PDF se buscan preguntas numeradas (1., 2.…) con opciones A., B., C.… (acentos de LaTeX y líneas partidas se arreglan). Las imágenes se asignan a la pregunta que las lleva.

• Un PDF no trae la clave de respuestas. Escríbela en el campo "Respuestas" (CABD… en orden, o 1C 2A 3B…; - o X si una pregunta no tiene respuesta). Sin clave el formulario se crea sin puntuación.
• No se copian las tablas como tabla (salen como texto en el enunciado), ni se aplica la penalización por fallo: Forms solo suma puntos.
• Solo PDF con texto (no escaneados). Hace falta pip install pypdf pillow (ya incluidos en los ejecutables).

Qué convierte

• Tarjetas tipo test (opciones A./a) en el texto): la correcta se detecta por Respuesta: C, c), opción en negrita o reverso con la opción.
• Normales y cloze: respuesta correcta + opciones falsas tomadas de otras tarjetas del mismo mazo.
• Se omiten (y se cuentan en el resumen) las tarjetas sin respuesta detectable o con respuesta larga. Las imágenes no se copian.

python test_apkg2forms.py comprueba el parser.

Lanzar con doble clic

Lanzar-macOS.command, Lanzar-Windows.bat o Lanzar-Linux.sh (en Linux, si el gestor de archivos no los ejecuta: chmod +x Lanzar-Linux.sh). En macOS la primera vez: clic derecho > Abrir.

Informe y extras

• Junto al .gs se crea *.revisar.csv con las tarjetas omitidas y las que tenían imagen.
• Las preguntas con imagen salen en el formulario con [IMAGEN] delante, y sus imágenes se copian a *-imagenes/ con el nombre formulario - pregunta N (el CSV dice cuál es cuál), para añadirlas a mano.
• Si la tarjeta trae explicación, se muestra como feedback en el formulario.

Ejecutable sin Python

• ./build.sh genera dist/apkg2forms.app (macOS) o dist/apkg2forms (Linux). Hay que ejecutarlo en cada sistema.
• Descarga lista (sin Python): en Releases del repo, apkg2forms-windows.exe, apkg2forms-macos.zip o apkg2forms-linux (en Linux: chmod +x apkg2forms-linux).
• Para publicar una versión nueva: git tag v1.1.0 && git push origin v1.1.0; GitHub Actions compila los tres y los adjunta.
• Windows avisa de "Windows protegió su PC": Más información > Ejecutar de todas formas. En macOS el .app no está firmado: clic derecho > Abrir.

Licencia

Software libre bajo licencia MIT: úsalo, cópialo, modifícalo y distribúyelo como quieras, siempre que conserves el aviso de copyright (la mención al autor original).