[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
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:
>> "Build PDF docs from rst-based guide documents"  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  to project-specific
>> docs with unified doc builds. It seems that unified doc builds have been
>> much enhanced with . Now I think having PDF build functionalities in
>> 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
> It uses the "docs" macro, which invokes the script
> 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.
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
More information about the OpenStack-dev