Skip to content

Commit ac82d31

Browse files
author
Claude-InfoTech
committed
fix(docs): replace undefined video/youtube shortcodes with alternatives
The video and youtube shortcodes are not defined in the documentation theme, causing Hugo build to fail silently in verbose mode. The build reports success but no HTML files are generated. Changes: - getting-started.md: Replace video shortcode with markdown link - user-guide.md: Replace video shortcodes with markdown link and escaped code examples for youtube/video demonstrations Standard markdown links provide same functionality without requiring custom shortcodes. Code examples are properly escaped to show usage without execution. Root cause analysis: - Hugo error: 'template for shortcode "video" not found' - build.sh in verbose mode doesn't check exit codes - Results in deployment of source files instead of HTML This fix resolves the build failure. Recommendations for build.sh improvements will be provided separately. Fixes: info-tech-io/info-tech-io.github.io#9 Related: Epic #2, Child #5
1 parent 64df77e commit ac82d31

2 files changed

Lines changed: 8 additions & 7 deletions

File tree

docs/content/getting-started.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -285,7 +285,8 @@ Reference assets in your content:
285285
![Python Logo](../static/images/python-logo.png)
286286

287287
Watch this introduction video:
288-
{{< video src="../static/videos/intro-python.mp4" >}}
288+
289+
[📹 Introduction to InfoTech CLI](../static/videos/intro-python.mp4)
289290
```
290291

291292
## Validation and Testing

docs/content/user-guide.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -440,14 +440,14 @@ static/
440440
#### Video Integration
441441

442442
```markdown
443-
# Embed videos in content
444-
{{< video src="../static/videos/intro.mp4" poster="../static/images/video-poster.jpg" >}}
443+
# Embed videos in content (as markdown link)
444+
[📹 Introduction Video](../static/videos/intro.mp4)
445445

446-
# YouTube integration
447-
{{< youtube id="dQw4w9WgXcQ" title="Tutorial Video" >}}
446+
# YouTube integration example
447+
{{</* youtube id="dQw4w9WgXcQ" title="Tutorial Video" */>}}
448448

449-
# Video with transcript
450-
{{< video src="../static/videos/lesson1.mp4" transcript="../static/transcripts/lesson1.vtt" >}}
449+
# Video with transcript example
450+
{{</* video src="../static/videos/lesson1.mp4" transcript="../static/transcripts/lesson1.vtt" */>}}
451451
```
452452

453453
## Workflow Optimization

0 commit comments

Comments
 (0)