[IPython-dev] Absolute Path IPython

Akim Demaille akim at lrde.epita.fr
Mon Oct 27 06:02:22 EDT 2014


Hi all!

A little ping, especially on the issues I face below when using
HMTL.  Thanks a lot!

Le 16 oct. 2014 à 16:42, Akim Demaille <akim at lrde.epita.fr> a écrit :

> 
> Le 23 sept. 2014 à 14:25, Matthias Bussonnier <bussonniermatthias at gmail.com> a écrit :
> 
>> Hi, 
> 
> Hi Matthias, Hi all,
> 
> The context was: our documentation, written in IPython notebooks
> (see http://nbviewer.ipython.org/urls/www.lrde.epita.fr/dload/vaucanson/2.0/notebooks/index.ipynb), is installed on the user's machine as IPython notebooks.
> I wanted to be able to open these ipynb on request from
> the user so that she could read the documentation inline in her
> working notebook, but it was reported that this won't work, by
> design, for safety reasons.
> 
> You suggested to open a static HTML page instead.
> 
>>> This is possible, indeed.  Which means that we should also install
>>> the html rendering.  Why not, after all.
>> 
>> I was referring in using the IPython display machinery to show a ilk to the user, and this link could open another tab. 
>> Yo could even use js to trigger the opening of this tab. 
>> 
>> If you look at what Julia is doing, their "info methods" for "objects" do return html with direct link to github source code. 
>> As you know the hash of the current version of the project, you can directly link to a rendered version. Which also avoid to build the doc locally, but I won't go into the debatee of having or not local build of docs. 
> 
>> One thing I can see you doing, is if you can export to html fragments, is having 
>> doc('somehting') just return a IPython.display.HTML object with the content of the doc. 
>> This would allow to see doc in the notebook. 
> 
> Well, I went ahead and now I also install the HTML rendering
> of these notebooks.  However the (outer) notebook goes nut
> when I try to read one of the html I created myself, while
> it seems to be happy with the same file, but served by nbviewer.
> 
> In clear, with:
> 
> from IPython.display import HTML
> HTML("http://nbviewer.ipython.org/urls/www.lrde.epita.fr/dload/vaucanson/2.0/notebooks/index.ipynb")
> 
> my notebook seems to stay alive, while:
> 
> HTML("http://www.lrde.epita.fr/dload/vcsn/2.0/notebooks/index.html")
> 
> completely breaks it (the JS part seems stuck: no means to run a cell
> etc.).  Would you have any idea what is going wrong?
> 
> Of course, I have the same problem when I try to rendering the
> page installed on the user's machine:
> 
> HTML(filename = "/opt/local/share/vcsn/notebooks/index.html")
> 
> Thanks!




More information about the IPython-dev mailing list