Merge pull request #289 from montoyamoraga/master

add spanish translation of missing examples

Author: montoyamoraga

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

@@ -1,11 +1,11 @@
 /*
- * @name Create Graphics
- * @description Creates and returns a new p5.Renderer object. Use this 
- * class if you need to draw into an off-screen graphics buffer. The two parameters
- * define the width and height in pixels.
+ * @name createGraphics
+ * @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.
  */
 
-var pg;
+let pg;
 
 function setup(){
   createCanvas(710, 400);
@@ -24,6 +24,6 @@ function draw(){
   pg.stroke(255);
   pg.ellipse(mouseX-150, mouseY-75, 60, 60);
 
-  //Draw the offscreen buffer to the screen with image()
+  //El buffer fuera de pantalla es dibujado en la pantalla con image()
   image(pg, 150, 75);
-}
+}

src/data/examples/es/02_Data/04_Numbers.js

@@ -1,13 +1,12 @@
 /*
- * @name Numbers
+ * @name Números
  * @frame 720,400
- * @description Numbers can be written with or without decimals. An integer
- * (more commonly called an int) is a number without a decimal point. A float
- * is a floating-point number, which means it is a number that has a decimal
- * place.
+ * @description Los números pueden ser escritos con o sin decimales. Un número * entero (más comúnmente conocido como int por el inglés integer) es un
+ * número sin fracción decimal. Un número de punto flotante (conocido como float
+ * por el inglés floating-point number) es un número con fracción decimal.
  */
-var a = 0;  // Create a global variable "a" of type Number
-var b = 0;  // Create a global variable "b" of type Number
+let a = 0;  // Crea una variable global "a" de tipo Number
+let b = 0;  // Crea una variable global "b" de tipo Number
 
 function setup() {
   createCanvas(720, 400);
@@ -17,8 +16,8 @@ function setup() {
 function draw() {
   background(0);
 
-  a = a + 1;  // Increment a with an integer
-  b = b + 0.2;  //Increment b with a float
+  a = a + 1;  // Incrementar a con un int
+  b = b + 0.2;  //Incrementar b con un float
   line(a, 0, a, height/2);
   line(b, height/2, b, height);
 

src/data/examples/es/10_Interaction/23_snake.js

@@ -1,170 +1,171 @@
 /*
- * @name Snake game
- * @description The famous snake game! Once you click run, click anywhere
- * inside the black area, and control the snake using i j k and l. Don't let
- * the snake hit itself or the wall!<br>
- * Example created by <a href='https://github.com/prashantgupta24' target='_blank'>Prashant Gupta
+ * @name Juego de Serpiente
+ * @description El famoso juego de Serpiente! Después de hacer click en run/ejecutar, haz click en cualquier parte
+ * dentro del área negra, y controla la serpiente usando i,j,k,l. No dejes que
+ * la serpiente choque contra sí misma o la pared.<br>
+ * Ejemplo creado por <a href='https://github.com/prashantgupta24' target='_blank'>Prashant Gupta
 */
 
-// the snake is divided into small segments, which are drawn and edited on each 'draw' call
-var numSegments = 10;
-var direction = 'right';
+// La serpiente se divide en pequeños segmentos, los que son dibujados y editados en cada ejecución de draw()
+let numeroSegmentos = 10;
+let direccion = 'derecha';
 
-var xStart = 0; //starting x coordinate for snake
-var yStart = 250; //starting y coordinate for snake
-var diff = 10;
+let xInicio = 0; //coordenada x de partida de la serpiente
+let yInicio = 250; //coordenada y de partida de la serpiente
+let diferencia = 10;
 
-var xCor = [];
-var yCor = [];
+let xCuerpo = [];
+let yCuerpo = [];
 
-var xFruit = 0;
-var yFruit = 0;
-var scoreElem;
+let xFruta = 0;
+let yFruta = 0;
+let elementoPuntaje;
 
 function setup() {
-  scoreElem = createDiv('Score = 0');
-  scoreElem.position(20, 20);
-  scoreElem.id = 'score';
-  scoreElem.style('color', 'white');
-  
+  elementoPuntaje = createDiv('Puntaje = 0');
+  elementoPuntaje.position(20, 20);
+  elementoPuntaje.id = 'puntaje';
+  elementoPuntaje.style('color', 'white');
+
   createCanvas(500, 500);
   frameRate(15);
   stroke(255);
   strokeWeight(10);
-  updateFruitCoordinates();
+  actualizarCoordenadasFruta();
 
-  for (var i = 0; i < numSegments; i++) {
-    xCor.push(xStart + (i * diff));
-    yCor.push(yStart);
+  for (let i = 0; i < numeroSegmentos; i++) {
+    xCuerpo.push(xInicio + (i * diferencia));
+    yCuerpo.push(yInicio);
   }
 }
 
 function draw() {
   background(0);
-  for (var i = 0; i < numSegments - 1; i++) {
-    line(xCor[i], yCor[i], xCor[i + 1], yCor[i + 1]);
+  for (let i = 0; i < numeroSegmentos - 1; i++) {
+    line(xCuerpo[i], yCuerpo[i], xCuerpo[i + 1], yCuerpo[i + 1]);
   }
-  updateSnakeCoordinates();
-  checkGameStatus();
-  checkForFruit();
+  actualizarCoordenadasSerpiente();
+  comprobarEstadoJuego();
+  comprobarFruta();
 }
 
 /*
- The segments are updated based on the direction of the snake.
- All segments from 0 to n-1 are just copied over to 1 till n, i.e. segment 0
- gets the value of segment 1, segment 1 gets the value of segment 2, and so on,
- and this results in the movement of the snake.
-
- The last segment is added based on the direction in which the snake is going,
- if it's going left or right, the last segment's x coordinate is increased by a
- predefined value 'diff' than its second to last segment. And if it's going up
- or down, the segment's y coordinate is affected.
+ Los segmentos son actualizados en la dirección de la serpiente.
+ Todos los segmentos entre 0 y n-1 son copiados al rango 1 hasta n, por ejemplo, el segmento 0 recibe el valor del segmento 1, el segmento 1 recibe el
+vallor del segmento 2, y así, esto resulta en el movimiento de la serpiente.
+
+ El último segmento es añadido según la dirección de movimiento de la serpiente,
+ si está yendo hacia izquierda o derecha, la coordenada x del último segmento
+ es igual a sumar un valor predefinido como 'diferencia' al valor del penúltimo
+ segmento. Y si está yendo hacia arriba o abajo, la coordenada y es afectada.
+ }
+
 */
-function updateSnakeCoordinates() {
+function actualizarCoordenadasSerpiente() {
 
-  for (var i = 0; i < numSegments - 1; i++) {
-    xCor[i] = xCor[i + 1];
-    yCor[i] = yCor[i + 1];
+  for (let i = 0; i < numeroSegmentos - 1; i++) {
+    xCuerpo[i] = xCuerpo[i + 1];
+    yCuerpo[i] = yCuerpo[i + 1];
   }
-  switch (direction) {
-    case 'right':
-      xCor[numSegments - 1] = xCor[numSegments - 2] + diff;
-      yCor[numSegments - 1] = yCor[numSegments - 2];
+  switch (direccion) {
+    case 'derecha':
+      xCuerpo[numeroSegmentos - 1] = xCuerpo[numeroSegmentos - 2] + diferencia;
+      yCuerpo[numeroSegmentos - 1] = yCuerpo[numeroSegmentos - 2];
       break;
-    case 'up':
-      xCor[numSegments - 1] = xCor[numSegments - 2];
-      yCor[numSegments - 1] = yCor[numSegments - 2] - diff;
+    case 'arriba':
+      xCuerpo[numeroSegmentos - 1] = xCuerpo[numeroSegmentos - 2];
+      yCuerpo[numeroSegmentos - 1] = yCuerpo[numeroSegmentos - 2] - diferencia;
       break;
-    case 'left':
-      xCor[numSegments - 1] = xCor[numSegments - 2] - diff;
-      yCor[numSegments - 1] = yCor[numSegments - 2];
+    case 'izquierda':
+      xCuerpo[numeroSegmentos - 1] = xCuerpo[numeroSegmentos - 2] - diferencia;
+      yCuerpo[numeroSegmentos - 1] = yCuerpo[numeroSegmentos - 2];
       break;
-    case 'down':
-      xCor[numSegments - 1] = xCor[numSegments - 2];
-      yCor[numSegments - 1] = yCor[numSegments - 2] + diff;
+    case 'abajo':
+      xCuerpo[numeroSegmentos - 1] = xCuerpo[numeroSegmentos - 2];
+      yCuerpo[numeroSegmentos - 1] = yCuerpo[numeroSegmentos - 2] + diferencia;
       break;
   }
 }
 
 /*
- I always check the snake's head position xCor[xCor.length - 1] and
- yCor[yCor.length - 1] to see if it touches the game's boundaries
- or if the snake hits itself.
+ Siempre reviso la posición de la cabeza de la serpiente
+ xCuerpo[xCuerpo.length - 1] e yCuerpo[yCuerpo.length - 1] para revisar si toca
+ los bordes del juego o si la serpiente se estrelló contra sí misma.
 */
-function checkGameStatus() {
-  if (xCor[xCor.length - 1] > width ||
-      xCor[xCor.length - 1] < 0 ||
-      yCor[yCor.length - 1] > height ||
-      yCor[yCor.length - 1] < 0 ||
-      checkSnakeCollision()) {
+function comprobarEstadoJuego() {
+  if (xCuerpo[xCuerpo.length - 1] > width ||
+      xCuerpo[xCuerpo.length - 1] < 0 ||
+      yCuerpo[yCuerpo.length - 1] > height ||
+      yCuerpo[yCuerpo.length - 1] < 0 ||
+      detectarColision()) {
     noLoop();
-    var scoreVal = parseInt(scoreElem.html().substring(8));
-    scoreElem.html('Game ended! Your score was : ' + scoreVal);
+    let puntajeValor = parseInt(elementoPuntaje.html().substring(8));
+    elementoPuntaje.html('Juego finalizado! Tu puntaje fue: ' + puntajeValor);
   }
 }
 
 /*
- If the snake hits itself, that means the snake head's (x,y) coordinate
- has to be the same as one of its own segment's (x,y) coordinate.
+ Si la serpiente se estrella contra sí misma, esto significa que la coordenada
+ (x,y) tiene que ser igual a la de un segmento propio.
 */
-function checkSnakeCollision() {
-  var snakeHeadX = xCor[xCor.length - 1];
-  var snakeHeadY = yCor[yCor.length - 1];
-  for (var i = 0; i < xCor.length - 1; i++) {
-    if (xCor[i] === snakeHeadX && yCor[i] === snakeHeadY) {
+function detectarColision() {
+  let cabezaSerpienteX = xCuerpo[xCuerpo.length - 1];
+  let cabezaSerpienteY = yCuerpo[yCuerpo.length - 1];
+  for (let i = 0; i < xCuerpo.length - 1; i++) {
+    if (xCuerpo[i] === cabezaSerpienteX && yCuerpo[i] === cabezaSerpienteY) {
       return true;
     }
   }
 }
 
 /*
- Whenever the snake consumes a fruit, I increment the number of segments,
- and just insert the tail segment again at the start of the array (basically
- I add the last segment again at the tail, thereby extending the tail)
+ Cada vez que la serpiente consume una fruta, incremento el número de segmentos,
+ y simplemente inserto este segmento de cola nuevamente al principio del arreglo
+ (básicamente añado el último segmento a la cola, con lo que la alargo).
 */
-function checkForFruit() {
-  point(xFruit, yFruit);
-  if (xCor[xCor.length - 1] === xFruit && yCor[yCor.length - 1] === yFruit) {
-    var prevScore = parseInt(scoreElem.html().substring(8));
-    scoreElem.html('Score = ' + (prevScore + 1));
-    xCor.unshift(xCor[0]);
-    yCor.unshift(yCor[0]);
-    numSegments++;
-    updateFruitCoordinates();
+function comprobarFruta() {
+  point(xFruta, yFruta);
+  if (xCuerpo[xCuerpo.length - 1] === xFruta && yCuerpo[yCuerpo.length - 1] === yFruta) {
+    let prevScore = parseInt(elementoPuntaje.html().substring(8));
+    elementoPuntaje.html('Score = ' + (prevScore + 1));
+    xCuerpo.unshift(xCuerpo[0]);
+    yCuerpo.unshift(yCuerpo[0]);
+    numeroSegmentos++;
+    actualizarCoordenadasFruta();
   }
 }
 
-function updateFruitCoordinates() {
+function actualizarCoordenadasFruta() {
   /*
-    The complex math logic is because I wanted the point to lie
-    in between 100 and width-100, and be rounded off to the nearest
-    number divisible by 10, since I move the snake in multiples of 10.
+    Hice matemática compleja porque quería que el punto estuviera
+    entre 100 y width-100, y que fuera aproximado al número divisible
+    por 10 más cercano, ya que muevo la serpiente en múltiplos de 10.
   */
 
-  xFruit = floor(random(10, (width - 100) / 10)) * 10;
-  yFruit = floor(random(10, (height - 100) / 10)) * 10;
+  xFruta = floor(random(10, (width - 100) / 10)) * 10;
+  yFruta = floor(random(10, (height - 100) / 10)) * 10;
 }
 
 function keyPressed() {
   switch (keyCode) {
     case 74:
-      if (direction != 'right') {
-        direction = 'left';
+      if (direccion != 'derecha') {
+        direccion = 'izquierda';
       }
       break;
     case 76:
-      if (direction != 'left') {
-        direction = 'right';
+      if (direccion != 'izquierda') {
+        direccion = 'derecha';
       }
       break;
     case 73:
-      if (direction != 'down') {
-        direction = 'up';
+      if (direccion != 'abajo') {
+        direccion = 'arriba';
       }
       break;
     case 75:
-      if (direction != 'up') {
-        direction = 'down';
+      if (direccion != 'arriba') {
+        direccion = 'abajo';
       }
       break;
   }

src/data/examples/es/10_Interaction/24_Wavemaker.js

@@ -1,11 +1,11 @@
 /*
  * @name Wavemaker
- * @description This illustrates how waves (like water waves) emerge
- * from particles oscillating in place. Move your mouse to direct the wave.
- * Contributed by Aatish Bhatia, inspired by <a href="https://beesandbombs.tumblr.com/post/45513650541/orbiters">Orbiters</a> by Dave Whyte.
+ * @description Este ejemplo ilustra cómo las olas (como las del mar) emergen
+ * a partir de partículas oscilando en su lugar. Mueve el ratón para dirigir la ola.
+ * Contribución por Aatish Bhatia, inspirada en <a href="https://beesandbombs.tumblr.com/post/45513650541/orbiters">Orbiters</a> por Dave Whyte.
  */
 
-let t = 0; // time variable
+let t = 0; // variable de tiempo
 
 function setup() {
   createCanvas(600, 600);
@@ -14,24 +14,24 @@ function setup() {
 }
 
 function draw() {
-  background(10, 10); // translucent background (creates trails)
+  background(10, 10); // fondo translúcido (crea estelas)
 
-  // make a x and y grid of ellipses
+  // grilla de elipses
   for (let x = 0; x <= width; x = x + 30) {
     for (let y = 0; y <= height; y = y + 30) {
-      // starting point of each circle depends on mouse position
-      let xAngle = map(mouseX, 0, width, -4 * PI, 4 * PI, true);
-      let yAngle = map(mouseY, 0, height, -4 * PI, 4 * PI, true);
-      // and also varies based on the particle's location
-      let angle = xAngle * (x / width) + yAngle * (y / height);
+      // punto de partida de cada círculo depende de posición del ratón
+      let anguloX = map(mouseX, 0, width, -4 * PI, 4 * PI, true);
+      let anguloY = map(mouseY, 0, height, -4 * PI, 4 * PI, true);
+      // y también varía según la posición de la partícula
+      let angulo = anguloX * (x / width) + anguloY * (y / height);
 
-      // each particle moves in a circle
-      let myX = x + 20 * cos(2 * PI * t + angle);
-      let myY = y + 20 * sin(2 * PI * t + angle);
+      // cada partícula se mueve en forma circular
+      let myX = x + 20 * cos(2 * PI * t + angulo);
+      let myY = y + 20 * sin(2 * PI * t + angulo);
 
-      ellipse(myX, myY, 10); // draw particle
+      ellipse(myX, myY, 10); // dibujar partícula
     }
   }
 
-  t = t + 0.01; // update time
+  t = t + 0.01; // actualizar tiempo
 }