On Thu, Mar 07, 2019 at 07:12:29AM -0800, kcrisman wrote:
> >
> > http://doc.sagemath.org/html/en/reference/repl/sage/repl/ipython_kernel/interact.html
> > http://doc.sagemath.org/html/en/prep/Quickstarts/Interact.html
> >
> >
> Thanks; I knew about the second one, since I wrote it :-) but the first one 
> is good to have on hand.
> 
> Unfortunately, that means the only really complete documentation for 
> interact is still in something like Dima's
> 
> file:///mnt/opt/Sage/sage-dev/local/share/doc/sagenb/notebook/interact.html 
> 
> Harald, is there some equivalent to this possible on the website?  Google 
> may otherwise have this old stale one around forever.

It is perfectly possible to link all these 
file:///mnt/opt/Sage/sage-dev/local/share/doc/sagenb/notebook/interact.html 

in the main Reference manual index.rst file; e.g the following
--------------------------------------------------------------------------
--- a/src/doc/en/reference/index.rst
+++ b/src/doc/en/reference/index.rst
@@ -15,6 +15,7 @@ User Interface
 * :doc:`Command Line Interface (REPL) <repl/index>`
 * For the Jupyter notebook interface, visit `its documentation 
<https://jupyter-notebook.readthedocs.io/en/latest/notebook.html>`_.
 * For the legacy notebook interface, which is no longer actively maintained, 
visit the `source repository <https://github.com/sagemath/sagenb>`_.
+* `SageNB </mnt/opt/Sage/sage-dev/local/share/doc/sagenb/index.html>`_

 Graphics
 ========
--------------------------------------------------------------------------

provides this. It's annoying that one must put full paths to the files
there, and not relative ones (cause one cannot get above "sphinx root"
with the relative links :-( )

I searched in vain for a Sphinx solution to this---it's really silly
that one cannot do things like 
`SageNB <$SAGE_LOCAL/share/doc/sagenb/index.html>`_

A good solution should be via autoconf then. We'll have index.rst.in
template to be filled in. I've opened #27495 to handle this.

Dima

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at https://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to