Antora site example

Author: humitos

.readthedocs.yaml

@@ -4,12 +4,11 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3"
-  apt_packages:
-    - tree
-
-sphinx:
-  configuration: docs/conf.py
-
-python:
-  install:
-    - requirements: requirements.txt
+    nodejs: "16"
+  commands:
+    # Commands from https://docs.antora.org/antora/latest/install-and-run-quickstart/
+    - npm i -g -D -E @antora/[email protected] @antora/[email protected]
+    - antora -v
+    - antora --fetch antora-playbook.yml
+    - mkdir $READTHEDOCS_OUTPUT
+    - mv build/site $READTHEDOCS_OUTPUT/html

antora-playbook.yml

@@ -0,0 +1,14 @@
+site:
+  title: Antora Docs
+  start_page: component-b::index.adoc
+content:
+  sources:
+  - url: https://gitlab.com/antora/demo/demo-component-a.git
+    branches: HEAD
+  - url: https://gitlab.com/antora/demo/demo-component-b.git
+    branches: [v2.0, v1.0]
+    start_path: docs
+ui:
+  bundle:
+    url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
+    snapshot: true