On Mon, Mar 19, 2018 at 12:16 PM, Emmanuel Charpentier <[email protected]> wrote: > > > Le lundi 19 mars 2018 11:44:33 UTC+1, Erik Bray a écrit : >> >> This question raised an issue I was not aware of (and didn't see any >> existing tickets for): >> >> https://ask.sagemath.org/question/41592/inside-help-not-processed/# >> >> When viewing docs for Sage objects in the Jupyter Notebook, they are >> just displayed as plain text--this is a major shortcoming over SageNB >> which renders the latex in the online help. >> >> What's worse, in the Notebook the docs are passed through the same >> "de-texification" that is used on the command-line to make some tex >> readable in plain ASCII. There are two issues here: >> >> 1) The de-texification is obviously imperfect. The particular example >> contained \longrightarrow which it didn't know what to do with. >> Easily fixable, but beside the point. It will never be 100% perfect >> (it also looks like it could benefit tremendously from Unicode support >> which has never been added to it). > > > De-texification is *hard* : see the various solutions enumerated here...
Yes... The solution we have is useful; could be improved; but that's a never-ended process. >> 2) It goes without saying that in the Notebook help should be rendered >> by MathJax. It's not clear to me that the Jupyter Notebook actually >> knows that it can/should run MathJax over the help window, but >> currently it does not appear to run MathJax over the help panel (even >> if I explicitly wrap equations in dollar signs or something). > > > It can be done. See for an (approximate) example what do the two available R > Jupyter kernels (respectively IRkernel and Juniper). I'ts only approximate, > since R help pahges use their own sui generis markup (Rd). > > A possibly easier alternative would go the route \LaTeX ==> DVI ==> HTML, as > proposed by the (many) "solutions" proposed there. I'm not sure what you mean here. We already *have* HTML versions of the Sage docs installed with Sage. For example if something like Manifold.diff_form? could return a path to http://doc.sagemath.org/html/en/reference/manifolds/sage/manifolds/differentiable/manifold.html?highlight=diff_form#sage.manifolds.differentiable.manifold.DifferentiableManifold.diff_form and display that in the Notebook's help window, then our job is done :) I'm just not sure if it's possible to do that through Jupyter's API, but I'll have to look at what the R kernels you pointed me to do. -- 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 [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
