[gtksourceview: 1/2] CI: Publish docs on GitLab Pages

[Christian Hergert <chergert src gnome org>]

commit ffcf137a9a785369a0370ed1a9a7801e96484fcc
Author: Christopher Davis <brainblasted disroot org>
Date:   Sat Nov 14 23:13:41 2020 -0800

    CI: Publish docs on GitLab Pages
    
    Publish our html docs on GitLab Pages. This is how GTK,
    libhandy, and others have been publishing their nightly
    reference documentation.

 .gitlab-ci.yml | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 7d7f0480..e0c8164e 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -2,6 +2,15 @@ include:
   - project: 'gnome/citemplates'
     file: 'flatpak/flatpak_ci_initiative.yml'
 
+stages:
+    - test
+    - docs
+    - deploy
+
+variables:
+    FEDORA_DEPS:
+        meson vala gtk4-devel ninja-build pkgconf clang gobject-introspection-devel gtk-doc vulkan-headers 
docbook-style-xsl docbook-dtds
+
 flatpak:
     image: 'registry.gitlab.gnome.org/gnome/gnome-runtime-images/gnome:master'
     variables:
@@ -12,3 +21,31 @@ flatpak:
         APP_ID: "org.gnome.GtkSourceView.TestWidget"
     extends: ".flatpak"
 
+reference:
+    image: fedora:rawhide
+    stage: docs
+    needs: []
+    variables:
+        MESON_FLAGS: "-Dwerror=true --buildtype=release"
+    script:
+        - dnf update -y --nogpgcheck
+        - dnf install -y --nogpgcheck $FEDORA_DEPS
+        - mkdir -p pfx/
+        - meson ${MESON_FLAGS} --prefix=${PWD}/pfx -Dgtk_doc=true -Dgir=false _build
+        - ninja -C _build install
+        - mkdir -p _reference/
+        - mv pfx/share/gtk-doc/html/gtksourceview-5.0 _reference/
+    artifacts:
+        paths:
+            - _reference
+
+pages:
+    stage: deploy
+    needs: ['reference']
+    script:
+        - mv _reference public/
+    artifacts:
+        paths:
+            - public
+    only:
+        - master