#6685: [with patch, needs work] 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):
Here's a patch. It puts a picture in sage/plot/plot.py which you can see
in the reference manual, and with a bit of work, in notebook
introspection: type {{{sage.plot.plot?}}}. The work is: you need to make
a symlink from {{{SAGE_ROOT/doc/en/reference/pictures}}} to
{{{SAGE_ROOT/doc/output/html/en/pictures}}}.
Things still to do:
- do this symlink automatically, say when building the reference manual.
- possibly modify detex in misc/sagedoc.py to remove, or otherwise
modify, ".. image::" directives from command-line help.
- at the moment, the cached version of the docstring (in
.sage/sage_notebook/doc) doesn't have the correct URL for the image -- the
html is scanned and modified each time it's displayed. This shouldn't
slow things down too much, but should we be saving the correct URL?
- lots of testing.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6685#comment:1>
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
-~----------~----~----~----~------~----~------~--~---
