2.11.2 Notebooks as Mathematica Expressions
Notebook[{ , , ... }] | a notebook containing a sequence of cells | | Notebook[cells, options] | a notebook with options specified |
Expressions corresponding to notebooks. | Here is a simple Mathematica notebook. | | 
| Here is the expression that corresponds to this notebook.
Notebook[ Cell["Section heading", "Section"], Cell["Some text.", "Text"], Cell["More text.", "Text"] ]
Just like individual cells, notebooks in Mathematica can also have options. You can look at and modify these options using the options inspector in the standard notebook front end.
| option | default value | | | WindowSize | {nx, ny} | the size in pixels of the window used to display the notebook | | WindowFloating | False | whether the window should float on top of others | | WindowToolbars | { } | what toolbars to include at the top of the window | | ShowPageBreaks | False | whether to show where page breaks would occur if the notebook were printed | | CellGrouping | Automatic | how to group cells in the notebook | | Evaluator | "Local" | what kernel should be used to do evaluations in the notebook |
A few of the large number of possible options for notebooks. In addition to notebook options, you can also set any cell option at the notebook level. Doing this tells Mathematica to use that option setting as the default for all the cells in the notebook. You can override the default by explicitly setting the options within a particular cell. Here is the expression corresponding to a notebook with a ruler displayed in the toolbar at the top of the window.
Notebook[ Cell["Section heading", "Section"], Cell["Some text.", "Text"] , WindowToolbars-> "RulerBar" ]
| This is what the notebook looks like in the front end. | | 
| This sets the default background color for all cells in the notebook.
Notebook[ Cell["Section heading", "Section"], Cell["Some text.", "Text"] , Background->GrayLevel[.7]]
| Now each cell has a gray background. | | 
|
If you go outside of Mathematica and look at the raw text of the file that corresponds to a Mathematica notebook, you will find that what is in the file is just the textual form of the expression that represents the notebook. One way to create a Mathematica notebook is therefore to construct an appropriate expression and put it in a file. In notebook files that are written out by Mathematica, some additional information is typically included to make it faster for Mathematica to read the file in again. The information is enclosed in Mathematica comments indicated by (* ... *) so that it does not affect the actual expression stored in the file.
| NotebookOpen["file.nb"] | open a notebook file in the front end | | NotebookPut[expr] | create a notebook corresponding to expr in the front end | | NotebookGet[obj] | get the expression corresponding to an open notebook in the front end |
Setting up notebooks in the front end from the kernel. | This writes a notebook expression out to the file sample.nb. | |
In[1]:=
Notebook[{Cell["Section heading", "Section"], Cell["Some text.", "Text"]}] >> "sample.nb"
|
|
| This reads the notebook expression back from the file. | |
Out[2]=
|
|
| This opens sample.nb as a notebook in the front end. | |
In[3]:=
NotebookOpen["sample.nb"]
|

|
Once you have set up a notebook in the front end using NotebookOpen, you can then manipulate the notebook interactively just as you would any other notebook. But in order to use NotebookOpen, you have to explicitly have a notebook expression in a file. With NotebookPut, however, you can take a notebook expression that you have created in the kernel, and immediately display it as a notebook in the front end. | Here is a notebook expression in the kernel. | |
In[4]:=
Notebook[{Cell["Section heading", "Section"], Cell["Some text.", "Text"]}]
|
Out[4]=
|
|
| This uses the expression to set up a notebook in the front end. | | 
|
| You can use NotebookGet to get the notebook corresponding to a particular NotebookObject back into the kernel. | |
Out[6]=
|
|
|