Add Antora files

Author: austek

.github/workflows/antora-deploy.yml

@@ -28,10 +28,11 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '20'
+          cache: 'npm'
       - name: Install Dependencies
-        run: npm ci
+        run: npm install
       - name: Generate Site
-        run: npx antora antora-playbook.yml
+        run: npx antora --fetch antora-playbook.yml
       - name: Upload Artifacts
         uses: actions/upload-pages-artifact@v3
         with:

Makefile

@@ -1,7 +1,7 @@
 ROOT_DIR=$(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
 
 # Rule to build everything after cleaning
-all:	install	clean	ui	antora
+all:	install	clean build serve
 
 # Rule to install dependencies
 install:
@@ -13,12 +13,14 @@ clean:
 	rm -rf build
 
 # Rule to build the Antora documentation
-antora:
+build:
 	@echo "Building documentation"
 	cd $(ROOT_DIR) && npm i
 	cd $(ROOT_DIR) && npx antora --fetch local-antora-playbook.yml
-	cd $(ROOT_DIR) && npx http-server build/site -c-1
-	@echo "Antora site is up"
+
+serve:
+	@echo "Serving documentation"
+	cd $(ROOT_DIR) && npx serve build/site
 
 # Rule to show help message
 help:

README.adoc

@@ -9,5 +9,5 @@ This is an https://antora.org/[Antora] documentation website, available at https
 
 == Usage
 
-. `make preview` to launch a "live preview" version of the documentation.
+. `make serve` to launch a "live preview" version of the documentation.