Merge pull request #1321 from Guirdo/fix-spanish-examples

Fix some spanish examples

Author: Qianqianye

src/data/examples/es/00_Structure/00_Statements_and_Comments.js

@@ -1,21 +1,21 @@
 /*
- * @name Comments and Statements
- * @description Statements are the elements that make up programs. The ";" (semi-colon) symbol is used to end statements.
- * It is called the "statement terminator". Comments are used for making notes to help people better understand programs. A comment begins with two forward slashes ("//").
- * <br><br><small><em>This example is ported from the <a href="https://processing.org/examples/statementscomments.html">Statements and Comments example</a>
- * on the Processing website</em></small>
+ * @name Sentencias y comentarios
+ * @description Las sentencias son los elementos que construyen a los programas. El símbolo ";" (punto y coma) se utiliza para cerrar las sentencias.
+ * Se le llama el "statement terminator". Los comentarios son usados para hacer notas para ayudar a las personas a entender mejor los programas. Un comentario empieza con dos diagonales ("//").
+ * <br><br><small><em>Este ejemplo es traído desde <a href="https://processing.org/examples/statementscomments.html">Statements and Comments example</a>
+ * en la página de Processing</em></small>
  */
-// The createCanvas function is a statement that tells the computer 
-// how large to make the window.
-// Each function statement has zero or more parameters. 
-// Parameters are data passed into the function
-// and are used as values for telling the computer what to do.
+// La función createCanvas es una sentencia que le dice a la computadora
+// que tan grande hacer la ventana.
+// Cada sentencia de función tiene cero o más parámetros.
+// Los parámetros son datos que pasan dentro de la función
+// y son usados como valores para decirle a la computadora que hacer.
 function setup() {
    createCanvas(710, 400);
 }
 
-// The background function is a statement that tells the computer
-// which color (or gray value) to make the background of the display window 
+// La función background es una sentencia que le dice a la computadora
+// con que color (o que valor de gris) hacer el fondo de la ventana mostrada.
 function draw() {
    background(204, 153, 0);
 }

src/data/examples/es/00_Structure/01_Coordinates.js

@@ -2,7 +2,7 @@
  * @name Coordenadas
  * @description Todas las formas dibujadas en la pantalla tienen una posición que es
  * especificada como una coordenada. Todas las coordenadas son medidas como una distancia desde el origen, usando el pixel como unidad de medida.
- * El origen [0, 0] es la coordenada en la esquina superior izquierda de la ventana y la coordenada de la esquina inferior derecha es [ancho-1, altura-1].
+ * El origen [0, 0] es la coordenada en la esquina superior izquierda de la ventana y la coordenada de la esquina inferior derecha es [width-1, height-1].
  */
 function setup() {
   // Definir lienzo de 720 pixeles de ancho y 400 pixeles de alto

src/data/examples/es/00_Structure/03_Setup_and_Draw.js

@@ -1,7 +1,9 @@
 /*
  * @name Setup y Draw
+* @arialabel Linea blanca horizontal animada en un fondo de color negro la cual se mueve de abajo hacia arriba en la pantalla
  * @description El código dentro de la función draw() corre continuamente de arriba
- * a a bajo hasta que el programa es parado.
+ * abajo hasta que el programa es detenido. El
+ * código en setup() es ejecutado una vez cuando el programa empieza.
  */
 let y = 100;
 
@@ -15,7 +17,7 @@ function setup() {
 }
 
 // Las instrucciones en draw() son ejecutadas hasta que
-// el programa es parado. Cada instrucción es ejecutada
+// el programa es detenido. Cada instrucción es ejecutada
 // en orden y luego de que la última línea es leída,
 // se vuelve a ejecutar draw() desde el principio
 function draw() {

src/data/examples/es/00_Structure/04_No_Loop.js

@@ -1,27 +1,28 @@
 /*
  * @name No Loop
- * @description La función noLoop() hace que draw() se ejecuta solo una vez.
+ * @arialabel Linea horizontal de color blanco en medio de un fondo color negro
+ * @description La función noLoop() hace que draw() se ejecute solo una vez.
  * Sin ejecutar noLoop(), el código dentro de draw() es ejecutado continuamente.
  */
 let y;
 
-// The statements in the setup() function
-// execute once when the program begins
+// Las sentencias en la función setup()
+// se ejecutan una vez cuando el programa empieza.
 function setup() {
-  // createCanvas should be the first statement
+  // createCanvas deberá ser la primera sentencia
   createCanvas(720, 400);
-  stroke(255); // Set line drawing color to white
+  stroke(255); // Hace que el color de trazado sea blanco
   noLoop();
 
   y = height * 0.5;
 }
 
 // Las instrucciones en draw() son ejecutadas hasta que
-// el programa es parado. Cada instrucción es ejecutada
+// el programa es detenido. Cada instrucción es ejecutada
 // en orden y luego de que la última línea es leída,
 // se vuelve a ejecutar draw() desde el principio
 function draw() {
-  background(0); // Set the background to black
+  background(0); // Pone el fondo en negro
   y = y - 1;
   if (y < 0) {
     y = height;

src/data/examples/es/00_Structure/05_Loop.js

@@ -1,19 +1,23 @@
 /*
- * @name Bucle
- * @description El código dentro de la función draw() corre continuamente de arriba a abajo hasta que el prorgrama para.
+ * @name Loop
+ * @arialabel Linea horizontal de color blanco en un fondo de color negro la cual se mueve de abajo hacia arriba de la pantalla paralelamente al eje x
+ * @description Si la función noLoop() es ejecutada dentro de setup(), el código en draw() 
+ * solo se ejecuta una vez. En este ejemplo, da click en el ratón
+ * para ejecutar la function loop() y así provocar que la draw()
+ * corra continuamente.
  */
-let y = 100;
+let y = 0;
 
 // Las instrucciones dentro de la función setup()
 // se ejecutan una vez, cuando el programa empieza
 function setup() {
   createCanvas(720, 400); // El tamaño debe ser la primera instrucción
   stroke(255); // Definir que el color del trazado sea blanco
   frameRate(30);
+  noLoop()
 }
-
 // Las instrucciones en draw() son ejecutadas hasta que
-// el programa es parado. Cada instrucción es ejecutada
+// el programa es detenido. Cada instrucción es ejecutada
 // en orden y luego de que la última línea es leída,
 // se vuelve a ejecutar draw() desde el principio
 function draw() {
@@ -24,3 +28,7 @@ function draw() {
   }
   line(0, y, width, y);
 }
+
+function mousePressed(){
+  loop();
+}

src/data/examples/es/00_Structure/06_Redraw.js

@@ -1,5 +1,6 @@
 /*
  * @name Redraw
+ * @arialabel Linea horizontal de color blanco en medio de un fondo color negro que se mueve hacia arriba en la pantalla con cada click del ratón
  * @description La función redraw() hace que draw() se ejecute una vez. En este ejemplo,
  * draw() se ejecutado una vez cada vez que el ratón hace click.
  */

src/data/examples/es/00_Structure/07_Functions.js

@@ -1,8 +1,9 @@
 /*
  *@name Funciones
- *@description La función drawTarget() hace fácil dibujar muchas dianas distintos.
+ *@arialabel Tres dianas son creados con la forma de círculos negros. Hay un gradiente de blanco a negro desde el centro  del círculo hacia el borde exterior.
+ *@description La función drawTarget() hace fácil dibujar muchas dianas distintas.
  * Cada llamada a drawTarget() especifica la posición, tamaño y número de
- * anillos por cada diana.
+ * anillos para cada diana.
  */
 
 function setup() {

src/data/examples/es/00_Structure/08_Recursion.js

@@ -1,11 +1,13 @@
 /*
  *@name Recursión
- *@description Una demonstración de recursión, que significa funciones llamándose a sí mismas.
- * Fíjate cómo la función drawCircle() se llama a sí misma al final del bloque de código.
+ *@arialabel Círculo gris con dos círculos de color gris en medio. Cada uno de estos dos círculos grises tiene más círculos en medio. Este patrón continua hasta que no posible dibujar más dentro de ellos.
+ *@description Una demostración de recursión, que significa funciones llamándose a sí mismas.
+ * Una función recursiva debe tener una condición que la termine, sin ella la función caerá
+ * en un ciclo infinito. Fíjate cómo la función drawCircle() se llama a sí misma al final del bloque de código.
  * Continúa haciéndolo hasta que la variable "level" es igual a 1.
  */
 
-function setup() {
+ function setup() {
   createCanvas(720, 560);
   noStroke();
   noLoop();
@@ -16,10 +18,15 @@ function draw() {
 }
 
 function drawCircle(x, radius, level) {
+  // 'level' es la variable que termina la recursión una vez que alcanza
+  // un cierto valor (en este ejemplo, 1). Si una condición de terminación no es especificada, una función recursiva seguirá llamándose a sí misma una y otra vez
+  // hasta que se acabe el espacio, un resultado no favorable!
   const tt = (126 * level) / 4.0;
   fill(tt);
   ellipse(x, height / 2, radius * 2, radius * 2);
   if (level > 1) {
+    // 'level' disminuye por 1 en cada paso y por lo tanto hace que la condición de terminación sea
+    // alcanzable
     level = level - 1;
     drawCircle(x - radius / 2, radius / 2, level);
     drawCircle(x + radius / 2, radius / 2, level);

src/data/examples/es/00_Structure/09_Create_Graphics.js

@@ -1,5 +1,6 @@
 /*
- * @name createGraphics
+ * @name Crear gráficos
+ * @arialabel Fondo de color negro con un rectángulo de color gris oscuro en medio. El ratón del usuario dibuja con color blanco pero no por el centro del rectángulo.
  * @description Crea y retorna un nuevo objeto p5.Renderer. Usa esta
  * clase si necesitas dibujar en un buffer gráfico fuera-de-pantalla. Los dos parámetros
  * definen el ancho y la altura en pixeles.

src/data/examples/es/01_Form/00_Points_and_Lines.js

@@ -1,5 +1,6 @@
 /*
  * @name Puntos y líneas
+ * @arialabel Contorno blanco de un cuadrado sobre un fondo de color negro
  * @description Puntos y líneas pueden ser usados para dibujar geometría básica.
  * Cambia el valor de la variable 'd' para escalar la figura. Las cuatro
  * variables definen las posiciones basadas en el valor de 'd'.