#17498: Pictures in the doc through ".. plot::" directive
-------------------------+-------------------------------------------------
Reporter: | Owner:
ncohen | Status: needs_review
Type: | Milestone: sage-6.5
enhancement | Resolution:
Priority: major | Merged in:
Component: | Reviewers:
documentation | Work issues:
Keywords: | Commit:
Authors: | bfdc22287e8f702e394753f0dbd55896d045282c
Nathann Cohen | Stopgaps:
Report Upstream: N/A |
Branch: |
public/17498 |
Dependencies: |
-------------------------+-------------------------------------------------
Comment (by kcrisman):
Sorry for perhaps being opaque. Here is the usual wish from people:
> Why don't the plots that appear when one evaluates the live
documentation appear already in the static documentation?
Your solution works great (I haven't tried it, but I trust you!) for
adding in a few plots at crucial points in the doc. But in files that
have a ''lot'' of plots, it would make it very wearying to have that
directive in there everywhere, and as you point out size might be a factor
as well (though that hasn't stopped us before).
I didn't think about Sphinx needing to go through doctests to build doc.
That is a good point.
What about this. Could we use a different name for the command, maybe?
Something that like `include_plot_for_doc`? (And hopefully just
`plot.plot().matplotlib()`, though one would want to test this with things
that are already `Graphics` objects as well.)
Edit: I see John's question - `savefig` may work if we have the right
backend, I think.
--
Ticket URL: <http://trac.sagemath.org/ticket/17498#comment:24>
Sage <http://www.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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
