Skip to content

Commit 4085685

Browse files
committed
Add instructions in docs to add python to PATH
1 parent 7ad9c69 commit 4085685

File tree

3 files changed

+21
-11
lines changed

3 files changed

+21
-11
lines changed

docs/Fieldsurveys.qmd

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -76,22 +76,24 @@ If you want to play around with the app before setting up one for your case, fee
7676
![Checking python version on windows machine](assets/check_python_version.gif)
7777

7878
``` bash
79-
python3 --version
79+
python --version
8080
```
8181

8282
OR
8383

8484
``` bash
85-
python --version
85+
python3 --version
8686
```
8787
:::
8888

8989
::: {.callout-important collapse="true" appearance="simple"}
9090
## If Python is not installed
9191

92-
Visit the [official Python downloads page](https://www.python.org/downloads/ "Python download page") and download the desired version of `Python 3`. Run the downloaded package and follow the installation wizard. Check the previous command to ensure python is installed successfully on the machine.
92+
Visit the [official Python downloads page](https://www.python.org/downloads/ "Python download page") and download the desired version of `Python 3`. Run the downloaded package and follow the installation wizard. Check the previous command to ensure python is installed successfully on the machine. Make sure you select the option to \`Add Python to PATH\` during installation.
93+
94+
![Add python to path](assets/add_python_to_path.png)
9395

94-
***Note:*** You may need to add Python to `PATH` if you’ve installed Python, but typing `python` on the command line doesn’t seem to work. Follow instructions [here](https://realpython.com/add-python-to-path/ "Add Python path").
96+
***Note:*** You will need to add Python to `PATH` if you’ve installed Python but did not select that option, follow instructions [here](https://realpython.com/add-python-to-path/ "Add Python path") to amend that.
9597
:::
9698

9799
- `Wheel` python package

docs/assets/add_python_to_path.png

575 KB
Loading

docs/index.html

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -242,9 +242,9 @@ <h2 class="anchored" data-anchor-id="prerequisites">Prerequisites</h2>
242242
<figcaption>Checking python version on windows machine</figcaption>
243243
</figure>
244244
</div>
245-
<div class="sourceCode" id="cb1"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="ex">python3</span> <span class="at">--version</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
245+
<div class="sourceCode" id="cb1"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="ex">python</span> <span class="at">--version</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
246246
<p>OR</p>
247-
<div class="sourceCode" id="cb2"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">python</span> <span class="at">--version</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
247+
<div class="sourceCode" id="cb2"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">python3</span> <span class="at">--version</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
248248
</div>
249249
</div>
250250
</div>
@@ -260,8 +260,14 @@ <h2 class="anchored" data-anchor-id="prerequisites">Prerequisites</h2>
260260
</div>
261261
<div id="callout-2" class="callout-2-contents callout-collapse collapse">
262262
<div class="callout-body-container callout-body">
263-
<p>Visit the <a href="https://www.python.org/downloads/" title="Python download page">official Python downloads page</a> and download the desired version of <code>Python 3</code>. Run the downloaded package and follow the installation wizard. Check the previous command to ensure python is installed successfully on the machine.</p>
264-
<p><strong><em>Note:</em></strong> You may need to add Python to <code>PATH</code> if you’ve installed Python, but typing <code>python</code> on the command line doesn’t seem to work. Follow instructions <a href="https://realpython.com/add-python-to-path/" title="Add Python path">here</a>.</p>
263+
<p>Visit the <a href="https://www.python.org/downloads/" title="Python download page">official Python downloads page</a> and download the desired version of <code>Python 3</code>. Run the downloaded package and follow the installation wizard. Check the previous command to ensure python is installed successfully on the machine. Make sure you select the option to `Add Python to PATH` during installation.</p>
264+
<div class="quarto-figure quarto-figure-center">
265+
<figure class="figure">
266+
<p><img src="assets/add_python_to_path.png" class="img-fluid figure-img"></p>
267+
<figcaption>Add python to path</figcaption>
268+
</figure>
269+
</div>
270+
<p><strong><em>Note:</em></strong> You will need to add Python to <code>PATH</code> if you’ve installed Python but did not select that option, follow instructions <a href="https://realpython.com/add-python-to-path/" title="Add Python path">here</a> to amend that.</p>
265271
</div>
266272
</div>
267273
</div></li>
@@ -492,12 +498,14 @@ <h2 class="anchored" data-anchor-id="deploying-the-app-on-the-web-so-it-can-be-a
492498
<li><p><strong>Verify Your Email</strong>: Fill all the required information and click on the <code>Sign Up</code> button. After creating your account, you’ll receive a verification email. Open the email and click on the verification link to confirm your email address.</p></li>
493499
<li><p><strong>Log in to Your Account</strong>: Once your email is verified, go back to <a href="https://www.shinyapps.io/" title="Shinyapps.io website">Shinyapps.io website</a> and click on the <code>Log In</code> button in the top right corner. Enter your credentials to log in to your account.</p></li>
494500
<li><p><strong>Select Account name:</strong> The first time you sign in, shinyapps.io prompts you to set up your account. <code>shinyapps.io</code> uses the account name as the domain name for all of your apps. Account names <em>must be between four and 63 characters</em> and can <strong>only</strong> contain letters, numbers, and dashes (-).</p></li>
495-
<li><p><strong>Create token:</strong> Click on the the user name on the top right of the page and select <code>Tokens</code> from the dropdown menu.</p></li>
501+
<li><p><strong>Create token:</strong> Click on the the user name on the top right of the page and select <code>Tokens</code> from the drop down menu.</p></li>
496502
<li><p><strong>Add token:</strong> Click on the <code>+ Add Token</code> button. It will add the new token below. Click on the <code>Show</code> button to reveal the token and the secret.</p></li>
497503
<li><p><strong>Copy command to clipboard:</strong> Click on the <code>With Python</code> tab and click on the <code>Copy to clipboard</code> button.</p></li>
498504
<li><p>Open your <strong><em>Terminal</em></strong> on a <code>macOS</code>/<code>Linux</code>machine or <strong><em>Windows PowerShell</em></strong>/<strong><em>Command Prompt</em></strong> on a <code>Windows</code> machine and paste the copied command and hit enter to store the credentials on your machine that will be used for deployment.</p></li>
499-
<li><p>In the <strong><em>Terminal</em></strong> on a <code>macOS</code>/<code>Linux</code>machine or <strong><em>Windows PowerShell</em></strong>/<strong><em>Command Prompt</em></strong>, navigate to the path where your app is located and run the following command to deploy your app</p>
500-
<div class="sourceCode" id="cb9"><pre class="sourceCode bash sh code-with-copy"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="ex">rsconnect</span> deploy shiny . <span class="at">--name</span> <span class="op">&lt;</span>NAME<span class="op">&gt;</span> --title my-app</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div></li>
505+
<li><p>In the <strong><em>Terminal</em></strong> on a <code>macOS</code>/<code>Linux</code>machine or <strong><em>Windows PowerShell</em></strong>/<strong><em>Command Prompt</em></strong>, navigate to the path where your app is located</p>
506+
<div class="sourceCode" id="cb9"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="bu">cd</span> path/to/your_app</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
507+
<p>Then, run the following command to deploy your app</p>
508+
<div class="sourceCode" id="cb10"><pre class="sourceCode bash sh code-with-copy"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="ex">rsconnect</span> deploy shiny . <span class="at">--name</span> <span class="op">&lt;</span>NAME<span class="op">&gt;</span> --title my-app</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div></li>
501509
</ol>
502510
<div class="callout callout-style-default callout-caution callout-titled">
503511
<div class="callout-header d-flex align-content-center">

0 commit comments

Comments
 (0)