#6685: [with patch, positive 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: Dan Drake | Author: John Palmieri, Mitesh Patel
Merged: |
---------------------------+------------------------------------------------
Comment(by ddrake):
Oops, I didn't see this before.
Replying to [comment:10 jhpalmieri]:
> 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.
I like this idea, since if Sage can't produce the graphic, we need to
track the image file. How about you find one of your applications and put
up a patch here (to be applied on top of the "proposal" patch), and then
we can ignore the usage-examples patch?
> 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?)
Remote hosting sounds nice, but I'd like to keep the documentation self-
contained, so that one can have everything available while, say, working
on a laptop on an airplane. Although I wouldn't mind if a nonessential bit
was linked, and something in the text said that the bit won't show up
unless you have a network connection. Then one could include, say, a
really big video file. Although all of this is moot if we can't figure out
how to get the links into the docs! (I certainly don't know how.)
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6685#comment:12>
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
-~----------~----~----~----~------~----~------~--~---
