[openstack-dev] [infra][docs][i18n][ptls] PDFs for project-specific docs with unified doc builds

Ian Y. Choi ianyrchoi at gmail.com
Tue Oct 3 21:55:27 UTC 2017

Hello Doug,

Thanks a lot for the details on unified docs builds for infra side: Your 
links are really helpful
to better point where to implement.

I have first written it as one WIP spec: 
I would like to discuss it in upcoming Docs team IRC meeting and update 
the spec with feedback :)

With many thanks,


Doug Hellmann wrote on 9/25/2017 10:50 PM:
> [Topic tags added to subject line]
> Excerpts from Ian Y. Choi's message of 2017-09-22 07:29:23 +0900:
>> Hello,
>> "Build PDF docs from rst-based guide documents" [1] was implemented in Ocata
>> cycle, and I have heard that there were a small conversation at the
>> Denver PTG
>> regarding getting PDFs for project-specific docs setup to help translations.
>> In my opinion, it would be a nice idea to extend [1] to project-specific
>> docs with unified doc builds. It seems that unified doc builds have been
>> much enhanced with [2]. Now I think having PDF build functionalities in
>> unified
>> doc builds would be a way to easily have PDFs for project-specific docs.
>> Would someone have any idea on this or help it with some good pointers?
> The job-template for the unified doc build job is in
> http://git.openstack.org/cgit/openstack-infra/project-config/tree/jenkins/jobs/openstack-publish-jobs.yaml#n22
> It uses the "docs" macro, which invokes the script
> http://git.openstack.org/cgit/openstack-infra/project-config/tree/jenkins/scripts/run-docs.sh
> I think we would want to place any new logic for extending the build in
> that script, although we should coordinate any changes with the Zuul v3
> rollout because as part of that I have seen some suggestions to change
> the expected interface for building documentation and we want to make
> sure any changes we make will work with the updated interface.
> Doug
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

More information about the OpenStack-dev mailing list