Build PDF docs from rst-based guide documents
Current RST based OpenStack documents are published on docs.openstack.org as a HTML format.
Building PDF docs from the documents enables readers to save the documents as a file and they can read in offline.
The followings are draft items to be finished:
- identifying requirements of libraries including rst2pdf
- checking tex library compatibility with openstack-infra
- change in Sphinx configuration
- pdf theme
- tox environment for building pdf files
- openstack-infra build job to generate and publish pdf files
- (future) build pdfs from translated documents
Blueprint information
- Status:
- Complete
- Approver:
- Lana
- Priority:
- Low
- Drafter:
- Ian Y. Choi
- Direction:
- Approved
- Assignee:
- Ian Y. Choi
- Definition:
- Approved
- Series goal:
- Accepted for ocata
- Implementation:
- Implemented
- Milestone target:
- None
- Started by
- KATO Tomoyuki
- Completed by
- Alexandra Settle
Related branches
Related bugs
Sprints
Whiteboard
Gerrit topic: https:/
Addressed by: https:/
Adds a spec to build PDFs as Ocata goal
Addressed by: https:/
[WIP] PDF generation test (do not merge please)
Addressed by: https:/
Update content to using Latex from rst2pdf
Gerrit topic: https:/
Addressed by: https:/
Remove unnecessary TODO comment line
Addressed by: https:/
[image-guide] build Image Guide PDF
Addressed by: https:/
[WIP] PDF Theme & style test for arch-design
Addressed by: https:/
[PDF] CartoGothicStd font support using xelatex
Addressed by: https:/
[contributor] Explains how to build PDF files
Addressed by: https:/
[README] Explains how to build PDFs