From e062f5bd13526c712023d557bb2da4d7a3fd479a Mon Sep 17 00:00:00 2001
From: unknown <yunhao319016@gmail.com>
Date: Wed, 22 Jan 2025 19:30:35 -0600
Subject: [PATCH] changing windows and mac faq sections
---
.../macintosh/installation_instructions.html | 5 ++++-
.../macintosh/installation_instructions.ipynb | 16 ++++++++++++++--
.../windows/installation_instructions.html | 2 ++
.../windows/installation_instructions.ipynb | 9 ++++++++-
4 files changed, 28 insertions(+), 4 deletions(-)
diff --git a/installation_instructions/macintosh/installation_instructions.html b/installation_instructions/macintosh/installation_instructions.html
index cf41075..e88a510 100644
--- a/installation_instructions/macintosh/installation_instructions.html
+++ b/installation_instructions/macintosh/installation_instructions.html
@@ -7510,7 +7510,7 @@ a.anchor-link {
<p>In your username directory type option-command-V to move the zip file here and double-click on the zip file to extract the application.</p>
<p>In finder, go back to the Download's directory and control-click on the notebook file you downloaded. In the pop-up menu select "open with -> other..." option</p>
<p><img alt="other option" src="images/other_open.png"/></p>
-<p>In the window browse to where you expanded the zip file to extract the application (i.e. click Download then go to the parent directory) and select the JupyterLabLauncher.app icon. Before you click "Open" make sure you checkmark the "Always Open With" checkbox.</p>
+<p>In the window browse to where you expanded the zip file to extract the application (i.e. click Download then go to the parent directory) and select the JupyterLabLauncher.app icon. Before you click "Open" make sure you change the "Enable" to be "All Applications" and checkmark the "Always Open With" checkbox. If you can't find the JupyterLabLaunchAssociator" App, try using the search bar at the top right corner to search for it.</p>
<p><img alt="jupyterlab launch associator" src="images/open_with_launcher.png"/></p>
<p>Go back to the Downloads folder and double-click to try and open the notebook file. You will probably get one of two errors</p>
<img alt="Cannot Verify" src="images/cannot_verify_notebook.png" width="50%"/>
@@ -7520,6 +7520,9 @@ a.anchor-link {
<p>Then, on this final error, click the "Open" button.</p>
<img alt="on first launch" src="images/on_first_launch.png" width="50%"/>
<h2 id="5.-Test-the-configuration">5. Test the configuration<a class="anchor-link" href="#5.-Test-the-configuration">¶</a></h2><p>Now, whenever you double-click on a Jupyter Notebook file, it should open that file in Jupyter Lab. Follow the steps in the notebook to check your configuration and your software should be installed and configured correctly.</p>
+<h2 id="6.-FAQ">6. FAQ<a class="anchor-link" href="#6.-FAQ">¶</a></h2><h4 id="1)-I-got-an-error-about-mac-malware-not-allowing-the-app-or-the-notebook-to-open,-what-should-I-do?">1) I got an error about mac malware not allowing the app or the notebook to open, what should I do?<a class="anchor-link" href="#1)-I-got-an-error-about-mac-malware-not-allowing-the-app-or-the-notebook-to-open,-what-should-I-do?">¶</a></h4><p>If MacOS is preventing opening jupyter launch associater the .ipynb file (the notebook file), first go to the mac apple symbol, click system settings, then go to privacy and security. Then scroll all the way down to the bottom and you should see something about mac prevented jupyterlab to open. You can press allow anyways on these then open them again.</p>
+<h4 id="2)-I-can't-click-the-jupyterlauncher-app-in-open-with,-what-should-I-do?">2) I can't click the jupyterlauncher app in open with, what should I do?<a class="anchor-link" href="#2)-I-can't-click-the-jupyterlauncher-app-in-open-with,-what-should-I-do?">¶</a></h4><p>Make sure that you change "Enable" at the bootm to All Applications and select Always open with.</p>
+<h4 id="3)-I-tried-to-install-anaconda-and-it-says-/opt/anaconda3-already-exist.">3) I tried to install anaconda and it says /opt/anaconda3 already exist.<a class="anchor-link" href="#3)-I-tried-to-install-anaconda-and-it-says-/opt/anaconda3-already-exist.">¶</a></h4><p>This usually happens when you tried to uninstall anaconda and install it again, but now /opt/anaconda3 is not being deleted when you uninstalled anaconda. To resolve this issue, in the terminal, type "cd /opt" and press Enter. Then type "ls" and press Enter. You should see a folder named "anaconda3" listed. Finally, type "sudo rm -rf anaconda3" and press enter, mac will asked for your password. After typed in your password and press Enter, you will delete the old anaconda3 folder. Now you should be able to install anaconda3.</p>
</div>
</div>
</div>
diff --git a/installation_instructions/macintosh/installation_instructions.ipynb b/installation_instructions/macintosh/installation_instructions.ipynb
index 7e12086..93d0ed7 100644
--- a/installation_instructions/macintosh/installation_instructions.ipynb
+++ b/installation_instructions/macintosh/installation_instructions.ipynb
@@ -63,7 +63,7 @@
"\n",
"\n",
"\n",
- "In the window browse to where you expanded the zip file to extract the application (i.e. click Download then go to the parent directory) and select the JupyterLabLauncher.app icon. Before you click \"Open\" make sure you checkmark the \"Always Open With\" checkbox.\n",
+ "In the window browse to where you expanded the zip file to extract the application (i.e. click Download then go to the parent directory) and select the JupyterLabLauncher.app icon. Before you click \"Open\" make sure you change the \"Enable\" to be \"All Applications\" and checkmark the \"Always Open With\" checkbox. If you can't find the JupyterLabLaunchAssociator\" App, try using the search bar at the top right corner to search for it. \n",
"\n",
"\n",
"\n",
@@ -86,7 +86,19 @@
"\n",
"## 5. Test the configuration\n",
"\n",
- "Now, whenever you double-click on a Jupyter Notebook file, it should open that file in Jupyter Lab. Follow the steps in the notebook to check your configuration and your software should be installed and configured correctly."
+ "Now, whenever you double-click on a Jupyter Notebook file, it should open that file in Jupyter Lab. Follow the steps in the notebook to check your configuration and your software should be installed and configured correctly.\n",
+ "\n",
+ "\n",
+ "## 6. FAQ\n",
+ "\n",
+ "#### 1) I got an error about mac malware not allowing the app or the notebook to open, what should I do?\n",
+ "If MacOS is preventing opening jupyter launch associater the .ipynb file (the notebook file), first go to the mac apple symbol, click system settings, then go to privacy and security. Then scroll all the way down to the bottom and you should see something about mac prevented jupyterlab to open. You can press allow anyways on these then open them again. \n",
+ "\n",
+ "#### 2) I can't click the jupyterlauncher app in open with, what should I do?\n",
+ "Make sure that you change \"Enable\" at the bootm to All Applications and select Always open with.\n",
+ "\n",
+ "#### 3) I tried to install anaconda and it says /opt/anaconda3 already exist.\n",
+ "This usually happens when you tried to uninstall anaconda and install it again, but now /opt/anaconda3 is not being deleted when you uninstalled anaconda. To resolve this issue, in the terminal, type \"cd /opt\" and press Enter. Then type \"ls\" and press Enter. You should see a folder named \"anaconda3\" listed. Finally, type \"sudo rm -rf anaconda3\" and press enter, mac will asked for your password. After typed in your password and press Enter, you will delete the old anaconda3 folder. Now you should be able to install anaconda3.\n"
]
}
],
diff --git a/installation_instructions/windows/installation_instructions.html b/installation_instructions/windows/installation_instructions.html
index 7044823..e80d1fc 100644
--- a/installation_instructions/windows/installation_instructions.html
+++ b/installation_instructions/windows/installation_instructions.html
@@ -7545,6 +7545,8 @@ b. Follow the instrcution in this <a href="https://www.geeksforgeeks.org/how-to-
<p>But now you will see a "(base)" in front. This tells you that you are in the conda environment. Now type "python --version" and <code>shift</code> + <code>enter</code> to see what is the current python version in conda environment. If it is not correct, follow the above instruction in the anaconda prompt to install the correct python version.</p>
<p><img alt="anaconda commadn prompt" src="images/image-37.png"/></p>
<h4 id="5)-My-debugger-is-not-working">5) My debugger is not working<a class="anchor-link" href="#5)-My-debugger-is-not-working">¶</a></h4><p>Open up the <code>kernel.json</code> file. Double check whether you have correctly changed and saved the content in the <code>kernel.json</code>.</p>
+<h4 id="6)-I-encountered-%22CodeVerificationError%22">6) I encountered "CodeVerificationError"<a class="anchor-link" href="#6)-I-encountered-%22CodeVerificationError%22">¶</a></h4><p>During installation of python 3.10.12, you might encountered "CodeVerificationError". The general solution is to uninstalled anaconda and installed it again following this <a href="https://docs.anaconda.com/anaconda/uninstall/">link</a>. You might want to install the "64-Bit Graphical Installer (912.3M)" under the windows logo at the download page. That should fix most of the cases.</p>
+<h4 id="7)-I-encountered-%22Executing-transaction:-%5C-menuinst-Exception%22">7) I encountered "Executing transaction: \ menuinst Exception"<a class="anchor-link" href="#7)-I-encountered-%22Executing-transaction:-%5C-menuinst-Exception%22">¶</a></h4><p>During installation of python 3.10.12, you might encountered "Executing transaction: \ menuinst Exception" error. To resolve this error, first press "ctrl + c" on your keyboard to terminate the installation process. Then type "conda update conda" and press enter on the keyboard. This will install some packages and might take awhile. After the update is done, try running "conda install python=3.10.12" again and you should be able to download python successfully.</p>
</div>
</div>
</div>
diff --git a/installation_instructions/windows/installation_instructions.ipynb b/installation_instructions/windows/installation_instructions.ipynb
index 1c9434f..4bcfd2a 100644
--- a/installation_instructions/windows/installation_instructions.ipynb
+++ b/installation_instructions/windows/installation_instructions.ipynb
@@ -140,7 +140,14 @@
"\n",
"\n",
"#### 5) My debugger is not working\n",
- "Open up the `kernel.json` file. Double check whether you have correctly changed and saved the content in the `kernel.json`. "
+ "Open up the `kernel.json` file. Double check whether you have correctly changed and saved the content in the `kernel.json`. \n",
+ "\n",
+ "#### 6) I encountered \"CodeVerificationError\"\n",
+ "During installation of python 3.10.12, you might encountered \"CodeVerificationError\". The general solution is to uninstalled anaconda and installed it again following this [link](https://docs.anaconda.com/anaconda/uninstall/). You might want to install the \"64-Bit Graphical Installer (912.3M)\" under the windows logo at the download page. That should fix most of the cases. \n",
+ "\n",
+ "#### 7) I encountered \"Executing transaction: \\ menuinst Exception\"\n",
+ "During installation of python 3.10.12, you might encountered \"Executing transaction: \\ menuinst Exception\" error. To resolve this error, first press \"ctrl + c\" on your keyboard to terminate the installation process. Then type \"conda update conda\" and press enter on the keyboard. This will install some packages and might take awhile. After the update is done, try running \"conda install python=3.10.12\" again and you should be able to download python successfully.\n",
+ "\n"
]
}
],
--
GitLab