Version module catalog templates

Store legacy catalog layout as v1 templates, move current layout to v2 templates, and render catalog from v2 templates by default.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/actions/update-index/src/Helper.psm1

@@ -128,6 +128,24 @@ function Update-MDSection {
     }
 }
 
+function Get-TemplateContent {
+    <#
+        .SYNOPSIS
+        Reads a template file as raw text.
+
+        .DESCRIPTION
+        Loads a UTF-8 template file from disk and returns the complete content as a string.
+    #>
+    [OutputType([string])]
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)]
+        [string] $Path
+    )
+
+    Get-Content -Path $Path -Raw
+}
+
 function Get-PropertyValue {
     <#
         .SYNOPSIS
@@ -640,6 +658,13 @@ function Update-ModuleList {
         $Repos = Show-RepoList
     }
 
+    $moduleCatalogTemplateVersion = 'v2'
+    $moduleCatalogTemplateFolder = Join-Path (Join-Path $PSScriptRoot '..') 'templates\module-catalog'
+    $moduleCatalogRowTemplatePath = Join-Path $moduleCatalogTemplateFolder "$moduleCatalogTemplateVersion-row.html"
+    $moduleCatalogTableTemplatePath = Join-Path $moduleCatalogTemplateFolder "$moduleCatalogTemplateVersion-table.html"
+    $moduleCatalogRowTemplate = Get-TemplateContent -Path $moduleCatalogRowTemplatePath
+    $moduleCatalogTableTemplate = Get-TemplateContent -Path $moduleCatalogTableTemplatePath
+
     $moduleRepos = $Repos | Where-Object {
         $_.Type -eq 'Module' -and $_.Owner -eq 'PSModule'
     } | Sort-Object Name
@@ -701,32 +726,22 @@ function Update-ModuleList {
         }
         New-ModuleCatalogPage -Path $modulePagePath -ModuleData $moduleData
 
-        $moduleTableRows += @"
-    <tr>
-        <td><a href="$modulePageRelativeLink" title="$titleSummary">$name</a></td>
-        <td><code>$version</code></td>
-        <td><code>$processReference</code><br><sub>$processStatus</sub></td>
-        <td><a href="https://github.com/$owner/$name/issues">$issues</a></td>
-        <td><a href="https://github.com/$owner/$name/pulls">$pullRequests</a></td>
-        <td><a href="https://github.com/$owner/$name/stargazers">$stars</a></td>
-    </tr>
-"@
+        $moduleTableRow = $moduleCatalogRowTemplate
+        $moduleTableRow = $moduleTableRow.Replace('{{ MODULE_PAGE_LINK }}', $modulePageRelativeLink)
+        $moduleTableRow = $moduleTableRow.Replace('{{ TITLE_SUMMARY }}', $titleSummary)
+        $moduleTableRow = $moduleTableRow.Replace('{{ NAME }}', $name)
+        $moduleTableRow = $moduleTableRow.Replace('{{ VERSION }}', $version)
+        $moduleTableRow = $moduleTableRow.Replace('{{ PROCESS_REFERENCE }}', $processReference)
+        $moduleTableRow = $moduleTableRow.Replace('{{ PROCESS_STATUS }}', $processStatus)
+        $moduleTableRow = $moduleTableRow.Replace('{{ OWNER }}', $owner)
+        $moduleTableRow = $moduleTableRow.Replace('{{ ISSUES }}', [string]$issues)
+        $moduleTableRow = $moduleTableRow.Replace('{{ PULL_REQUESTS }}', [string]$pullRequests)
+        $moduleTableRow = $moduleTableRow.Replace('{{ STARS }}', [string]$stars)
+        $moduleTableRows += $moduleTableRow.TrimEnd()
+        $moduleTableRows += [Environment]::NewLine
     }
 
-    $moduleTable = @"
-
-<table>
-    <tr>
-        <th width="24%">Name</th>
-        <th width="12%">Version</th>
-        <th width="24%">ProcessVersion</th>
-        <th width="10%">Issues</th>
-        <th width="10%">PRs</th>
-        <th width="10%">Stars</th>
-    </tr>
-$moduleTableRows</table>
-
-"@
+    $moduleTable = $moduleCatalogTableTemplate.Replace('{{ ROWS }}', $moduleTableRows.TrimEnd())
 
     Update-MDSection -Path '.\src\docs\Modules\Catalog\index.md' -Name 'MODULE_CATALOG' -Content $moduleTable
 }

.github/actions/update-index/templates/module-catalog/v1-row.html

@@ -0,0 +1,11 @@
+    <tr>
+        <td><a href="https://github.com/{{ OWNER }}/{{ NAME }}">{{ NAME }}</a></td>
+        <td>{{ DESCRIPTION }}
+            <br>
+            <a href="https://github.com/{{ OWNER }}/{{ NAME }}/issues">Issues</a> |
+            <a href="https://github.com/{{ OWNER }}/{{ NAME }}/pulls">PRs</a> |
+            <a href="https://github.com/{{ OWNER }}/{{ NAME }}/stargazers">Stars</a> |
+            <a href="https://www.powershellgallery.com/packages/{{ NAME }}/">PS Gallery</a>
+        </td>
+        <td><code>{{ VERSION }}</code></td>
+    </tr>

.github/actions/update-index/templates/module-catalog/v1-table.html

@@ -0,0 +1,9 @@
+
+<table>
+    <tr>
+        <th width="10%">Name</th>
+        <th width="80%">Description</th>
+        <th width="10%">Version</th>
+    </tr>
+{{ ROWS }}</table>
+

.github/actions/update-index/templates/module-catalog/v2-row.html

@@ -0,0 +1,8 @@
+    <tr>
+        <td><a href="{{ MODULE_PAGE_LINK }}" title="{{ TITLE_SUMMARY }}">{{ NAME }}</a></td>
+        <td><code>{{ VERSION }}</code></td>
+        <td><code>{{ PROCESS_REFERENCE }}</code><br><sub>{{ PROCESS_STATUS }}</sub></td>
+        <td><a href="https://github.com/{{ OWNER }}/{{ NAME }}/issues">{{ ISSUES }}</a></td>
+        <td><a href="https://github.com/{{ OWNER }}/{{ NAME }}/pulls">{{ PULL_REQUESTS }}</a></td>
+        <td><a href="https://github.com/{{ OWNER }}/{{ NAME }}/stargazers">{{ STARS }}</a></td>
+    </tr>

.github/actions/update-index/templates/module-catalog/v2-table.html

@@ -0,0 +1,12 @@
+
+<table>
+    <tr>
+        <th width="24%">Name</th>
+        <th width="12%">Version</th>
+        <th width="24%">ProcessVersion</th>
+        <th width="10%">Issues</th>
+        <th width="10%">PRs</th>
+        <th width="10%">Stars</th>
+    </tr>
+{{ ROWS }}</table>
+