##// END OF EJS Templates
Rewrote introduction. Introduced concept of *notebook space* and discussion of why the same word 'notebook' is used both for the notebook space and the corresponding notebook document
David P. Sanders -
Show More
@@ -9,23 +9,18 b' The IPython Notebook'
9
9
10 The IPython Notebook combines two components:
10 The IPython Notebook combines two components:
11
11
12 * A web application, called the *IPython Notebook web app*, for interactive
12 * **The *IPython Notebook* web application**:
13 authoring of literate computations, in which explanatory text, mathematics,
14 computations and rich media output may be combined. Input and output are stored in persistent cells that may be edited in-place.
15
13
16 * Plain text documents, called *notebook documents*, or *notebooks*, for recording and distributing the results of the rich computations.
14 The IPython Notebook web app is a browser-based tool for interactive authoring of literate computations, in which explanatory text, mathematics,computations and rich media output may be combined. Input and output are stored in persistent cells that may be edited in-place.
17
15
18 In the documentation, the distinction between the *N*otebook app and *n*otebook documents is made by capitalization.
16 * **Notebook documents**:
19
17
20 The Notebook app automatically saves, at certain intervals, the current state of the computational process occurring in the web browser to the corresponding notebook document.
18 *Notebook documents*, or *notebooks*, are plain text documents which record all inputs and outputs of the computations, interspersed with text, mathematics and HTML 5 representations of objects, in a literate style.
21
19
22 Note that it is also common to refer to the current state of the computation,
20 Since the similarity in names can lead to some confusion, in the documentation, we will always use the typographical distinction between the *N*otebook app and *n*otebook documents via the respective capitalization. Here we are thinking of the Notebook app as being a proper noun. We will also always refer to the "Notebook app" when we are referring to the browser-based interface, to increase clarity.
23 as represented by the sequence of input cells in the Notebook app, as a
24 *notebook*. There is no problem with confounding these two concepts, since
25 there is actually a one-to-one correspondence between what you see on the
26 screen inside the app, and what is stored in the corresponding ``.ipynb``
27 notebook document.
28
21
22 We refer to the current state of the computational process taking place in the Notebook app, i.e. the (numbered) sequence of input and output cells, as the
23 *notebook space*. Notebook documents provide an *exact*, *one-to-one* record of all the content in the notebook space, and the Notebook app automatically saves, at certain intervals, the contents of the notebook space to a notebook document stored on disk, with the same name as the title of the notebook space, and the file extension ".ipynb". For this reason, there is no confusion about using the same name "notebook" for both the notebook space and the corresonding notebook document.
29
24
30 Features of the IPython Notebook web app
25 Features of the IPython Notebook web app
31 ----------------------------------------
26 ----------------------------------------
General Comments 0
You need to be logged in to leave comments. Login now