Crear mazos y tarjetas

1. Antes de empezar

Qué es un mazo

Un mazo es una colección con nombre de tarjetas. Cada tarjeta tiene un Título (etiqueta en la lista, se lee primero) y Contenido (cuerpo principal; admite Markdown). Deck Reader prepara audio de voz (M4A) para que puedas estudiar sin usar las manos — como una lista de reproducción de temas.

Free vs Plus (límites de autoría)

La importación está disponible en Free dentro de esos límites.

Modo Bonito vs etiquetas

En el editor de tarjetas, el ícono de markdown alterna entre Bonito (vista previa con formato; imágenes como fichas [Alt: filename]) y etiquetas visibles (código fuente sin procesar). Activa etiquetas visibles al editar regiones [caption] — Bonito las oculta por completo.

2. Cómo crear un mazo

1. Abre la Biblioteca de mazos (pantalla de inicio).
2. Toca + (crear) en la barra inferior.
3. Ingresa un nombre de mazo → confirma.
4. Toca el mazo nuevo para abrir la lista de tarjetas.

Opcional más adelante: renombrar en modo de edición de la biblioteca; activar Generación automática en la lista de tarjetas para que el audio faltante se prepare al abrir el mazo o guardar tarjetas; usar Importar de la biblioteca para .deckreader.csv o paquetes ZIP; explorar el catálogo con Descargar mazos.

Usa un nombre claro y único (la importación coincide por nombre). Al publicar actualizaciones, incrementa la Versión del mazo (MAJOR.MINOR.PATCH) para que los lectores existentes puedan elegir Actualizar.

3. Cómo crear una tarjeta simple

Objetivo: solo texto plano — no se requiere Markdown.

1. Abre un mazo → lista de tarjetas.
2. Toca + para Agregar tema (o abre una tarjeta → Editar).
3. Completa Título (obligatorio para guardar).
4. Completa Contenido con párrafos normales. Separa ideas con una línea en blanco.
5. Toca Guardar.

Title: Photosynthesis

Content:
Plants convert light into chemical energy.

They use carbon dioxide and water.
Oxygen is released as a by-product.

Opcional: configura idioma/voz en las fichas del micrófono; usa Generación automática del mazo o el ↺ de la lista para preparar la voz. En Free, Contenido se detiene en 150 caracteres al editar.

4. Cómo crear tarjetas con formato (Markdown)

Deck Reader almacena Markdown en Título y Contenido. Los delimitadores deben tocar el texto (**bold**, no ** bold **). Usa la barra inferior (Texto, Párrafo, Insertar, Tablas, Ω) o escribe el marcado con etiquetas visibles.

4.1 Formato de texto

Colores: Black, Gray, Brown, Blue, Cyan, Green, Purple, Red, Pink, Orange, Yellow, White. Siempre cierra con [/]. La voz lee solo las palabras internas.

Encabezados: de uno a ocho # al inicio de una línea, luego un espacio (H1–H6, luego B1 / B2 por debajo del tamaño del cuerpo).

4.2 Párrafos y estructura

Las citas de varios párrafos mantienen > en las líneas en blanco entre párrafos. Una línea en blanco sin > termina la cita.

> First paragraph.
>
> Second paragraph.

4.3 Insertar elementos

Enlaces

• Enlace → [label](https://example.com)
• Enlace rápido → URL como etiqueta y destino
• Enlace en la misma tarjeta → [label](#heading-anchor) desde un encabezado en la misma tarjeta

Correo

• Correo → <name@example.com>
• Correo rápido → dirección sin formato

Imágenes

1. Insertar → Imagen.
2. Elige un archivo o reutiliza una imagen de la biblioteca del mazo.
3. Tamaño opcional en dp: {w:240}, {h:200}, o ambos; claves de borde opcionales.

![Sales chart](deckimg:a1b2c3d4e5f67890_chart.png){w:240}

• Varias imágenes en la misma línea se muestran lado a lado; las imágenes funcionan en celdas de tabla.
• Dentro de bloques de código o código en línea, la sintaxis de imagen permanece literal (no se dibuja como mapa de bits).
• Los archivos faltantes muestran una advertencia roja con el código markdown completo en el reproductor.
• Voz: palabra de imagen localizada + alt, luego [caption] opcional.

Símbolos (Ω)

Matemáticas, símbolos y caracteres de dibujo de cajas. En tabletas, la caja de herramientas lateral inserta los mismos glifos rápidamente.

4.4 Tablas

Usa el menú Tablas (Plus) o escribe una cuadrícula estilo GFM:

| Term | Meaning |
| :--- | :--- |
| ATP | Energy currency |
| Chlorophyll | Light-absorbing pigment |

• Alineación de columnas: :--- / :---: / ---:; dígitos de ancho % opcionales en los guiones.
• Fila de estilo opcional antes del encabezado: |{w:200; t:1; b:1}| (ancho en caracteres).
• Continuar una celda: termina con ^^ y continúa en la fila siguiente.
• [br] inicia un párrafo visual en una celda (la voz une con un espacio).
• El w: de tabla es en caracteres; el {w:} de imagen es en dp — no mezcles las unidades.

4.5 Etiquetas especiales de voz de Deck Reader

Desde el menú Párrafo:

• Omitir — omite una sección pero avisa al oyente que algo se omitió.
• Silenciar — notas del profesor o spoilers solo en pantalla; audio continuo.
• Subtítulo — describe un gráfico o imagen en la voz sin saturar la tarjeta.

![Trend](deckimg:trend-chart.png){w:280}
[caption]The line climbs steadily from left to right.[/caption]

[GREEN]Pass[/] criteria met. [skip](see appendix)[/skip] Next topic.
[mute]Teacher note: discuss edge cases here.[/mute] Continue with examples.

No confundas el texto alt de la imagen, la ficha de imagen en modo Bonito y [caption] — alt es la etiqueta corta en la tarjeta/voz; caption es la descripción más larga solo para audio.

5. Voz, voces y preparación de audio

1. Voz predeterminada de la app — Ajustes → Configurar voz de síntesis.
2. Fichas por campo — Título y Contenido pueden usar distintos idiomas/voces (estudio bilingüe).
3. Generación automática — interruptor en la lista de tarjetas; encola audio faltante al abrir el mazo / después de guardar.
4. Generar al guardar — barra superior del editor cuando la generación automática está activa (omitir voz para un guardado).
5. ↺ manual — encolar o actualizar; toca el spinner/anillo para quitar de la cola.

Prefiere oraciones claras; los saltos de línea forzados se convierten en oraciones habladas separadas. [br] es solo visual. Las reglas horizontales y el dibujo de cajas son silenciosos/omitidos en la voz.

6. Importar, exportar y versiones de mazos

Exportar (Plus): solo texto .deckreader.csv, texto + imágenes .deckreader.images.zip, o texto + imágenes + M4A .deckreader.media.zip.

Importar: Biblioteca → Importar → elige CSV o ZIP. Mismo nombre de mazo:

• Versión del mazo superior → Actualizar (títulos coincidentes reemplazados) o Cancelar.
• Misma / versión inferior → Combinar (agrega tarjetas; contenido distinto en colisión recibe un sufijo) o Cancelar.

Incrementa SemVer al publicar un mazo mejorado para que los lectores usen la ruta Actualizar.

7. Consejos, escapes y errores comunes

Mostrar sintaxis como texto literal

Prefiere código en línea para ejemplos, o escapa con barra invertida los caracteres de marcado (\*, \[, \{, …).

Emparejamiento estricto

**bold** funciona; ** bold** no.

Ajuste de línea

El ajuste del editor está activado por defecto. Desactívalo para desplazar tablas anchas horizontalmente.

Guardar vs reconstrucción de voz

El audio existente se conserva cuando el texto hablado, los destinos de enlaces y la configuración de voz no cambian. Unir líneas sin punto normalmente reconstruye la voz.

Lista de verificación para tarjetas pulidas

1. Título claro.
2. Estructura Contenido con encabezados / listas donde ayude.
3. Imágenes con tamaño en dp; anchos de tabla en caracteres.
4. Subtítulos para gráficos con [caption].
5. Silenciar u omitir notas solo para el profesor.
6. Previsualiza fichas de voz si es bilingüe.
7. Guardar → confirma que el audio se prepara o encola ↺.

8. Referencia rápida

Mapa de la barra de herramientas

Hoja de referencia de marcado

**bold**  *italic*  ++underline++  ~~strike~~  `code`
[RED]colored[/]
# H1 … ######## B2
:-  :-:  -:
- bullet    1. numbered
> quote
[label](https://…)   [label](#anchor)   <a@b.c>
![alt](deckimg:file.png){w:240}
[skip]…[/skip]  [mute]…[/mute]  [caption]…[/caption]
\  escapes the next markup character

9. Crear un mazo fuera de Deck Reader (editor de texto + ZIP)

Puedes crear contenido en un ordenador (editor de texto, hoja de cálculo o scripts) e importarlo con Biblioteca → Importar — los mismos formatos que exporta Deck Reader.

Elige un formato

Estructura del ZIP (CSV + imágenes)

Coloca estas entradas en el nivel superior del ZIP (no dentro de una carpeta extra):

manifest.json mínimo (solo imágenes; la voz se genera después en la app):

{
  "formatVersion": 1,
  "bundleType": "text_only",
  "deckName": "My deck",
  "cardCount": 2,
  "cards": []
}

Conceptos básicos de deck.csv

• Guárdalo como UTF-8 (UTF-8 con BOM está bien desde Excel).
• Incluye líneas de metadatos cuando puedas (Deck Version como MAJOR.MINOR.PATCH). Si falta, se trata como 1.0.0.
• La fila de encabezado necesita al menos Title y Content (el legado Definition aún se importa).
• Columnas opcionales de idioma / voz / velocidad / tono — déjalas en blanco para usar los valores predeterminados de la app.

Imágenes

1. Coloca los archivos en media/ (p. ej. media/badge.png).
2. Referéncialas en markdown: ![Badge](deckimg:badge.png) (tamaño opcional {w:240} en dp).
3. Deck Reader reescribe los nombres internos al importar. Los archivos faltantes muestran una advertencia roja en el reproductor.

Crear e importar

1. Comprime deck.csv, media/ (si hay) y manifest.json como {name}.deckreader.images.zip.
2. Copia el archivo al dispositivo.
3. Biblioteca de mazos → Importar → selecciona el CSV o ZIP.

Consejo: Exporta una vez un mazo pequeño desde Deck Reader y ábrelo en el PC — es la plantilla más fácil para nombres y metadatos.

10. Sugerencia: HTML → Markdown → mazo

Si ya tienes notas en HTML (exportaciones de Docs, Notion, un sitio web o una wiki personal), un flujo práctico es:

1. HTML → Markdown — usa un convertidor en línea fiable (o una herramienta local como Pandoc) para obtener Markdown que Deck Reader pueda guardar.
2. Limpia el Markdown — revisa encabezados, listas, enlaces y tablas; sustituye imágenes remotas por archivos en media/ y referencias deckimg:; añade [skip] / [mute] / [caption] donde convenga.
3. Divide en tarjetas — un tema por tarjeta (Title claro, cuerpo en Content). Numera los títulos (01:, 02:, …) si quieres que el orden alfabético coincida con tu esquema.
4. Crea el CSV o ZIP — como en la sección 9, luego Importar en Deck Reader y genera el audio.

La calidad de los convertidores en línea varía. Prefiere herramientas que conserven encabezados y enlaces, y revisa algunas tarjetas en la app antes de publicar un mazo completo. Conserva una copia del HTML original hasta que la importación se vea bien.