ci: generate and publish HTML documentation

.builds/alpine.yml

@@ -20,8 +20,13 @@ packages:
   - xwayland-dev
   - libseat-dev
   - hwdata-dev
+  # for docs
+  - go
+  - zip
 sources:
   - https://gitlab.freedesktop.org/wlroots/wlroots.git
+artifacts:
+  - public.zip
 tasks:
   - setup: |
       cd wlroots
@@ -37,3 +42,16 @@ tasks:
   - tinywl: |
       cd wlroots/tinywl
       make
+  - docs: |
+      go install 'git.sr.ht/~emersion/gyosu@latest'
+      include_dir="$(echo /usr/local/include/wlroots-*)"
+      ~/go/bin/gyosu \
+        -DWLR_USE_UNSTABLE \
+        $(pkg-config --cflags-only-I $(basename "$include_dir")) \
+        -Iwlroots/build/protocol/ \
+        -fexported-symbols='wlr_*' -fexported-symbols='WLR_*' \
+        -ffile-prefix-map="$include_dir/"= \
+        -fsite-name=wlroots \
+        -o public \
+        "$include_dir/wlr/"
+      zip -r ~/public.zip public/

.gitlab-ci.yml

@@ -1,6 +1,7 @@
 include: https://git.sr.ht/~emersion/dalligi/blob/master/templates/multi.yml
 alpine:
   extends: .dalligi
+  pages: true
 archlinux:
   extends: .dalligi
 freebsd: