Skip to content

Commit

Permalink
changes per carpentries/workshop-template#837
Browse files Browse the repository at this point in the history
  • Loading branch information
@n2ygk
n2ygk committed Dec 17, 2024
1 parent 5515662 commit e966e3f
Showing 1 changed file with 51 additions and 44 deletions.
95 changes: 51 additions & 44 deletions _includes/install_instructions/python.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,9 @@ <h3>Python</h3>
<p>
<a href="https://python.org">Python</a> is a popular language for
research computing, and great for general-purpose programming as
well. Installing all of its research packages individually can be
a bit difficult, so we recommend
<a href="https://www.anaconda.com/download/success">Anaconda</a>,
an all-in-one installer.
well. We'll be using some standard tools to first install Python
and then the packages required for this workshop using
<a href="https://pip.pypa.io/en/stable/installation/">pip</a>.
</p>

<p>
Expand All @@ -29,8 +28,8 @@ <h3>Python</h3>
if you do not plan to use Jupyter Notebook environment.
{% endcomment %}
<p>
We will teach Python using the <a href="https://jupyter.org/">Jupyter Notebook</a>,
a programming environment that runs in a web browser (Jupyter Notebook will be installed by Anaconda). For this to work you will need a reasonably
We will teach Python using the <a href="https://jupyter.org/">Jupyter Lab notebooks</a>,
a programming environment that runs in a web browser (Jupyter Lab will be installed by pip). For this to work you will need a reasonably
up-to-date browser. The current versions of the Chrome, Safari and
Firefox browsers are all
<a href="https://jupyter-notebook.readthedocs.io/en/stable/notebook.html#browser-compatibility">supported</a>
Expand All @@ -48,9 +47,23 @@ <h3>Python</h3>
<div class="tab-content">
<article role="tabpanel" class="tab-pane active" id="python-windows">
<ol>
<li>Open <a href="https://www.anaconda.com/download/success">https://www.anaconda.com/download/success</a> with your web browser.</li>
<li>Download the Anaconda for Windows installer with Python 3. (If you are not sure which version to choose, you probably want the 64-bit Graphical Installer <em>Anaconda3-...-Windows-x86_64.exe</em>)</li>
<li>Install Python 3 by running the Anaconda Installer, using all of the defaults for installation <em>except</em> make sure to check <strong>Add Anaconda to my PATH environment variable</strong>.</li>
<li>Open <a href="https://www.python.org/downloads/">https://www.python.org/downloads/</a> with your web browser.</li>
<li>Click on <kbd>Download Python 3.x.y</kbd> under "Download the latest version for Windows" near the top.</li>
<li>Click on the downloaded installer and run it.</li>
<li>You'll see a popup window from the installer. Check the "Add python.exe to PATH" box near the bottom
and then click <kbd>Install Now</kbd>.</li>
<li>To confirm that it's installed, open git-bash (installed per the instructions above)
and type <kbd>python --version</kbd>. This should print something like:"Python 3.12.5".</li>
<li>Next we'll install Jupyter Lab and the various Python packages we'll be using.
These will all be installed in a Python "Virtual Environment" (venv). Type these commands in the git-bash shell:
<pre>
cd ~/Desktop
python -m venv venv
source venv/Scripts/activate
pip install jupyterlab ipywidgets pandas matplotlib
</pre>
That last step will take a while and will print a lot of progress output showing the packages being installed.
</li>
</ol>
<h4>Video Tutorial</h4>
<div class="yt-wrapper2">
Expand All @@ -61,10 +74,23 @@ <h4>Video Tutorial</h4>
</article>
<article role="tabpanel" class="tab-pane" id="python-macos">
<ol>
<li>Open <a href="https://www.anaconda.com/download/success">https://www.anaconda.com/download/success</a> with your web browser.</li>
<li>Download the Anaconda Installer with Python 3 for macOS (you can either use the Graphical or the Command Line Installer).</li>
<li>Install Python 3 by running the Anaconda Installer using all of the defaults for installation.</li>
<li>Open <a href="https://www.python.org/downloads/">https://www.python.org/downloads/</a> with your web browser.</li>
<li>Click on <kbd>Download Python 3.x.y</kbd> under "Download the latest version for macOS" near the top.</li>
<li>Click on the downloaded installer and run it, responding to the license agreement prompt, and so on.</li>
<li>To confirm that it's installed, open Terminal
and type <kbd>python --version</kbd>. This should print something like:"Python 3.12.5".</li>
<li>Next we'll install Jupyter Lab and the various Python packages we'll be using.
These will all be installed in a Python "Virtual Environment" (venv). Type these commands in the git-bash shell:
<pre>
cd ~/Desktop
python -m venv venv
source venv/bin/activate
pip install jupyterlab ipywidgets pandas matplotlib
</pre>
That last step will take a while and will print a lot of progress output showing the packages being installed.
</li>
</ol>

<h4>Video Tutorial</h4>
<div class="yt-wrapper2">
<div class="yt-wrapper">
Expand All @@ -73,39 +99,20 @@ <h4>Video Tutorial</h4>
</div>
</article>
<article role="tabpanel" class="tab-pane" id="python-linux">
Python is usually already installed on most Linux distributions.
<ol>
<li>Open <a href="https://www.anaconda.com/download/success">https://www.anaconda.com/download/success</a> with your web browser.</li>
<li>Download the Anaconda Installer with Python 3 for Linux.<br>
(The installation requires using the shell. If you aren't
comfortable doing the installation yourself
stop here and request help at the workshop.)
</li>
<li>
Open a terminal window and navigate to the directory where
the executable is downloaded (e.g., `cd ~/Downloads`).
</li>
<li>
Type <pre>bash Anaconda3-</pre> and then press
<kbd>Tab</kbd> to autocomplete the full file name. The name of
file you just downloaded should appear.
</li>
<li>
Press <kbd>Enter</kbd>
(or <kbd>Return</kbd> depending on your keyboard).
You will follow the text-only prompts.
To move through the text, press <kbd>Spacebar</kbd>.
Type <code>yes</code> and press enter to approve the license.
Press <kbd>Enter</kbd> (or <kbd>Return</kbd>)
to approve the default location
for the files.
Type <code>yes</code> and press
<kbd>Enter</kbd> (or <kbd>Return</kbd>)
to prepend Anaconda to your <code>PATH</code>
(this makes the Anaconda distribution the default Python).
</li>
<li>
Close the terminal window.
</li>
<li>To confirm that it's installed, open a terminal
and type <kbd>python3 --version</kbd>. This should print something like:"Python 3.12.5".</li>
<li>Next we'll install Jupyter Lab and the various Python packages we'll be using.
These will all be installed in a Python "Virtual Environment" (venv). Type these commands in the git-bash shell:
<pre>
cd
python3 -m venv venv
source venv/bin/activate
pip install jupyterlab ipywidgets pandas matplotlib
</pre>
That last step will take a while and will print a lot of progress output showing the packages being installed.
</li>
</ol>
</article>
</div>
Expand Down

0 comments on commit e966e3f

Please sign in to comment.