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: contributor_docs/es/steward_guidelines.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
-
# Proceso de construcción
1
+
# Proceso de Construcción
2
2
3
3
Esta sección no cubrirá la configuración general de construcción ni los comandos, sino más bien detalles sobre lo que sucede detrás de escena. Consulta las [directrices para administradores](contributor_guidelines.md#working-on-p5js-codebase) para obtener información más detallada sobre la construcción.
4
4
5
5
El archivo Gruntfile.js contiene las definiciones principales de construcción para p5.js. Entre las diferentes herramientas utilizadas para construir la biblioteca y la documentación se incluyen, pero no se limitan a: Grunt, Browserify, YUIDoc, ESLint, Babel, Uglify y Mocha. Puede ser útil comenzar con la tarea `default` y retroceder desde allí. También puede ser útil abrir el documento Gruntfile.js mientras se sigue la explicación a continuación.
6
6
7
7
8
-
### Tarea principal de construcción
8
+
### Tarea Principal de Construcción
9
9
10
10
```
11
11
grunt.registerTask('default', ['lint', 'test']);
@@ -24,7 +24,7 @@ La tarea `lint` consiste en dos sub tareas: `lint:source` y `lint:samples`. `lin
24
24
25
25
La tarea `lint:samples` primero ejecutará la tarea `yui`, que a su vez consiste en `yuidoc:prod`, `clean:reference` y `minjson`, que extraen la documentación del código fuente en un documento JSON, eliminan archivos no utilizados del paso anterior y minifican el archivo JSON generado en `data.min.json, respectivamente.
26
26
27
-
A continuación en `lint:samples` está `eslint-samples:source`, que es una tarea escrita personalizada cuya definición está en [./tasks/build/eslint-samples.js](tasks/build/eslint-samples.js); ejecutará ESLint para verificar el código de ejemplo de la documentación y asegurarse de que siga la misma convención de codificación que el resto de p5.js (`yui se ejecuta primero aquí porque necesitamos que el archivo JSON se construya primero antes de que podamos aplicar lint a los ejemplos).
27
+
A continuación en `lint:samples` está `eslint-samples:source`, que es una tarea escrita personalizada cuya definición está en [./tasks/build/eslint-samples.js](tasks/build/eslint-samples.js); ejecutará ESLint para verificar el código de ejemplo de la documentación y asegurarse de que siga la misma convención de codificación que el resto de p5.js (`yui` se ejecuta primero aquí porque necesitamos que el archivo JSON se construya primero antes de que podamos aplicar lint a los ejemplos).
28
28
29
29
30
30
#### Tarea `test`
@@ -56,7 +56,7 @@ Las tareas que comienzan con `browserify` están definidas en [./tasks/build/bro
56
56
-`uglify` toma el archivo de salida de `browserify:min` y lo minifica en el p5.min.js final (la configuración de este paso está en el archivo Gruntfile.js principal).
57
57
-`browserify:test` está construyendo una versión idéntica y completa a la de p5.js, salvo por el código adicional que se utiliza para informar sobre la cobertura de código de prueba (usando [Istanbul](https://istanbul.js.org/)).
58
58
59
-
Primero, el uso del código específico de node.js `fs.readFileSync()` es reemplazado por el contenido real del archivo utilizando `brfs-babel`. Esto se utiliza principalmente en el código WebGL para insertar código de shader desde archivos fuente escritos como archivos separados.
59
+
Primero, el uso del código específico de node.js `fs.readFileSync()` es reemplazado por el contenido real del archivo utilizando `brfs-babel`. Esto se utiliza principalmente en el código WebGL para insertar código de <em>shader</em> desde archivos fuente escritos como archivos separados.
60
60
61
61
A continuación, el código fuente, incluidas todas las dependencias de node\_modules, se transpila usando Babel para cumplir con el requisito de [Browserslist](https://browsersl.ist/) definido en package.json, así como para convertir las declaraciones de importación ES6 en `require()` de CommonJS que browserify comprende. Esto también nos permite utilizar una sintaxis más nueva disponible en ES6 y más allá sin la preocupación por la compatibilidad del navegador.
62
62
@@ -91,7 +91,7 @@ Finalmente, después de que todas las construcciones y pruebas estén completas,
91
91
¡Y eso cubre la tarea predeterminada en la configuración de Gruntfile.js!
92
92
93
93
94
-
### Tareas variadas
94
+
### Tarea Variada
95
95
96
96
Todos los pasos pueden ejecutarse directamente con `npx grunt [paso]`. También hay algunas tareas que no se mencionan arriba pero podrían ser útiles en ciertos casos.
97
97
@@ -122,21 +122,21 @@ Dependiendo de en qué estés trabajando, elegir la tarea de observación más m
A veces, la cantidad de issues y PR que requieren revisión puede ser un poco abrumadora. Si bien intentamos implementar procesos que faciliten las cosas, hay algunos consejos y trucos que puedes utilizar para ayudar con la revisión de issues y PRs.
134
+
A veces, la cantidad de <em>issues</em> y PR que requieren revisión puede ser un poco abrumadora. Si bien intentamos implementar procesos que faciliten las cosas, hay algunos consejos y trucos que puedes utilizar para ayudar con la revisión de <em>issues</em> y PRs.
135
135
136
136
137
-
### Plantillas de respuesta
137
+
### Plantillas de Respuesta
138
138
139
-
Una característica útil de GitHub que puedes utilizar es la funcionalidad [Respuestas Hduardadas](https://docs.github.com/en/get-started/writing-on-github/working-with-saved-replies/about-saved-replies), que está disponible para usar al redactar una respuesta a issues o pull requests. Algunos de los flujos de trabajo descritos anteriormente pueden requerir responder a issues o PRs con respuestas idénticas o muy similares (redireccionar preguntas al foro, aceptar un problema para su corrección, etc.), y usar Respuestas Guardadas puede hacer que esto sea un poco más eficiente.
139
+
Una característica útil de GitHub que puedes utilizar es la funcionalidad [Respuestas Guardadas](https://docs.github.com/en/get-started/writing-on-github/working-with-saved-replies/about-saved-replies), que está disponible para usar al redactar una respuesta a <em>issues</em> o <em>pull requests</em>. Algunos de los flujos de trabajo descritos anteriormente pueden requerir responder a <em>issues</em> o PRs con respuestas idénticas o muy similares (redireccionar preguntas al foro, aceptar un problema para su corrección, etc.), y usar Respuestas Guardadas puede hacer que esto sea un poco más eficiente.
140
140
141
141
A continuación, se muestran algunas de las Respuestas Guardadas que están siendo utilizadas por los mantenedores de p5.js. ¡Puedes usarlas tú mismo o crear las tuyas!
142
142
@@ -148,12 +148,12 @@ A continuación, se muestran algunas de las Respuestas Guardadas que están sien
148
148
149
149
##### Cerrando: Necesita Fragmento
150
150
151
-
> Estoy cerrando esto por motivos organizativos. Por favor, reabre si puedes proporcionar un fragmento de código que ilustre el issue. ¡Gracias!
151
+
> Estoy cerrando esto por motivos organizativos. Por favor, reabre si puedes proporcionar un fragmento de código que ilustre el <em>issue</em>. ¡Gracias!
152
152
153
153
154
154
##### Cerrando: Usa el Foro
155
155
156
-
> Los issues de GitHub aquí son un buen lugar para los issues y problemas con la biblioteca p5.js en sí. Para preguntas sobre cómo escribir tu propio código, pruebas o seguir tutoriales, el [foro](https://discourse.processing.org/) es el mejor lugar para publicar. ¡Gracias!
156
+
> Los <em>issues</em> de GitHub aquí son un buen lugar para los <em>issues</em> y problemas con la biblioteca p5.js en sí. Para preguntas sobre cómo escribir tu propio código, pruebas o seguir tutoriales, el [foro](https://discourse.processing.org/) es el mejor lugar para publicar. ¡Gracias!
157
157
158
158
159
159
##### Cerrando: GSOC
@@ -163,22 +163,22 @@ A continuación, se muestran algunas de las Respuestas Guardadas que están sien
163
163
164
164
##### Cerrando: Acceso
165
165
166
-
> No veo mucho interés en esta función, y no tenemos una explicación clara de cómo [amplía el acceso](access.md), así que cerraré esto por ahora. Si se puede agregar una declaración de acceso a la solicitud del issue, no dudes en volver a abrirlo.
166
+
> No veo mucho interés en esta función, y no tenemos una explicación clara de cómo [amplía el acceso](access.md), así que cerraré esto por ahora. Si se puede agregar una declaración de acceso a la solicitud del <em>issue</em>, no dudes en volver a abrirlo.
167
167
168
-
> No vemos una explicación más detallada de cómo esta cuestión [amplía el acceso](access.md), así que cerraré este issue por ahora. Si se puede agregar una declaración de acceso más detallada a la solicitud de función, no dudes en volver a abrirla. ¡Gracias!
168
+
> No vemos una explicación más detallada de cómo esta cuestión [amplía el acceso](access.md), así que cerraré este <em>issue</em> por ahora. Si se puede agregar una declaración de acceso más detallada a la solicitud de función, no dudes en volver a abrirla. ¡Gracias!
169
169
170
170
171
171
##### Cerrando: Complemento
172
172
173
173
> Creo que esta función está fuera del alcance de la API de p5.js (intentamos mantenerla lo más minimalista posible), pero podría ser un gran punto de partida para una biblioteca complementaria. Consulta la documentación aquí sobre cómo crear un complemento: [https://github.com/processing/p5.js/blob/main/contributor\_docs/creating\_libraries.md](creating_libraries.md)
> Gracias. Como recordatorio, primero deben abrirse issues antes de que se abran pull request y etiquetarse con el issue. Esto es necesario para realizar un seguimiento del desarrollo y mantener la discusión clara. ¡Gracias!
178
+
> Gracias. Como recordatorio, primero deben abrirse <em>issues</em> antes de que se abran pull request y etiquetarse con el <em>issue</em>. Esto es necesario para realizar un seguimiento del desarrollo y mantener la discusión clara. ¡Gracias!
179
179
180
180
181
-
##### Aprobar issue para corrección
181
+
##### Aprobar <em>issue</em> para corrección
182
182
183
183
> Puedes seguir adelante con una solución. Gracias.
184
184
@@ -197,15 +197,15 @@ Después de instalar GitHub CLI e iniciar sesión, revisar una PR localmente se
197
197
También hay muchos otros comandos disponibles en GitHub CLI que puedes encontrar útiles o no, pero es una buena herramienta para tener en cualquier caso.
198
198
199
199
200
-
### Gestión de notificaciones
200
+
### Gestión de Notificaciones
201
201
202
-
En lugar de monitorear manualmente las pestañas "Issues" o "Pull Requests" del repositorio en busca de nuevos issues o PRs, puedes "ver" el repositorio haciendo clic en el botón "Watch" con un ícono de ojo en la parte superior de la página del repositorio, frente al nombre del repositorio.
202
+
En lugar de monitorear manualmente las pestañas <em>Issues</em> o <em>Pull Requests</em> del repositorio en busca de nuevos <em>issues</em> o PRs, puedes "ver" el repositorio haciendo clic en el botón <em>Watch</em> con un ícono de ojo en la parte superior de la página del repositorio, frente al nombre del repositorio.
203
203
204
204

205
205
206
-
Al observar un repositorio, eventos como nuevos issues, nuevos pull requests, menciones de tu nombre de usuario y otras actividades a las que te hayas suscrito en el repositorio se enviarán como notificaciones a tu [página de notificaciones](https://github.com/notifications), donde se pueden marcar como leídas o descartadas de la misma manera que un buzón de correo electrónico.
206
+
Al observar un repositorio, eventos como nuevos <em>issues</em>, nuevos <em>pull requests</em>, menciones de tu nombre de usuario y otras actividades a las que te hayas suscrito en el repositorio se enviarán como notificaciones a tu [página de notificaciones](https://github.com/notifications), donde se pueden marcar como leídas o descartadas de la misma manera que un buzón de correo electrónico.
207
207
208
208
En algunos casos, también puedes recibir correos electrónicos de GitHub sobre eventos en el repositorio que estás observando, y puedes personalizarlos (incluida la desuscripción completa de ellos) desde tu [página de configuración de notificaciones](https://github.com/settings/notifications).
209
209
210
-
Configurar estas opciones para que se adapten a la forma en que trabajas puede ser la diferencia entre tener que buscar issues/PRs relevantes para revisar manualmente y sentirse abrumado por notificaciones interminables de GitHub. Se requiere un buen equilibrio aquí. Como sugerencia inicial, los supervisores deberían observar este repositorio para "Issues" y "Pull Requests" y configurarlo para recibir correos electrónicos solo sobre "Participando, @menciones y personalizadas".
210
+
Configurar estas opciones para que se adapten a la forma en que trabajas puede ser la diferencia entre tener que buscar <em>issues</em>/PRs relevantes para revisar manualmente y sentirse abrumado por notificaciones interminables de GitHub. Se requiere un buen equilibrio aquí. Como sugerencia inicial, los supervisores deberían observar este repositorio para <em>Issues</em> y <em>Pull Requests</em> y configurarlo para recibir correos electrónicos solo sobre "Participando, @menciones y personalizadas".
Copy file name to clipboardExpand all lines: contributor_docs/es/webgl_contribution_guide.md
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,8 +7,7 @@ Si estás leyendo esta página, probablemente estés interesado en ayudar a trab
7
7
8
8
- Lee nuestra [visión general de la arquitectura WebGL de p5.js](webgl_mode_architecture.md) para entender cómo difiere el modo WebGL del modo 2D. Esta será una referencia valiosa para algunos detalles de implementación para shaders, trazos y más.
9
9
- Lee nuestras [instrucciones para contribuyentes](https://p5js.org/contributor-docs/#/./contributor_guidelines) para obtener información sobre cómo crear issues, configurar el código base y probar cambios.
10
-
- Puede ser útil conocer un poco sobre la API WebGL del navegador, en la que se basa el modo WebGL de p5.js:
11
-
-[Fundamentos de WebGL](https://webglfundamentals.org/) repasa muchos conceptos básicos de renderización.
10
+
- Puede ser útil conocer un poco sobre la API WebGL del navegador, en la que se basa el modo WebGL de p5.js:[WebGL Fundamentals](https://webglfundamentals.org/) repasa muchos conceptos básicos de renderización.
12
11
-[The Book of Shaders](https://thebookofshaders.com/) explica muchas técnicas utilizadas en shaders de WebGL.
13
12
14
13
@@ -18,12 +17,12 @@ Organizamos <em>issues</em> abiertos [en un Proyecto de GitHub](https://github.c
18
17
19
18
-**Cambios a nivel del sistema** son objetivos a largo plazo con implicaciones de gran alcance en el código. Estos requieren más discusión y planificación antes de comenzar con la implementación.
20
19
-**Errores sin solución aún** son informes de errores que necesitan un poco de depuración para reducir la causa. Estos aún no están listos para ser corregidos: una vez que se encuentra la causa, entonces podemos discutir la mejor manera de corregirla.
21
-
-**Errores con soluciones pero sin <em>PR</em>** son errores donde hemos decidido cómo solucionarlo y están libres para que alguien escriba el código.
22
-
-**Mejoras menores** son issues para nuevas características que tienen un lugar obvio dentro de la arquitectura actual sin necesidad de discutir cómo encajarlas. Una vez acordado que vale la pena hacerlas, están disponibles para que alguien escriba el código.
20
+
-**Errores con soluciones pero sin PR** son errores donde hemos decidido cómo solucionarlo y están libres para que alguien escriba el código.
21
+
-**Mejoras menores** son <em>issues</em> para nuevas características que tienen un lugar obvio dentro de la arquitectura actual sin necesidad de discutir cómo encajarlas. Una vez acordado que vale la pena hacerlas, están disponibles para que alguien escriba el código.
23
22
-**Funcionalidades 2D** son aquellas que ya existen en p5.js pero no dentro del modo WebGL. El comportamiento esperado de la funcionalidad, una vez implementada, es que coincida con el modo 2D. Es posible que necesitemos discutir la mejor implementación, pero los requisitos del usuario para estos son claros.
24
23
-**Funcionalidades que no funcionan en todos los contextos** son aquellas que existen en el modo WebGL pero no funcionan en todas las formas en que se puede usar el modo WebGL. Por ejemplo, algunos métodos de p5.js funcionan tanto con coordenadas 2D como 3D, pero otros fallan si se usan coordenadas 3D. Estás están disponibles para comenzar a trabajar.
25
24
- Las **solicitudes de funcionalidad** son todas las demás solicitudes de cambios de código. Estos necesitan un poco de discusión para asegurarnos de que sean cosas que encajen en la hoja de ruta del modo WebGL.
26
-
- Issues de **documentación** son aquellos que no necesitan un cambio de código, sino una mejor documentación del comportamiento de p5.js.
25
+
-<em>Issues</em> de **documentación** son aquellos que no necesitan un cambio de código, sino una mejor documentación del comportamiento de p5.js.
27
26
28
27
29
28
## Dónde Colocar el Código
@@ -97,7 +96,7 @@ test('coplanar strokes match 2D', function() {
97
96
});
98
97
```
99
98
100
-
Esto no siempre funciona porque no se puede desactivar el <em>antialiasing</em> en el modo 2D, y el antialiasing en el modo WebGL a menudo es ligeramente diferente. Sin embargo, puede funcionar para líneas rectas en los ejes x, y.
99
+
Esto no siempre funciona porque no se puede desactivar el <em>antialiasing</em> en el modo 2D, y el <em>antialiasing</em> en el modo WebGL a menudo es ligeramente diferente. Sin embargo, puede funcionar para líneas rectas en los ejes x, y.
101
100
102
101
Si una funcionalidad es exclusiva de WebGL, en lugar de comparar píxeles con el modo 2D, a menudo verificamos algunos píxeles para asegurarnos de que su color sea el esperado. Algún día, podríamos convertir esto en un sistema más robusto que compare con instantáneas de imagen completas de nuestros resultados esperados en lugar de algunos píxeles, pero por ahora, aquí tienes un ejemplo de verificación de color de píxeles:
0 commit comments