Pages job in .gitlab-ci.yml: Permit more artifact paths than just `public`
This came up in #660 (closed) and I had to figure out the issue myself earlier today at work.
The automatic deploy job for GitLab Pages only happens if the pages
job has the public
path in its artifacts. Various SSGs output to build/ or output/ or public_html/ or similar arbitrary paths and although the requirement for the path to be public
is documented, it's very easy to miss the documentation.
The public/ part of the path is stripped anyway, so I'd suggest always creating the pages deploy job with a build or test job called pages, and making it a requirement that exactly one directory - of any name - is listed in the artifacts section. If more than one directory is in the toplevel, the deploy can be failed with a clear error to make discovering the problem easier.