Editing Wiki.tetrain.com Upgrade Plan (section)

== 8. Post-handover: YouTube video embed restoration (2026-07-25) ==

Discovered as part of the separate <code><nowiki>Wiki Pages Cleaning</nowiki></code> project's content audit: dropping <code><nowiki>HTML5video</nowiki></code> during the migration (Section 6) broke every pre-existing YouTube embed on the wiki — 149 embeds across 44 pages, all internal KT/training recordings and client-architecture walkthroughs. <code><nowiki>TimedMediaHandler</nowiki></code> doesn't cover this use case (it's for self-hosted uploaded video files, not embedding external YouTube links), so this wasn't actually fixed by the original migration decision.

* '''Platform fix''': installed the third-party <code><nowiki>EmbedVideo</nowiki></code> extension (<code><nowiki>StarCitizenTools/mediawiki-extensions-EmbedVideo</nowiki></code> — not Wikimedia/Gerrit-hosted, no <code><nowiki>REL1_43</nowiki></code> branch, cloned default branch, confirmed <code><nowiki>extension.json</nowiki></code> supports MediaWiki ≥1.29.0). Patched a MediaWiki-1.43-incompatibility in <code><nowiki>EmbedVideo.hooks.php</nowiki></code> (core <code><nowiki>ParserOutput::addModules()</nowiki></code>/<code><nowiki>addModuleStyles()</nowiki></code> now require strict <code><nowiki>array</nowiki></code> typing; EmbedVideo was passing bare strings) — two one-line fixes, verified via a scratch test page with <code><nowiki>$wgShowExceptionDetails</nowiki></code> temporarily enabled, reverted after. Loaded via <code><nowiki>wfLoadExtension('EmbedVideo')</nowiki></code> in <code><nowiki>LocalSettings.php</nowiki></code>. New embed syntax: <code><nowiki>{{#ev:youtube|VIDEO_ID|640}}</nowiki></code>, replacing the dead <code><nowiki><HTML5video></nowiki></code> tag.
* '''Content fix''': for every one of the 149 embeds, retrieved the video's actual YouTube transcript (via browser automation — auto-captions, not audio playback) and wrote an accurate summary paragraph published directly under each embed on its wiki page. Quality varies with source audio: most got full detailed summaries; ~25 are explicitly flagged <code><nowiki>[VERY POOR TRANSCRIPT QUALITY]</nowiki></code> or <code><nowiki>[PARTIAL TRANSCRIPT]</nowiki></code> where ASR/audio quality only allowed a partial or topic-level summary — flagged rather than guessed. 5 videos are outright inaccessible and flagged as such: 1 private, 4 removed by YouTube (3 for harassment/bullying policy, 1 general ToS violation — all 4 removals landed on the same <code><nowiki>Training_2022_Linux_team</nowiki></code> page, worth raising with whoever owns that YouTube account since repeated strikes risk the account itself). 2 duplicate-content pairs identified and cross-referenced instead of re-summarized. All findings are written directly into the paragraphs published on the wiki, so they're visible to anyone reading the page, not just in this doc.
* '''Publish mechanism''': pulled current wikitext per page via <code><nowiki>php maintenance/run.php getText.php "<title>"</nowiki></code>, replaced each <code><nowiki><HTML5video>...</HTML5video></nowiki></code> tag with the <code><nowiki>{{#ev:...}}</nowiki></code> embed plus a <code><nowiki>'''Video summary:'''</nowiki></code> paragraph, applied via <code><nowiki>php maintenance/run.php edit.php -u Admin -b --nocreate "<title>"</nowiki></code> (stdin). Note: most of these 44 "pages" are actually <code><nowiki>Category:</nowiki></code>-namespace pages being used to hold real content (a pre-existing wiki quirk, not introduced by this work) — titles needed the correct namespace prefix (<code><nowiki>Category:</nowiki></code>, or <code><nowiki>Help:</nowiki></code> for one outlier, <code><nowiki>Editing</nowiki></code>) to resolve correctly; a plain-namespace title lookup silently reports "page does not exist" otherwise.
* '''Verified''': DB sweep confirms zero leftover <code><nowiki><HTML5video></nowiki></code> tags across all 44 pages; spot-checked in-browser that embeds render as real <code><nowiki><iframe></nowiki></code> elements (not just wikitext), including the largest page (50 videos, first/last IDs both confirmed rendering correctly).