diff --git a/installation_instructions/macintosh/images/associate_with_launcher.png b/installation_instructions/macintosh/images/associate_with_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..bda545dfccc294439ba4faa0f17258c6546dc702 Binary files /dev/null and b/installation_instructions/macintosh/images/associate_with_launcher.png differ diff --git a/installation_instructions/macintosh/images/cannot_open.png b/installation_instructions/macintosh/images/cannot_open.png new file mode 100644 index 0000000000000000000000000000000000000000..f4f3ae38d8c84f3ca7c7d7189093a57a24f9e218 Binary files /dev/null and b/installation_instructions/macintosh/images/cannot_open.png differ diff --git a/installation_instructions/macintosh/images/cannot_verify_notebook.png b/installation_instructions/macintosh/images/cannot_verify_notebook.png new file mode 100644 index 0000000000000000000000000000000000000000..326b22aa385d404784bfb3ac4ce0dece5221c3dc Binary files /dev/null and b/installation_instructions/macintosh/images/cannot_verify_notebook.png differ diff --git a/installation_instructions/macintosh/images/launcher_logo.png b/installation_instructions/macintosh/images/launcher_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..8e64490bad70af5989d0f50acb57e19b6bff6b46 Binary files /dev/null and b/installation_instructions/macintosh/images/launcher_logo.png differ diff --git a/installation_instructions/macintosh/images/on_first_launch.png b/installation_instructions/macintosh/images/on_first_launch.png new file mode 100644 index 0000000000000000000000000000000000000000..08b2d9b2a6f17b1285870ee197618a329b55d590 Binary files /dev/null and b/installation_instructions/macintosh/images/on_first_launch.png differ diff --git a/installation_instructions/macintosh/images/on_open_in_finder.png b/installation_instructions/macintosh/images/on_open_in_finder.png new file mode 100644 index 0000000000000000000000000000000000000000..8c9b1951e1c95be5acdbb0154174903ae70738bd Binary files /dev/null and b/installation_instructions/macintosh/images/on_open_in_finder.png differ diff --git a/installation_instructions/macintosh/installation_instructions.md b/installation_instructions/macintosh/installation_instructions.md index fd7fb5a003933c94968a56f77174b03a3f8c0f13..da6419d285cb89daf698f1b43b9b7bddb3cad305 100644 --- a/installation_instructions/macintosh/installation_instructions.md +++ b/installation_instructions/macintosh/installation_instructions.md @@ -44,7 +44,9 @@ The line that reads `"debugger": false` needs to be changed to be `"debugger": t ## 4. Associate Notebook Files with Jupyter Lab -The files that we will be working with this semester are called *Jupyter Notebook* files. These files have a file extension of `.ipynb`. You can make it so that when you double click on a file that ends in `.ipynb` it will be opened by Jupyter Lab. Download the [Test Configuration Notebook](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-lecture-material/-/raw/main/installation_instructions/test_configuration.ipynb?ref_type=heads&inline=false) and a [Jupyter Lab Associator Program](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-lecture-material/-/raw/main/installation_instructions/JupyterLabLaunchAssociator.zip?ref_type=heads&inline=false) which we will use to make the file assocation. Open your Downloads folder with finder. Click on the `JupyterLabLaunchAssociator.zip` file and type Command-C to copy the file name. Then control-click on the "Downloads" folder at the top of the window to see the parent directories and select the folder with your username. +The files that we will be working with this semester are called *Jupyter Notebook* files. These files have a file extension of `.ipynb`. You can make it so that when you double click on a file that ends in `.ipynb` it will be opened by Jupyter Lab. + +Download the [Test Configuration Notebook](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-lecture-material/-/raw/main/installation_instructions/test_configuration.ipynb?ref_type=heads&inline=false) and a [Jupyter Lab Associator Program](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-lecture-material/-/raw/main/installation_instructions/JupyterLabLaunchAssociator.zip?ref_type=heads&inline=false) which we will use to make the file assocation. Open your Downloads folder with finder. Click once on the `JupyterLabLaunchAssociator.zip` file and type Command-C to copy the file name. Then control-click on the "Downloads" folder at the top of the window to see the parent directories and select the folder with your username.  @@ -60,7 +62,19 @@ In the window browse to where you expanded the zip file to extract the applicati -Go back to the Downloads folder and double-click to try and open the notebook file. +Go back to the Downloads folder and double-click to try and open the notebook file. You will probably get one of two errors + +<img alt="Cannot Verify" src="images/cannot_verify_notebook.png" width="50%"> + +<img alt="Cannot Open Error" src="images/cannot_open.png" width="50%"> + +On the first error click "Open" and then on the second error click the "Show in Finder" button. On the laucher logo control-click and select open. + +<img alt="after ctrl-click on launcher log" src="images/on_open_in_finder.png" width="50%"> + +Then, on this final error, click the "Open" button. + +<img alt="on first launch" src="images/on_first_launch.png" width="50%"> ## 5. Test the configuration diff --git a/installation_instructions/windows/installation_instructions.md b/installation_instructions/windows/installation_instructions.md index c1dffac1a0d644d1771c4e97915ff79692ea5f18..6965ba5afed0d55746c19507f31469a37da4206d 100644 --- a/installation_instructions/windows/installation_instructions.md +++ b/installation_instructions/windows/installation_instructions.md @@ -14,12 +14,12 @@ This document will walk you through the steps you need to perform to install and On the download page, it should have detected your operating system and provided a link at the top of the page for the proper version. - Download and run the installer. On the "Install for:" page select "Just Me (recommended)" and then accept the default installation folder.  - + On the Advanced Installation Options, keep the default first and third checkmarks to create a shortcut and register Anaconda3 as the default for Python. @@ -42,7 +42,7 @@ You will be submitting your code to our grader, which is running a slightly olde ## 3. Enable the debugger -One feature of Jupyter Lab that we will use this semester in the debugger. It is disabled by default. To enable it you will need to edit a text file. Start by opening the file explorer +One feature of Jupyter Lab that we will use this semester is the debugger. It is disabled by default. To enable it you will need to edit a text file. Start by opening the file explorer  and in the sidebar, click on *home*. 