ci: Build docs with Sphinx

Signed-off-by: Jens Reidel <adrian@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/7295>

.ci/build-docs.sh

@@ -10,13 +10,10 @@
 # Install dependencies
 if [ "$(id -u)" = 0 ]; then
 	set -x
-	apk -q add git nodejs npm
+	apk -q add py3-pip make git
 	exec su "${TESTUSER:-build}" -c "sh -e $0"
 fi
 
-npm install antora
-npx antora -v
-
-# FIXME: https://gitlab.com/antora/antora/-/issues/1183
-git clone --depth 1 https://gitlab.postmarketos.org/postmarketOS/handbook
-npx antora --clean antora-test.yml
+cd docs/
+make venv
+make

.gitignore

@@ -66,8 +66,7 @@ instance/
 .scrapy
 
 # Documentation
-docs/_build/
-build/site
+public
 
 # PyBuilder
 target/

.gitlab-ci.yml

@@ -208,17 +208,17 @@ build-docs:
   rules:
     - if: $CI_PIPELINE_SOURCE == "merge_request_event"
       changes:
-        - docs/**/*
+        - docs/**
 
 deploy-docs:
   stage: deploy
   trigger:
-    project: postmarketOS/handbook
+    project: postmarketOS/docs.postmarketos.org
     strategy: depend
   rules:
     - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH && $CI_PROJECT_NAMESPACE == "postmarketOS"
       changes:
-        - docs/**/*
+        - docs/**
 
 auto-update:
   stage: autoupdate

antora-test.yml

@@ -1,16 +0,0 @@
-site:
-  title: Device ports
-  start_page: pmaports::index.adoc
-
-content:
-  sources:
-  - url: .
-    start_path: docs
-    branches: HEAD
-  - url: https://gitlab.postmarketos.org/postmarketOS/handbook
-    branches: HEAD
-
-ui:
-  bundle:
-    url: https://gitlab.postmarketos.org/postmarketOS/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
-    snapshot: true