On 2009-03-09, Georg Brandl wrote:
> Cameron Laird schrieb:
>> I have diagrams that are best maintained as vector-based
>> graphics, though. How does Sphinx handle that? Are
>> there Sphinx automations for transformation of SVG to
>> TeX or images embeddable in HTML? Is the Sphinx attitude,
>> "use a browser that supports SVG"? Are there plans for
>> enhancement in this area?
> I had thought about some automatic image conversion in the past
> but since PNG is a nice format for both HTML and PDF output, it
> hasn't been done.
PNG is not the best choice for vector graphics, as it is a bitmap with
fixed resolution. Typically, the resolution on-screen is far less than
what is required for printing (100 vs. 300...600 dpi).
> SVG is another story: Sphinx cannot e.g. provide an SVG renderer
But Sphinx could call a SVG renderer (inkscape, say) if it exists on the
system.
It could also convert PDF to PNG for HTML output so that the source can
be kept in vector format and used by LaTeX.
>> How should I think about maintenance of vector-based graphics within a
>> Sphinx project?
Keep the source in vector format (SVG, PDF or EPS):
SVG
+ can be embedded/linked in HTML and is rendered by a growing number of
web browsers,
- is not recognised by LaTeX.
- converters to PNG or PDF are not always available.
PDF
+ is recognised by LaTeX (with pdfTeX),
+ converters to PNG and EPS are widely available,
- cannot be used inside a HTML page.
EPS
+ is recognised by LaTeX (when exporting to DVI/Postscript)
+ converters to PNG and PDF are widely available,
- cannot be used inside a HTML page.
Günter
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---