Updated recipe 1.1.

Author: rossant

installation.md

@@ -22,20 +22,36 @@ You need to know/learn, several things before you start:
 
 ### The terminal
 
-#### Windows
+#### OS-specific instructions
+
+##### Windows
 
 Use Powershell.
 
 
-#### Linux
+##### Linux
 
 TODO
 
-#### Mac OS X
+##### Mac OS X
 
 TODO
 
 
+#### Home directory
+
+* On Windows: `c:\users\yourname\`
+* On Linux: `/home/yourname/`
+
+
+#### Current directory
+
+* `cd subfolder`: go into a subfolder
+* `cd ~`: go in your home directory
+* `ls` (if on Windows and not in Powershell, replace by `dir`)
+
+
+
 ### Git
 
 Not strictly required, but highly recommended if you want to use obscure packages, or if you start to write significant amount of code.
@@ -56,6 +72,7 @@ TODO
 
 Once you're relatively confortable with the terminal and git, you can install Anaconda, a Python distribution.
 
+**Don't execute `conda` or any other Python-related commands in the Anaconda directory: go somewhere else.**
 
 ### Windows
 
@@ -81,6 +98,10 @@ TODO
 
 ### The basics
 
+### Updating the packages
+
+`conda update conda`
+
 
 ## Environments
 
@@ -112,6 +133,21 @@ Anaconda lets you maintain various isolated environements. You can switch to any
 
 ## Running Python, IPython, and the IPython notebook
 
+### IPython profile
+
+* A profile is a set of parameters and configuration files specific to a project of yours.
+* You can use different profiles for different use-cases: one profile when running code from the Cookbook, another one for your work, etc.
+* Using IPython profiles is not strictly necessary, and you can do everything in the same default profile. But it is good practice to use different profiles.
+
+
+#### Creating a profile for the cookbook
+
+`ipython profile create cookbook`
+
+#### Running IPython with this profile
+
+* Command-line interface: `ipython --profile=cookbook`
+* Notebook: `ipython notebook --profile=cookbook`
 
 
 ## Using a code editor

notebooks/chapter01_basic/01_notebook.ipynb

@@ -1,7 +1,7 @@
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:b83bd984415ffd506c5913d9119e63a2f2baaf17f1f3b6abea2afb1e1ecd0931"
+  "signature": "sha256:e84e4ad9f3531057c88784f5341dd9edb6503d1b0ffb78233f0f10d8d7b74b11"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
@@ -169,6 +169,10 @@
      "cell_type": "code",
      "collapsed": false,
      "input": [
+      "# You can omit this, it is just to force help output\n",
+      "# to print in the standard output, rather than \n",
+      "# in the pager. This might change in future versions\n",
+      "# of IPython.\n",
       "from __future__ import print_function\n",
       "from IPython.core import page\n",
       "page.page = print"
@@ -202,9 +206,9 @@
      ]
     },
     {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
+     "cell_type": "raw",
+     "metadata": {},
+     "source": [
       "### New paragraph\n",
       "\n",
       "This is *rich* **text** with [links](http://ipython.org), equations:\n",
@@ -220,10 +224,7 @@
       "and images:\n",
       "\n",
       "![This is an image](http://ipython.org/_static/IPy_header.png)"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": []
+     ]
     },
     {
      "cell_type": "markdown",
@@ -244,7 +245,8 @@
       "```\n",
       "\n",
       "and images:\n",
-      "\n"
+      "\n",
+      "![This is an image](http://ipython.org/_static/IPy_header.png)"
      ]
     },
     {
@@ -372,9 +374,9 @@
       "# the keys (video name) and the values (Youtube identifier) \n",
       "# of every menu item.\n",
       "dw = DropdownWidget(values=OrderedDict([\n",
-      "                            ('SciPy 2012', 'iwVvqwLDsJo'), \n",
-      "                            ('PyCon 2012', '2G5YTlheCbw'),\n",
-      "                            ('SciPy 2013', 'j9YpkSX7NNM')]))\n",
+      "                        ('SciPy 2012', 'iwVvqwLDsJo'), \n",
+      "                        ('PyCon 2012', '2G5YTlheCbw'),\n",
+      "                        ('SciPy 2013', 'j9YpkSX7NNM')]))\n",
       "# We create a callback function that displays the requested\n",
       "# Youtube video.\n",
       "def on_value_change(name, val):\n",