Comment créer des cartes Anki vérifiables à partir de sous-titres YouTube

1. Définissez un objectif d’apprentissage

Choisissez une leçon publique et une langue que vous pouvez vérifier. Définissez l’objectif d’apprentissage avant de choisir les lignes de sous-titres. Vous pourriez, par exemple, vouloir identifier le champ qui relie deux tables dans une leçon.

Choisissez un court passage qui répond à cet objectif. Ne transformez pas chaque ligne de sous-titres en carte. Les limites des sous-titres indiquent quand le texte apparaît. Elles ne délimitent pas nécessairement une idée complète.

Définissez trois critères de réussite pour le petit paquet :

1. Chaque réponse découle d’un passage que vous avez vérifié.
2. Chaque note conserve assez d’informations sur la source pour permettre une nouvelle vérification.
3. Une seconde importation modifie la réponse voulue sans créer de note indésirable.

N’ajoutez pas de passage incertain au paquet d’étude. Vous pourrez y revenir plus tard. Une réponse plausible n’est pas une réponse vérifiée.

2. Utilisez les sous-titres existants comme copie de référence

Une piste de sous-titres est un texte horodaté associé à une vidéo. Un segment est une portion horodatée de ce texte. Vous pouvez préparer quelques cartes à la main avec les sous-titres accessibles et le lecteur de la vidéo source. Si vous avez déjà des sous-titres horodatés, passez à la vérification du passage.

Si les sous-titres sont absents, consultez le guide consacré à l’obtention et à la vérification d’une transcription YouTube. Cette étape fournit le texte source. Elle ne détermine pas ce qui doit figurer sur une carte.

Le YouTube Transcript Scraper peut collecter les pistes de sous-titres publiques existantes. Un Actor est un programme hébergé. Une Task est un ensemble de paramètres d’entrée prédéfinis et enregistrés pour ce programme. La Task de transcription JSON horodatée constitue un point de départ documenté pour obtenir du texte horodaté.

JSON est un format texte qui stocke des valeurs nommées et des listes. Utilisez-le ici pour conserver les temps des segments. Le texte brut seul ne permet pas de déterminer où les segments se terminent. L’Actor ne transcrit pas la parole et ne télécharge ni audio ni vidéo. Il fournit le contenu source. Vous concevez et vérifiez les cartes.

Ces quelques paramètres respectent les règles publiques d’entrée fournies :

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

Avant de lancer l’Actor, remplacez toute l’entrée d’exemple dans `startUrls` par l’URL de la leçon publique choisie. L’URL fournie sert d’exemple de saisie. Elle ne prouve ni que la leçon convient ni qu’une exécution a réussi.

Une liste `preferredLanguages` vide autorise la sélection de la meilleure piste de sous-titres disponible. Elle n’impose pas l’anglais. Si votre objectif d’apprentissage exige l’anglais, définissez ce champ sur `["en"]`. Les langues préférées sont essayées dans l’ordre. Si aucune ne correspond, l’Actor signale un échec pour langue indisponible au lieu de renvoyer une autre langue.

L’Actor accepte de 1 à 1 000 URL directes de vidéos ou identifiants de vidéos. Il ne traite qu’une fois un identifiant de vidéo répété. Il n’accepte pas les chaînes, les playlists ou les recherches comme entrées. Pour cette méthode, commencez avec une seule vidéo. Ces fonctions sont documentées. Il ne s’agit pas de résultats d’une exécution réalisée pour ce guide.

3. Conservez les données sources séparément de vos cartes

Un champ est une valeur nommée dans un enregistrement. Avant de rédiger les cartes, enregistrez les champs renvoyés suivants, lorsqu’ils sont disponibles :

Conservez les segments d’origine sans les modifier. Consignez les corrections dans un journal séparé. Vous pourrez ainsi distinguer le texte reçu de la réponse rédigée ensuite.

Chaque segment contient `text`, `startSeconds`, `endSeconds` et `durationSeconds`. Conservez les valeurs renvoyées. Une durée absente est inconnue. Ce n’est pas une durée de zéro seconde. En revanche, un début de lecture à zéro seconde désigne le début de la vidéo.

Examinez les enregistrements vidéo renvoyés ainsi que le résumé d’exécution nommé OUTPUT. Les vidéos distinctes traitées avec succès produisent des lignes dans le jeu de données. Chaque ligne est un enregistrement de résultat individuel. Les entrées en échec ne produisent pas ces lignes de transcription réussie. Consultez OUTPUT pour connaître les détails des entrées en échec. Un résultat vide ne suffit pas à conclure que les sous-titres sont absents.

La langue des sous-titres, les indicateurs d’origine, le nombre de segments et la couverture décrivent la piste renvoyée. Ils ne prouvent pas l’exactitude des mots. Le nombre de segments n’indique pas non plus combien de cartes utiles vous pourrez créer. Les spécifications publiques de l’Actor précisent ces limites.

4. Vérifiez le passage avant de rédiger la réponse

Ouvrez le passage choisi dans la vidéo. Écoutez aussi la phrase qui le précède et celle qui le suit. Élargissez cet intervalle si l’explication exige plus de contexte. Le contexte désigne les mots ou les images environnants nécessaires pour comprendre la réponse.

Vérifiez le passage dans cet ordre :

1. Écoutez les mots qui étayent la réponse.
2. Vérifiez les noms, les nombres, les unités, les conditions et les mots comme « pas ».
3. Identifiez ce que désignent les mots comme « il » ou « ceci ».
4. Examinez l’écran lorsqu’un tableau, un schéma ou un exemple de code fournit des informations nécessaires.
5. Rédigez une courte note de contexte et consignez toute correction des sous-titres.
6. Mettez le passage en attente si un mot ou un sens nécessaire reste incertain.

Ne remplacez pas un mot peu clair par la réponse attendue. Ne déduisez pas une définition absente à partir d’un terme familier. Si la leçon n’étaye pas la réponse proposée, choisissez une autre question ou un autre passage.

Pour une carte qui exige une formulation exacte, suivez la méthode consacrée à la vérification d’une citation YouTube. Pour la plupart des cartes, vous pouvez reformuler brièvement le passage avec vos propres mots. Cette reformulation doit conserver le sens de la source, y compris ses conditions.

Même un enregistrement clair peut contenir une erreur factuelle. Vérifier ce que dit la leçon et vérifier si son affirmation est vraie sont deux tâches distinctes. Si vous avez une raison de douter de l’affirmation, gardez la carte en attente jusqu’à la résolution du doute.

5. Rédigez une question avec une réponse

Rédigez la question avant de raccourcir la réponse. Une question utile précise ce que l’apprenant doit se rappeler. Elle doit rester compréhensible lorsque l’apprenant la voit sans la vidéo.

Évitez les questions comme « À quoi cela sert-il ? ». Le mot « cela » dépend d’un contexte absent. Nommez plutôt l’objet ou l’opération. Si la question concerne l’exemple particulier de la leçon, précisez-le.

Gardez un seul fait principal par question. Scindez une question qui porte sur deux faits sans rapport. Conservez chaque condition avec le fait auquel elle s’applique. Ne supprimez pas une condition uniquement pour raccourcir la réponse.

Appliquez ces vérifications à chaque brouillon :

Une réponse peut être courte sans être vague. Conservez avec elle le contexte qui l’étaye pour pouvoir l’examiner plus tard. Le recto de la carte ne doit pas révéler la réponse.

6. Configurez des champs adaptés aux modifications ultérieures

Utilisez un type de note personnalisé. Un type de note définit les champs et la mise en page des cartes. Configurez-le pour afficher une question au recto et sa réponse au verso. Affichez le lien source et le segment avec la réponse pour pouvoir la vérifier à nouveau.

Utilisez ces six champs dans cet ordre :

Gardez `SourceKey` en premier. La gestion des notes répétées dans Anki dépend du type de note et du premier champ. Testez le comportement voulu au lieu de supposer que chaque importation met à jour les notes existantes. Le manuel d’importation de fichiers texte d’Anki explique les séparateurs de champs, la correspondance des champs et la gestion des doublons.

Une clé source peut combiner un identifiant de vidéo, le temps d’un segment et un numéro de carte. Attribuez-la une seule fois. Si vous reformulez la question ou corrigez la réponse, conservez cette clé. Si vous ajustez plus tard le temps du segment, ne reconstruisez pas automatiquement la clé à partir du nouveau temps. Une clé différente pourrait faire passer la modification pour une nouvelle note.

Utilisez des étiquettes de vérification simples, comme `needs_review` et `reviewed`. Vous attribuez ces étiquettes vous-même. Ce ne sont ni des résultats de l’Actor ni la preuve d’une vérification indépendante.

Tenez un journal de corrections séparé avec la clé source, le texte d’origine du segment, le texte corrigé, le motif, l’intervalle vérifié et la date de vérification. Votre fichier de notes, vos décisions de vérification et vos paramètres d’importation Anki sont des données du propriétaire. Une page publique de Task ne révèle ni ne vérifie ces données.

7. Enregistrez le fichier et testez deux notes

Enregistrez les six champs dans un fichier texte UTF-8 avec des tabulations comme séparateurs. UTF-8 est un encodage de texte qui prend en charge les caractères de nombreuses langues. Un fichier séparé par des tabulations utilise un caractère de tabulation entre les champs. Pour ce petit test, utilisez un enregistrement par ligne.

Gardez le premier fichier simple. Utilisez une seule ligne par champ, sans caractère de tabulation dans les valeurs. Si votre contenu exige des tabulations ou des sauts de ligne dans les champs, suivez les règles documentées d’Anki pour l’emploi des guillemets et examinez l’aperçu. Ne remplacez pas le texte sans contrôle si cela en modifie le sens.

Suivez ces étapes :

1. Créez un paquet de test temporaire avec le type de note personnalisé.
2. Préparez deux notes vérifiées avec des clés sources différentes.
3. Ouvrez l’aperçu d’importation et sélectionnez la tabulation comme séparateur.
4. Associez chaque colonne du fichier au champ correspondant.
5. Confirmez que la première colonne correspond à `SourceKey`.
6. Importez le fichier et examinez les deux cartes.
7. Modifiez une seule réponse dans le fichier. Conservez sa clé source.
8. Réimportez le fichier avec les paramètres de mise à jour voulus et le même type de note.
9. Confirmez que la réponse a changé et qu’aucune note supplémentaire indésirable n’a été créée.

Examinez la question, la réponse, le segment et le lien source affichés. Ouvrez chaque lien source réel et vérifiez le temps indiqué dans le lecteur. Une URL visible ne prouve pas qu’elle ouvre la leçon voulue.

Un type de note intégré à deux champs exige une correspondance différente et explicite. N’y importez pas ce fichier à six champs sans déterminer où chaque valeur doit aller. Si le test de mise à jour échoue, arrêtez-vous. Corrigez la correspondance, la clé, le type de note ou le paramètre de gestion des doublons avant d’importer d’autres notes.

Exemple détaillé : fiction originale

Cet exemple est une fiction originale. Ce n’est ni un résultat de l’Actor, ni une leçon réelle, ni un test Anki effectué. Les étapes d’importation proposées ci-dessous n’ont pas été exécutées.

Dans la leçon fictive, un passage à 02:14 explique que deux tables d’échantillons utilisent un ID stable pour relier leurs enregistrements. ID signifie identifiant. Ici, c’est une valeur qui identifie un échantillon. Un autre passage fictif indique ensuite que la modification du libellé d’un échantillon ne doit pas modifier son ID.

Le premier passage commence à 2 minutes et 14 secondes :

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

Dans cet exemple fictif, il se termine à 142 secondes. Sa durée est de :

`142 seconds − 134 seconds = 8 seconds`

Le second passage fictif va de 142 à 148 secondes :

`148 seconds − 142 seconds = 6 seconds`

Ces intervalles sont des valeurs inventées à des fins pédagogiques. Ils ne proviennent pas de mesures effectuées sur une vidéo. La clé `demo-video:134:01` identifie la première carte fictive. La terminaison `01` est un numéro de carte, pas un score d’exactitude.

Préparez ces deux notes fictives :

L’exemple laisse les URL sources vides, car elles sont absentes. Il ne les remplace pas par une URL de vidéo d’exemple. Les notes restent hors d’un véritable paquet d’étude, car aucune source réelle ne peut être vérifiée.

La première question limite « Quel champ sert à joindre les deux tables ? » aux tables d’échantillons de la leçon. Elle n’enseigne pas que toutes les tables doivent utiliser le même champ de jointure.

Pour le test de gestion des doublons proposé, remplacez la première réponse par « L’ID stable de l’échantillon. ». Gardez `demo-video:134:01` inchangé. Après une mise à jour correctement configurée, le résultat attendu reste de deux notes, avec la première réponse modifiée. Une troisième note indiquerait que cette importation n’a pas effectué la mise à jour voulue. Il s’agit de résultats attendus pour un test, et non de résultats de test constatés.

Pour une leçon réelle, remplacez le contenu fictif par du contenu source vérifié. Conservez les temps de lecture réels, un lien source fonctionnel et votre compte rendu de vérification.

Résolvez les échecs avant d’ajouter des notes au paquet

Choisissez l’action suivante selon l’échec observé. N’attribuez pas chaque problème à l’absence de sous-titres.

Deux notes correctement affichées montrent que ces notes ont réussi votre petit contrôle. Elles ne prouvent pas que chaque importation future fonctionnera ou que chaque réponse future sera correcte. Vérifiez chaque passage ajouté. Répétez le test d’importation lorsque vous modifiez la structure du fichier ou le type de note.