diff --git a/examples/notebooks/User Experience.ipynb b/examples/notebooks/User Experience.ipynb
new file mode 100644
index 0000000..e7fae5a
--- /dev/null
+++ b/examples/notebooks/User Experience.ipynb
@@ -0,0 +1,378 @@
+{
+ "metadata": {
+ "name": ""
+ },
+ "nbformat": 3,
+ "nbformat_minor": 0,
+ "worksheets": [
+ {
+ "cells": [
+ {
+ "cell_type": "heading",
+ "level": 1,
+ "metadata": {},
+ "source": [
+ "User Experience"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "This notebook describes the user experience of the IPython Notebook. This includes both mouse and keyboard based navigation and interaction.\n",
+ "\n",
+ "
\n",
+ "As of IPython 2.0, the user experience has changed significantly. Because of this we highly recommend existing users to review this information after upgrading to IPython 2.0. All new users of IPython should review this information as well.\n",
+ "
"
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 2,
+ "metadata": {},
+ "source": [
+ "Modal editor"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Starting with IPython 2.0, the IPython Notebook has a modal user experience. This means that the keyboard does different things depending on which mode the Notebook is in. There are two modes:"
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 3,
+ "metadata": {},
+ "source": [
+ "Edit mode"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Edit mode is indicated by a green cell border and a prompt showing in the editor area:\n",
+ "\n",
+ "\n",
+ "\n",
+ "When a cell is in edit mode, you can type into the cell, like a normal text editor.\n",
+ "\n",
+ "\n",
+ "Enter edit mode by pressing `enter` or using the mouse to click on a cell's editor area.\n",
+ "
"
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 3,
+ "metadata": {},
+ "source": [
+ "Command mode"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Command mode is indicated by a grey cell border:\n",
+ "\n",
+ "\n",
+ "\n",
+ "When you are in command mode, you are able to edit the notebook as a whole, but not type into individual cells. Most importantly, in command mode, the keyboard is mapped to a set of shortcuts that let you perform notebook and cell actions efficiently. For example, if you are in command mode and you press `c`, you will copy the current cell - no modifier is needed.\n",
+ "\n",
+ "\n",
+ "Don't try to type into a cell in command mode; unexpected things will happen!\n",
+ "
\n",
+ "\n",
+ "\n",
+ "Enter command mode by pressing `esc` or using the mouse to click *outside* a cell's editor area.\n",
+ "
"
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 2,
+ "metadata": {},
+ "source": [
+ "Mouse navigation"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "All navigation and actions in the Notebook are available using the mouse through the menubar and toolbar, which are both above the main Notebook area:\n",
+ "\n",
+ ""
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "The first idea of mouse based navigation is that **cells can be selected by clicking on them.** The currently selected cell gets a grey or green border depending on whether the notebook is in edit or command mode. If you click inside a cell's editor area, you will enter edit mode. If you click on the prompt or output area of a cell you will enter command mode.\n",
+ "\n",
+ "If you are running this notebook in a live session (not on http://nbviewer.ipython.org) try selecting different cells and going between edit and command mode. Try typing into a cell."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "The second idea of mouse based navigation is that **cell actions usually apply to the currently selected cell**. Thus if you want to run the code in a cell, you would select it and click the \"Play\" button in the toolbar or the \"Cell:Run\" menu item. Similarly, to copy a cell you would select it and click the \"Copy\" button in the toolbar or the \"Edit:Copy\" menu item. With this simple pattern, you should be able to do most everything you need with the mouse.\n",
+ "\n",
+ "Markdown and heading cells have one other state that can be modified with the mouse. These cells can either be rendered or unrendered. When they are rendered, you will see a nice formatted representation of the cell's contents. When they are unrendered, you will see the raw text source of the cell. To render the selected cell with the mouse, click the \"Play\" button in the toolbar or the \"Cell:Run\" menu item. To unrender the selected cell, double click on the cell."
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 2,
+ "metadata": {},
+ "source": [
+ "Keyboard Navigation"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "The modal user experience of the IPython Notebook has been optimized for efficient keyboard usage. This is made possible by having two different sets of keyboard shortcuts: one set that is active in edit mode and another in command mode.\n",
+ "\n",
+ "The most important keyboard shortcuts are `enter`, which enters edit mode, and `esc`, which enters command mode.\n",
+ "\n",
+ "In edit mode, most of the keyboard is dedicated to typing into the cell's editor. Thus, in edit mode there are relatively few shortcuts:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "collapsed": false,
+ "input": [
+ "display_edit_shortcuts()"
+ ],
+ "language": "python",
+ "metadata": {},
+ "outputs": [
+ {
+ "html": [
+ "esc : command mode
ctrl+m : command mode
shift+enter : run cell
ctrl+enter : run cell, select below
alt+enter : run cell, insert below
up : select previous cell
down : select next cell
alt+- : split cell
meta+s : save notebook
ctrl+s : save notebook
"
+ ],
+ "output_type": "display_data"
+ },
+ {
+ "javascript": [
+ "var help = IPython.quick_help.build_edit_help();\n",
+ "help.children().first().remove();\n",
+ "this.append_output({output_type: 'display_data', html: help.html()});"
+ ],
+ "metadata": {},
+ "output_type": "display_data",
+ "text": [
+ ""
+ ]
+ }
+ ],
+ "prompt_number": 14
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "There are two other keyboard shortcuts in edit mode that are not listed here:\n",
+ "\n",
+ "* `tab`: trigger \"tab\" completion\n",
+ "* `shift+tab`: open the tooltip"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "In command mode, the entire keyboard is available for shortcuts:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "collapsed": false,
+ "input": [
+ "display_command_shortcuts()"
+ ],
+ "language": "python",
+ "metadata": {},
+ "outputs": [
+ {
+ "html": [
+ "enter : edit mode
shift+enter : run cell
ctrl+enter : run cell, select below
alt+enter : run cell, insert below
y : to code
m : to markdown
t : to raw
1 : to heading 1
2 : to heading 2
3 : to heading 3
4 : to heading 4
5 : to heading 5
6 : to heading 6
up : select previous cell
down : select next cell
k : select previous cell
j : select next cell
ctrl+k : move cell up
ctrl+j : move cell down
a : insert cell above
b : insert cell below
x : cut cell
c : copy cell
v : paste cell below
z : undo last delete
d : delete cell (press twice)
shift+= : merge cell below
s : save notebook
meta+s : save notebook
ctrl+s : save notebook
l : toggle line numbers
o : toggle output
shift+o : toggle output
h : keyboard shortcuts
i : interrupt kernel
. : restart kernel
"
+ ],
+ "output_type": "display_data"
+ },
+ {
+ "javascript": [
+ "var help = IPython.quick_help.build_command_help();\n",
+ "help.children().first().remove();\n",
+ "this.append_output({output_type: 'display_data', html: help.html()});"
+ ],
+ "metadata": {},
+ "output_type": "display_data",
+ "text": [
+ ""
+ ]
+ }
+ ],
+ "prompt_number": 15
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Here the rough order in which we recommend learning the command mode shortcuts:\n",
+ "\n",
+ "1. Basic navigation: `enter`, `shift-enter`, `up/k`, `down/j`\n",
+ "2. Saving the notebook: `s`\n",
+ "2. Cell types: `y`, `m`, `1-6`, `t`\n",
+ "3. Cell creation and movement: `a`, `b`, `ctrl+k`, `ctrl+j`\n",
+ "4. Cell editing: `x`, `c`, `v`, `d`, `z`, `shift+=`\n",
+ "5. Kernel operations: `i`, `.`"
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 2,
+ "metadata": {},
+ "source": [
+ "Keyboard shortcut customization"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Starting with IPython 2.0 keyboard shortcuts in command and edit mode are fully customizable. These customizations are made using the IPython JavaScript API. Here is an example that makes the `r` key available for running a cell:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "collapsed": false,
+ "input": [
+ "%%javascript\n",
+ "\n",
+ "IPython.keyboard_manager.command_shortcuts.add_shortcut('r', {\n",
+ " help : 'run cell',\n",
+ " help_index : 'bd',\n",
+ " handler : function (event) {\n",
+ " IPython.notebook.execute_cell();\n",
+ " return false;\n",
+ " }}\n",
+ ");"
+ ],
+ "language": "python",
+ "metadata": {},
+ "outputs": [
+ {
+ "javascript": [
+ "\n",
+ "IPython.keyboard_manager.command_shortcuts.add_shortcut('r', {\n",
+ " help : 'run cell',\n",
+ " help_index : 'bd',\n",
+ " handler : function (event) {\n",
+ " IPython.notebook.execute_cell();\n",
+ " return false;\n",
+ " }}\n",
+ ");"
+ ],
+ "metadata": {},
+ "output_type": "display_data",
+ "text": [
+ ""
+ ]
+ }
+ ],
+ "prompt_number": 17
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "There are a couple of points to mention about this API:\n",
+ "\n",
+ "* The `help_index` field is used to sort the shortcuts in the Keyboard Shortcuts help dialog.\n",
+ "* When a handler returns `false` it indicates that the event should stop propagating and the default action should not be performed. For further details about the `event` object or event handling, see the jQuery docs.\n",
+ "* If you don't need a `help` or `help_index` field, you can simply pass a function as the second argument to `add_shortcut`.\n",
+ "\n",
+ "Likewise, to remove a shortcut, use `remove_shortcut`:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "collapsed": false,
+ "input": [
+ "%%javascript\n",
+ "\n",
+ "IPython.keyboard_manager.command_shortcuts.remove_shortcut('r');"
+ ],
+ "language": "python",
+ "metadata": {},
+ "outputs": [
+ {
+ "javascript": [
+ "\n",
+ "IPython.keyboard_manager.command_shortcuts.remove_shortcut('r');"
+ ],
+ "metadata": {},
+ "output_type": "display_data",
+ "text": [
+ ""
+ ]
+ }
+ ],
+ "prompt_number": 18
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "If you want your keyboard shortcuts to be active for all of your notebooks, put the above API calls into your `custom.js` file."
+ ]
+ },
+ {
+ "cell_type": "heading",
+ "level": 2,
+ "metadata": {},
+ "source": [
+ "Utilities"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "We use the following functions to generate the keyboard shortcut listings above."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "collapsed": false,
+ "input": [
+ "from IPython.display import Javascript, display\n",
+ "\n",
+ "t = \"\"\"var help = IPython.quick_help.build_{0}_help();\n",
+ "help.children().first().remove();\n",
+ "this.append_output({{output_type: 'display_data', html: help.html()}});\"\"\"\n",
+ "\n",
+ "def display_command_shortcuts():\n",
+ " display(Javascript(t.format('command')))\n",
+ "\n",
+ "def display_edit_shortcuts():\n",
+ " display(Javascript(t.format('edit'))) "
+ ],
+ "language": "python",
+ "metadata": {},
+ "outputs": [],
+ "prompt_number": 12
+ }
+ ],
+ "metadata": {}
+ }
+ ]
+}
\ No newline at end of file
diff --git a/examples/notebooks/images/command_mode.png b/examples/notebooks/images/command_mode.png
new file mode 100644
index 0000000000000000000000000000000000000000..673f79aa73266207495853806dce626288104ce6
GIT binary patch
literal 6021
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
literal 0
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⋘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