Skip to content

Commit

Permalink
docs: Document virtualenv for docs project
Browse files Browse the repository at this point in the history
Signed-off-by: Marko Mudrinić <mudrinic.mare@gmail.com>
  • Loading branch information
xmudrii committed Jul 4, 2024
1 parent ef24453 commit 0176237
Showing 1 changed file with 17 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -43,8 +43,24 @@ To participate in the FlyByWire Documentation Project, you need to have the foll
- mike
- pillow
- cairosvg
- Install with this single line command:
- Create and activate a Python Virtual Environment (`virtualenv`) to be used for working on the documentation project:
```title="Run In Terminal"
python -m venv venv
```
Once created, you need to activate it. Use the following command on Windows:
```title="Activating virtualenv on Windows"
.\venv\Scripts\activate.bat
```
Or the following command on Linux and macOS:
```title="Activating virtualenv on Linux and macOS"
source venv/bin/activate
```
!!! info "Using `virtualenv`"
Starting with Python 3.11, the `pip` tool will fail to install dependencies and packages globally, instead it's recommended to use `virtualenv`. If you desire to install packages globally, you must use another tool, such as [`pipx`](https://github.com/pypa/pipx). We recommend using `virtualenv` because it's easier and the recommended way to work on Python projects.
!!! info "Activating `virtualenv`"
It's important to note that `virtualenv` activation is not persisted. If you restart your terminal/command prompt and want to work on the documentation project again, you have to reactivate your `virutalenv` using the appropriate activation command that was shown earlier in this guide.
- Install dependencies with this single line command:
```title="Run In Terminal"
pip install -r requirements.txt
```
Expand Down

0 comments on commit 0176237

Please sign in to comment.