#6685: [with patch, needs review] include pictures in the reference manual and
notebook introspection
---------------------------+------------------------------------------------
Reporter: jhpalmieri | Owner: tba
Type: enhancement | Status: new
Priority: major | Milestone: sage-4.1.2
Component: documentation | Keywords:
Reviewer: | Author:
Merged: |
---------------------------+------------------------------------------------
Comment(by jhpalmieri):
I would note that we already include some binaries: there are pictures in
the directory SAGE_ROOT/sage/doc/en/bordeaux_2008 (modpcurve.png and
birch.png).
I don't have any strong feelings about the particular picture included in
the patch here; it was included as a test case, and I didn't put a lot of
thought into finding a place in the reference manual where a picture would
help but where that picture couldn't be easily (or quickly) autogenerated.
I certainly have in mind some applications -- triangulations of various
topological spaces, to be used in the simplicial complexes code -- where I
want to include pictures that can not be produced by Sage.
Would it be better if I tried to find a more natural candidate for a
picture? Or (as ddrake suggested), get rid of the binary and just have a
way to include pictures for now? Then we can have a discussion on sage-
devel, or wherever is appropriate, about just how many pictures (and other
media) to include, and what criteria to use.
The idea of remotely hosting media is interesting, but I don't see a way
to embed a remotely hosted image in reST: it looks like the image
directive needs a path, not a URL. (I know how to do it in html,
certainly, but is there Sphinx/reST code which would let us pass a URL to
an image directive?)
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6685#comment:10>
Sage <http://sagemath.org/>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sage-trac" 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/sage-trac?hl=en
-~----------~----~----~----~------~----~------~--~---
