Cómo crear tarjetas de Anki verificables con subtítulos de YouTube

1. Define un objetivo de aprendizaje

Elige una lección pública y un idioma que puedas comprobar. Escribe el objetivo de aprendizaje antes de elegir las líneas de subtítulos. Por ejemplo, quizá quieras identificar el campo que conecta dos tablas en una lección.

Elige un pasaje breve que responda a ese objetivo. No conviertas cada línea de subtítulos en una tarjeta. Los límites de los subtítulos indican cuándo aparece el texto. No siempre delimitan una idea completa.

Define tres comprobaciones para dar por válido el mazo pequeño:

1. Cada respuesta se desprende de un pasaje que has comprobado.
2. Cada nota conserva suficiente información de la fuente para volver a comprobarla.
3. Una segunda importación modifica la respuesta prevista sin crear una nota no deseada.

Deja fuera del mazo de estudio cualquier pasaje que genere dudas. Puedes volver a él más adelante. Una respuesta plausible no es una respuesta comprobada.

2. Usa los subtítulos existentes como copia de la fuente

Una pista de subtítulos es texto con marcas de tiempo que se guarda con un vídeo. Un bloque de subtítulos es una parte de ese texto con su propio tiempo. Puedes usar los subtítulos disponibles y el reproductor de la fuente para preparar unas pocas tarjetas a mano. Si ya tienes subtítulos con marcas de tiempo, pasa a comprobar el pasaje.

Si faltan subtítulos, consulta la guía específica para obtener y comprobar una transcripción de YouTube. Ese paso proporciona el texto de la fuente. No decide qué debe incluirse en una tarjeta.

YouTube Transcript Scraper puede recopilar pistas de subtítulos públicos ya existentes. Un Actor es un programa alojado en un servidor. Una Task es una configuración de entrada guardada para ese programa. La Task de transcripción JSON con marcas de tiempo es un punto de partida documentado para obtener texto con marcas de tiempo.

JSON es un formato de texto que guarda valores con nombre y listas. Úsalo aquí porque conserva los tiempos de los bloques de subtítulos. El texto sin formato, por sí solo, no permite determinar dónde terminan esos bloques. El Actor no convierte voz en texto ni descarga audio o vídeo. Proporciona el material de la fuente; tú diseñas y compruebas las tarjetas.

Estos datos de entrada básicos cumplen las reglas públicas de entrada proporcionadas:

{
  "includeFailedInputDetails": true,
  "outputFormats": ["json"],
  "preferredLanguages": [],
  "startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]
}

Antes de ejecutarlo, sustituye toda la entrada de ejemplo de `startUrls` por la URL de la lección pública que quieras usar. La URL de ejemplo solo muestra un dato de entrada. No demuestra que la lección sea adecuada ni que se haya completado una ejecución correctamente.

Una lista `preferredLanguages` vacía permite seleccionar la mejor pista de subtítulos disponible. No exige que esté en inglés. Si tu objetivo de aprendizaje requiere inglés, establece ese campo en `["en"]`. Las preferencias de idioma se prueban en orden. Si ninguna coincide, el Actor informa de un fallo por idioma no disponible en lugar de devolver otro idioma.

El Actor acepta entre 1 y 1000 URL directas de vídeos o ID de vídeos. Procesa una sola vez cada ID de vídeo repetido. No acepta canales, listas de reproducción ni búsquedas como entrada. Para este método, empieza con un vídeo. Estas son funciones documentadas, no resultados de una ejecución realizada para esta guía.

3. Guarda el registro de la fuente separado de tus tarjetas

Un campo es un valor con nombre dentro de un registro. Antes de escribir las tarjetas, guarda estos campos devueltos cuando estén disponibles:

Conserva los bloques de subtítulos originales sin cambios. Guarda las correcciones en un registro aparte. Así podrás distinguir el texto que recibiste de la respuesta que escribiste después.

Cada segmento contiene `text`, `startSeconds`, `endSeconds` y `durationSeconds`. Conserva los valores devueltos. Si falta la duración, se desconoce. No equivale a una duración de cero segundos. En cambio, un inicio de reproducción en cero segundos indica el principio del vídeo.

Revisa tanto los registros de vídeo devueltos como el resumen de ejecución llamado OUTPUT. Cada vídeo único procesado correctamente genera una fila en el conjunto de datos, es decir, un registro de resultado individual. Las entradas fallidas no generan esas filas de transcripciones obtenidas correctamente. Consulta OUTPUT para ver los detalles de las entradas fallidas. Un resultado vacío no basta para concluir que faltan subtítulos.

El idioma de los subtítulos, los indicadores de origen, el número de segmentos y la cobertura describen la pista devuelta. No demuestran que las palabras sean correctas. El número de segmentos tampoco indica cuántas tarjetas útiles puedes crear. El contrato público del Actor especifica estos límites.

4. Comprueba el pasaje antes de redactar la respuesta

Abre el pasaje elegido en el vídeo. Reproduce la frase anterior y la posterior. Amplía ese intervalo cuando la explicación necesite más contexto. El contexto son las palabras o imágenes que rodean el pasaje y hacen falta para entender la respuesta.

Comprueba el pasaje en este orden:

1. Escucha las palabras que respaldan la respuesta.
2. Comprueba los nombres, los números, las unidades, las condiciones y palabras como «no».
3. Identifica a qué se refieren palabras como «ello» o «esto».
4. Revisa la pantalla cuando una tabla, un diagrama o un ejemplo de código aporte información necesaria.
5. Escribe una breve nota de contexto y registra cualquier corrección de los subtítulos.
6. Deja el pasaje pendiente si aún hay dudas sobre una palabra o un significado necesario.

No sustituyas una palabra poco clara por la respuesta que esperas. No deduzcas una definición ausente a partir de un término conocido. Si la lección no respalda la respuesta propuesta, elige otra pregunta u otro pasaje.

Si una tarjeta necesita una formulación exacta, sigue el método específico para comprobar una cita de YouTube. En la mayoría de las tarjetas puedes expresar la idea brevemente con tus propias palabras. Esa reformulación debe conservar el significado de la fuente, incluidas sus condiciones.

Una grabación clara también puede contener un error de hecho. Comprobar lo que dice la lección no es lo mismo que comprobar si su afirmación es cierta. Si tienes motivos para dudar de ella, deja la tarjeta pendiente hasta resolver la duda.

5. Escribe una pregunta con una respuesta

Escribe la pregunta antes de acortar la respuesta. Una pregunta útil indica qué debe recordar quien estudia. Debe tener sentido cuando se vea fuera del vídeo.

Evita preguntas como «¿Qué hace esto?». La palabra «esto» depende de un contexto que no se ve. Nombra el objeto o la operación. Si la pregunta se refiere al ejemplo concreto de la lección, indícalo.

Incluye un solo dato principal en cada pregunta. Divide una pregunta que pida dos datos sin relación entre sí. Mantén cada condición junto al dato al que se aplica. No elimines una condición solo para acortar la respuesta.

Aplica estas comprobaciones a cada borrador:

Una respuesta puede ser breve sin ser imprecisa. Conserva el contexto que respalda la respuesta junto a ella para poder revisarlo después. Evita que el anverso de la tarjeta revele la respuesta.

6. Configura campos que sigan siendo útiles tras las modificaciones

Usa un tipo de nota personalizado. Un tipo de nota define los campos y el diseño de la tarjeta. Configúralo para mostrar una pregunta en el anverso y su respuesta en el reverso. Muestra el enlace a la fuente y el bloque de subtítulos junto a la respuesta para poder comprobarla de nuevo.

Usa estos seis campos en este orden:

Mantén `SourceKey` en primer lugar. La forma en que Anki trata las notas repetidas depende del tipo de nota y del primer campo. Comprueba el comportamiento previsto en lugar de suponer que cada importación actualiza las notas existentes. El manual de importación de texto de Anki explica los campos separados, su asignación y el tratamiento de duplicados.

Una clave de fuente puede combinar el identificador del vídeo, el tiempo del bloque de subtítulos y el número de tarjeta. Asígnala una sola vez. Si reescribes la pregunta o corriges la respuesta, conserva esa clave. Si después ajustas el tiempo del bloque de subtítulos, no vuelvas a crear la clave automáticamente a partir del nuevo tiempo. Una clave distinta podría hacer que la modificación pareciera una nota nueva.

Usa etiquetas de revisión sencillas, como `needs_review` y `reviewed`. Son etiquetas que tú asignas. No son resultados del Actor ni pruebas de una comprobación independiente.

Mantén un registro de correcciones aparte con la clave de fuente, el texto original del bloque de subtítulos, el texto corregido, el motivo, el intervalo comprobado y la fecha de revisión. Tu archivo de notas, tus decisiones de revisión y la configuración de importación de Anki son registros del propietario. Una página pública de una Task no muestra ni verifica esos registros.

7. Guarda el archivo y prueba dos notas

Guarda los seis campos como texto UTF-8 separado por tabulaciones. UTF-8 es una codificación de texto que admite caracteres de muchos idiomas. «Separado por tabulaciones» significa que un carácter de tabulación separa cada campo. Usa un registro por línea para esta pequeña prueba.

Mantén el primer archivo sencillo. Usa una sola línea en cada campo y no incluyas tabulaciones dentro de sus valores. Si el contenido necesita tabulaciones o saltos de línea dentro de los campos, sigue las reglas de Anki sobre el uso de comillas y revisa la vista previa. No sustituyas texto sin comprobarlo si eso cambia su significado.

Sigue estos pasos:

1. Crea un mazo de prueba temporal con el tipo de nota personalizado.
2. Prepara dos notas revisadas con claves de fuente distintas.
3. Abre la vista previa de importación y selecciona la tabulación como separador.
4. Asigna cada columna del archivo a su campo correspondiente.
5. Confirma que la primera columna esté asignada a `SourceKey`.
6. Importa el archivo y revisa las dos tarjetas.
7. Cambia solo una respuesta en el archivo. Conserva su clave de fuente.
8. Vuelve a importar con la configuración de actualización prevista y el mismo tipo de nota.
9. Confirma que la respuesta haya cambiado y que no haya aparecido una nota adicional no deseada.

Revisa la pregunta, la respuesta, el bloque de subtítulos y el enlace a la fuente que se muestran. Abre cada enlace a una fuente real y comprueba el tiempo indicado en el reproductor. Que una URL sea visible no demuestra que abra la lección prevista.

Un tipo de nota integrado de dos campos necesita una asignación distinta y explícita. No importes este archivo de seis campos en él sin decidir dónde debe ir cada valor. Si falla la prueba de actualización, detente y resuelve el problema de asignación, clave, tipo de nota o configuración de duplicados antes de importar más notas.

Ejemplo paso a paso: ficción original

Este ejemplo es una ficción original. No es un resultado del Actor, una lección real ni una prueba completada en Anki. Los pasos de importación propuestos a continuación no se han ejecutado.

En la lección ficticia, un pasaje situado en 02:14 explica que dos tablas de muestras usan un ID estable para conectar sus registros. ID significa identificador. Aquí es un valor que identifica una muestra. Otro pasaje ficticio posterior dice que cambiar la etiqueta de una muestra no debe cambiar su ID.

El primer pasaje empieza a los 2 minutos y 14 segundos:

`2 × 60 seconds + 14 seconds = 134 seconds`

En este ejemplo ficticio, termina a los 142 segundos. Su duración es:

`142 seconds − 134 seconds = 8 seconds`

El segundo pasaje ficticio va de los 142 a los 148 segundos:

`148 seconds − 142 seconds = 6 seconds`

Estos intervalos son valores inventados para enseñar el método. No son resultados medidos en un vídeo. La clave `demo-video:134:01` identifica la primera tarjeta ficticia. La terminación `01` es un número de tarjeta, no una puntuación de exactitud.

Prepara estas dos notas ficticias:

El ejemplo deja vacías las URL de las fuentes porque no existen. No coloca una URL de vídeo de ejemplo en su lugar. Las notas se mantienen fuera de un mazo de estudio real porque no hay una fuente real que se pueda comprobar.

La primera pregunta limita «¿Qué campo une las dos tablas?» a las tablas de muestras de la lección. No enseña que todas las tablas deban usar el mismo campo de unión.

Para la prueba de duplicados propuesta, cambia la primera respuesta por «El ID estable de la muestra». Mantén `demo-video:134:01` sin cambios. Tras una actualización bien configurada, el resultado esperado sigue siendo dos notas, con la primera respuesta modificada. Una tercera nota mostraría que esta importación no realizó la actualización prevista. Estos son resultados esperados de una prueba, no resultados de una prueba realizada.

En una lección real, sustituye el contenido ficticio por material comprobado de la fuente. Conserva los tiempos de reproducción reales, un enlace a la fuente que funcione y tu registro de revisión.

Resuelve los fallos antes de ampliar el mazo

Elige la siguiente acción según el fallo observado. No trates todos los problemas como si faltaran subtítulos.

Dos notas que se muestran correctamente indican que esas notas han superado tu pequeña comprobación. No demuestran que todas las importaciones futuras vayan a funcionar ni que todas las respuestas futuras sean correctas. Revisa cada pasaje que añadas. Repite la prueba de importación cuando cambies la estructura del archivo o el tipo de nota.