[IPython-dev] IMPORTANT: Notebook format incremented

Brian Granger ellisonbg at gmail.com
Tue Jan 31 12:44:43 EST 2012


Yesterday we pushed a change to the IPython notebook that will affect
all users of the notebook - especially those who are following the dev
version.  We have incremented the notebook version number to v3.  This
is done anytime there are backwards incompatible changes to the
notebook format.  In this case, we have added new cell types (Heading
Cells, Plaintext Cells (reST, latex)).  Here is how this affects you:

* Older v2 notebooks (those created with IPython versions before
yesterday) will be automatically converted to v3 notebooks when you
open them the first time.  We are in the process of adding a dialog
that will notify you of this.
* The newer v3 notebooks cannot be opened by previous versions of the
notebook server.  Once you go v3, there is no turning back.  This
means that everyone who wants to use your notebooks MUST to transition
and follow the dev version of the notebook.
* The v3 notebook format is not finalized.  There will likely be
additional backwards incompatible changes to the nbformat.  This means
that if you go v3, you MUST regularly pull from github master to
follow the latest state of the code.  We will announce on list when
the v3 format is finalized in advance of the 0.13 release.

Cheers and happy notebooking!


Brian E. Granger
Cal Poly State University, San Luis Obispo
bgranger at calpoly.edu and ellisonbg at gmail.com

More information about the IPython-dev mailing list