Try jekyll-relative-links

Author: keveleigh

Pipelines/Scripts/prepare-pages.ps1

@@ -21,9 +21,9 @@ Copy-Item -Path (Join-Path $ProjectRoot "images" "*") -Destination $images -Recu
 Copy-Item -Path (Join-Path $ProjectRoot "org.mixedrealitytoolkit.standardassets" "Textures" "Logos" "MRTK_Logo_White.png") -Destination $images -Force
 Copy-Item -Path (Join-Path $ProjectRoot "org.mixedrealitytoolkit.standardassets" "Textures" "Logos" "IconMRTKLogo.png") -Destination $images -Force
 
-$licenseDestination = Join-Path $docs "LICENSE.md"
-# Create home page, add front matter, and copy content
-New-Item -Path $licenseDestination -ItemType File -Force -Value @"
+$destination = Join-Path $docs "LICENSE.md"
+# Create page, add front matter, and copy content
+New-Item -Path $destination -ItemType File -Force -Value @"
 ---
 title: License
 nav_order: 1
@@ -32,19 +32,45 @@ parent: Home
 
 
 "@
-Add-Content -Path $licenseDestination -Value (Get-Content -Path (Join-Path $ProjectRoot "LICENSE.md"))
+Add-Content -Path $destination -Value (Get-Content -Path (Join-Path $ProjectRoot "LICENSE.md"))
 
-$indexDestination = Join-Path $docs "index.md"
-# Create home page, add front matter, and copy content
-New-Item -Path $indexDestination -ItemType File -Force -Value @"
+$destination = Join-Path $docs "MAINTAINERS.md"
+# Create page, add front matter, and copy content
+New-Item -Path $destination -ItemType File -Force -Value @"
+---
+title: Maintainers
+nav_order: 2
+parent: Home
+---
+
+
+"@
+Add-Content -Path $destination -Value (Get-Content -Path (Join-Path $ProjectRoot "MAINTAINERS.md"))
+
+$destination = Join-Path $docs "GOVERNANCE.md"
+# Create page, add front matter, and copy content
+New-Item -Path $destination -ItemType File -Force -Value @"
+---
+title: Governance
+nav_order: 3
+parent: Home
+---
+
+
+"@
+Add-Content -Path $destination -Value (Get-Content -Path (Join-Path $ProjectRoot "GOVERNANCE.md"))
+
+$destination = Join-Path $docs "index.md"
+# Create page, add front matter, and copy content
+New-Item -Path $destination -ItemType File -Force -Value @"
 ---
 title: Home
 nav_order: 1
 ---
 
 
 "@
-Add-Content -Path $indexDestination -Value (Get-Content -Path (Join-Path $ProjectRoot "README.md"))
+Add-Content -Path $destination -Value (Get-Content -Path (Join-Path $ProjectRoot "README.md"))
 
 # Convert GitHub admonitions to just-the-docs syntax for in-place docs files
 # We leave them checked-in so they render correctly in the GitHub repo, but we convert them for Pages

docs/Gemfile

@@ -2,3 +2,4 @@ source 'https://rubygems.org'
 
 gem "jekyll", "~> 4.4.1"
 gem "just-the-docs", "0.10.1"
+gem 'jekyll-relative-links', '~> 0.7.0'

docs/Gemfile.lock

@@ -1,24 +1,20 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
-    base64 (0.2.0)
-    bigdecimal (3.1.9)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
     colorator (1.1.0)
     concurrent-ruby (1.3.5)
-    csv (3.3.2)
+    csv (3.3.5)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
-    ffi (1.17.1-arm64-darwin)
-    ffi (1.17.1-x86_64-linux-gnu)
+    ffi (1.17.2-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
-    google-protobuf (4.29.3-arm64-darwin)
-      bigdecimal
-      rake (>= 13)
-    google-protobuf (4.29.3-x86_64-linux)
+    google-protobuf (4.33.1-x86_64-linux-gnu)
       bigdecimal
       rake (>= 13)
     http_parser.rb (0.8.0)
@@ -45,13 +41,15 @@ GEM
       webrick (~> 1.7)
     jekyll-include-cache (0.2.1)
       jekyll (>= 3.7, < 5.0)
-    jekyll-sass-converter (3.0.0)
-      sass-embedded (~> 1.54)
+    jekyll-relative-links (0.7.0)
+      jekyll (>= 3.3, < 5.0)
+    jekyll-sass-converter (3.1.0)
+      sass-embedded (~> 1.75)
     jekyll-seo-tag (2.8.0)
       jekyll (>= 3.8, < 5.0)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
-    json (2.9.1)
+    json (2.16.0)
     just-the-docs (0.10.1)
       jekyll (>= 3.8.5)
       jekyll-include-cache
@@ -68,30 +66,28 @@ GEM
     mercenary (0.4.0)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    public_suffix (6.0.1)
-    rake (13.2.1)
+    public_suffix (7.0.0)
+    rake (13.3.1)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rexml (3.4.0)
-    rouge (4.5.1)
+    rexml (3.4.4)
+    rouge (4.6.1)
     safe_yaml (1.0.5)
-    sass-embedded (1.83.4-arm64-darwin)
-      google-protobuf (~> 4.29)
-    sass-embedded (1.83.4-x86_64-linux-gnu)
-      google-protobuf (~> 4.29)
+    sass-embedded (1.94.2-x86_64-linux-gnu)
+      google-protobuf (~> 4.31)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.6.0)
-    webrick (1.9.1)
+    webrick (1.9.2)
 
 PLATFORMS
-  arm64-darwin
   x86_64-linux-gnu
 
 DEPENDENCIES
   jekyll (~> 4.4.1)
+  jekyll-relative-links (~> 0.7.0)
   just-the-docs (= 0.10.1)
 
 BUNDLED WITH
-   2.5.9
+   2.4.20

docs/_config.yml

@@ -3,12 +3,17 @@ description: MRTK3 is the third generation of the Mixed Reality Toolkit for Unit
 theme: just-the-docs
 color_scheme: dark
 
-include: [ 'CONTRIBUTING.md', 'docs/LICENSE.md', '**/CHANGELOG.md' ,'GOVERNANCE.md']
-
 url: https://mixedrealitytoolkit.github.io/MixedRealityToolkit-Unity/
 logo: "/images/MRTK_Logo_White.png"
 favicon_ico: "/images/IconMRTKLogo.png"
 
+plugins:
+  - jekyll-relative-links
+relative_links:
+  enabled: true
+  collections: true
+include: [ 'CONTRIBUTING.md', 'LICENSE.md', '**/CHANGELOG.md' ,'GOVERNANCE.md']
+
 defaults:
   - scope:
       path: "" # an empty string here means all files in the project