[mutter/bilelmoussaoui/docs] CI: Build and deploy documentations

[Bilal Elmoussaoui <bilelmoussaoui src gnome org>]

commit 0bc607db74b9e14f3cc2eb02bd17bf8110b20816
Author: Bilal Elmoussaoui <bil elmoussaoui gmail com>
Date:   Tue May 24 11:17:56 2022 +0000

    CI: Build and deploy documentations
    
    A first step towards better documentations of Mutter
    and it internal libraries

 .gitlab-ci.yml | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 3a9b3441ea..8e648c0252 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -9,6 +9,7 @@ stages:
  - build
  - test
  - analyze
+ - docs
  - deploy
 
 variables:
@@ -45,6 +46,9 @@ variables:
       dnf builddep -y wayland-protocols --setopt=install_weak_deps=False &&
       dnf builddep -y kernel --setopt=install_weak_deps=False &&
 
+      # For docs
+      dnf install -y gi-docgen &&
+
       # For Xwayland
       dnf builddep -y xorg-x11-server-Xwayland --setopt=install_weak_deps=False &&
       dnf install -y 'pkgconfig(fontutil)' &&
@@ -485,3 +489,31 @@ dist-mutter-tarball:
       - build/meson-dist/$CI_PROJECT_NAME-$CI_COMMIT_TAG.tar.xz
   rules:
     - if: '$CI_COMMIT_TAG'
+
+reference:
+  extends:
+    - .fdo.distribution-image@fedora
+    - .mutter.fedora:35@x86_64
+  stage: docs
+  needs:
+    - build-fedora-container@x86_64
+  script:
+    - meson . build --werror -Ddocs=true -Dtests=false
+    - ninja -C build
+    - mkdir references
+    - mv build/doc/reference/{cally/cally,clutter/clutter,cogl/cogl,cogl-pango/cogl-pango,meta/meta} 
references/
+  artifacts:
+    expire_in: 1 week
+    paths:
+      - references
+
+pages:
+  stage: deploy
+  needs: ['reference']
+  script:
+    - mv references public/
+  artifacts:
+    paths:
+      - public
+  rules:
+    - if: ($CI_DEFAULT_BRANCH == $CI_COMMIT_BRANCH)