Skip to content

Commit 139d778

Browse files
committed
Update Windows instructions based on suggestions from Eli
1 parent 21b1c4e commit 139d778

2 files changed

Lines changed: 12 additions & 3 deletions

File tree

manual/installation.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,9 @@ To check whether Python is already installed and which version you have, open a
3030
python3 --version
3131
```
3232

33+
{: .note }
34+
On Windows, the command is typically `python` rather than `python3`. Use whichever works on your system. The rest of this guide uses `python3`, but Windows users should substitute `python` where needed.
35+
3336
You should see output like `Python 3.11.9` or `Python 3.12.3`. Any version 3.11 or higher is fine. If the command is not found, or the version is older than 3.11, install Python using the instructions for your operating system below.
3437

3538
### macOS
@@ -89,16 +92,22 @@ python3 -m venv .venv
8992
```fish
9093
source .venv/bin/activate.fish
9194
```
95+
- Windows Command Prompt (`cmd.exe`):
96+
```
97+
.venv\Scripts\activate.bat
98+
```
9299
- Windows PowerShell:
93100
```powershell
94101
.venv\Scripts\Activate.ps1
95102
```
96103

97-
> On a fresh Windows install, PowerShell's default execution policy blocks running `.ps1` scripts. To allow it, run the following once in PowerShell — this only needs to be done once per user account and does not require administrator privileges:
104+
> On a fresh Windows install, PowerShell's default execution policy blocks running `.ps1` scripts. If you see an error like `Activate.ps1 cannot be loaded because running scripts is disabled on this system`, run the following command first:
98105
>
99106
> ~~~powershell
100-
> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
107+
> Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
101108
> ~~~
109+
>
110+
> This only affects the current PowerShell session and resets when you close the terminal. Then re-run `.venv\Scripts\Activate.ps1`. Alternatively, use Command Prompt (`cmd.exe`) with `.venv\Scripts\activate.bat` instead, which does not require changing the execution policy.
102111
{: .warning }
103112
104113
Once activated, your prompt will show the name of the environment (e.g., `(.venv)`).

manual/web-editor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ProofFrog includes a browser-based editor that gives you a graphical environment
1818
## Launching
1919

2020
{: .important }
21-
**Activate your Python virtual environment first.** In every new terminal, run `source .venv/bin/activate` (macOS/Linux bash/zsh), `source .venv/bin/activate.fish` (fish), or `.venv\Scripts\Activate.ps1` (Windows PowerShell) before invoking `proof_frog`. See [Installation]({% link manual/installation.md %}).
21+
**Activate your Python virtual environment first.** In every new terminal, run `source .venv/bin/activate` (macOS/Linux bash/zsh), `source .venv/bin/activate.fish` (fish), `.venv\Scripts\Activate.ps1` (Windows PowerShell), or `.venv\Scripts\activate.bat` (Windows Command Prompt) before invoking `proof_frog`. See [Installation]({% link manual/installation.md %}).
2222

2323
```bash
2424
proof_frog web [directory]

0 commit comments

Comments
 (0)