Cómo escribir buenas tarjetas

3.1 El editor de tarjetas de un vistazo

Cada tarjeta tiene dos caras, Pregunta y Respuesta, y cada una se edita por separado. Una cara tiene tres pestañas:

• Texto: lo que escribes, con la barra de formato encima.
• Imagen: una imagen de Fotos (o pegada en el texto).
• Audio: un archivo de audio, como .mp3, .m4a o .wav.

Debajo del campo de texto encontrarás Ayuda de formato (una versión de bolsillo de este capítulo, siempre a un toque) y el Idioma de esa cara.

Una cara no puede estar vacía: tanto la pregunta como la respuesta necesitan texto, una imagen o un sonido antes de que Guardar se active. También importa desde qué pestaña guardas: el capítulo 4 explica cómo combinar texto con una imagen o un sonido sin perder ninguno.

3.1.1 La barra de herramientas

Nunca tienes que acordarte del marcado. La barra que hay encima del campo de texto lo inserta por ti, envolviendo lo que tengas seleccionado. Se desplaza de lado; de izquierda a derecha:

3.1.2 El idioma importa

El selector de Idioma le dice a JustFlip! qué voz debe leer en voz alta esa cara, y cada cara tiene el suyo: una palabra en inglés en el anverso y su significado en español en el reverso.

3.1.3 Etiquetas y marcas

Las etiquetas se escriben en un campo de chips: pulsa Intro, el botón + o una coma para convertir el texto en una etiqueta. Pega verbos, irregulares, A2 y obtendrás tres chips de golpe. Las mayúsculas no importan y los duplicados se descartan. Una marca de color hace que una tarjeta destaque cuando hojeas un mazo.

3.2 Texto que se ve bien

El texto de las tarjetas es Markdown, simplificado para pantallas pequeñas. Esto es todo lo que da forma al texto normal:

Las mitocondrias son la **central
energética** de la *célula*. La función
es `atp_synthase()`.

• **bold** y *italic*: énfasis.
• `code`: un fragmento en monoespaciado.
• \*: una barra invertida muestra el siguiente carácter tal cual, así que \*not italic\* conserva sus asteriscos.
• Una línea en blanco empieza un párrafo nuevo; un salto de línea simple se conserva tal cual.

3.2.1 Enlaces

[the guide](https://example.com) muestra the guide como un enlace que se puede tocar. Funcionan los enlaces web (https://), de correo (mailto:) y de teléfono (tel:); cualquier otro tipo de enlace se muestra como texto normal.

3.3 Rellena los huecos

Una tarjeta de huecos (cloze) oculta parte de una frase. La pregunta muestra un hueco; al voltear la tarjeta aparecen las palabras que faltan, resaltadas. Es la forma más rápida de convertir un párrafo de apuntes en algo sobre lo que te puedan examinar.

La capital de Francia
es {{c1::París}}.

Añade una pista después de un segundo par de dos puntos. La pista aparece dentro del hueco, y es lo que dice la voz en lugar de las palabras «espacio en blanco»:

Las {{c1::mitocondrias::orgánulo}}
producen la mayor parte del ATP
de la célula.

Al voltear la tarjeta, la frase entera vuelve con las respuestas marcadas: las mitocondrias producen la mayor parte del ATP de la célula. La cara de la respuesta de una tarjeta de huecos es opcional. Lo que escribas ahí se muestra debajo de la frase revelada como notas adicionales.

Algunos detalles que te ahorrarán quebraderos de cabeza:

• Solo cuentan los huecos bien formados. {{c0::x}}, {{c1::}} o {{not a cloze}} se muestran tal cual, con llaves y todo.
• ¿Necesitas las propias llaves? Escribe \{\{c1::…}}.
• Dentro del código y de las matemáticas, {{c1::…}} no se toca: se queda literal.

3.4 Grande y centrado

Algunas tarjetas son un solo carácter: un kana, un kanji, un símbolo químico, el nombre de un acorde. Ponlo dentro de un bloque hero y llenará la tarjeta:

::: hero
あ
:::

::: center hace lo mismo sin cambiar el tamaño: el contenido simplemente se centra. Abre el bloque con ::: hero o ::: center en su propia línea y ciérralo con :::.

3.5 Matemáticas

JustFlip! compone las matemáticas con sintaxis TeX, la notación que usan los matemáticos de todo el mundo. Envuelve una fórmula entre dólares simples para mantenerla en la línea, o ponla entre líneas $$ para darle su propia fila centrada:

La derivada:

$$
f'(x) = \lim_{h\to 0}\frac{f(x+h)-f(x)}{h}
$$

Las matemáticas en línea funcionan igual: $E = mc^2$ se convierte en $E = mc^2$ dentro de la propia frase. Cómo hacer que una fórmula suene bien cuando se lee en voz alta se explica en Dile a la voz qué decir.

3.6 Código

Delimita el código con tres comillas invertidas y escribe el nombre del lenguaje tras las de apertura. JustFlip! colorea palabras clave, cadenas, comentarios, números y tipos:

```swift
let answer = 6 * 7
// prints 42
print(answer)
```

let answer = 6 * 7
// prints 42
print(answer)

Nombres de lenguaje reconocidos: Swift, Python, JavaScript, TypeScript, Java, Kotlin, C, C++, C#, Objective-C, Go, Rust, Ruby, PHP, SQL, Bash, Smalltalk/Pharo, JSON y YAML. Un nombre desconocido o ausente te da igualmente un bloque monoespaciado limpio, solo que sin colores. El texto dentro de un bloque de código se muestra exactamente como está escrito; ahí no se aplica ningún marcado.

3.7 Diagramas

Un bloque de código llamado mermaid no se muestra como código: JustFlip! lo dibuja. Admite diagramas de flujo, de secuencia, de estados, de clases y de entidad-relación.

```mermaid
graph TD
  A[Start review] --> B{Card due?}
  B -->|Yes| C[Show question]
  B -->|No| D[All caught up]
```

3.8 Tablas

Las comparaciones pequeñas se leen mejor en una tabla. Deja una línea en blanco encima; la primera fila es el encabezado y se muestra en negrita:

| Tiempo | Forma |
|---|---|
| Presente | yo voy |
| Pretérito | yo fui |
| Perfecto | yo he ido |

Las celdas admiten el mismo formato que el resto de la tarjeta: negrita, código, matemáticas. Para mostrar una | dentro de una celda, escribe \|.

3.9 Imágenes

Cada cara de una tarjeta admite una imagen. Añádela en la pestaña Imagen, o con el botón de imagen de la barra de texto, que además inserta un marcador en el texto:

Which bird is this?

![attachment:0]

El marcador, ![attachment:0], decide dónde va la imagen dentro del texto. Un marcador sin imagen detrás simplemente no muestra nada.

La imagen también tiene un campo de descripción. VoiceOver se la lee a quien no puede ver la imagen, así que merece la pena escribir unas palabras.

Usa fotos y mapas de bits (PNG, JPEG). Los archivos SVG no se admiten. No hace falta reducir antes las fotos grandes: JustFlip! reduce la imagen a 3.000 píxeles por su lado largo al guardar, lo que mantiene ágil la sincronización con iCloud en todos tus dispositivos. El capítulo 4 cuenta más sobre las imágenes que funcionan bien.

3.10 Dile a la voz qué decir

JustFlip! puede leer en voz alta cualquier tarjeta, con la voz del idioma de esa cara. Normalmente acierta. Cuando no (una sigla, un símbolo, una fórmula), puedes darle una pista hablada: unas llaves justo detrás de algo le dicen a la voz que diga esto en su lugar.

Activa la actualización en segundo
plano de [iOS]{ai ou ese}.

La tarjeta sigue mostrando iOS; la voz dice «ai ou ese». La misma regla funciona exactamente en cuatro sitios:

Sin pista, el texto se lee con normalidad, las matemáticas se leen a partir de su código fuente y las imágenes no dicen nada.

3.11 Cuando una tarjeta es demasiado larga

JustFlip! intenta primero que todo quepa en la tarjeta. Si el texto no cabe, se encoge un poco, hasta el 80 % del tamaño normal. Si aún no cabe, el texto se corta en la última línea completa y la parte de abajo de la tarjeta se difumina.

Pero no se pierde nada. El botón •••, abajo en la tarjeta, abre el contenido completo de esa cara en una hoja. En una tarjeta cuyo diagrama o imagen sí cabe, en ese mismo sitio aparece Ampliar, que abre la imagen a pantalla completa.

Es una red de seguridad, no un estilo de escritura. Una tarjeta que no puedes leer de un vistazo suele ser dos o tres tarjetas haciéndose pasar por una.

3.12 Tarjetas que tu memoria conservará

El formato hace que una tarjeta sea agradable. Estos hábitos hacen que funcione:

1. Un dato por tarjeta. «¿Cuáles son los tres poderes del Estado?» es una tarjeta que falla la mitad de las veces. Tres tarjetas, una por poder, aciertan cada una por su cuenta.
2. Pregunta con precisión. Una pregunta que admite dos respuestas correctas no te enseñará ninguna. Añade contexto (o una pista en el hueco) hasta que solo encaje una respuesta.
3. Usa tus propias palabras. Reformular algo es la primera repetición, y sale gratis.
4. Añade una imagen o un sonido siempre que la cosa sea visual o sonora: un pájaro, un acorde, una pronunciación.
5. Que el texto de las preguntas no se repita dentro de un mazo.

3.13 Chuleta

↑ Volver arriba · Todos los capítulos · PDF