[yt-dev] Updating documentation notebook and notebook dependency to IPython 4

Nathan Goldbaum nathan12343 at gmail.com
Tue Oct 20 14:23:14 PDT 2015


On Tue, Oct 20, 2015 at 2:14 PM, Nathan Goldbaum <nathan12343 at gmail.com>
wrote:

>
>
> On Tue, Oct 20, 2015 at 2:13 PM, Cameron Hummels <chummels at gmail.com>
> wrote:
>
>> With this new format, what is the way to edit notebooks (e.g. in the
>> docs)?  We won't be able to edit the .ipynb file directly with a text
>> editor?  How now?
>>
>
> You can if you want, but you'll need IPython 4.0 or newer to edit the
> notebooks in the notebook browser interface.
>

Right you have to edit it with a text editor or install IPython 2.x. This
is annoying because 2.x is getting pretty long in the tooth and many people
(well, me) don't have it installed anymore.


>
>
>>
>> On Tue, Oct 20, 2015 at 1:46 PM, Nathan Goldbaum <nathan12343 at gmail.com>
>> wrote:
>>
>>> Hi all,
>>>
>>> Would anyone object to me updating the install script dependency and
>>> notebook dependency to IPython 4.x?
>>>
>>> Right now it's quite annoying to edit the notebooks in the
>>> documentation, since you basically need to either edit them "by hand" (e.g.
>>> by directly editing the .ipynb file in a text editor) or update to IPython
>>> 2.x. It also causes a possibly scary to a new user pop-up box when opening
>>> the notebooks warning that notebook has been automatically converted to the
>>> new format.
>>>
>>> The down side of doing this update is that people on older versions of
>>> IPython will no longer be able to read the notebooks. In addition, we will
>>> need to update our build automation and sphinx setup to use the newer
>>> version of IPython.
>>>
>>> My ultimate goal is to make sure our docs are fully compatible with both
>>> python2 and python3, but I figure if I'm going over the full docs build I
>>> might as well update the IPython dependency as well.
>>>
>>> -Nathan
>>>
>>> _______________________________________________
>>> yt-dev mailing list
>>> yt-dev at lists.spacepope.org
>>> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org
>>>
>>>
>>
>>
>> --
>> Cameron Hummels
>> NSF Postdoctoral Fellow
>> Department of Astronomy
>> California Institute of Technology
>> http://chummels.org
>>
>> _______________________________________________
>> yt-dev mailing list
>> yt-dev at lists.spacepope.org
>> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org
>>
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.spacepope.org/pipermail/yt-dev-spacepope.org/attachments/20151020/0955788f/attachment.htm>


More information about the yt-dev mailing list