John H Palmieri wrote:
> So for notebook introspection, we need to replace the old path with
> the appropriate URL; then the issue is that the images may get renamed
> when the docs are built.  For example, I was imagining that the
> "pictures" directory would have subdirectories, for example, one from
> each Sage module.  If there are files "pictures/homology/simplex.png"
> and "pictures/geometry/simplex.png", each used in docstrings somewhere
> in the Sage library, then these would be copied to something like
> "reference/_images/simplex.png" and "reference/_images/simplex1.png",

What if we searched for and saved all of the image directives before
running Sphinx and inserted the correct paths afterward?  We could
verify that the file base names agree on some metric.

Alternatively, we could extract a path from the "**File:**" field
inserted by server.support.docstring() or source_code().  But this could
make it difficult to include images from other modules.

With custom Sphinx directives, we could do the same for, e.g., movies
and PDF files.  It might take a "bit" more work to insert interactive
output.

Is there an open ticket for this topic?


--~--~---------~--~----~------------~-------~--~----~
To post to this group, send an email to [email protected]
To unsubscribe from this group, send an email to 
[email protected]
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to