Skip to content

Instantly share code, notes, and snippets.

@alfredodeza
Last active February 2, 2024 18:47
Show Gist options
  • Save alfredodeza/7fb5c667addb1c6963b9 to your computer and use it in GitHub Desktop.
Save alfredodeza/7fb5c667addb1c6963b9 to your computer and use it in GitHub Desktop.
pdf output from sphinx with rst2pdf
1. Install rst2pdf
- use your package manager (or)
- pip install rst2pdf (or)
- easy_install rst2pdf
2. Add rst2pdf to the list of extensions in conf.py
extensions = ['rst2pdf.pdfbuilder']
This list will be empty if you accepted the defaults when the project was setup. If not, just append 'rst2pdf.pdfbuilder' to the list.
3. Add a pdf_documents variable to conf.py
pdf_documents = [('index', u'rst2pdf', u'Sample rst2pdf doc', u'Your Name'),]
# index - master document
# rst2pdf - name of the generated pdf
# Sample rst2pdf doc - title of the pdf
# Your Name - author name in the pdf
4. Generate pdf
sphinx-build -b pdf source build/pdf
The generated pdf will be in the build/pdf directory.
@johnthagen
Copy link

To track a Python 3-compatible release for rst2pdf, see this issue.

@the-vampiire
Copy link

brilliant man. thank you for the guide.

@saileshkush95
Copy link

how can i add button or link to generate pdf, in sphinx generated document instead of using terminal

@alfredodeza
Copy link
Author

how can i add button or link to generate pdf, in sphinx generated document instead of using terminal

You can't

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment