Merge pull request #3 from johnlockejrr/antora

Antora

.gitlab-ci.yml

@@ -191,3 +191,32 @@ docs-stop-surge:
 
   script:
     - surge teardown ${CI_ENVIRONMENT_URL}
+
+antora-generate:
+  stage: build
+  image: registry.gitlab.teklia.com/internal/mkdocs-to-antora:latest
+
+  script:
+    - teklia-antora
+    - teklia-push-antora-ci
+
+  artifacts:
+    paths:
+      - antora
+
+antora-build:
+  stage: deploy
+  image: node:20
+
+  dependencies:
+    - antora-generate
+
+  before_script:
+    - npm install antora
+
+  script:
+    - npx antora antora-playbook.yml
+
+  artifacts:
+    paths:
+      - build

Makefile

@@ -1,4 +1,7 @@
-.PHONY: release
+.PHONY: release antora
+
+antora:
+	npx antora antora-playbook.yml
 
 release:
 	# Grep the version from pyproject.toml, squeeze multiple spaces, delete double and single quotes, get 3rd val.

antora-playbook.yml

@@ -0,0 +1,12 @@
+site:
+  title: Teklia Documentation
+  start_page: pylaia::index.adoc
+content:
+  sources:
+  - url: .
+    branches: HEAD
+    start_path: antora
+ui:
+  bundle:
+    url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
+    snapshot: true

antora/antora.yml

@@ -0,0 +1,5 @@
+name: pylaia
+version: ~
+title: PyLaia
+nav:
+- modules/ROOT/nav.adoc