Comment retrouver une notion dans un long cours sur YouTube

1. Écrivez d’abord la question d’apprentissage

Écrivez une phrase avant de parcourir la transcription. Nommez la notion. Ajoutez d’autres mots qu’un enseignant pourrait employer. Précisez le type de réponse dont vous avez besoin.

Utilisez ces types de réponses :

• Une définition indique ce que signifie la notion ou comment la mettre en pratique.
• Un exemple résolu traite un cas étape par étape.
• Une suite d’étapes présente les actions dans l’ordre.
• Une comparaison met 2 notions en regard.
• Une limite indique où s’arrête la portée de la notion.

Gardez cette distinction claire. « Mentionne la mesure » ne signifie pas « explique comment mesurer ». Votre phrase doit préciser lequel de ces éléments vous cherchez.

2. Obtenez une piste de sous-titres

Un sous-titre est un texte déjà associé à un repère temporel et enregistré pour la vidéo. Une transcription regroupe tous les sous-titres d’une vidéo. Un segment est une ligne horodatée. Chaque segment comporte un texte, un début et une durée. La durée indique combien de temps cette ligne reste affichée.

Un intervalle est délimité par le début et la fin que vous choisissez pour une notion. Vous le choisissez plus tard, après avoir lu les segments.

Un Actor est un programme hébergé qui collecte des lignes de données source. Une ligne de données source correspond au résultat d’une vidéo. Une Task est un ensemble de paramètres d’entrée enregistré. L’Actor collecte uniquement les lignes. Vous effectuez vous-même le travail sur les notions à partir de ces lignes.

Utilisez YouTube Transcript version 0.1.43. L’Actor est YouTube Transcript Scraper. La Task publique est YouTube Transcript Data for Video Chapter Generation.

Cette Task fournit des paramètres d’entrée pour commencer. Elle n’attribue pas de libellés aux notions à votre place. Sa liste enregistrée contient des vidéos d’exemple, pas votre cours. Remplacez toute la liste par une seule vidéo de cours publique que vous connaissez déjà. N’étudiez pas la liste d’exemples. N’en recopiez pas les mots.

L’Actor accepte l’URL d’une vidéo publique. Il accepte aussi un identifiant vidéo de 11 caractères. Cet identifiant est le code court de la vidéo. Vous pouvez envoyer jusqu’à 1 000 entrées. Pour ce travail, envoyez une seule vidéo. Un identifiant vidéo répété est traité une seule fois.

Une URL de départ peut être un lien de visionnage standard, un lien youtu.be, un lien Shorts, un lien de direct ou un lien d’intégration. Un lien d’intégration permet de placer le lecteur sur une autre page. L’Actor ne recherche pas de vidéos dans une chaîne, une playlist ou une page de résultats de recherche.

Il lit uniquement les sous-titres publics existants. Il ne transforme pas la parole en nouveau texte. Il ne traduit pas. Il ne rédige ni chapitres, ni libellés, ni résumés.

Utilisez ces paramètres d’entrée pour demander une piste en anglais :

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

Remplacez YOUR_PUBLIC_VIDEO par la vidéo publique que vous connaissez. `outputFormats` doit valoir `["json"]` pour que chaque segment conserve ses repères temporels. La valeur `["en"]` pour `preferredLanguages` demande l’anglais. Si l’anglais manque, le résultat indique que la langue est indisponible. Il ne renvoie pas une autre langue sans le signaler.

Si vous voulez la meilleure piste disponible, utilisez une liste de langues vide :

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

Une liste vide ne garantit pas une piste en anglais. Vous devez lire `transcriptLanguageCode` après l’exécution. Gardez `includeFailedInputDetails` à true pour qu’une entrée en échec reste visible.

3. Vérifiez le résultat avant de chercher

Repérez ces noms dans une ligne de données source. Un champ est une valeur désignée par un nom.

• `videoId`
• `videoUrl`
• `transcriptLanguageCode`
• `isAutoGenerated`
• `segments`, chacun avec `text`, `startSeconds`, `endSeconds` et `durationSeconds`
• `segmentCount`
• `status`
• `statusReason`
• `scrapedAt`

`videoDurationSeconds` peut être absent. Une valeur absente est inconnue. Ne remplacez pas une valeur inconnue par 0.

`isAutoGenerated` indique comment la piste a été créée. La valeur true signifie que les sous-titres ont été générés automatiquement. La valeur false signifie qu’une personne a fourni la piste. Une piste manuelle peut tout de même contenir des mots erronés. Vous devez donc regarder la vidéo.

`status` indique si la lecture des sous-titres a réussi. `statusReason` en indique la raison. `scrapedAt` est la date et l’heure de l’observation. Conservez avec vos notes l’identifiant vidéo, l’URL, la langue, l’indicateur de génération automatique ou manuelle et `scrapedAt`.

Lisez ensuite le bilan de l’exécution, appelé OUTPUT :

• `successfulTranscriptRows`
• `rowsWritten`
• `failedInputs`
• `statusCounts`
• `errorCodeCounts`
• `failedInputDetails`

Une entrée en échec ne produit pas de ligne de transcription. Si `status` n’indique pas une réussite, arrêtez-vous. Si la langue demandée est indisponible, laissez la recherche sans conclusion. L’absence de correspondance dans le texte ne prouve pas que la notion est absente. Les mots peuvent apparaître uniquement à l’écran. La piste dans la bonne langue peut manquer. La lecture des sous-titres peut avoir échoué. Cette limite concerne uniquement la piste vérifiée, pas toute la vidéo.

Un test de la version 0.1.43 a utilisé un seul identifiant précis de vidéo publique. Il a renvoyé une transcription. La piste était en anglais et manuelle. Elle comportait 4 530 segments horodatés. OUTPUT indiquait une réussite et aucune entrée en échec. Cela confirme l’obtention de segments horodatés pour cette seule source. Cela ne valide pas les libellés des notions. Cela ne garantit pas un texte sans erreur. Cela ne garantit pas le même résultat pour toutes les vidéos. Vérifiez chaque intervalle dans la vidéo.

`transcriptSpanSeconds`, ainsi que les premières et dernières valeurs temporelles, décrivent uniquement la piste de sous-titres. Ils ne prouvent pas qu’une notion est traitée en entier.

4. Conservez chaque segment d’origine

Conservez tous les segments d’origine. Ne faites pas de chaque mot des sous-titres une notion distincte. Cherchez votre notion et les autres mots de votre liste. Lisez ensuite les segments qui précèdent et suivent immédiatement une correspondance.

Une recherche par mots-clés peut proposer un intervalle candidat. Un intervalle candidat est un intervalle possible, pas un intervalle confirmé. La recherche ne produit pas de libellé vérifié. Vous rédigez le libellé seulement après avoir regardé le passage.

5. Délimitez l’intervalle candidat

Faites commencer l’intervalle au premier segment qui introduit l’explication. Terminez-le au dernier segment qui répond encore à votre question.

Utilisez de préférence la valeur `endSeconds` renvoyée pour ce dernier segment. Lorsque `durationSeconds` est connu, vérifiez que `endSeconds` est égal à `startSeconds` plus `durationSeconds`. `durationSeconds` peut valoir null alors que `endSeconds` est connu. Conservez null. Ne supposez jamais que la valeur est 0. N’utilisez pas le début du segment suivant comme fin. Les segments peuvent se chevaucher. Ils peuvent aussi être séparés par des intervalles sans sous-titres. La fin du dernier sous-titre n’est pas la fin de la vidéo.

Incluez les segments précédents lorsqu’ils définissent un mot dont vous avez besoin. Un mot défini peut désigner une valeur. Les intervalles peuvent se chevaucher lorsque l’enseignant revient sur une notion précédente. Vous n’avez pas à découper toute la vidéo en une suite continue d’intervalles.

6. Regardez la vidéo et attribuez un libellé à la réponse

Ouvrez l’intervalle candidat dans la vidéo source. Écoutez les paroles. Regardez aussi les schémas, le code affiché à l’écran et les références. Ces éléments peuvent manquer dans les sous-titres.

Attribuez un libellé parmi les catégories de cette grille simple :

• `mention_only` signifie que la notion est nommée, mais pas expliquée.
• `explains_definition` signifie que l’intervalle explique le sens ou la méthode.
• `worked_example` signifie que l’intervalle traite un cas étape par étape.
• `comparison` signifie que l’intervalle compare des éléments.
• `unresolved` signifie que ce visionnage ne permet pas de confirmer la réponse.

Ces libellés sont vos propres annotations du contenu. Ils ne sont pas produits par l’Actor. Écrivez pourquoi l’intervalle répond à la question d’apprentissage, ou pourquoi il n’y répond pas.

7. Enregistrez une ligne d’index

Une ligne d’index est une ligne que vous rédigez pour un intervalle vérifié. Incluez les éléments suivants :

• libellé de la notion
• question d’apprentissage
• identifiant et URL de la vidéo
• langue des sous-titres
• début et fin en secondes
• repère de début en minutes et secondes
• type d’explication
• `checked_at`
• note sur les éléments observés
• niveau de confiance

Conservez aussi le repère de fin. Le niveau de confiance est l’évaluation que vous attribuez après vérification. Ce n’est pas un score de modèle. Si une borne est inconnue, laissez-la inconnue.

8. Ouvrez le lien de début et étudiez cet intervalle

Sur un ordinateur, ouvrez Partager, puis Démarrer à. Saisissez le repère de début. Copiez le lien. Ouvrez le lien copié. Vérifiez que la lecture commence à proximité du contexte voulu. YouTube explique cette commande dans Partager des vidéos et des chaînes.

Un lien de début n’impose pas de point d’arrêt. Conservez le repère de fin dans l’index. Ne considérez pas une URL d’exemple inventée comme une vidéo dont la lecture a été vérifiée.

Utilisez l’intervalle vérifié pour étudier. Si vous ne pouvez pas confirmer l’explication, indiquez `no_confirmed_explanation_in_checked_track`. Ajoutez une note qui précise la portée de ce constat et nomme la piste vérifiée. Consultez ensuite une autre source. Ne concluez pas que toute la vidéo est incapable de répondre à la question parce qu’une recherche incertaine dans les sous-titres a échoué.

Cours fictif : Mesurer une plate-bande

L’exemple ci-dessous est une fiction originale. Il explique les calculs sur les intervalles. Ce n’est pas un résultat de l’Actor. Il ne possède aucune URL de vidéo réelle. Ne considérez aucun lien associé à cet exemple comme permettant de lire une vidéo.

La fiction s’intitule « Mesurer une plate-bande ». Ce cours inventé dure 12 minutes. Ses intervalles pédagogiques sont les suivants :

• préparation de 0 à 120 secondes
• explication de la mesure de 120 à 330 secondes
• exemple de calcul de 330 à 570 secondes
• limites de 570 à 720 secondes

3 segments fictifs se trouvent près du passage sur la notion de largeur :

La question d’apprentissage est : Comment mesurer la largeur dans une même unité ?

La ligne à 120 secondes indique l’action. La ligne à 150 secondes ajoute la consigne d’utiliser une même unité. La ligne à 300 secondes termine la méthode. L’intervalle de définition inclut donc ces 3 lignes. Il va de 120 secondes à 330 secondes.

Fin du dernier segment : 300 + 30 = 330 secondes. Durée de l’intervalle : 330 - 120 = 210 secondes. 210 secondes correspondent à 3 minutes et 30 secondes. Le repère de début est 2:00. Le repère de fin est 5:30.

Après un visionnage manuel de ce cours fictif, le libellé est `explains_definition`. La note sur les éléments observés indique que les bords intérieurs sont montrés. C’est cette étape de visionnage qui confirme le libellé. Le texte des segments ne suffit pas.

L’intervalle de calcul correspond à un autre type de notion. Il va de 330 à 570 secondes. 570 - 330 = 240 secondes. 240 secondes correspondent à 4:00. Son repère de début est 5:30. Attribuez-lui le libellé `worked_example`. Ne le fusionnez pas avec la définition.

Les 4 durées pédagogiques sont de 120, 210, 240 et 150 secondes. 120 + 210 + 240 + 150 = 720 secondes. Ensemble, elles couvrent ce cours fictif. Couvrir toute la durée ne signifie pas que chaque notion est expliquée.

Le mot mesure apparaît aussi à 600 secondes. Ce repère correspond à 10:00. Il se trouve dans l’intervalle consacré aux limites et fait partie d’un avertissement. Conservez-le avec le libellé `mention_only`, ou comme une limite. Ne déplacez pas la définition principale à 600.

Une autre borne fictive nécessite un choix manuel. Un segment commence à 310 secondes et dure 30 secondes. Sa fin est à 310 + 30 = 340 secondes. L’intervalle suivant commence à 330 secondes. 340 - 330 = 10 secondes de chevauchement. Conservez ce chevauchement, ou déplacez la borne après le visionnage. Ne coupez pas les paroles à 330 uniquement pour obtenir une séparation nette.

`scrapedAt` est inconnu ici, car aucune piste réelle n’a été lue. `videoDurationSeconds` est également inconnu. Les 720 secondes proviennent des durées inventées. Elles ne constituent pas un champ de durée vidéo. Ce qui est inconnu reste inconnu.

Calculs temporels pour les 4 intervalles fictifs

Cas de délimitation dans la même fiction

Index vérifié de la fiction

La question sur la largeur conduit à choisir la ligne de 120 à 330. Vous regarderiez à partir de 2:00 et prendriez 5:30 comme fin de la vérification. Vous enregistreriez le lien de début, le repère de fin et la note sur les éléments observés. Cette ligne fictive n’a aucun lien réel. Pour une vidéo réelle, utilisez Partager, puis Démarrer à, ouvrez le lien copié et écrivez ce que vous avez vu.

Cette fiction ne présente aucun résultat mesuré sur la vitesse d’apprentissage. Les nombres servent uniquement à expliquer les calculs sur les intervalles.