This notebook describes how to get setup with Jupyter (formerly iPython Notebooks). It's part of the The Art of Literary Text Analysis. In particular, we'll look at:
Setting up Jupyter is (usually) a smooth and painless process. The easiest and recommended option is to download and install Anaconda, which is freely avaailble bundle that includes Python, Jupyter, and several very other things that will be useful to us. It's very important for the purposes of our notebooks to select a version for Mac OS X, Windows or Linux of Anaconda with Python 3.x (not Python 2.x).
Once the Anaconda 3.x installer program is downloaded you can click on the installer and follow the instructions (using the defaults will work just fine). If you encounter difficulties, you may want to consult the Jupyter installation documentation.
Once you've installed Anaconda, the easiest way to launch Jupyter is to use the Anaconda Launcher. During a normal setup on Mac, there should be a Launcher icon created on your desktop – you can click on that. On Windows, you should find Anaconda in your Programs hierarchy.
The Anaconda Launcher will present several applications to choose from, we'll click on the Launch button of notebook (Jupyter Notebook):
This should launch two more windows:
The default path on a Mac is the user's "Home" directory. We probably don't want to create Jupyter notebooks there, so we'll navigate to another directory (like "Documents") and create a new folder (like "Notebooks"). The location and names aren't important but we'll need to remember where our notebooks are for future use.
To create a new folder or notebook you use the New button in the directory browser window.
Creating a new folder gives a default name (like "Untitled Folder") but we can select the folder using the checkbox to the left and then click the rename button that appears before giving the folder a new name.
Now we have Jupyter running and we have a new folder for our notebooks, we're ready for the next step in Getting Started. But just before that, let's look at how we quit Jupyter.
Now you can create your first notebook. Use the same New menu and pull down to the Python 3 under the Notebooks heading in the menu. This will create your first notebook. We will review this and how to use notebooks in the next notebook Getting Started.
The browser window that was opened by the Anaconda Launcher is just a regular window. If we'd been working on a notebook, we'd of course want to save our work before quitting. We don't need to do this for browser (directory) windows. We can close the browser window(s) created by Jupyter in the usual browser way. Then we have to shut down the server (kernel). To do that we do the following:
Let's now proceed to Getting Started.
CC BY-SA From The Art of Literary Text Analysis by Stéfan Sinclair & Geoffrey Rockwell
Created January 7, 2015 and last modified April 21st, 2015 (Jupyter 4.2)