CODEWITHSUNDEEP
python-sphinxrestructuredtextrst2pdf
Culip
Culip

Reputation: 589

Sphinx rst2pdf and role directives

In a reStructuredText on Sphinx 2.x, I want to put a content that changes depending on the output format.

In any source document, say, index.rst, add the following lines:

.. role:: pdf(raw)
   :format: pdf

.. role:: latex(raw)
   :format: latex

.. role:: html(raw)
   :format: html

.. |foo| replace::
   :pdf:`PDF!`
   :latex:`LaTeX!`
   :html:`HTML!`

I am |foo|

I expect it shows "I am HTML!" when the output format is in HTML, "I am LaTeX!" if it's LaTeX (even after converting the product to PDF via pdflatex) and "I am PDF!" if it's PDF.

I make the HTML version using make html and I see only "I am HTML!" in a web browser as I expect:

A make html result

Install rst2pdf. Put the following lines in conf.py:

extensions = [
    'rst2pdf.pdfbuilder'
]

pdf_documents = [(
    'index',
    u'testRst2Pdf',
    u'Test Title',
    u'Sarah Author')]

Make the PDF version with

sphinx-build -b pdf ./source/ ./build/

Update. Below is the output. No error. I ran this using WSL 1 (Ubuntu 18.04).

Running Sphinx v2.4.3
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [pdf]: targets for 1 source files that are out of date
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
processing testRst2Pdf...
index
resolving references...
done
writing testRst2Pdf...
done
build succeeded.

I see "I am PDF! LaTeX! HTML!" that includes all the three items.

An rst2pdf result

Is there any way to get either "I am PDF!" or "I am LaTeX!" in the PDF file?

Note.

Upvotes: 2

Views: 833

Answers (1)

Lorna Mitchell
Lorna Mitchell

Reputation: 1986

rst2pdf does not really have conditionals, but you might find the --strip-elements-with-class switch useful? Put the optional pieces into a class name and then if that class doesn't make sense for this format, remove it with the switch.

Manual is here https://rst2pdf.org/static/manual.html#command-line-options and I also blogged (basically a longer version of this first paragraph) about this https://rst2pdf.org/static/manual.html#command-line-options if more information would be useful.

Upvotes: 0

Related Questions