re-generate descriptive & permalink names

Author: ilg-ul

.github/workflows/build-linux-x64.yml

@@ -27,8 +27,6 @@
 # -----------------------------------------------------------------------------
 
 
-
-
 name: 'Build xPack WineHQ linux-x64'
 
 on:
@@ -68,14 +66,10 @@ on:
         default: 'xpack-development'
 
 jobs:
-
-
   linux-x64-build:
     name: 'linux-x64 wine ${{github.event.inputs.version}} build'
-    timeout-minutes: 5760 # 4 days
+    timeout-minutes: 2880 # 2 days
     runs-on: [self-hosted, linux, x64, xbblix]
-    container:
-      image: ilegeul/debian:amd64-10-xbb-v6.0.0
     defaults:
       run:
         shell: bash
@@ -108,40 +102,20 @@ jobs:
           npm install --location=global xpm@${{github.event.inputs.xpm_version}}
           xpm --version
 
-      - name: 'Install project dependencies'
-        timeout-minutes: 1440
-        run: xpm install --loglevel ${{github.event.inputs.xpm_install_loglevel}} ${{github.event.inputs.xpm_install_options}} -C build-assets
-
       - name: 'Build linux-x64 binaries'
         timeout-minutes: 1440
         run: |
-          xpm install --config linux-x64 --loglevel ${{github.event.inputs.xpm_install_loglevel}} ${{github.event.inputs.xpm_install_options}} -C build-assets
-          xpm run build --config linux-x64 -C build-assets
-
-  linux-x64-upload:
-    name: 'linux-x64 wine ${{github.event.inputs.version}} upload'
-    timeout-minutes: 5760 # 4 days
-    runs-on: [self-hosted, linux, x64, xbblix]
-    defaults:
-      run:
-        shell: bash
-    needs: [linux-x64-build]
-
-    steps:
-      - name: 'Show environment'
-        run: |
-          uname -a
-          lsb_release -sd
-          echo "whoami: $(whoami)"
-          echo "pwd: $(pwd)"
-          ls -lLA
-          env | sort | grep -E '^[^ \t]+='
+          xpm install --loglevel ${{github.event.inputs.xpm_install_loglevel}} ${{github.event.inputs.xpm_install_options}} -C build-assets
+          xpm run docker-prepare --config linux-x64 --loglevel ${{github.event.inputs.xpm_install_loglevel}} ${{github.event.inputs.xpm_install_options}} -C build-assets
+          xpm run docker-build --config linux-x64 -C build-assets
+          ls -l build-assets/build/linux-x64/application
+          ls -l build-assets/build/linux-x64/deploy
 
       - name: Upload platform artefacts
         uses: actions/upload-artifact@v4
         with:
           name: deploy-linux-x64
-          path: ${{github.workspace}}/build/linux-x64/deploy/*
+          path: ${{github.workspace}}/build-assets/build/linux-x64/deploy/*
           overwrite: true
 
       - name: 'Publish pre-release'
@@ -171,7 +145,7 @@ jobs:
   linux-x64-test:
     name: 'linux-x64 wine ${{github.event.inputs.version}} test'
     runs-on: ubuntu-24.04
-    needs: [linux-x64-upload]
+    needs: [linux-x64-build]
 
     steps:
       - name: 'Show environment'
@@ -183,6 +157,7 @@ jobs:
           ls -lLA
           env | sort | grep -E '^[^ \t]+='
 
+      # https://github.com/actions/checkout
       - name: 'Checkout project'
         uses: actions/checkout@v4
         with:
@@ -198,6 +173,3 @@ jobs:
 
       - name: 'Run ${{github.event.inputs.version}} native test'
         run: bash build-assets/scripts/test.sh --image github-actions-ubuntu-latest --version ${{github.event.inputs.version}} --base-url pre-release
-
-
-

.github/workflows/publish-github-pages.yml

@@ -13,10 +13,15 @@
 #
 # -----------------------------------------------------------------------------
 
-# Simple workflow for deploying static content to GitHub Pages
+# https://xpack-dev-tools.github.io/wine-xpack/
+# https://github.com/xpack-dev-tools/wine-xpack/actions/workflows/publish-github-pages.yml
+
+# Workflow for deploying static content to GitHub Pages.
 name: GitHub Pages
 
+# https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
 # https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows
+
 on:
   # Runs on pushes, if all conditions are met:
   push:
@@ -37,27 +42,29 @@ on:
       - 'package.json'
       - 'build-assets/package.json'
 
-  # Allows you to run this workflow manually from the Actions tab
+  # Allows you to run this workflow manually from the Actions tab.
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages.
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow one concurrent deployment
+# Allow one concurrent deployment.
+# https://docs.github.com/en/actions/using-jobs/using-concurrency
 concurrency:
   group: "pages"
   cancel-in-progress: true
 
 jobs:
-  # Single deploy job since we're just deploying
+  # Single deploy job since we're just deploying.
   # https://docs.github.com/en/actions/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners#standard-github-hosted-runners-for-public-repositories
   deploy:
     environment:
       name: github-pages
       url: ${{steps.deployment.outputs.page_url}}
+    # https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners#supported-runners-and-hardware-resources
     runs-on: ubuntu-24.04
 
     steps:
@@ -72,26 +79,29 @@ jobs:
         # https://github.com/actions/setup-node
         uses: actions/setup-node@v4
         with:
+          # Node LTS version.
           node-version: 20
 
       - name: Install dependencies
-        run: npm ci -C website
+        run: (cd website; npm ci)
 
       - name: Build the Docusaurus site
-        run: npm run build -C website
+        run: (cd website; npm run build)
 
       - name: Setup Pages
         # https://github.com/actions/configure-pages
         uses: actions/configure-pages@v5
 
-      - name: Upload artifact
+      - name: Upload Pages artifact
         # https://github.com/actions/upload-pages-artifact
         uses: actions/upload-pages-artifact@v3
         with:
           # Upload entire repository
           path: './website/build'
 
       - name: Deploy to GitHub Pages
-        id: deployment
+        id: deployment # referred by environment above, to get the URL.
         # https://github.com/actions/deploy-pages
         uses: actions/deploy-pages@v4
+        with:
+          artifact_name: github-pages

.gitignore

@@ -154,7 +154,10 @@ build*/
 Thumbs.db
 .DS_Store
 
+tests/top
+
 website/.docusaurus
 website/build
+website/html
 
 # ----- end -----

build-assets/package.json

@@ -10,14 +10,14 @@
   "xpack": {
     "minimumXpmRequired": "0.20.5",
     "devDependencies": {
-      "@xpack-dev-tools/xbb-helper": "^3.1.8"
+      "@xpack-dev-tools/xbb-helper": "^3.1.13"
     },
     "properties": {
       "platforms": "linux-x64",
       "buildFolderRelativePath": "{{'build' | path_join: configuration.name | to_filename | downcase}}",
       "buildFolderRelativePathPosix": "{{'build' | path_posix_join: configuration.name | downcase}}",
       "commandBashBuild": "bash {{properties.dbg}} scripts/build.sh --target {{configuration.name}} --build-folder {{properties.buildFolderRelativePathPosix}}",
-      "xpm-version": "0.18.0",
+      "xpm-version": "0.20.5",
       "xpm-install-loglevel": "info",
       "dbg": ""
     },

package.json

@@ -81,8 +81,9 @@
     "liquidjs": "^10.19.1"
   },
   "topConfig": {
-    "longName": "WineHQ",
-    "shortName": "wine"
+    "descriptiveName": "WineHQ",
+    "permalinkName": "wine",
+    "useSelfHostedRunners": "true"
   },
   "engines": {
     "node": " >=18.0.0"