✨ feat(theBrain): new script for formatting YouTube thumbnails in TheBrain Notes

This commit introduces a new PowerShell script that scans for YouTube thumbnail URLs in the `Notes.md` files located under the Brain data folder. The script then backs up and modifies the `Notes.md` files to retrieve the YouTube thumbnails from the YouTube API instead of using local storage. This ensures that the YouTube thumbnails are always up-to-date and accessible.

The script utilizes the `Get-ChildItem` and `Select-String` cmdlets to search for `Notes.md` files and match the YouTube thumbnail URL pattern. It performs various actions for each matching result, including creating backups, moving local image files, modifying the YouTube thumbnail URLs, and saving the modified `Notes.md` files.

This new script enhances the functionality of the project by automating the process of updating YouTube thumbnails in TheBrain Notes.

Author: chriskyfung

theBrain/Format-TheBrainNotesYouTubeThumbnail.ps1

@@ -0,0 +1,78 @@
+<#
+.SYNOPSIS
+  Format YouTube thumbnails in TheBrain Notes by replacing local image URLs
+  withto web URLs.
+
+.DESCRIPTION
+  Scan for YouTube thumbnail URLs in the Notes.md files located under the Brain
+  data folder, then back up and modify the Notes.md files to retrieve the
+  YouTube thumbnails from the YouTube API instead of using local storage.
+
+.PARAMETER None
+
+.INPUTS
+  None.
+
+.OUTPUTS
+  None
+
+.EXAMPLE
+  PS C:\> .\Format-TheBrainNotesYouTubeThumbnail.ps1
+
+.NOTES
+  Version:        1.0.0
+  Author:         chriskyfung
+  License:        GNU GPLv3 license
+#>
+
+#Requires -Version 2.0
+
+# Enable Verbose output
+[CmdletBinding()]
+
+$ErrorActionPreference = "Stop"
+
+# Look up the Notes.md files that locate under the Brain data folder and contain the YouTube thumbnail URLs.
+$BrainFolder = . "$PSScriptRoot\Get-TheBrainDataDirectory.ps1"
+$SubFolders = Get-ChildItem -Directory -Path $BrainFolder -Exclude 'Backup'
+$BackupFolder = Join-Path $BrainFolder 'Backup'
+
+$Filename = 'Notes.md'
+$FilenameWithoutExtension = [System.IO.Path]::GetFileNameWithoutExtension($Filename)
+$FileExtension = [System.IO.Path]::GetExtension($Filename)
+
+Write-Host 'Scanning YouTube thumbnail URLs in Brain Notes...'
+
+$MatchInfo = Get-ChildItem -Path $SubFolders -Filter $Filename -Recurse | Select-String '\[\!\[(?<ALT>.*)\]\(\.data\/md-images\/(?<IMAGEFILE>.+)\.jpg(?<width>.*)\)\]\(https:\/\/youtu.be\/(?<VIDEOID>.+?)\)' -List
+
+# For each matching result
+Write-Host 'Backing up and modifying Brain Notes...'
+ForEach ($Match in $MatchInfo) {
+  $FilePath = $Match.Path | Convert-Path # FilePath of the Notes.md file
+  $ParentFolder = Split-Path -Path $FilePath -Parent # Path of the parent folder
+  $BackupLocation = $ParentFolder.Replace($BrainFolder, $BackupFolder)
+  # Backup the Notes.md file
+  $Timestamp = (Get-Item $FilePath).LastWriteTime.ToString('yyyyMMdd_HHmmss')
+  $BackupFilename = "$FilenameWithoutExtension-$Timestamp$FileExtension~"
+  $BackupPath = Join-Path $BackupLocation $BackupFilename
+  Copy-Item -Path $FilePath -Destination (New-Item -ItemType File -Force -Path $BackupPath) -Force
+  # Backup the md-image file
+  $LocalImageFile = $Match.Matches[0].Groups['IMAGEFILE'].Value
+  $LocalImagePath = Convert-Path "$ParentFolder/.data/md-images/$LocalImageFile.jpg"
+  $BackupImagePath = $LocalImagePath.Replace($BrainFolder, $BackupFolder)
+  Move-Item -Path $LocalImagePath -Destination (New-Item -ItemType File -Force -Path $BackupImagePath) -Force
+  Write-Verbose "Created --> '$BackupPath'"
+  # Amend the link of the YouTube thumbnail with UTF8 encoding
+  $Pattern = $Match.Matches.Value
+  $AltText = $Match.Matches[0].Groups['ALT'].Value
+  $VideoId = $Match.Matches[0].Groups['VIDEOID'].Value
+  $NewString = '[![{0}](https://img.youtube.com/vi/{1}/maxresdefault.jpg)](https://www.youtube.com/watch?v={1})' -f $AltText, $VideoId
+  (Get-Content $FilePath -Encoding UTF8).Replace($Pattern, $NewString) | Set-Content $FilePath -Encoding UTF8
+  Write-Verbose "Modified --> '$FilePath'"
+}
+
+Write-Host ('Finished: {0} file(s) found' -f $MatchInfo.Length) # Output the number of files found
+
+$MatchInfo | Format-Table Path | Out-Host # Output the path of the files found
+
+Return