[geocode-glib/bilelmoussaoui/gi-docgen] CI: build & deploy the docs

[Bilal Elmoussaoui <bilelmoussaoui src gnome org>]

commit 293288a32e3bad9c30aad2a2767ae278107a3b79
Author: Bilal Elmoussaoui <bil elmoussaoui gmail com>
Date:   Fri Jan 14 13:34:25 2022 +0100

    CI: build & deploy the docs

 .gitlab-ci.yml | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index b29b36d..b63b5d4 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -6,7 +6,7 @@ variables:
       glibc-langpack-en
       glib2-devel
       json-glib-devel
-      gtk-doc
+      gi-docgen
       meson
       git
       gcc
@@ -71,3 +71,28 @@ build-fedora-soup3:
     # To build the old version
     - dnf install -y $SOUP2_DEPS
     - check-abi --new-parameters="-Dsoup2=false" ${LAST_ABI_BREAK} $(git rev-parse HEAD)
+
+reference:
+  extends: .build
+  variables:
+    SOUP2_ENABLED: 'true'
+    MESON_FLAGS: "-Dwerror=true --buildtype=release"
+  script:
+    - mkdir -p docs_build/
+    - meson ${MESON_FLAGS} --prefix=${PWD}/docs_build -Denable-gtk-doc=true _build
+    - ninja -C _build install
+    - mkdir -p _reference/
+    - mv docs_build/share/doc/geocode-glib-1/ _reference/
+  artifacts:
+    paths:
+      - _reference
+
+pages:
+  needs: ['reference']
+  script:
+    - mv _reference public/
+  artifacts:
+    paths:
+      - public
+  only:
+    - master