[docs] Install gems with --user-install

.github/workflows/deploy_docs.yaml

@@ -21,20 +21,15 @@ jobs:
 
       - name: Install Asciidoctor and Asciidoctor-Diagram
         run: |
-          gem install asciidoctor asciidoctor-diagram asciidoctor-pdf
-
-      - name: Install dependencies
-        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
+          echo "PATH=$(ruby -r rubygems -e 'puts Gem.user_dir')/bin:$PATH" >> $GITHUB_ENV
 
       - 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 ci
 
       - 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
@@ -26,6 +26,6 @@ guidebook.adoc: docs/*.adoc 00-guidebook.header
 	ls 00-guidebook.header docs/*.adoc | sort | xargs -I {} sh -c 'cat {}; echo ""' > guidebook.adoc
 
 # And the diagrams we can export as PUML using Structurizr CLI
-exported_images: diagrams/*.puml
+exported_images:
 	docker pull structurizr/cli:latest
 	docker run -it --rm -v $$PWD:/usr/local/structurizr structurizr/cli export -workspace workspace.dsl -format plantuml -output diagrams