Create docusaurus site & update doc build workflow

.github/workflows/docs-build.yml

@@ -17,37 +17,17 @@ jobs:
       with:
         persist-credentials: false
 
-    - name: Setup ruby
-      uses: ruby/setup-ruby@efbf473cab83af4468e8606cc33eca9281bb213f # v1.256.0
+    - uses: actions/setup-node@v4
       with:
-        ruby-version: '3.3'
-        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-        cache-version: 0 # Increment this number if you need to re-download cached gems
-        working-directory: ./docs
+        node-version: 20.x
 
-    - name: Setup pages
-      id: pages
-      uses: actions/configure-pages@v5
-
-    - name: Build with Jekyll
-      run: bundle exec jekyll build --baseurl "$PAGES_PATH"
-      working-directory: ./docs
-      env:
-        PAGES_PATH: ${{ steps.pages.outputs.base_path }}
-
-    - name: Check links
+    - name: Build website
       run: |
-        bundle exec htmlproofer \
-          --disable-external \
-          --assume_extension '.html' \
-          --swap-urls "^${PAGES_PATH}/:/" \
-          ./_site
-      working-directory: ./docs
-      env:
-        PAGES_PATH: ${{ steps.pages.outputs.base_path }}
+        cd website
+        npm ci
+        npm run build
 
-    - name: Upload site assets as artifact
-      id: deployment
+    - name: Upload website artifact
       uses: actions/upload-pages-artifact@v3
       with:
-        path: ./docs/_site
+        path: ./website/build

docs/imagecreator/README.md

@@ -1,6 +1,7 @@
 ---
 title: Image Creator
 nav_order: 3
+sidebar_position: 3
 has_toc: false
 ---
 

docs/imagecreator/api/api.md

@@ -2,6 +2,7 @@
 parent: Image Creator
 title: API
 nav_order: 1
+sidebar_position: 1
 ---
 
 # Image Creator API

docs/imagecreator/api/cli.md

@@ -3,6 +3,7 @@ title: Command line
 parent: API
 grand_parent: Image Creator
 nav_order: 3
+sidebar_position: 3
 ---
 
 # Image Creator command line

docs/imagecreator/api/configuration/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Configuration",
+    "position": 1
+}

docs/imagecreator/api/configuration/configuration.md

@@ -3,6 +3,7 @@ parent: API
 grand_parent: Image Creator
 title : Configuration
 nav_order: 2
+sidebar_position: 1
 has_toc: false
 ---
 

docs/imagecreator/developer-guide.md

@@ -1,6 +1,7 @@
 ---
 parent: Image Creator
 nav_order: 5
+sidebar_position: 5
 ---
 
 # Developers guide

docs/imagecreator/quick-start/quick-start.md

@@ -2,6 +2,7 @@
 title: Quick Start
 parent: Image Creator
 nav_order: 1
+sidebar_position: 1
 
 ---
 

docs/imagecustomizer/README.md

@@ -1,6 +1,7 @@
 ---
 title: Image Customizer
 nav_order: 2
+sidebar_position: 2
 has_toc: false
 ---
 

docs/imagecustomizer/api/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "API",
+    "position": 4
+}

docs/imagecustomizer/api/api.md

@@ -2,6 +2,7 @@
 parent: Image Customizer
 title: API
 nav_order: 4
+sidebar_position: 4
 ---
 
 # Image Customizer API

docs/imagecustomizer/api/cli/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Command line",
+    "position": 1
+}

docs/imagecustomizer/api/cli/cli.md

@@ -3,6 +3,7 @@ title: Command line
 parent: API
 grand_parent: Image Customizer
 nav_order: 1
+sidebar_position: 1
 ---
 
 # Image Customizer command line

docs/imagecustomizer/api/cli/inject-files.md

@@ -3,6 +3,7 @@ title: inject-files
 parent: Command line
 ancestor: Image Customizer
 nav_order: 1
+sidebar_position: 1
 ---
 
 # inject-files subcommand

docs/imagecustomizer/api/configuration/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Configuration",
+    "position": 2
+}

docs/imagecustomizer/api/configuration/configuration.md

@@ -3,6 +3,7 @@ title: Configuration
 parent: API
 grand_parent: Image Customizer
 nav_order: 2
+sidebar_position: 2
 has_toc: false
 ---
 

docs/imagecustomizer/api/cosi.md

@@ -2,6 +2,7 @@
 parent: API
 grand_parent: Image Customizer
 nav_order: 3
+sidebar_position: 3
 ---
 
 # Composable Operating System Image (COSI) Specification

docs/imagecustomizer/concepts/README.md

@@ -2,6 +2,7 @@
 parent: Image Customizer
 title: Concepts
 nav_order: 3
+sidebar_position: 3
 has_toc: false
 ---
 

docs/imagecustomizer/concepts/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Concepts",
+    "position": 3
+}

docs/imagecustomizer/concepts/imagehistory.md

@@ -1,6 +1,7 @@
 ---
 parent: Concepts
 nav_order: 1
+sidebar_position: 1
 ---
 
 # Image History

docs/imagecustomizer/concepts/iso.md

@@ -2,6 +2,7 @@
 parent: Concepts
 title: ISO Support
 nav_order: 3
+sidebar_position: 3
 ---
 
 # Image Customizer Live OS ISO Support

docs/imagecustomizer/concepts/liveos.md

@@ -2,6 +2,7 @@
 parent: Concepts
 title: Live OS
 nav_order: 2
+sidebar_position: 2
 ---
 
 # Image Customizer Live OS Support

docs/imagecustomizer/concepts/pxe.md

@@ -2,6 +2,7 @@
 parent: Concepts
 title: PXE Support
 nav_order: 4
+sidebar_position: 4
 ---
 
 # Image Customizer PXE Support

docs/imagecustomizer/concepts/sysext.md

@@ -1,6 +1,7 @@
 ---
 parent: Concepts
 nav_order: 7
+sidebar_position: 7
 ---
 
 # System extension

docs/imagecustomizer/concepts/things-to-avoid.md

@@ -1,6 +1,7 @@
 ---
 parent: Concepts
 nav_order: 5
+sidebar_position: 5
 ---
 
 # Things to avoid

docs/imagecustomizer/concepts/verity/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Verity Image Recommendations",
+    "position": 6
+}

docs/imagecustomizer/concepts/verity/cloud-init.md

@@ -1,6 +1,7 @@
 ---
 title: cloud-init
 parent: Verity Image Recommendations
+sidebar_position: 2
 ---
 
 # Verity and cloud-init

docs/imagecustomizer/concepts/verity/networking.md

@@ -1,6 +1,7 @@
 ---
 title: Networking
 parent: Verity Image Recommendations
+sidebar_position: 1
 ---
 
 # Verity and Networking

docs/imagecustomizer/concepts/verity/sshd.md

@@ -1,6 +1,7 @@
 ---
 title: sshd
 parent: Verity Image Recommendations
+sidebar_position: 4
 ---
 
 # Verity and sshd

docs/imagecustomizer/concepts/verity/systemd-growfs-root.md

@@ -1,6 +1,7 @@
 ---
 title: systemd-growfs-root
 parent: Verity Image Recommendations
+sidebar_position: 5
 ---
 
 # Verity and systemd-growfs-root

docs/imagecustomizer/concepts/verity/verity.md

@@ -1,6 +1,7 @@
 ---
 parent: Concepts
 nav_order: 6
+sidebar_position: 1
 ---
 
 # Verity Image Recommendations

docs/imagecustomizer/concepts/verity/writable-var.md

@@ -1,6 +1,7 @@
 ---
 title: var Partition
 parent: Verity Image Recommendations
+sidebar_position: 6
 ---
 
 # Verity and `/var` Partition

docs/imagecustomizer/developer-guide.md

@@ -1,6 +1,7 @@
 ---
 parent: Image Customizer
 nav_order: 5
+sidebar_position: 5
 ---
 
 # Developers guide

docs/imagecustomizer/how-to/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "How To",
+    "position": 2
+}

docs/imagecustomizer/how-to/azure-vm/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Create Azure VM",
+    "position": 2
+}

docs/imagecustomizer/how-to/azure-vm/azure-vm.md

@@ -2,6 +2,7 @@
 title: Create Azure VM
 parent: How To
 nav_order: 2
+sidebar_position: 1
 has_toc: false
 ---
 

docs/imagecustomizer/how-to/azure-vm/download-marketplace-image.md

@@ -2,6 +2,7 @@
 title: Download Marketplace Image
 parent: Create Azure VM
 nav_order: 1
+sidebar_position: 2
 has_toc: false
 ---
 

docs/imagecustomizer/how-to/external-repos.md

@@ -2,6 +2,7 @@
 title: Install/Update Packages from External Repos
 parent: How To
 nav_order: 7
+sidebar_position: 2
 ---
 
 # Install/Update Packages from External Repos

docs/imagecustomizer/how-to/how-to.md

@@ -2,6 +2,7 @@
 title: How To
 parent: Image Customizer
 nav_order: 2
+sidebar_position: 1
 ---
 
 # Image Customizer How To Guides

docs/imagecustomizer/how-to/live-iso.md

@@ -2,6 +2,7 @@
 title: Create LiveOS ISO
 parent: How To
 nav_order: 9
+sidebar_position: 3
 ---
 
 # Create a LiveOS ISO and run it in a VM

docs/imagecustomizer/how-to/verity-and-uki.md

@@ -2,6 +2,7 @@
 title: Create Verity and UKI image
 parent: How To
 nav_order: 9
+sidebar_position: 4
 ---
 
 # Create image with both verity and UKI

docs/imagecustomizer/quick-start/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Quick Start",
+    "position": 1
+}

docs/imagecustomizer/quick-start/quick-start-binary.md

@@ -3,6 +3,7 @@ title: Quick Start - Binary
 parent: Quick Start
 grand_parent: Image Customizer
 nav_order: 1
+sidebar_position: 1
 ---
 
 # Using the Image Customizer Binary

docs/imagecustomizer/quick-start/quick-start.md

@@ -2,6 +2,7 @@
 title: Quick Start
 parent: Image Customizer
 nav_order: 1
+sidebar_position: 1
 has_toc: false
 ---
 

docs/imagecustomizer/reference/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Reference",
+    "position": 6
+}

docs/imagecustomizer/reference/building-packages.md

@@ -1,6 +1,7 @@
 ---
 parent: Reference
 nav_order: 1
+sidebar_position: 1
 ---
 
 # Building custom packages

docs/imagecustomizer/reference/clone-rpm-repo.md

@@ -1,6 +1,7 @@
 ---
 parent: Reference
 nav_order: 2
+sidebar_position: 2
 ---
 
 # Cloning an RPM repo