[perl PATCH v4 2/3] gitlab: add a simple job that publishes the API docs as HTML
The Perl modules have inline POD docs. This can be converted to HTML and
published as a GitLab artifact. The rendered HTML is kind of ugly but
improving this is left as an exercise for the future.
Signed-off-by: Daniel P. Berrangé <berrange(a)redhat.com>
---
.gitlab-ci.yml | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 586434e..1099e2b 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -3,6 +3,7 @@ stages:
- prebuild
- containers
- builds
+ - docs
.container_job_template: &container_job_definition
image: docker:stable
@@ -169,3 +170,17 @@ ubuntu-2004-git-build:
<<: *git_build_job_definition
variables:
NAME: ubuntu-2004
+
+apiref:
+ stage: docs
+ image: perl
+ script:
+ - mkdir apiref
+ - perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go lib apiref
+ artifacts:
+ expose_as: 'API Reference'
+ name: 'apiref'
+ when: on_success
+ expire_in: 30 days
+ paths:
+ - apiref
--
2.26.2