Adding moved content.

examples/Notebook/Running the Notebook Server.ipynb

@@ -1,248 +1,389 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:84fa8b285a29d021b31d7211c6452729fb042a5c74cee6bf31e74e06fdd26b97"
+  "signature": "sha256:ee4b22b4c949fe21b3e5cda24f0916ba59d8c09443f4a897d98b96d4a73ac335"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Running the Notebook Server"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "The IPython notebook server is a custom web server that runs the notebook web application. Most of the time, users run the notebook server on their local computer using IPython's command line interface."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Starting the notebook server using the command line"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can start the notebook server from the command line (Terminal on Mac/Linux, CMD prompt on Windows) by running the following command: \n",
       "\n",
       "    ipython notebook\n",
       "\n",
-      "This will print some information about the notebook server in your console, including the URL of the web application (by default, `http://127.0.0.1:8888`). It will then open your default web browser to this URL.\n",
+      "This will print some information about the notebook server in your terminal, including the URL of the web application (by default, `http://127.0.0.1:8888`). It will then open your default web browser to this URL.\n",
       "\n",
       "When the notebook opens, you will see the **notebook dashboard**, which will show a list of the notebooks and subdirectories in the directory where the notebook server was started. As of IPython 2.0, the dashboard allows you to navigate to different subdirectories. Because of this, it is no longer necessary to start a separate notebook server for each subdirectory. Most of the time, you will want to start a notebook server in the highest directory in your filesystem where notebooks can be found. Often this will be your home directory.\n",
       "\n",
       "You can start more than one notebook server at the same time. By default, the first notebook server starts on port 8888 and later notebook servers search for open ports near that one.\n",
       "\n",
       "You can also specify the port manually:\n",
       "\n",
       "    ipython notebook --port 9999\n",
       "\n",
       "Or start notebook server without opening a web browser.\n",
       "\n",
       "    ipython notebook --no-browser\n",
       "\n",
       "The notebook server has a number of other command line arguments that can be displayed with the `--help` flag: \n",
       "\n",
       "    ipython notebook --help\n",
       "\n",
       "<div class=\"alert alert-failure\">\n",
       "It used to be possible to specify kernel options, such as <code>--pylab inline</code> from the command line. This is deprecated in IPython 2.0 and will be removed in IPython 3.0. To enable matplotlib based plotting for the Python kernel use the <code>%matplotlib</code> magic command.\n",
       "</div>\n",
       "\n"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Configuring the IPython Notebook"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "The notebook web server can also be configured using IPython profiles and configuration files. The Notebook web server configuration options are set in a file named `ipython_notebook_config.py` in your IPython *profile directory*. The profile directory is a subfolder of your IPython directory, which itself is usually `.ipython` in your home directory.\n",
       "\n",
-      "You can display the location of your default profile directory by running the command:\n",
-      "\n",
-      "    ipython locate\n",
-      "\n",
+      "You can display the location of your default profile directory by running the command:"
+     ]
+    },
+    {
+     "cell_type": "code",
+     "collapsed": false,
+     "input": [
+      "!ipython profile locate default"
+     ],
+     "language": "python",
+     "metadata": {},
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "/Users/bgranger/.ipython/profile_default\r\n"
+       ]
+      }
+     ],
+     "prompt_number": 7
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
       "The default version of `ipython_notebook_config.py` lists all of the options available along with documentation for each. Changes made to that file will affect all notebook servers run under that profile. Command line options always override those set in configuration files.\n",
       "\n",
+      "You can create a new profile:"
+     ]
+    },
+    {
+     "cell_type": "code",
+     "collapsed": false,
+     "input": [
+      "!ipython profile create my_profile"
+     ],
+     "language": "python",
+     "metadata": {},
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_my_profile/ipython_config.py'\r\n"
+       ]
+      },
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_my_profile/ipython_qtconsole_config.py'\r\n"
+       ]
+      },
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_my_profile/ipython_notebook_config.py'\r\n",
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_my_profile/ipython_nbconvert_config.py'\r\n"
+       ]
+      }
+     ],
+     "prompt_number": 3
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "And then view its location:"
+     ]
+    },
+    {
+     "cell_type": "code",
+     "collapsed": false,
+     "input": [
+      "!ipython profile locate my_profile"
+     ],
+     "language": "python",
+     "metadata": {},
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "/Users/bgranger/.ipython/profile_my_profile\r\n"
+       ]
+      }
+     ],
+     "prompt_number": 5
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "To start the notebook server using a given profile, run the following:\n",
+      "\n",
+      "    ipython notebook --profile=my_profile"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
       "More details about IPython configuration files and profiles can be found [here](http://ipython.org/ipython-doc/dev/config/intro.html)."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Securing the notebook server"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "The IPython Notebook allows arbitrary code execution on the computer running it. Thus, the notebook web server should never be run on the open internet without first securing it. By default, the notebook server only listens on local network interface (`127.0.0.1`) There are two steps required to secure the notebook server:\n",
       "\n",
       "1. Setting a password\n",
-      "2. Encrypt network traffic using SSL\n",
-      "\n",
-      "\n",
-      "\n",
-      "You can protect your notebook server with a simple single password by setting the `NotebookApp.password` configurable. You can prepare a hashed password using the function `IPython.lib.security.passwd`:\n",
-      "\n",
-      "```python\n",
-      "In [1]: from IPython.lib import passwd\n",
-      "In [2]: passwd()\n",
-      "Enter password: \n",
-      "Verify password: \n",
-      "Out[2]: 'sha1:67c9e60bb8b6:9ffede0825894254b2e042ea597d771089e11aed'\n",
-      "```\n",
-      "\n",
-      "<div class=\"alert alert-warn\">\n",
-      "`IPython.lib.security.passwd` can also take the password as a string argument. **Do not** pass it as an argument inside an IPython session, as it will be saved in your input history.\n",
-      "</div>\n",
-      "\n",
+      "2. Encrypt network traffic using SSL"
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 3,
+     "metadata": {},
+     "source": [
+      "Setting a password"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "You can protect your notebook server with a simple single password by setting the `NotebookApp.password` configurable. You can prepare a hashed password using the function `IPython.lib.passwd`:"
+     ]
+    },
+    {
+     "cell_type": "code",
+     "collapsed": false,
+     "input": [
+      "from IPython.lib import passwd\n",
+      "password = passwd(\"secret\")\n",
+      "password"
+     ],
+     "language": "python",
+     "metadata": {},
+     "outputs": [
+      {
+       "metadata": {},
+       "output_type": "pyout",
+       "prompt_number": 1,
+       "text": [
+        "'sha1:6c2164fc2b22:ed55ecf07fc0f985ab46561483c0e888e8964ae6'"
+       ]
+      }
+     ],
+     "prompt_number": 1
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
       "You can then add this to your `ipython_notebook_config.py`:\n",
       "\n",
       "```python\n",
       "# Password to use for web authentication\n",
       "c = get_config()\n",
       "c.NotebookApp.password = \n",
-      "u'sha1:67c9e60bb8b6:9ffede0825894254b2e042ea597d771089e11aed'\n",
-      "```\n",
-      "When using a password, it is a good idea to also use SSL, so that your \n",
-      "password is not sent unencrypted by your browser. You can start the notebook \n",
-      "to communicate via a secure protocol mode using a self-signed certificate with \n",
-      "the command::\n",
-      "\n",
-      "    $ ipython notebook --certfile=mycert.pem\n",
-      "\n",
-      ".. note::\n",
-      "\n",
-      "    A self-signed certificate can be generated with ``openssl``.  For example, \n",
-      "    the following command will create a certificate valid for 365 days with \n",
-      "    both the key and certificate data written to the same file::\n",
-      "\n",
-      "        $ openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.pem -out mycert.pem\n",
-      "\n",
-      "Your browser will warn you of a dangerous certificate because it is\n",
-      "self-signed.  If you want to have a fully compliant certificate that will not\n",
-      "raise warnings, it is possible (but rather involved) to obtain one,\n",
-      "as explained in detail in `this tutorial`__.\n",
-      "\n",
-      ".. __: http://arstechnica.com/security/news/2009/12/how-to-get-set-with-a-secure-sertificate-for-free.ars\n",
-      "\t\n",
-      "Keep in mind that when you enable SSL support, you will need to access the\n",
-      "notebook server over ``https://``, not over plain ``http://``.  The startup\n",
-      "message from the server prints this, but it is easy to overlook and think the\n",
-      "server is for some reason non-responsive."
+      "u'sha1:6c2164fc2b22:ed55ecf07fc0f985ab46561483c0e888e8964ae6'\n",
+      "```"
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 3,
+     "metadata": {},
+     "source": [
+      "Using SSL/HTTPS"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Running a public notebook server\n",
-      "--------------------------------\n",
+      "When using a password, it is a good idea to also use SSL, so that your \n",
+      "password is not sent unencrypted by your browser to the web server. When running the notebook on the public internet this is absolutely required.\n",
       "\n",
-      "If you want to access your notebook server remotely via a web browser,\n",
-      "you can do the following.  \n",
+      "The first step is to generate an SSL certificate. A self-signed certificate can be generated with ``openssl``.  For example, the following command will create a certificate valid for 365 days with both the key and certificate data written to the same file:\n",
       "\n",
-      "Start by creating a certificate file and a hashed password, as explained \n",
-      "above.  Then create a custom profile for the notebook, with the following \n",
-      "command line, type::\n",
+      "    openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.pem -out mycert.pem\n",
       "\n",
-      "  $ ipython profile create nbserver\n",
+      "In most cases, you should run this command in your profile directory, which will make it easy to use the generated key and certificate.\n",
       "\n",
-      "In the profile directory just created, edit the file \n",
-      "``ipython_notebook_config.py``.  By default, the file has all fields \n",
-      "commented; the minimum set you need to uncomment and edit is the following::\n",
+      "When you connect to a notebook server over HTTPS using a self-signed certificate, your browser will warn you of a dangerous certificate because it is self-signed.  If you want to have a fully compliant certificate that will not raise warnings, it is possible (but rather involved) to obtain one,\n",
+      "as explained in detail in [this tutorial](http://arstechnica.com/security/news/2009/12/how-to-get-set-with-a-secure-sertificate-for-free.ars)\n",
+      "\t\n",
+      "When you enable SSL support, you will need to access the notebook server over ``https://``, rather than plain ``http://``.  The startup message from the notebook server prints the correct URL, but it is easy to overlook and think the server is for some reason non-responsive.\n",
       "\n",
-      "     c = get_config()\n",
+      "Once you have generated the key and certificate, you can configure the notebook server to use them, by adding the following to `ipython_notebook_config.py`:\n",
       "\n",
-      "     # Kernel config\n",
-      "     c.IPKernelApp.pylab = 'inline'  # if you want plotting support always\n",
+      "```python\n",
+      "# The full path to an SSL/TLS certificate file.\n",
+      "c.NotebookApp.certfile = u'/Users/bgranger/.ipython/profile_my_profile/mycert.crt'\n",
       "\n",
-      "     # Notebook config\n",
-      "     c.NotebookApp.certfile = u'/absolute/path/to/your/certificate/mycert.pem'\n",
-      "     c.NotebookApp.ip = '*'\n",
-      "     c.NotebookApp.open_browser = False\n",
-      "     c.NotebookApp.password = u'sha1:bcd259ccf...[your hashed password here]'\n",
-      "     # It is a good idea to put it on a known, fixed port\n",
-      "     c.NotebookApp.port = 9999\n",
+      "# The full path to a private key file for usage with SSL/TLS.\n",
+      "c.NotebookApp.keyfile = u'/Users/bgranger/.ipython/profile_my_profile/mycert.key'\n",
+      "```"
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
+      "Running a public notebook server"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "<div class=\"alert alert-error\">\n",
+      "Don't run a public notebook server unless you first secure it with a password and SSL/HTTPS as described above\n",
+      "</div>\n",
       "\n",
-      "You can then start the notebook and access it later by pointing your browser \n",
-      "to ``https://your.host.com:9999`` with ``ipython notebook \n",
-      "--profile=nbserver``.\n",
+      "By default the notebook server only listens on the `localhost/127.0.0.1` network interface. If you want to connect to the notebook from another computers, or over the internet, you need to configure the notebook server to listen on all network interfaces and not open the browser. You will often also want to disable the automatic launching of the web browser.\n",
       "\n",
-      "Running with a different URL prefix\n",
-      "-----------------------------------\n",
+      "This can be accomplished by passing a command line options.\n",
       "\n",
-      "The notebook dashboard (the landing page with an overview\n",
-      "of the notebooks in your working directory) typically lives at the URL\n",
-      "``http://localhost:8888/``. If you prefer that it lives, together with the \n",
-      "rest of the notebook, under a sub-directory,\n",
-      "e.g. ``http://localhost:8888/ipython/``, you can do so with\n",
-      "configuration options like the following (see above for instructions about\n",
-      "modifying ``ipython_notebook_config.py``)::\n",
+      "    ipython notebook --ip=* --no-browser\n",
       "\n",
-      "    c.NotebookApp.base_url = '/ipython/'\n",
-      "    c.NotebookApp.webapp_settings = {'static_url_prefix':'/ipython/static/'}\n",
+      "You can also add the following to your`ipython_notebook_config.py` file:\n",
       "\n",
-      "Using a different notebook store\n",
-      "--------------------------------\n",
+      "```python\n",
+      "c.NotebookApp.ip = '*'\n",
+      "c.NotebookApp.open_browser = False\n",
+      "```"
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
+      "Running with a different URL prefix"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "The notebook dashboard typically lives at the URL `http://localhost:8888/tree`. If you prefer that it lives, together with the \n",
+      "rest of the notebook web application, under a base URL prefix, such as `http://localhost:8888/ipython/tree`, you can do so by adding the following lines to your `ipython_notebook_config.py` file.\n",
       "\n",
-      "By default, the notebook server stores the notebook documents that it saves as \n",
-      "files in the working directory of the notebook server, also known as the\n",
-      "``notebook_dir``. This  logic is implemented in the \n",
-      ":class:`FileNotebookManager` class. However, the server can be configured to \n",
-      "use a different notebook manager class, which can \n",
-      "store the notebooks in a different format. \n",
+      "```python\n",
+      "c.NotebookApp.base_url = '/ipython/'\n",
+      "c.NotebookApp.webapp_settings = {'static_url_prefix':'/ipython/static/'}\n",
+      "```"
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
+      "Using a different notebook store"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "By default, the notebook server stores the notebook documents that it saves as files in the working directory of the notebook server, also known as the\n",
+      "`notebook_dir`. This  logic is implemented in the `FileNotebookManager` class. However, the server can be configured to use a different notebook manager class, which can store the notebooks in a different format. \n",
       "\n",
-      "The bookstore_ package currently allows users to store notebooks on Rackspace\n",
-      "CloudFiles or OpenStack Swift based object stores.\n",
+      "The [bookstore](https://github.com/rgbkrk/bookstore) package currently allows users to store notebooks on Rackspace CloudFiles or OpenStack Swift based object stores.\n",
       "\n",
-      "Writing a notebook manager is as simple as extending the base class\n",
-      ":class:`NotebookManager`. The simple_notebook_manager_ provides a great example\n",
+      "Writing a notebook manager is as simple as extending the base class `NotebookManager`. The [simple_notebook_manager](https://github.com/khinsen/simple_notebook_manager) provides a great example\n",
       "of an in memory notebook manager, created solely for the purpose of\n",
-      "illustrating the notebook manager API.\n",
-      "\n",
-      ".. _bookstore: https://github.com/rgbkrk/bookstore\n",
-      "\n",
-      ".. _simple_notebook_manager: https://github.com/khinsen/simple_notebook_manager\n",
-      "\n",
-      "Known issues\n",
-      "------------\n",
-      "\n",
-      "When behind a proxy, especially if your system or browser is set to autodetect\n",
-      "the proxy, the notebook web application might fail to connect to the server's\n",
-      "websockets, and present you with a warning at startup. In this case, you need\n",
-      "to configure your system not to use the proxy for the server's address.\n",
+      "illustrating the notebook manager API."
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
+      "Known issues"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "When behind a proxy, especially if your system or browser is set to autodetect the proxy, the notebook web application might fail to connect to the server's websockets, and present you with a warning at startup. In this case, you need to configure your system not to use the proxy for the server's address.\n",
       "\n",
       "For example, in Firefox, go to the Preferences panel, Advanced section,\n",
       "Network tab, click 'Settings...', and add the address of the notebook server\n",
       "to the 'No proxy for' field."
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Notebook/Working With Code Cells.ipynb

@@ -1,467 +1,171 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:a52ac3735e5881fe8fe68f88d0113c3b1dca40cb809955db692fedb89b66a7fa"
+  "signature": "sha256:1cf51b66a39fb370f2fb3d08af95cfc79b8884f310509181b3b0586400e20b81"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Running Code in the IPython Notebook"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "First and foremost, the IPython Notebook is an interactive environment for writing and running Python code."
+      "First and foremost, the IPython Notebook is an interactive environment for writing and running code. IPython is capable of running code in a wide range of languages. However, in IPython 2.0, the default kernel runs Python code."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Code cells allow you to enter and run Python code"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "\n",
-      "<script type=\"text/javascript\">\n",
-      "var _toggle=false;\n",
-      "var hl = function (id, on){\n",
-      "    $(id)[0].style.background = '';\n",
-      "    if (on) {\n",
-      "        $(id)[0].style.background = 'lightcyan';\n",
-      "    }\n",
-      "};\n",
-      "</script>\n",
-      "\n",
-      "Run a code cell using `shift-enter` or pressing the <button class='btn btn-default btn-xs'><i class=\"icon-play fa fa-play\"></i></button> button in the <a href=\"#\" onMouseover=\"hl('#maintoolbar-container', 1)\" onMouseout=\"hl('#maintoolbar-container', 0)\">toolbar</a> above:"
+      "Run a code cell using `Shift-Enter` or pressing the <button><i class=\"icon-play fa fa-play\"></i></button> button in the toolbar above:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "a = 10"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [],
      "prompt_number": 1
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "print(a)"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "10\n"
        ]
       }
      ],
      "prompt_number": 2
     },
     {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "There are two other keyboard shortcuts for running code:\n",
+      "\n",
+      "* `Alt-Enter` runs the current cell and inserts a new one below.\n",
+      "* `Ctrl-Enter` run the current cell and enters command mode."
+     ]
+    },
+    {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Managing the IPython Kernel"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Code is run in a separate process called the IPython Kernel.  The Kernel can be interrupted or restarted.  Try running the following cell and then hit the <button class='btn btn-default btn-xs'><i class='icon-stop fa fa-stop'></i></button> button in the <a href=\"#\" onMouseover=\"hl('#maintoolbar-container', 1)\" onMouseout=\"hl('#maintoolbar-container', 0)\">toolbar</a> above."
+      "Code is run in a separate process called the IPython Kernel.  The Kernel can be interrupted or restarted.  Try running the following cell and then hit the <button><i class='icon-stop fa fa-stop'></i></button> button in the toolbar above."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "import time\n",
       "time.sleep(10)"
      ],
      "language": "python",
      "metadata": {},
      "outputs": []
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "If the Kernel dies you will be prompted to restart it. Here we call the low-level system libc.time routine with the wrong argument via\n",
       "ctypes to segfault the Python interpreter:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "import sys\n",
       "from ctypes import CDLL\n",
-      "# This will crash a Linux or Mac system; equivalent calls can be made on Windows\n",
+      "# This will crash a Linux or Mac system\n",
+      "# equivalent calls can be made on Windows\n",
       "dll = 'dylib' if sys.platform == 'darwin' else 'so.6'\n",
       "libc = CDLL(\"libc.%s\" % dll) \n",
       "libc.time(-1)  # BOOM!!"
      ],
      "language": "python",
      "metadata": {},
      "outputs": []
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
-      "All of the goodness of IPython works"
-     ]
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Here are two system aliases:"
-     ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "pwd"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [
-      {
-       "metadata": {},
-       "output_type": "pyout",
-       "prompt_number": 1,
-       "text": [
-        "u'/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Notebook/Tutorials'"
-       ]
-      }
-     ],
-     "prompt_number": 1
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "ls"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [
-      {
-       "output_type": "stream",
-       "stream": "stdout",
-       "text": [
-        "Basic Output.ipynb                    Plotting with Matplotlib.ipynb        data.csv\r\n",
-        "Custom Display Logic.ipynb            Running Code.ipynb                    \u001b[34mimages\u001b[m\u001b[m/\r\n",
-        "Display System.ipynb                  Typesetting Math Using MathJax.ipynb\r\n",
-        "Markdown Cells.ipynb                  User Interface.ipynb\r\n"
-       ]
-      }
-     ],
-     "prompt_number": 2
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Any command line program can be run using `!` with string interpolation from Python variables:"
-     ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "message = 'The IPython notebook is great!'\n",
-      "# note: the echo command does not run on Windows, it's a unix command.\n",
-      "!echo $message"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [
-      {
-       "output_type": "stream",
-       "stream": "stdout",
-       "text": [
-        "The IPython notebook is great!\r\n"
-       ]
-      }
-     ],
-     "prompt_number": 3
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Tab completion works:"
+      "Cell menu"
      ]
     },
     {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "import numpy"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 5
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "numpy.random."
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": []
-    },
-    {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Shift-Tab on selection, or after `(` brings up a tooltip with the docstring:"
-     ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "numpy.random.rand("
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": []
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Adding `?` opens the docstring in the pager below:"
-     ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "magic?"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 8
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Exceptions are formatted nicely:"
+      "The \"Cell\" menu has a number of menu items for running code in different ways. These includes:\n",
+      "\n",
+      "* Run and Select Below\n",
+      "* Run and Insert Below\n",
+      "* Run All\n",
+      "* Run All Above\n",
+      "* Run All Below"
      ]
     },
     {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "x = 1\n",
-      "y = 4\n",
-      "z = y/(1-x)"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [
-      {
-       "ename": "ZeroDivisionError",
-       "evalue": "integer division or modulo by zero",
-       "output_type": "pyerr",
-       "traceback": [
-        "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m\n\u001b[0;31mZeroDivisionError\u001b[0m                         Traceback (most recent call last)",
-        "\u001b[0;32m<ipython-input-6-dc39888fd1d2>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m()\u001b[0m\n\u001b[1;32m      1\u001b[0m \u001b[0mx\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;36m1\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      2\u001b[0m \u001b[0my\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;36m4\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 3\u001b[0;31m \u001b[0mz\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0my\u001b[0m\u001b[0;34m/\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m-\u001b[0m\u001b[0mx\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
-        "\u001b[0;31mZeroDivisionError\u001b[0m: integer division or modulo by zero"
-       ]
-      }
-     ],
-     "prompt_number": 6
-    },
-    {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
-      "Working with external code"
+      "Restarting the kernels"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "There are a number of ways of getting external code into code cells."
-     ]
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Pasting code with `>>>` prompts works as expected:"
-     ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      ">>> the_world_is_flat = 1\n",
-      ">>> if the_world_is_flat:\n",
-      "...     print(\"Be careful not to fall off!\")"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [
-      {
-       "output_type": "stream",
-       "stream": "stdout",
-       "text": [
-        "Be careful not to fall off!\n"
-       ]
-      }
-     ],
-     "prompt_number": 7
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "The `%load` magic lets you load code from URLs or local files:"
+      "The kernel maintains the state of a notebook's computations. You can reset this state by restarting the kernel. This is done by clicking on the <button><i class='icon-repeat'></i></button> in the toolbar above."
      ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "%load?"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 8
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "%matplotlib inline"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 9
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "%load http://matplotlib.org/mpl_examples/showcase/integral_demo.py"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 10
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "\"\"\"\n",
-      "Plot demonstrating the integral as the area under a curve.\n",
-      "\n",
-      "Although this is a simple example, it demonstrates some important tweaks:\n",
-      "\n",
-      "    * A simple line plot with custom color and line width.\n",
-      "    * A shaded region created using a Polygon patch.\n",
-      "    * A text label with mathtext rendering.\n",
-      "    * figtext calls to label the x- and y-axes.\n",
-      "    * Use of axis spines to hide the top and right spines.\n",
-      "    * Custom tick placement and labels.\n",
-      "\"\"\"\n",
-      "import numpy as np\n",
-      "import matplotlib.pyplot as plt\n",
-      "from matplotlib.patches import Polygon\n",
-      "\n",
-      "\n",
-      "def func(x):\n",
-      "    return (x - 3) * (x - 5) * (x - 7) + 85\n",
-      "\n",
-      "\n",
-      "a, b = 2, 9 # integral limits\n",
-      "x = np.linspace(0, 10)\n",
-      "y = func(x)\n",
-      "\n",
-      "fig, ax = plt.subplots()\n",
-      "plt.plot(x, y, 'r', linewidth=2)\n",
-      "plt.ylim(ymin=0)\n",
-      "\n",
-      "# Make the shaded region\n",
-      "ix = np.linspace(a, b)\n",
-      "iy = func(ix)\n",
-      "verts = [(a, 0)] + list(zip(ix, iy)) + [(b, 0)]\n",
-      "poly = Polygon(verts, facecolor='0.9', edgecolor='0.5')\n",
-      "ax.add_patch(poly)\n",
-      "\n",
-      "plt.text(0.5 * (a + b), 30, r\"$\\int_a^b f(x)\\mathrm{d}x$\",\n",
-      "         horizontalalignment='center', fontsize=20)\n",
-      "\n",
-      "plt.figtext(0.9, 0.05, '$x$')\n",
-      "plt.figtext(0.1, 0.9, '$y$')\n",
-      "\n",
-      "ax.spines['right'].set_visible(False)\n",
-      "ax.spines['top'].set_visible(False)\n",
-      "ax.xaxis.set_ticks_position('bottom')\n",
-      "\n",
-      "ax.set_xticks((a, b))\n",
-      "ax.set_xticklabels(('$a$', '$b$'))\n",
-      "ax.set_yticks([])\n",
-      "\n",
-      "plt.show()\n"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [
-      {
-       "metadata": {},
-       "output_type": "display_data",
-       "png": "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\niISh/weZPyRnS1m/IAAAAABJRU5ErkJggg==\n",
-       "text": [
-        "<matplotlib.figure.Figure at 0x108604e50>"
-       ]
-      }
-     ],
-     "prompt_number": 11
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Notebook/Working With Markdown Cells.ipynb

@@ -1,272 +1,319 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:056f083d2453c83c77ea0a659e9185084426263c9e42b4c0ccbb91c773d9503b"
+  "signature": "sha256:3b7cae0c0936f25e6ccb7acafe310c08a4162a1a7fd66fa9874a52cffa0f64f9"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Markdown Cells"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Text can be added to IPython Notebooks using Markdown cells.  Markdown is a popular markup language that is a superset of HTML. Its specification can be found here:\n",
       "\n",
       "<http://daringfireball.net/projects/markdown/>"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Markdown basics"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can make text *italic* or **bold**."
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can build nested itemized or enumerated lists:\n",
       "\n",
       "* One\n",
       "    - Sublist\n",
       "        - This\n",
       "  - Sublist\n",
       "        - That\n",
       "        - The other thing\n",
       "* Two\n",
       "  - Sublist\n",
       "* Three\n",
       "  - Sublist\n",
       "\n",
       "Now another list:\n",
       "\n",
       "1. Here we go\n",
       "    1. Sublist\n",
       "    2. Sublist\n",
       "2. There we go\n",
       "3. Now this"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can add horizontal rules:\n",
       "\n",
       "---"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Here is a blockquote:\n",
       "\n",
       "> Beautiful is better than ugly.\n",
       "> Explicit is better than implicit.\n",
       "> Simple is better than complex.\n",
       "> Complex is better than complicated.\n",
       "> Flat is better than nested.\n",
       "> Sparse is better than dense.\n",
       "> Readability counts.\n",
       "> Special cases aren't special enough to break the rules.\n",
       "> Although practicality beats purity.\n",
       "> Errors should never pass silently.\n",
       "> Unless explicitly silenced.\n",
       "> In the face of ambiguity, refuse the temptation to guess.\n",
       "> There should be one-- and preferably only one --obvious way to do it.\n",
       "> Although that way may not be obvious at first unless you're Dutch.\n",
       "> Now is better than never.\n",
       "> Although never is often better than *right* now.\n",
       "> If the implementation is hard to explain, it's a bad idea.\n",
       "> If the implementation is easy to explain, it may be a good idea.\n",
       "> Namespaces are one honking great idea -- let's do more of those!"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "And shorthand for links:\n",
       "\n",
       "[IPython's website](http://ipython.org)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Headings"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "If you want, you can add headings using Markdown's syntax:\n",
       "\n",
       "# Heading 1\n",
       "# Heading 2\n",
       "## Heading 2.1\n",
       "## Heading 2.2"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "**BUT most of the time you should use the Notebook's Heading Cells to organize your Notebook content**, as they provide meaningful structure that can be interpreted by other tools, not just large bold fonts."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Embedded code"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can embed code meant for illustration instead of execution in Python:\n",
       "\n",
       "    def f(x):\n",
       "        \"\"\"a docstring\"\"\"\n",
       "        return x**2\n",
       "\n",
       "or other languages:\n",
       "\n",
       "    if (i=0; i<n; i++) {\n",
       "      printf(\"hello %d\\n\", i);\n",
       "      x += 4;\n",
       "    }"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "LaTeX equations"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Courtesy of MathJax, you can include mathematical expressions both inline: \n",
       "$e^{i\\pi} + 1 = 0$  and displayed:\n",
       "\n",
       "$$e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i$$"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
+      "Github flavored markdown (GFM)"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "The Notebook webapp support Github flavored markdown meaning that you can use triple backticks for code blocks \n",
+      "<pre>\n",
+      "```python\n",
+      "print \"Hello World\"\n",
+      "```\n",
+      "\n",
+      "```javascript\n",
+      "console.log(\"Hello World\")\n",
+      "```\n",
+      "</pre>\n",
+      "\n",
+      "Gives \n",
+      "```python\n",
+      "print \"Hello World\"\n",
+      "```\n",
+      "\n",
+      "```javascript\n",
+      "console.log(\"Hello World\")\n",
+      "```\n",
+      "\n",
+      "And a table like this : \n",
+      "\n",
+      "<pre>\n",
+      "| This | is   |\n",
+      "|------|------|\n",
+      "|   a  | table| \n",
+      "</pre>\n",
+      "\n",
+      "A nice Html Table\n",
+      "\n",
+      "| This | is   |\n",
+      "|------|------|\n",
+      "|   a  | table| "
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
       "General HTML"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Because Markdown is a superset of HTML you can even add things like HTML tables:\n",
       "\n",
       "<table>\n",
       "<tr>\n",
       "<th>Header 1</th>\n",
       "<th>Header 2</th>\n",
       "</tr>\n",
       "<tr>\n",
       "<td>row 1, cell 1</td>\n",
       "<td>row 1, cell 2</td>\n",
       "</tr>\n",
       "<tr>\n",
       "<td>row 2, cell 1</td>\n",
       "<td>row 2, cell 2</td>\n",
       "</tr>\n",
       "</table>"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Local files"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "If you have local files in your Notebook directory, you can refer to these files in Markdown cells directly:\n",
       "\n",
       "    [subdirectory/]<filename>\n",
       "\n",
       "For example, in the images folder, we have the Python logo:\n",
       "\n",
       "    <img src=\"images/python-logo.svg\" />\n",
       "\n",
       "<img src=\"images/python-logo.svg\" />\n",
       "\n",
       "and a video with the HTML5 video tag:\n",
       "\n",
       "    <video controls src=\"images/animation.m4v\" />\n",
       "\n",
       "<video controls src=\"images/animation.m4v\" />\n",
       "\n",
       "These do not embed the data into the notebook file, and require that the files exist when you are viewing the notebook."
      ]
     },
     {
      "cell_type": "heading",
      "level": 3,
      "metadata": {},
      "source": [
       "Security of local files"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Note that this means that the IPython notebook server also acts as a generic file server\n",
       "for files inside the same tree as your notebooks.  Access is not granted outside the\n",
       "notebook folder so you have strict control over what files are visible, but for this\n",
       "reason it is highly recommended that you do not run the notebook server with a notebook\n",
       "directory at a high level in your filesystem (e.g. your home directory).\n",
       "\n",
       "When you run the notebook in a password-protected manner, local file access is restricted\n",
       "to authenticated users unless read-only views are active."
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file