A tool to add diagrams to sphinx docs

[Albert-Jan Roskam]

> Subject: Re: A tool to add diagrams to sphinx docs
> From: irmen.NOSPAM at xs4all.nl
> Date: Fri, 1 Apr 2016 18:26:48 +0200
> To: python-list at python.org
> 
> On 1-4-2016 17:59, George Trojan - NOAA Federal wrote:
> > What graphics editor would you recommend to create diagrams that can be
> > included in sphinx made documentation? In the past I used xfig, but was not
> > happy with font quality. My understanding is the diagrams would be saved in
> > a .png file and I should use an image directive in the relevant .rst file.
> > 
> > George
> > 
> 
> I've used .png successfully for a few images in my sphinx docs.
> However if you're concerned with font quality, a better option is perhaps to use a
> vector format like SVG instead. You can create them using a tool like Inkskape or
> Illustrator. I haven't tried to use .svg in sphinx myself yet but I guess it simply
> embeds/links it into the resulting html so a recent web browser should display them just
> fine.
I used .svg for dependency graphs made with snakefood. Looked good in html, though they essily get too detailed. The .rst:

.. figure:: images/my_image.svg    :width: 100%