feat: https://psturtle.com/CONTRIBUTING ( Fixes #187 )

Author: StartAutomating

psturtle.com/CONTRIBUTING.html.ps1

@@ -0,0 +1,61 @@
+<#
+.SYNOPSIS
+    Project Contribution Guide
+.DESCRIPTION
+    Contributing to the Project
+.NOTES
+    The contribution guide for the Project
+#>
+param(
+# We can provide the repository url by hard-coding it, 
+# or it can be provided in site or page metadata.
+# If we do not provide either, we can also look at the `$gitHubEvent`
+[uri]
+$RepositoryUrl,
+
+# We can provide the path by hard-coding it, or it can provided in site or page metadata.
+[string]
+$ContributingPath = '../CONTRIBUTING.md'
+)
+
+# Push into this location, in case we are building this file interactively.
+if ($PSScriptRoot) { Push-Location $PSScriptRoot}
+
+if (-not $RepositoryUrl) {
+    if ($gitHubEvent.repository.html_url) {
+        $repositoryUrl = $gitHubEvent.repository.html_url -as [uri]
+    } else {
+        return
+    }
+}
+
+# Get my own help
+$myHelp = Get-Help $MyInvocation.MyCommand.ScriptBlock.File
+if ($myHelp) {
+    # If we have page metadata
+    if ($page -is [Collections.IDictionary]) {
+        # Replace 'Project' in the title with the url, to make the title and description more helpful
+        $page.Title = $myHelp.SYNOPSIS -replace 'Project', { 
+            $RepositoryUrl.Segments[-1] -replace '/'
+        }
+        $page.Description = $myHelp.Description.text -join [Environment]::NewLine -replace 'The Project', {
+            $RepositoryUrl.Segments[-1] -replace '/'
+        }
+    }
+
+    # If we have notes, replace the project with our name
+    $myNotes = $myHelp.alertSet.alert.text -join [Environment]::NewLine -replace 'The Project', {
+        $RepositoryUrl.Segments[-1] -replace '/'
+    }
+    if ($myNotes) {
+        # and convert our notes from markdown.
+        (ConvertFrom-Markdown -InputObject $myNotes).Html
+    }
+}
+
+if (Test-Path $ContributingPath) {
+    ConvertFrom-Markdown -Path $ContributingPath | 
+        Select-Object -ExpandProperty HTML
+}
+
+if ($PSScriptRoot) { Pop-Location }