[glib/ci-api-reference] ci: Add a stage for building the API reference

[Emmanuele Bassi <ebassi src gnome org>]

commit de3dd2d9f48a93c5a7009cb23944711a00d9fb93
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Thu Mar 28 14:44:39 2019 +0000

    ci: Add a stage for building the API reference
    
    We can generate the GLib API references and publish them, so they are
    always up to date.

 .gitlab-ci.yml | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index e2afb12dd..b3b29acda 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -3,6 +3,7 @@ image: registry.gitlab.gnome.org/gnome/glib/master:v11
 stages:
   - build
   - coverage
+  - docs
   - deploy
 
 cache:
@@ -189,12 +190,29 @@ coverage:
     - bash -x ./.gitlab-ci/coverage-docker.sh
   coverage: '/^\s+lines\.+:\s+([\d.]+\%)\s+/'
 
+api-reference:
+  stage: docs
+  except:
+    - tags
+  script:
+    - meson -Dgtk_doc=true _build .
+    - ninja -C _build
+    - ninja -C _build glib-doc gobject-doc gio-doc
+    - mv _build/docs/reference/glib/html _docs/glib
+    - mv _build/docs/reference/gobject/html _docs/gobject
+    - mv _build/docs/reference/gio/html _docs/gio
+  artifacts:
+    name: "glib-apidocs-${CI_JOB_NAME}-${CI_COMMIT_REF_NAME}"
+    paths:
+      - _docs
+
 pages:
   stage: deploy
   only:
     - master
   script:
-    - mv _coverage/ public/
+    - mv _coverage/ public/coverage/
+    - mv _docs/ public/docs/
   artifacts:
     paths:
       - public