2. Relative links come through to the PDF but are broken.
Can you give an example of a link that didn't work? I suspect this has to do with using HTML links instead of :ref: or :doc: links that Sphinx knows how to resolve.
One of the cases I saw (sorry, don't have the upstream job functional yet) was an RST using the "image::" directive that had a ":target:" param. Our flow diagrams generate links to the actual SVG so you can zoom with your browser. Code is here: https://opendev.org/openstack/octavia/src/branch/master/tools/create_flow_do... That said, the others might be native links of some sort, I will keep that in mind as I try this stuff out. Michael On Tue, Jun 25, 2019 at 7:10 AM Luigi Toscano <ltoscano@redhat.com> wrote:
On Tuesday, 25 June 2019 15:17:50 CEST Doug Hellmann wrote:
Michael Johnson <johnsomor@gmail.com> writes:
I gave this a quick run on Octavia. I did get it to output a PDF with our svg included.
I see a few issues right away (beyond the screens and screens of warnings).
How do we want to collect this feedback? Storyboard stories with a tag?
1. I needed to add the following bindeps: librsvg2-bin [doc platform:dpkg] fonts-freefont-otf [doc platform:dpkg]
We should add those globally in the job definition, and optionally in the project bindep file.
2. Relative links come through to the PDF but are broken.
Can you give an example of a link that didn't work? I suspect this has to do with using HTML links instead of :ref: or :doc: links that Sphinx knows how to resolve.
I think I've seen this issue while testing the generation locally for Sahara:
LaTeX Warning: Hyper reference `user/hadoop-swift::doc' on page 6 undefined on input line 368. (and many others similar warnings)
The example above comes from https://opendev.org/openstack/sahara/src/branch/ master/doc/source/intro/overview.rst
To get more information on how to enable swift support see :doc:`../user/hadoop-swift`.
The generate document does not contain any hyperlink, but the replaced text is correct.
-- Luigi