Commit d053b7b1 authored by Niels De Graef's avatar Niels De Graef

Auto-deploy documentation on master

After this commit, you can find the latest version of the Folks
documentation on

* https://gnome.pages.gitlab.gnome.org/folks/devhelp/folks/index.htm
* https://gnome.pages.gitlab.gnome.org/folks/gtkdoc/folks/

Fixes #109
parent 9b421ddc
Pipeline #186279 passed with stages
in 10 minutes and 46 seconds
......@@ -2,6 +2,7 @@ image: fedora:latest
stages:
- build
- deploy
build-folks:
stage: build
......@@ -13,10 +14,10 @@ build-folks:
dbus-glib-devel evolution-data-server-devel glib2-devel
gobject-introspection-devel libgee-devel libxml2-devel meson ninja-build
python3-dbusmock readline-devel redhat-rpm-config telepathy-glib-devel
telepathy-glib-vala tracker-devel vala
telepathy-glib-vala tracker-devel vala valadoc gtk-doc
dbus-daemon # FIXME: dbus-broker breaks the CI, see https://github.com/bus1/dbus-broker/issues/145
script:
- meson _build
- meson _build -Ddocs=true
- ninja -C _build
- bash +x ./.gitlab-ci/run-tests.sh
artifacts:
......@@ -28,3 +29,25 @@ build-folks:
- "_build/config.h"
- "_build/meson-logs"
- "_build/${CI_JOB_NAME}-report.xml"
- "_build/docs"
pages:
stage: deploy
dependencies:
- build-folks
script:
# Devhelp (Vala API)
- mkdir -p public/devhelp
- mv _build/docs/devhelp/* public/devhelp
# Gtk-doc (C API)
- >
for f in folks folks-dummy folks-eds folks-telepathy; do
mkdir -p public/gtkdoc/$f
# We're only interested in the generated HTML here
mv _build/docs/gtkdoc/$f/html/* public/gtkdoc/$f
done
artifacts:
paths:
- public
only:
- master
......@@ -35,6 +35,10 @@ separate translation infrastructure instead. More info can be found at the
## More information
libfolks has its own web page on https://wiki.gnome.org/Projects/Folks.
The latest version of the documentation is alo published online by our CI to
the GitLab Pages of our repository. You can find the documentation for both the
[Vala API] as well as the [C API].
To discuss issues with developers and other users, you can post to the [GNOME
discourse] instance or join [#contacts] on irc.gnome.org.
......@@ -48,4 +52,6 @@ libfolks is released under the LGPL, version 2.1. See `COPYING` for more info.
[issue tracker]: https://gitlab.gnome.org/GNOME/folks/issues
[translation project wiki page]: https://wiki.gnome.org/TranslationProject/
[GNOME Discourse]: https://discourse.gnome.org
[Vala API]: https://gnome.pages.gitlab.gnome.org/folks/devhelp/folks/index.htm
[C API]: https://gnome.pages.gitlab.gnome.org/folks/gtkdoc/folks/
[#contacts]: irc://irc.gnome.org/contacts
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment