[docs] Project guides in PDF format

Peter Matulis peter.matulis at canonical.com
Mon Mar 29 23:47:24 UTC 2021


I changed the testenv to 'pdf-docs' and the build is still being skipped.

Do I need to submit a PR to have this [1] set to 'false'?

[1]:
https://opendev.org/openstack/openstack-zuul-jobs/src/commit/01746b6df094c25f0cd67690b44adca0fb4ee1fd/zuul.d/jobs.yaml#L970

On Mon, Mar 29, 2021 at 5:56 PM Jeremy Stanley <fungi at yuggoth.org> wrote:

> On 2021-03-29 16:34:16 -0400 (-0400), Peter Matulis wrote:
> [...]
> > For my local web server, the resulting HTML has an icon with this
> > download link: http://<domain>//doc-charm-deployment-guide.pdf
> >
> > Which doesn't work.
> >
> > How do I fix that? And especially, how do I get Zuul to do it?
> [...]
>
> Looking at the console for the docs build on your change, it seems
> to be skipping PDF building in the run phase because of this check:
>
> <URL:
> https://opendev.org/openstack/openstack-zuul-jobs/src/commit/01746b6df094c25f0cd67690b44adca0fb4ee1fd/roles/build-pdf-docs/tasks/main.yaml#L3
> >
>
> Your change uses deploy-guide-pdf as its tox testenv instead of the
> default "pdf-docs" value set by the build-pdf-docs role. You could
> override it in a vars block within a custom job, but probably easier
> to adjust your tox.ini to what the standard
> build-openstack-deploy-guide job expects. Alternatively, you might
> adjust the job definition here, maybe it was an oversight (I don't
> immediately spot any examples of projects publishing PDFs with that
> job specifically, though my search was far from complete):
>
> <URL:
> https://opendev.org/openstack/openstack-zuul-jobs/src/commit/01746b6df094c25f0cd67690b44adca0fb4ee1fd/zuul.d/jobs.yaml#L962-L970
> >
>
> --
> Jeremy Stanley
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20210329/1d8668f8/attachment.html>


More information about the openstack-discuss mailing list