Matrix 0.1

.github/workflows/deploy.yml

@@ -0,0 +1,61 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: deploy
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: [$default-branch]
+  # or manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, and cancel any in-progress deployments if a new one is triggered
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  # GitHub Pages use a single job, named deploy.
+  deploy:
+    # By using an environment, we avoid locking
+    environment:
+      name: github-pages
+      # and we can control where it is deployed.
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      # Check out our repository
+      - name: Checkout
+        uses: actions/checkout@main
+        with:
+          # Using fetch-depth: 0 to ensure we get the full history of the repository
+          fetch-depth: 0
+      # Setup GitHub Pages
+      - name: Setup Pages
+        uses: actions/configure-pages@main
+      # To Build Pages in PowerShell, we just call a script      
+      - name: Build Pages
+        # set the shell to pwsh
+        shell: pwsh
+        # and then call any script we would like to build the page.
+        # By default, this can use the same name as the workflow
+        # (in this case, just deploy.ps1)
+        run: . "./deploy.ps1"
+        # This approach makes it easier to logically organize workflow scripts.
+        # We will also map the page_url to an environment variable, so our scripts can access it.
+        env:
+          page_url: ${{ steps.deployment.outputs.page_url }}
+          analytics_id: ${{vars.ANALYTICSID}}
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@main
+        with:
+          # Upload the contents to the GitHub Pages artifact
+          path: './'          
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@main

Build/GitHub/Jobs/BuildMatrix.psd1

@@ -0,0 +1,11 @@
+@{
+    "runs-on" = "ubuntu-latest"    
+    if = '${{ success() }}'
+    steps = @(
+        @{
+            name = 'Check out repository'
+            uses = 'actions/checkout@main'
+        }
+        'RunEZOut'
+    )
+}

Build/GitHub/Steps/PublishTestResults.psd1

@@ -0,0 +1,10 @@
+@{
+    name = 'PublishTestResults'
+    uses = 'actions/upload-artifact@main'
+    with = @{
+        name = 'PesterResults'
+        path = '**.TestResults.xml'
+    }
+    if = '${{always()}}'
+}
+

Build/Matrix.GitHubWorkflow.PSDevOps.ps1

@@ -0,0 +1,18 @@
+#requires -Module PSDevOps
+param(
+    $moduleName = $(
+        $PSScriptRoot | Split-Path | Split-Path -Leaf
+    )
+)
+Import-BuildStep -SourcePath (
+    Join-Path $PSScriptRoot 'GitHub'
+) -BuildSystem GitHubWorkflow
+
+
+Push-Location ($PSScriptRoot | Split-Path)
+New-GitHubWorkflow -Name "Build Module" -On Push,
+    PullRequest, 
+    Demand -Job  TestPowerShellOnLinux, 
+    TagReleaseAndPublish, "Build$moduleName" -OutputPath .\.github\workflows\build.yml
+
+Pop-Location

Build/Matrix.ezout.ps1

@@ -0,0 +1,39 @@
+#requires -Module EZOut
+#  Install-Module EZOut or https://github.com/StartAutomating/EZOut
+$myFile = $MyInvocation.MyCommand.ScriptBlock.File
+$myModuleName = $MyInvocation.MyCommand.Name -replace '\.ezout.ps1$'
+$myRoot = $myFile | Split-Path | Split-Path
+Push-Location $myRoot
+$formatting = @(
+    # Add your own Write-FormatView here,
+    # or put them in a Formatting or Views directory
+    foreach ($potentialDirectory in 'Formatting','Views','Types') {
+        Join-Path $myRoot $potentialDirectory |
+            Get-ChildItem -ea ignore |
+            Import-FormatView -FilePath {$_.Fullname} 
+    }
+)
+
+$destinationRoot = $myRoot
+
+if ($formatting) {
+    $myFormatFilePath = Join-Path $destinationRoot "$myModuleName.format.ps1xml"
+    # You can also output to multiple paths by passing a hashtable to -OutputPath.
+    $formatting | Out-FormatData -Module $MyModuleName -OutputPath $myFormatFilePath
+}
+
+$types = @(
+    # Add your own Write-TypeView statements here
+    # or declare them in the 'Types' directory
+    Join-Path $myRoot Types |
+        Get-Item -ea ignore |
+        Import-TypeView
+
+)
+
+if ($types) {
+    $myTypesFilePath = Join-Path $destinationRoot "$myModuleName.types.ps1xml"
+    # You can also output to multiple paths by passing a hashtable to -OutputPath.
+    $types | Out-TypeData -OutputPath $myTypesFilePath
+}
+Pop-Location

CHANGELOG.html.ps1

@@ -0,0 +1,37 @@
+<#
+.SYNOPSIS
+    CHANGELOG
+.DESCRIPTION
+    Matrix CHANGELOG
+.NOTES
+    Renders the CHANGLOG as html, with links to the repo.
+#>
+param(
+[uri]
+$RepositoryUrl = $(
+    if ($env:GITHUB_REPOSITORY) {
+        "https://github.com/$env:GITHUB_REPOSITORY"
+    } else {
+        "https://github.com/PoshWeb/Matrix"
+    }
+)    
+)
+
+$changelogPath = Join-Path $PSScriptRoot 'CHANGELOG.md'
+
+$changeLog  = Get-Content $changelogPath -Raw
+
+[Regex]::Replace(
+    $changeLog,
+    '#(?<n>\d+)',
+    {
+        param($match)
+        "[$match]($(
+            "$repositoryUrl" + '/issues/' + $match.Groups['n'].Value
+        ))"
+    }   
+) | 
+    ConvertFrom-Markdown | 
+        Select-Object -ExpandProperty Html
+
+

CHANGELOG.md

@@ -0,0 +1,44 @@
+# Matrix
+
+## Matrix 0.1
+
+* Initial Matrix Module (#1)
+* `Matrix.ps1` makes matrices (#2)
+* `Matrix` has a build (#3)
+* `Matrix` extended types
+  * `[Numerics.Matrix3x2]`
+    * `.Points` contains the points in the matrix (#4)
+    * `.CSS` renders the matrix as CSS (#5)
+    * `.MathML` renders the matrix as MathML (#33)
+    * `.Html` renders the matrix as MathML in HTML (#36)
+    * `DefaultDisplay` limits the number of displayed properties (#34)
+  * `[Numerics.Matrix4x4]`
+    * `.Points` contains the points in the matrix (#6)
+    * `.CSS` renders the matrix as CSS (#7)
+    * `.MathML` renders the matrix as MathML (#31)
+    * `.Html` renders the matrix as MathML in HTML (#35)
+    * `DefaultDisplay` limits the number of displayed properties (#32)
+  * `[Numerics.Quaternion]`
+    * `.CSS` renders the matrix as CSS (#12)
+    * `.MathML` renders a quaternion as MathML (#37)
+    * `.Html` renders the matrix as MathML in HTML (#38)
+    * `DefaultDisplay` limits the number of displayed properties (#39)
+* `Matrix` aliases provide CSS Compatibility (#8)
+* `Matrix` has an autogenerated `README.md.ps1` (#10)
+* `Matrix` website demonstrates matrix
+  * `layout.ps1` lays out pages (#16)
+  * `deploy.ps1` deploys the site (#22)
+  * `config.ps1` configures the site (#23)
+  * `/_includes/`
+    * `/_includes/FeatherIcon` includes feather icons (#24)
+    * `/_includes/Palette` includes a palette (#25)
+    * `/_includes/CopyCode` includes a "copy code" button (#26)
+    * `/_includes/Sitemap` includes a sitemap (#27)
+    * `/_includes/Menu` includes a menu (#29)
+  * `/Matrix.html.ps1` is the site root (#14)
+    * `/matrix/css`
+      * `/matrix/css/compatible` shows side by side comparisons (#17)
+      * `/matrix/css/transform` shows some matrix transform examples (#18)
+    * `/matrix/dotnet` explains matrices in DotNet (#19)
+    * `/matrix/svg` shows matrices in SVG (#28)
+    * `/matrix/powershell` shows matrices in PowerShell (#20)