Additional explanation for pre IPython 4.x use

Author: BCSharp

notebooks/chapter03_notebook/03_controls.ipynb

@@ -18,7 +18,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The CSS and Javascript of the HTML notebook can be customized through the files in `~/.ipython/profile_default/static/custom`, where `~` is your `HOME` directory, and `default` is your IPython profile. In this short recipe, we will use this feature to add a new button in the notebook toolbar on top of every notebook. Specifically, this button renumbers linearly all code cells."
+    "The CSS and Javascript of the HTML notebook can be customized through the files in `~/.jupyter/custom` directory, where `~` is your `HOME` directory, (if you are using IPython < 4.x, the location is `~/.ipython/profile_default/static/custom`, where `default` is your IPython profile). In this short recipe, we will use this feature to add a new button in the notebook toolbar on top of every notebook. Specifically, this button renumbers linearly all code cells."
    ]
   },
   {
@@ -39,26 +39,28 @@
     "%%javascript\n",
     "// This function allows us to add buttons \n",
     "// to the notebook toolbar.\n",
-    "IPython.toolbar.add_buttons_group([\n",
+    "// If using IPython < 4.x, replace 'Jupyter' everywhere below\n",
+    "// with 'IPython'\n",
+    "Jupyter.toolbar.add_buttons_group([\n",
     "{\n",
     "    // The button's label.\n",
     "    'label': 'renumber all code cells',\n",
     "    \n",
     "    // The button's icon.\n",
     "    // See a list of Font-Awesome icons here:\n",
     "    // http://fortawesome.github.io/Font-Awesome/icons/\n",
-    "    'icon': 'fa-list-ol',\n",
+    "    'icon': 'fa-list-ol', // 'icon-list-ol' for older IPython\n",
     "    \n",
     "    // The callback function.\n",
     "    'callback': function () {\n",
     "        \n",
     "        // We retrieve the lists of all cells.\n",
-    "        var cells = IPython.notebook.get_cells();\n",
+    "        var cells = Jupyter.notebook.get_cells();\n",
     "        \n",
     "        // We only keep the code cells.\n",
     "        cells = cells.filter(function(c)\n",
     "            {\n",
-    "                return c instanceof IPython.CodeCell; \n",
+    "                return c instanceof Jupyter.CodeCell; \n",
     "            })\n",
     "        \n",
     "        // We set the input prompt of all code cells.\n",
@@ -80,38 +82,38 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "2. To make these changes permanent, i.e. to add this button on every notebook, we can open (or create, if necesary) the file `~/.jupyter/custom/custom.js` (for IPython before 4.0.0 use `~/.ipython/profile_default/static/custom/custom.js`) and add the following code:"
+    "2. To make these changes permanent, i.e. to add this button on every notebook, we can open (or create, if necesary) the file `~/.jupyter/custom/custom.js` and add the code below. For IPython before 3.x and older, use file `~/.ipython/profile_default/static/custom/custom.js` and replace all occurences of `Jupyter` in the code with `IPython`."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
     "```javascript\n",
-    "$([IPython.events]).on('app_initialized.NotebookApp',\n",
+    "$([Jupyter.events]).on('app_initialized.NotebookApp',\n",
     "                       function(){\n",
     "\n",
     "    // Copy of the Javascript code above (step 1).\n",
-    "    IPython.toolbar.add_buttons_group([\n",
+    "    Jupyter.toolbar.add_buttons_group([\n",
     "    {\n",
     "        // The button's label.\n",
     "        'label': 'renumber all code cells',\n",
     "\n",
     "        // The button's icon.\n",
     "        // See a list of Font-Awesome icons here:\n",
     "        // http://fortawesome.github.io/Font-Awesome/icons/\n",
-    "        'icon': 'fa-list-ol',\n",
+    "        'icon': 'fa-list-ol', // 'icon-list-ol' for older IPython\n",
     "\n",
     "        // The callback function.\n",
     "        'callback': function () {\n",
     "\n",
     "            // We retrieve the lists of all cells.\n",
-    "            var cells = IPython.notebook.get_cells();\n",
+    "            var cells = Jupyter.notebook.get_cells();\n",
     "\n",
     "            // We only keep the code cells.\n",
     "            cells = cells.filter(function(c)\n",
     "                {\n",
-    "                    return c instanceof IPython.CodeCell; \n",
+    "                    return c instanceof Jupyter.CodeCell; \n",
     "                })\n",
     "\n",
     "            // We set the input prompt of all code cells.\n",