Align new actions with MSX standards

Apply MSXOrg/docs standards to newly introduced internal actions: use consistent src/main.ps1 entry points, add PowerShell script headers/cmdlet binding, and add action README documentation for discoverability and reuse.

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

Author: MariusStorhaug

.github/actions/Build-ZensicalSite/README.md

@@ -0,0 +1,16 @@
+# Build-ZensicalSite
+
+Builds Zensical documentation site output and normalizes it to `<working-directory>/_site`.
+
+## Inputs
+
+- `WorkingDirectory` (required): Build working directory.
+
+## Usage
+
+```yaml
+- name: Build documentation site with Zensical
+  uses: ./_wf/.github/actions/Build-ZensicalSite
+  with:
+    WorkingDirectory: .
+```

.github/actions/Build-ZensicalSite/action.yml

@@ -11,4 +11,4 @@ runs:
   steps:
     - name: Build documentation site
       shell: pwsh
-      run: '& "${{ github.action_path }}/src/build-zensical-site.ps1" -WorkingDirectory "${{ inputs.WorkingDirectory }}"'
+      run: '& "${{ github.action_path }}/src/main.ps1" -WorkingDirectory "${{ inputs.WorkingDirectory }}"'

.github/actions/Build-ZensicalSite/src/main.ps1

@@ -0,0 +1,32 @@
+#Requires -Version 7.0
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory)]
+    [string]$WorkingDirectory
+)
+
+$ErrorActionPreference = 'Stop'
+
+$resolvedWorkingDirectory = Resolve-Path -Path $WorkingDirectory | Select-Object -ExpandProperty Path
+$siteWorkingDirectory = Join-Path -Path $resolvedWorkingDirectory -ChildPath 'outputs/site'
+$outputSitePath = Join-Path -Path $resolvedWorkingDirectory -ChildPath '_site'
+
+Set-Location -Path $siteWorkingDirectory
+
+if (-not (Test-Path -Path 'zensical.toml')) {
+    throw "No documentation config file found in outputs/site. Expected zensical.toml."
+}
+
+zensical build --config-file 'zensical.toml'
+
+if (Test-Path -Path '_site') {
+    if (Test-Path -Path $outputSitePath) {
+        Remove-Item -Path $outputSitePath -Recurse -Force
+    }
+    Move-Item -Path '_site' -Destination $outputSitePath -Force
+}
+
+if (-not (Test-Path -Path $outputSitePath)) {
+    throw "Expected Zensical output at $outputSitePath but it was not created."
+}

.github/actions/Inject-SiteScripts/README.md

@@ -0,0 +1,18 @@
+# Inject-SiteScripts
+
+Injects JavaScript snippets from `.github/scripts/site-injectors/*.js` into generated HTML files.
+
+## Inputs
+
+- `SitePath` (required): Path to generated site output.
+- `WorkflowPath` (optional, default `_wf`): Path where workflow repository is checked out.
+
+## Usage
+
+```yaml
+- name: Inject shared site scripts
+  uses: ./_wf/.github/actions/Inject-SiteScripts
+  with:
+    SitePath: ./_site
+    WorkflowPath: _wf
+```

.github/actions/Inject-SiteScripts/action.yml

@@ -15,4 +15,4 @@ runs:
   steps:
     - name: Inject site scripts
       shell: pwsh
-      run: '& "${{ github.action_path }}/src/inject-site-scripts.ps1" -SitePath "${{ inputs.SitePath }}" -WorkflowPath "${{ inputs.WorkflowPath }}"'
+      run: '& "${{ github.action_path }}/src/main.ps1" -SitePath "${{ inputs.SitePath }}" -WorkflowPath "${{ inputs.WorkflowPath }}"'

.github/actions/Inject-SiteScripts/src/main.ps1

@@ -0,0 +1,44 @@
+#Requires -Version 7.0
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory)]
+    [string]$SitePath,
+
+    [Parameter(Mandatory)]
+    [string]$WorkflowPath
+)
+
+$resolvedSitePath = Resolve-Path -Path $SitePath -ErrorAction Stop | Select-Object -ExpandProperty Path
+$injectorsPath = Join-Path -Path $env:GITHUB_WORKSPACE -ChildPath "$WorkflowPath/.github/scripts/site-injectors"
+
+if (-not (Test-Path -Path $injectorsPath)) {
+    throw "Expected site injector folder at $injectorsPath but it was not found."
+}
+
+$injectorScripts = Get-ChildItem -Path $injectorsPath -File -Filter '*.js' | Sort-Object -Property Name
+if (-not $injectorScripts) {
+    Write-Host "No site injector scripts found under $injectorsPath."
+    exit 0
+}
+
+Get-ChildItem -Path $resolvedSitePath -Filter '*.html' -Recurse | ForEach-Object {
+    $html = Get-Content -Path $_.FullName -Raw
+    $modified = $false
+
+    foreach ($injectorScript in $injectorScripts) {
+        $marker = "data-psmodule-site-injector=""$($injectorScript.Name)"""
+        if ($html -match [Regex]::Escape($marker)) {
+            continue
+        }
+
+        $scriptContent = Get-Content -Path $injectorScript.FullName -Raw
+        $injectedScript = "<script $marker>$scriptContent</script>"
+        $html = $html -replace '</body>', "$injectedScript`n</body>"
+        $modified = $true
+    }
+
+    if ($modified) {
+        Set-Content -Path $_.FullName -Value $html -NoNewline
+    }
+}

.github/actions/Install-Zensical/README.md

@@ -0,0 +1,14 @@
+# Install-Zensical
+
+Installs the Zensical CLI used by site build workflows.
+
+## Inputs
+
+None.
+
+## Usage
+
+```yaml
+- name: Install Zensical
+  uses: ./_wf/.github/actions/Install-Zensical
+```

.github/actions/Install-Zensical/action.yml

@@ -6,4 +6,4 @@ runs:
   steps:
     - name: Install Zensical CLI
       shell: pwsh
-      run: '& "${{ github.action_path }}/src/install-zensical.ps1"'
+      run: '& "${{ github.action_path }}/src/main.ps1"'

.github/actions/Install-Zensical/src/main.ps1

@@ -0,0 +1,8 @@
+#Requires -Version 7.0
+
+[CmdletBinding()]
+param()
+
+$ErrorActionPreference = 'Stop'
+
+pip install zensical

.github/actions/Structure-Site/README.md

@@ -0,0 +1,18 @@
+# Structure-Site
+
+Prepares site content and writes a resolved Zensical config file under `outputs/site`.
+
+## Inputs
+
+- `WorkingDirectory` (required): Build working directory.
+- `Name` (optional): Module name override.
+
+## Usage
+
+```yaml
+- name: Structure site
+  uses: ./_wf/.github/actions/Structure-Site
+  with:
+    WorkingDirectory: .
+    Name: MyModule
+```