Skip to content

Commit 083bae8

Browse files
docs: replace outdated Grunt commands with npm/Vitest equivalents in test section #7871
1 parent 49234c5 commit 083bae8

1 file changed

Lines changed: 14 additions & 22 deletions

File tree

contributor_docs/es/steward_guidelines.md

Lines changed: 14 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ El archivo Gruntfile.js contiene las definiciones principales de construcción p
180180
### Tarea Principal de Construcción
181181

182182
```
183-
grunt.registerTask('default', ['lint', 'test']);
183+
npm test
184184
```
185185

186186
Cuando ejecutamos `grunt` o el script npm `npm test`, ejecutamos la tarea predeterminada que consiste en `lint` y luego `test`.
@@ -189,7 +189,7 @@ Cuando ejecutamos `grunt` o el script npm `npm test`, ejecutamos la tarea predet
189189
#### Tarea `lint`
190190

191191
```
192-
grunt.registerTask('lint', ['lint:source', 'lint:samples']);
192+
npm run lint
193193
```
194194

195195
La tarea `lint` consiste en dos sub tareas: `lint:source` y `lint:samples`. `lint:source` está subdividida aún más en tres sub tareas adicionales: `eslint:build`, `eslint:source` y `eslint:test`, que utilizan ESLint para verificar los scripts de construcción, el código fuente y los scripts de prueba.
@@ -201,26 +201,20 @@ A continuación en `lint:samples` está `eslint-samples:source`, que es una tare
201201

202202
#### Tarea `test`
203203

204-
```js
205-
grunt.registerTask('test', [
206-
'build',
207-
'connect:server',
208-
'mochaChrome',
209-
'mochaTest',
210-
'nyc:report'
211-
]);
204+
En la rama `dev-2.0`, la tarea `test` de Grunt ha sido reemplazada por un comando moderno de `npm`:
205+
206+
```
207+
npm test
212208
```
213209

214-
Primero, veamos la tarea `build` dentro de `test`.
210+
Este comando ejecuta la suite de pruebas completa usando [Vitest](https://vitest.dev/), e incluye cobertura y pruebas en múltiples entornos según sea necesario.
211+
215212

216-
```js
217-
grunt.registerTask('build', [
218-
'browserify',
219-
'browserify:min',
220-
'uglify',
221-
'browserify:test'
222-
]);
223213
```
214+
npm run build
215+
```
216+
217+
Este comando construye la biblioteca `p5.js` utilizando herramientas modernas como [Vite](https://vitejs.dev/) o configuraciones personalizadas según `package.json`. Sustituye completamente los pasos anteriores que usaban `browserify` y `uglify`.
224218

225219
Las tareas que comienzan con `browserify` están definidas en [./tasks/build/browserify.js](tasks/build/browserify.js). Todas siguen pasos similares con diferencias menores. Estos son los pasos principales para construir la biblioteca completa de p5.js a partir de sus numerosos archivos fuente en uno solo:
226220

@@ -270,17 +264,15 @@ Finalmente, después de que todas las construcciones y pruebas estén completas,
270264
Todos los pasos pueden ejecutarse directamente con `npx grunt [step]`. También hay algunas tareas que no se mencionan arriba pero podrían ser útiles en ciertos casos.
271265

272266
```
273-
grunt yui:dev
267+
npm test
274268
```
275269

276270
Esta tarea ejecutará las construcciones de documentación y biblioteca descritas arriba, seguidas de la puesta en marcha de un servidor web que sirve una versión funcionalmente similar de la página de referencia que encontrarás en el sitio web en [http://localhost:9001/docs/reference/](http://localhost:9001/docs/reference/). Luego, supervisará el código fuente en busca de cambios y reconstruirá la documentación y la biblioteca.
277271

278272
`grunt` `yui:dev` es útil cuando estás trabajando en la referencia en la documentación en línea porque no necesitas mover archivos construidos del repositorio de p5.js a un repositorio local de un sitio de p5.js y reconstruir el sitio web cada vez que hagas un cambio, y puedes previsualizar tus cambios con esta versión ligeramente simplificada de la referencia en tu navegador. De esta manera, también puedes tener más confianza en que los cambios que hiciste probablemente se mostrarán correctamente en el sitio web. Ten en cuenta que esto solo está destinado a modificaciones en la documentación en línea; los cambios en la página de referencia en sí, incluido el estilo y el diseño, deben hacerse y probarse en el repositorio del sitio web.
279273

280274
```
281-
grunt watch
282-
grunt watch:main
283-
grunt watch:quick
275+
npm run watch
284276
```
285277

286278
Las tareas de observación vigilarán una serie de archivos en busca de cambios y ejecutarán tareas asociadas para construir la referencia o la biblioteca según los archivos que hayan cambiado. Estas tareas hacen lo mismo, la única diferencia es el alcance.

0 commit comments

Comments
 (0)