You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/install/create-project.md
+16-21Lines changed: 16 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -137,50 +137,45 @@ For the `fish` shell, see [`nvm.fish`](https://github.com/jorgebucaran/nvm.fish)
137
137
138
138
#### Yeoman and the Volto boilerplate generator
139
139
140
-
Install {term}`Yeoman` and the Volto boilerplate generator
140
+
Install {term}`Yeoman` and the Volto boilerplate generator.
141
141
142
142
```shell
143
143
npm install -g yo @plone/generator-volto
144
144
```
145
145
146
+
146
147
(install-prerequisites-yarn-label)=
147
148
148
149
#### Yarn
149
150
151
+
Use {term}`Corepack` to enable Yarn, which was already installed with the {ref}`supported version of Node.js <install-packages-prerequisites-label>`.
152
+
150
153
1. Open a terminal and type:
151
154
152
155
```shell
153
156
corepack enable
154
157
```
155
158
156
-
From that moment on, `yarn` will be available foryou to usein your system.
157
-
This is thanks that `yarn` is shipped with NodeJS since Node 16 (along with other common package managers).
158
-
The version shipped is v1 (classic `yarn`).
159
-
Volto makes sure that you are using the correct version of `yarn` at runtime.
160
-
This is because it's pinned in the Volto boilerplate to use the right version.
161
-
So from this moment on, you don't have to worry about the version of `yarn` you are using, it will adapt to the project's needs.
162
-
163
-
````important
164
-
These instructions will not work if you have used another package manager, such as Homebrew on macOS, to install Yarn.
165
-
You can verify where you installed Yarn and its version.
166
-
Make sure that you are using the yarn version provided by NodeJS by default
159
+
In your generated Volto project from the previous step, you can find the pinned version of Yarn in its {file}`.yarnrc.yml`.
160
+
161
+
````{important}
162
+
The preceding instructions will not work if you have used another package manager, such as Homebrew on macOS, to install Yarn.
163
+
You can verify where you installed Yarn and its version, and compare that to the pinned value of Yarn in your generated Volto project's {file}`.yarnrc.yml`.
164
+
167
165
```shell
168
166
which yarn
169
-
```
170
-
```console
171
-
/opt/homebrew/bin/yarn
172
-
```
173
-
```shell
167
+
# /opt/homebrew/bin/yarn
174
168
yarn -v
169
+
# 3.2.3
175
170
```
176
-
```console
177
-
3.2.3
178
-
```
171
+
179
172
If the console includes `homebrew` in the path, and the version of Yarn is not supported, then you must uninstall it.
0 commit comments