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

[Carlos Garnacho <carlosg src gnome org>]

commit 1d41c23269d08541fe73b0b35d34a8cb6699885a
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 | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index ec84f34..25b2d01 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,33 @@ 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
+  only:
+    - master