#17498: Pictures in the doc through ".. plot::" directive
-------------------------+-------------------------------------------------
       Reporter:         |        Owner:
  ncohen                 |       Status:  needs_work
           Type:         |    Milestone:  sage-6.5
  enhancement            |   Resolution:
       Priority:  major  |    Merged in:
      Component:         |    Reviewers:
  documentation          |  Work issues:
       Keywords:         |       Commit:
        Authors:         |  361f9a8a79aa51fa1f0d39dc08be0a379fb9b30a
  Nathann Cohen          |     Stopgaps:
Report Upstream:  N/A    |
         Branch:         |
  public/17498           |
   Dependencies:         |
  #17508                 |
-------------------------+-------------------------------------------------

Comment (by ncohen):

 Yo !

 > - This was already discussed in comments [comment:27] and [comment:28]:
 there should be a way to turn this feature on/off from the `sage
 -docbuild` and the `make doc` commands, since some binaries need to stay
 small.

 I do not know how to do that. At first I thought that it would be
 impossible without rewriting matplotlib's plot directive, but then it
 seems that it accepts a 'nofigs' option to do just that. I have no idea
 how to change its value, however (we cannot touch the file directly, it is
 not Sage code)

 > - The new `sphinx_plot` function is not documented nor tested.

 Well, it is not even a function but a string. And I do not see what you
 want me to test, the function returns no output.

 ({{{sage -coverage}}} does not report the function)

 > Concerning the discussion about the syntax, a possibility which could
 make syntax more uniform (hence easier to remember) could be to have a
 similar syntax as in passing options to the doctests, e.g.

 It would be nice, but I have no idea how to do that you want of me. Do you
 ?

 I also expect that we cannot ask Sphinx to do that unless the doctests are
 in some kind of environment (like ".. PLOT")

 Nathann

--
Ticket URL: <http://trac.sagemath.org/ticket/17498#comment:43>
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.

Reply via email to