|
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