Programmatically add front matter

Author: keveleigh

Pipelines/Scripts/prepare-pages.ps1

@@ -21,12 +21,34 @@ Get-ChildItem -Path (Join-Path $ProjectRoot "*" "package.json") | ForEach-Object
     }
 
     $packageName = $packageName.Matches[0].Value
+    $packageFriendlyName = (Select-String -Pattern "`"displayName`": `"(.+)`"" -Path $_ | Select-Object -First 1).Matches.Groups[1].Value
     $packagePath = $_.Directory
 
-    Copy-Item -Path (Join-Path $packagePath "README.md") -Destination "./$packageName.md"
-    Copy-Item -Path (Join-Path $packagePath "CHANGELOG.md") -Destination "./$packageName.CHANGELOG.md"
-    Add-Content -Path "./$packageName.md" -Value "
+    # Create README, add front matter, copy content, and add changelog link
+    New-Item -Path "./$packageName.md" -Value @"
+---
+title: $packageFriendlyName
+parent: Packages
+---
+
+
+"@
+    Add-Content -Path "./$packageName.md" -Value (Get-Content -Path (Join-Path $packagePath "README.md"))
+    Add-Content -Path "./$packageName.md" -Value @"
+
 ## Latest changelog
 
-[Changelog](./$packageName.CHANGELOG.md)"
+[Changelog](./$packageName.CHANGELOG.md)
+"@
+
+    # Create CHANGELOG, add front matter, and copy content
+    New-Item -Path "./$packageName.CHANGELOG.md" -Value @"
+---
+title: $packageFriendlyName Changelog
+parent: $packageFriendlyName
+---
+
+
+"@
+    Add-Content -Path "./$packageName.CHANGELOG.md" -Value (Get-Content -Path (Join-Path $packagePath "CHANGELOG.md"))
 }

org.mixedrealitytoolkit.accessibility/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK Accessibility
-parent: Experimental
----
-
 # MRTK Accessibility
 
 Features and subsystem to enable accessibility in MR experiences.

org.mixedrealitytoolkit.audio/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK Audio Effects
-parent: Packages
----
-
 # MRTK Audio Effects
 
 Features to enhance audio in XR experiences.

org.mixedrealitytoolkit.core/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK Core Definitions
-parent: Packages
----
-
 # MRTK Core Definitions
 
 A limited collection of common interfaces and utilities that most MRTK packages share. Most implementations of these interfaces are contained in other packages in the MRTK ecosystem.

org.mixedrealitytoolkit.diagnostics/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK Diagnostics
-parent: Packages
----
-
 # MRTK Diagnostics
 
 Subsystems and utilities for common diagnostic and performance monitoring tasks.

org.mixedrealitytoolkit.tools/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK Tools
-parent: Packages
----
-
 # MRTK Tools
 
 A collection of tools, utilities, and wizards that can be used to create and analyze components for use with MRTK3.

org.mixedrealitytoolkit.uxcomponents.noncanvas/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK UX Components (Non-Canvas)
-parent: Packages
----
-
 # MRTK UX Components (Non-Canvas)
 
 UX component library for 3D UX without Canvas layout. In some cases, non-Canvas UI may offer better performance.

org.mixedrealitytoolkit.uxcomponents/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK UX Components
-parent: Packages
----
-
 # MRTK UX Components
 
 UX library leveraging RectTransform and Canvas for dynamic layout and presentation. Contains prefabs, visuals, controls, and everything to get started building 3D user interfaces for mixed reality.

org.mixedrealitytoolkit.uxcore/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK UX Core
-parent: Packages
----
-
 # MRTK UX Core Scripts
 
 Core interaction and visualization scripts for building MR UI components. Intended to be consumed when building UX libraries. For pre-existing library of components, see the UX Components package.

org.mixedrealitytoolkit.windowsspeech/README.md

@@ -1,8 +1,3 @@
----
-title: MRTK Windows Speech
-parent: Packages
----
-
 # MRTK Windows Speech
 
 Speech subsystem implementation for native Windows speech APIs enables native Windows text-to-speech and speech recognition features, producing events to drive XRI interactions using speech.