Manage Youtube videos

Managing YouTube Videos for NKD Agility

We synchronise all our YouTube videos to a local folder to publish and link them from our site. At a later date, these posts are updated with enhanced marketing content.

---

Anatomy of a Synced Post

Generated Markdown and Front Matter

Below is an example of a synced post:

---
title: Ep 007 - Running a Live Virtual Classroom
date: 2020-05-02T16:34:05Z
videoId: _bjNHN4PI9s
url: /resources/videos/ep-007-running-a-live-virtual-classroom
canonicalUrl: https://www.youtube.com/watch?v=_bjNHN4PI9s
preview: https://i.ytimg.com/vi/_bjNHN4PI9s/maxresdefault.jpg
duration: 1496
isShort: false
sitemap:
  filename: sitemap.xml
  priority: 0.4
---

{{< youtube _bjNHN4PI9s >}}

# Ep 007 - Running a Live Virtual Classroom

It's important that students in Live Virtual Classrooms are already familiar with the technology used by instructors. We've had success with Microsoft Teams and Mural. This video demonstrates how to connect to both and make the most of the class.

[Watch on YouTube](https://www.youtube.com/watch?v=_bjNHN4PI9s)

---

Updated Markdown and Front Matter

When a post is updated with new content, the following changes are made:

1. Title: Updated to the new marketing title for SEO and branding.
2. Canonical URL: Removed to establish the site as the original source.
3. Aliases: Add the current slug as /resources/videos/{{slug}} to prevent 404 errors.
4. Slug: Updated to match the new title or removed to dynamically generate it from the title.
5. Sitemap Priority: Increased to 0.6 for SEO optimisation.
6. Content: Rewritten to include new, engaging copy.

Note:

• If slug is missing, update url to /resources/videos/:slug and derive the slug from the title.
• Be mindful of adding appropriate aliases when changing titles.

Automated Updates: Sitemap and other metadata, like the last modified date, are automatically refreshed based on Git activity.

Example Updated Post:

---
title: 'Training: A Bridge to Knowledge and Growth'
date: 2024-09-18
resourceTypes: video
layout: video
videoId: _2ZH7vbKu7Y
url: /resources/videos/:slug
slug: training-a-bridge-to-knowledge-and-growth
preview: https://i.ytimg.com/vi/_2ZH7vbKu7Y/maxresdefault.jpg
duration: 412
isShort: false
aliases:
  - /resources/videos/3-key-elements-for-an-agile-leader-to-consider-if-the-team-are-incompetent
  - /resources/training-a-bridge-to-knowledge-and-growth
  - /resources/videos/_2ZH7vbKu7Y
sitemap:
  filename: sitemap.xml
  priority: 0.6
---

{{< youtube _2ZH7vbKu7Y >}}

In any organisation, the skills and knowledge of a team can determine its success or failure. But what happens when a team is identified as deficient? This video explores how to address these gaps through training and continuous learning before resorting to drastic measures.

---

Folder Structure for Each Video

Each video's folder includes the following:

1. index.md: Contains the Markdown and front matter.
2. data.json: Cached YouTube API data to minimise API calls.
3. transcript.*.srt: Transcripts for use in AI tools or other content generation.

Legacy Files (Imported from WordPress)

• wordpress.custom.yaml: Original WordPress post in YAML format.
• wordpress.custom.md.import: Markdown version of the WordPress post.

These legacy files are retained for reference but not actively used.

---

Standard Operating Procedures (SOPs)

Pull New Videos

1. Sync with main.
2. Create a new branch: update-youtube-[date].
3. Ensure $env:google_apiKey is configured.
4. Run .powershell\syncNKDAgilityTV.ps1.
5. Commit changes using opencommit and push to GitHub.
6. Create a PR on GitHub.
7. Preview changes on Preview Site.
8. (Optional) Create a new release.

Update Videos with New Marketing Content

1. Sync with main.
2. Create a new branch: update-marketing-[date].
3. Update the video’s index.md with the latest marketing copy, following the steps outlined in the "Updated Markdown and Front Matter" section.
4. Commit and push changes.
5. Preview updates on the site and validate changes.