[docs] Install gems with --user-install

.github/workflows/deploy_docs.yaml

@@ -19,22 +19,20 @@ jobs:
         with:
           python-version: '3.x'  # Ensures Python 3.x is installed, adjust as needed for your project
 
-      - name: Install Asciidoctor and Asciidoctor-Diagram
+      - name: Add .gem to PATH
         run: |
-          gem install asciidoctor asciidoctor-diagram asciidoctor-pdf
-
-      - name: Install dependencies
+          echo "$GITHUB_WORKSPACE/.gem/bin" >> $GITHUB_PATH
+          
+      - name: Install Asciidoctor and Asciidoctor-Diagram
         run: |
-          sudo apt-get update
-          sudo apt-get install -y make  # Install make if not available
+          gem install asciidoctor asciidoctor-diagram asciidoctor-pdf --user-install
 
       - name: Run Make
         run: |
-          cd docs  # Changes directory to where the Makefile is located
-          make ci  # Executes your Make target that builds docs
+          make -C doc
 
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/doc/dist  # Adjusts the path to the build output directory
+          publish_dir: ./doc/dist  # Adjusts the path to the build output directory

doc/Makefile

@@ -7,10 +7,10 @@ start:
 	docker pull structurizr/lite
 	docker run -it --rm -p 8080:8080 -v $(PWD):/usr/local/structurizr structurizr/lite
 
-ci html: dist/readme.html dist/manual.html dist/guidebook.html
+ci html: dist/index.html dist/manual.html dist/guidebook.html
 
-dist/readme.html: readme.adoc
-	asciidoctor readme.adoc -D dist
+dist/index.html: index.adoc
+	asciidoctor index.adoc -D dist
 
 dist/manual.html: manual.adoc
 	asciidoctor manual.adoc -D dist