[Docutils-users] HTML embed tag for SVG images?

[Will D. <ma...@wi...>]

Hi,

Emailing this list as suggested in the rst docs[1]:

I created an SVG image for an architecture diagram to include in my
sphinx-generated python docs. The graphic has clickable elements that direct to
the relevant class documentation pages.

Naively, I assumed I could just embed the image with image:: directive but I
found that in my browser (upt-to-date Firefox) using SVG images via HTML <img>
tag does not work for hyperlinks within the SVG.

Instead I discovered that if I use the HTML5 <embed> tag, the SVG becomes
clickable again. So my question is whether there exists some method other than
using raw HTML output to include the image in a reStructuredText page?

It's also annoying that sphinx now doesn't know about my image file to copy it
into the generated output, but I guess that bit is OT for this list.

Would appreciate any advice on how best to handle SVGs. A single href target for
the entire SVG is sadly of no use in my case.


Thanks,

-Will


[1]
http://docutils.sourceforge.net/docs/ref/rst/directives.html#raw-data-pass-through