update doc scripts

Author: ashtum

.github/workflows/ci.yml

@@ -1016,37 +1016,119 @@ jobs:
           tag-pattern: 'boost-.*\..*\..*'
 
   antora:
-    name: Antora Docs
-    runs-on: ubuntu-latest
+    needs: [ runner-selection ]
+    strategy:
+      matrix:
+        include:
+          # - { name: Windows, os: windows-latest }
+          - { name: Ubuntu, os: ubuntu-latest }
+          - { name: MacOS, os: macos-latest }
+    name: Antora Docs (${{ matrix.name }})
+    runs-on: ${{ fromJSON(needs.runner-selection.outputs.labelmatrix)[matrix.os] }}
+    defaults:
+      run:
+        shell: bash
     steps:
+      - name: Install packages
+        uses: alandefreitas/cpp-actions/[email protected]
+        with:
+          apt-get: git cmake
+
       - name: Clone Boost.Http.Io
         uses: actions/checkout@v3
+        with:
+          path: http-io-root
 
-      - uses: actions/setup-node@v3
+      - name: Clone Boost.Http.Proto
+        uses: actions/checkout@v3
         with:
-          node-version: 18
+          repository: cppalliance/http_proto
+          path: http-proto-root
+          ref: develop
 
-      - name: Setup C++
-        uses: alandefreitas/cpp-actions/[email protected]
-        id: setup-cpp
+      - name: Clone Boost.Buffers
+        uses: actions/checkout@v3
         with:
-          compiler: clang
-          version: 18
+          path: buffers-root
+          repository: cppalliance/buffers
+          ref: develop
 
-      - name: Build Antora Docs
+      - name: Clone Boost
+        uses: alandefreitas/cpp-actions/[email protected]
+        id: boost-clone
+        with:
+          branch: ${{ (github.ref_name == 'master' && github.ref_name) || 'develop' }}
+          boost-dir: boost-source
+          scan-modules-dir: http-io-root
+          scan-modules-ignore: http_io
+
+      - name: Patch Boost
+        id: patch
+        shell: bash
         run: |
           set -xe
+          pwd
+          ls
+          ls -lah boost-source
+
+          # Identify boost module being tested
+          module=${GITHUB_REPOSITORY#*/}
+          echo "module=$module" >> $GITHUB_OUTPUT
 
-          CXX="/usr/bin/clang++-18"
-          export CXX
-          CC="/usr/bin/clang-18"
-          export CC
+          # Identify GitHub workspace root
+          workspace_root=$(echo "$GITHUB_WORKSPACE" | sed 's/\\/\//g')
+          echo -E "workspace_root=$workspace_root" >> $GITHUB_OUTPUT
 
+          # Remove module from boost-source
+          rm -r "boost-source/libs/$module" || true
+
+          # Copy cached boost-source to an isolated boost-root
+          cp -r boost-source boost-root
+
+          # Set boost-root output
+          cd boost-root
+          boost_root="$(pwd)"
+          boost_root=$(echo "$boost_root" | sed 's/\\/\//g')
+          echo -E "boost_root=$boost_root" >> $GITHUB_OUTPUT
+
+          # Patch boost-root with workspace module
+          cp -r "$workspace_root"/http-io-root "libs/$module"
+          cp -r "$workspace_root"/buffers-root libs/buffers
+          cp -r "$workspace_root"/http-proto-root libs/http_proto
+
+          python3 tools/boostdep/depinst/depinst.py buffers
+          python3 tools/boostdep/depinst/depinst.py http_proto
+          python3 tools/boostdep/depinst/depinst.py http_io
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Setup Ninja
+        if: runner.os == 'Windows'
+        uses: seanmiddleditch/gha-setup-ninja@v5
+
+      - name: Build Antora Docs
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config --global --add safe.directory "$(pwd)"
+          
+          BOOST_SRC_DIR="$(pwd)/boost-root"
+          export BOOST_SRC_DIR
+          cd boost-root/libs/http_io
+          
           cd doc
           bash ./build_antora.sh
+          
+          # Antora returns zero even if it fails, so we check if the site directory exists
+          if [ ! -d "build/site" ]; then
+              echo "Antora build failed"
+              exit 1
+          fi
 
       - name: Create Antora Docs Artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: antora-docs
+          name: antora-docs-${{ matrix.name }}
           path: doc/build/site

doc/antora.yml

@@ -9,8 +9,5 @@ asciidoc:
 nav:
   - modules/ROOT/nav.adoc
 ext:
-  collector:
-    run:
-      command: node doc/generate-files.mjs
-    scan:
-      dir: doc/build/generated-files
+  cpp-reference:
+    config: doc/mrdocs.yml