|
2 | 2 | title: "Installation"
|
3 | 3 | ---
|
4 | 4 |
|
5 |
| -## Install development dependencies in a VSCode Dev Container |
| 5 | +## Install all dependencies in a VSCode Dev Container |
6 | 6 |
|
7 | 7 | If you use VSCode with Docker to develop in a container, the following VSCode Dev Container configuration will install all dependencies:
|
8 | 8 |
|
9 | 9 | ``` json
|
10 | 10 | {
|
11 | 11 | "name": "Python 3",
|
12 | 12 | "image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
|
13 |
| - "postCreateCommand": "sudo apt update && sudo apt install -y python3-dev libpq-dev graphviz && pipx install poetry && poetry install && poetry shell", |
| 13 | + "postCreateCommand": "sudo apt update && sudo apt install -y python3-dev libpq-dev graphviz && quarto add mcanouil/quarto-iconify && pipx install poetry && poetry install && poetry shell", |
14 | 14 | "features": {
|
15 | 15 | "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {},
|
16 | 16 | "ghcr.io/rocker-org/devcontainer-features/quarto-cli:1": {}
|
@@ -45,48 +45,53 @@ For Windows:
|
45 | 45 |
|
46 | 46 | - No installation required
|
47 | 47 |
|
48 |
| -### Quarto CLI and Graphviz |
| 48 | +### Python dependencies |
49 | 49 |
|
50 |
| -- [Quarto CLI](https://quarto.org/docs/get-started/) |
| 50 | +1. Install Poetry |
51 | 51 |
|
| 52 | +``` bash |
| 53 | +pipx install poetry |
| 54 | +``` |
52 | 55 |
|
53 |
| -For macOS: |
| 56 | +2. Install project dependencies |
54 | 57 |
|
55 | 58 | ``` bash
|
56 |
| -brew install graphviz |
| 59 | +poetry install |
57 | 60 | ```
|
58 | 61 |
|
59 |
| -For Ubuntu/Debian: |
| 62 | +3. Activate shell |
60 | 63 |
|
61 | 64 | ``` bash
|
62 |
| -sudo apt update && sudo apt install -y graphviz |
| 65 | +poetry shell |
63 | 66 | ```
|
64 | 67 |
|
65 |
| -For Windows: |
| 68 | +(Note: You will need to activate the shell every time you open a new terminal session. Alternatively, you can use the `poetry run` prefix before other commands to run them without activating the shell.) |
66 | 69 |
|
67 |
| -- Download and install from [Graphviz.org](https://graphviz.org/download/#windows) |
| 70 | +## Install documentation dependencies manually |
68 | 71 |
|
69 |
| -### Python dependencies |
| 72 | +### Quarto CLI |
70 | 73 |
|
71 |
| -1. Install Poetry |
| 74 | +To render the project documentation, you will need to download and install the [Quarto CLI](https://quarto.org/docs/get-started/) for your operating system. |
72 | 75 |
|
73 |
| -``` bash |
74 |
| -pipx install poetry |
75 |
| -``` |
| 76 | +### Graphviz |
76 | 77 |
|
77 |
| -2. Install project dependencies |
| 78 | +Architecture diagrams in the documentation are rendered with [Graphviz](https://graphviz.org/). |
| 79 | + |
| 80 | +For macOS: |
78 | 81 |
|
79 | 82 | ``` bash
|
80 |
| -poetry install |
| 83 | +brew install graphviz |
81 | 84 | ```
|
82 | 85 |
|
83 |
| -3. Activate shell |
| 86 | +For Ubuntu/Debian: |
84 | 87 |
|
85 | 88 | ``` bash
|
86 |
| -poetry shell |
| 89 | +sudo apt update && sudo apt install -y graphviz |
87 | 90 | ```
|
88 | 91 |
|
89 |
| -(Note: You will need to activate the shell every time you open a new terminal session. Alternatively, you can use the `poetry run` prefix before other commands to run them without activating the shell.) |
| 92 | +For Windows: |
| 93 | + |
| 94 | +- Download and install from [Graphviz.org](https://graphviz.org/download/#windows) |
90 | 95 |
|
91 | 96 | ## Set environment variables
|
92 | 97 |
|
|
0 commit comments