Using the software (terminal)

These instructions are for Linux and macOS. Windows users can follow these instructions on PowerShell, but double-clicking a desktop shortcut is simpler.

Regular use

Every time you want to work on the M269 notebooks, you need to follow the next 5 steps.

  1. Open a new terminal. Do not use an already opened terminal.

  2. Enter m269-26j to go to your M269 folder and activate the M269 software. The command line prompt becomes (m269-26j) ... to remind you that you’re using the M269 software and not your default Python installation.

  3. Enter nb to start working with notebooks. After a little while, a web browser opens, with JupyterLab listing the contents of your M269 folder. You can now open the M269 book: double-click subfolder notebooks, then file M269.ipynb.

  4. After finishing working on the notebooks, click on File > Shut Down and then close the browser tab.

  5. Close the terminal you opened in step 1.

Handling errors

If you forgot to type m269-26j(i.e. skipped step 2 by mistake), then entering nb (step 3) will still activate the M269 software but Jupyter will start in your current folder rather than the M269 folder, and you won’t see the M269 materials in JupyterLab. When this happens, do step 4 to close JupyterLab and then go back to step 2.

macOS: If steps 2 and 3 (the m269-26j and nb commands) don’t work, and you are using bash, enter in the terminal

 echo 'if [ -f ~/.bashrc ]; then source ~/.bashrc; fi' >> ~/.bash_profile

Then close the terminal, and start again from step 1.

Important note

Never install third-party software while the M269 software is active, i.e. after step 2 and before step 5, as that may change the M269 software installation and break it. It is however possible to upgrade the M269 software between steps 2 and 3.

⇦ Upgrading ⇧ Home Uninstalling ⇨