[libmediaart/wip/carlosg/ci-templates: 3/3] ci: Deploy API documentation to gitlab pages

[Carlos Garnacho <carlosg src gnome org>]

commit 19cffb053d191b7c95eb324c9cbbcd3b956418c4
Author: Carlos Garnacho <carlosg gnome org>
Date:   Sat May 22 15:33:16 2021 +0200

    ci: Deploy API documentation to gitlab pages
    
    Since library-web is in such sorry state, it makes sense to publish
    the API in some other way that does not rely on it.

 .gitlab-ci.yml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 8ec959a..c45672e 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -13,6 +13,8 @@ variables:
 stages:
   - prepare
   - test
+  - docs
+  - deploy
 
 .libmediaart.fedora@common:
   variables:
@@ -140,3 +142,31 @@ test-ubuntu-rolling:
   needs:
     - build-ubuntu-container@x86_64
   <<: *test
+
+documentation:
+  extends:
+    - .fdo.distribution-image@fedora
+    - .libmediaart.fedora:rawhide@x86_64
+  needs:
+    - build-fedora-container@x86_64
+  stage: docs
+  script:
+    - meson setup _build -Dgtk_doc=true .
+    - meson compile -C _build
+    - mv _build/docs/html _reference
+  artifacts:
+    paths:
+      - _reference
+
+pages:
+  extends:
+    - .fdo.distribution-image@fedora
+    - .libmediaart.fedora:rawhide@x86_64
+  stage: deploy
+  script:
+    - mv _reference/ public/
+  artifacts:
+    paths:
+      - public
+  needs:
+    - documentation