- 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?
- 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.
- 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