Merge pull request #799 from thraex41/traduccion

Tutorial en Español

Author: samaaron

etc/doc/tutorial/es/01-Welcome-to-Sonic-Pi.md

@@ -0,0 +1,29 @@
+1 Bienvenido a Sonic Pi
+
+# Bienvenido amigo :-)
+
+Bienvenido a Sonic Pi. Ojalá estés tan emocionado por comenzar a
+hacer sonidos de locura, como yo de mostrarte cómo. Va a ser realmente
+divertido, aprenderás música, síntesis, programación, composición,
+ejecución y más.
+
+Pero espera, ¡qué rudeza la mía! Deja que me presente - yo soy 
+[Sam Aaron](http://twitter.com/samaaron) - quien creó Sonic
+Pi. Puedes encontrarme en Twitter[@samaaron](http://twitter.com/samaaron) 
+y estaré encantado de saludarte. Quizás te interese saber más de mis ejecuciones
+[Live Coding Performances](http://facebook.com/livecodersamaaron) donde
+codifico con Sonic Pi en vivo frente a audiencias.
+
+Si tienes ideas para mejorar Sonic Pi - por favor pásamelas - la retroalimentación
+es bienvenida. ¡Nunca sabes, tu idea podría ser la próxima gran adición!
+
+Este tutorial está dividido en secciones, agrupadas por categoría. 
+Lo he escrito para tener una fácil progresión desde principio a fin,
+siéntete libre de saltar de una sección a otra, cuanto te apetezca. 
+Si sientes que hay algo que falta, dímelo y consideraré añadirlo en 
+el futuro.
+
+Finalmente, el observar a otros codificar en vivo es una gran manera
+de aprender. Yo lo hago en vivo por [livecoding.tv/samaaron](http://livecoding.tv/samaaron) así que visita, saluda y pregunta todo lo que quieras :-)
+
+OK, comencemos...

etc/doc/tutorial/es/01.1-Live-Coding.md

@@ -0,0 +1,117 @@
+1.1 Live Coding
+
+# Live Coding
+
+Uno de los aspectos más excitantes de Sonic Pi es la posibilidad de
+escribir y modificar código en vivo para hacer música, así como lo
+harías al tocar una guitarra. Esto significa que con algo de práctica
+podrás usar Sonic Pi en escena y tocar con él. 
+
+## Libera tu mente
+
+Antes de entrar en los detalles de cómo funciona Sonic Pi en el resto de 
+este tutorial, me gustaría darte una experiencia de lo que es codificar
+en vivo.
+No te preocupes si no entiendes mucho (o nada) de esto. Sólo intenta
+permanecer sentado y disfrutar...
+
+## Un Bucle Vivo
+
+Comencemos copiando el siguiente código en un buffer vacío arriba:
+
+```
+live_loop :flibble do
+  sample :bd_haus, rate: 1
+  sleep 0.5
+end
+```
+
+Ahora presiona el botón "Ejecutar" y escucharás una batería tocada
+rápidamente. Si en cualquier momento deseas parar el sonido, sólo 
+debes presional el botón "Parar". Pero no lo pares, aún...En vez de ello
+sigue los siguientes pasos:
+
+1. Asegúrate que el sonido de batería sigue sonando.
+2. Cambia el valor "sleep" desde "0.5" a algo más alto como "1".
+3. Presiona de nuevo el botón "Ejecutar".
+4. ¿Notas cómo cambió la velocidad de la batería?.
+5. Finalmente, *recuerda este momento*, esta es la primera vez
+   que has codificado en tiempo real con Sonic Pi y muy probablemente
+   no será tu última...
+
+Ok, eso fue lo suficientemente sencillo. Añadamos algo a la mezcla.
+Encima de `sample :bd_haus` añade la línea `sample :ambi_choir, rate: 0.3`.
+Tu código debería mirarse, así:
+
+```
+live_loop :flibble do
+  sample :ambi_choir, rate: 0.3
+  sample :bd_haus, rate: 1
+  sleep 1
+end
+```
+Ahora juega, cambia valores. ¿qué pasa cuando usas valores altos, bajos
+o negativos? Mira lo que pasa cuando cambias el valor `rate:`
+por `:ambi_choir` ajustalo mìnimamente (digamos a 0.29). ¿Qué pasa si 
+pones un valor muy bajo para `sleep` ? Mira si puedes hacerlo sonar tan
+ràpido que tu computadora se paraliza con un error (si eso sucede, simplemente
+elige un valor más alto para `sleep` y presiona `Ejecutar` de nuevo).
+
+Prueba a comentar una de las líneas del ejemplo, añadiendo un `#` al
+comienzo: 
+
+```
+live_loop :flibble do
+  sample :ambi_choir, rate: 0.3
+#  sample :bd_haus, rate: 1
+  sleep 1
+end
+
+```
+
+¿Notas que el numeral hace que la computadora ignore esa línea?
+Esto se llama 'comentar'. En sonic Pi podemos usar comentarios para 
+quitar y añadir cosas a la mezcla.
+
+Finalmente, te dejo con algo divertido con lo que jugar. Toma el siguiente
+código y cópialo en un buffer vacío. Por el momento no intentes
+comprender demasiado más que notar que hay dos bucles - lo que significa
+que hay dos eventos al mismo tiempo - experimenta y juega. Te dejo algunas
+sugerencias:
+
+* Prueba cambiando el valor de `rate:` para escuchar cambios en el sample.
+* Prueba cambiando los tiempos de `sleep` y presta atención a cómo
+  ambos bucles dan vueltas a diferentes valores.
+* Prueba quitando el numeral de la línea de ejemplo y disfruta el sonidos
+  de la guitarra en reversa.
+* Prueba cambiando cualquiera de los valores azules `mix:` a números entre
+  `0` (no en la mezcla) y `1` (totalmente en la mezcla).
+
+Recuerda que debes presionar 'Ejecutar' para escuchar el cambio en el próximo
+bucle. Si termina siendo un relajo, no te preocupes - dale a 'Parar', borra el
+código del buffer y pega una copia fresca para volver a comenzar. Cometiendo
+errores es como aprenderás más rápidamente.
+
+
+```
+live_loop :guit do
+  with_fx :echo, mix: 0.3, phase: 0.25 do
+    sample :guit_em9, rate: 0.5
+  end
+#  sample :guit_em9, rate: -0.5
+  sleep 8
+end
+
+live_loop :boom do
+  with_fx :reverb, room: 1 do
+    sample :bd_boom, amp: 10, rate: 1
+  end
+  sleep 8
+end
+```
+
+Ahora, sigue tocando y experimentando hasta que tu curiosidad acerca
+de todo esto se dispare y comiences a preguntarte ¿qué más puedes
+hacer? Ya estás listo para leer el resto del tutorial.
+
+Así que: ¿qué estás esperando?

etc/doc/tutorial/es/01.2-Exploring-the-Interface.md

@@ -0,0 +1,78 @@
+1.2 Explorando el interfaz
+
+# El interfaz de Sonic Pi
+
+Sonic Pi tiene un sencillo interfaz para codificar música.
+Explorémoslo por un momento.
+
+![Sonic Pi Interface](../images/tutorial/GUI.png)
+
+
+* *A* - Controles de Ejecución
+* *B* - Controles de edición
+* *C* - Info y ayuda
+* *D* - Editor de código 
+* *E* - Panel de Preferencias
+* *F* - Visor de bitácora
+* *G* - Sistema de ayuda
+
+
+## A. Controles de Ejecución
+
+Estos botones rosados son los principales controles para comenzar y
+parar sonidos. Está el botón de 'Ejecutar' para correr el código en el
+editor y 'Parar' para parar todo código en Ejecución en el editor, 
+'Guardar' para guardar el código a un archivo externo y 'Grabar' para
+crear una grabación (archivo WAV) de los sonidos ejecutándose.
+
+## B. Controles de edición
+
+Estos botones anaranjados te permiten manipular el editor del código.
+Los botones *Tamaño+* y *Tamaño-* te permiten cambiar el tamaño del texto.
+El botón *Alinear*  hará que tu código este más claro y profesional.
+
+## C. Info y ayuda
+
+Estos botones azules te dan acceso a información, ayuda y preferencias.
+El botón *Info* abre la ventana informativa, la cual contiene información
+del propio programa Sonic Pi - el equipo base, historia, contribuyentes y
+la comunidad. El botón de *Ayuda* cambia entre el sistema de ayuda y el
+botón *Preferencias* activa la ventana de preferencias, la cual te permite
+controlar algunos parametros básicos del sistema.
+
+## D. Editor de código
+
+Esta es el área donde escribirás tu código y compndrás/ejecutarás
+música. Es un sencillo editor de texto donde puedes escribir, borrar,
+cortar, pegar, etc. Piensa que es una versión simplificada de Word o
+Google Docs.
+
+El editor colorea las palabras utomáticamente, basado en su significado
+para el código.Al principio, esto puede parecer extraño, pero pronto lo
+encontrarás muy útil. Por ejemplo, sabrás que algo es un número, porque
+es de color azul.
+
+## E. Panel de Preferencias
+
+Sonic Pi permite cambiar ciertos parámetros, accesibles a través del botón
+*preferencias* . Este botón cambia la visibilidad del panel de preferencias,
+el cual incluye un número de opciones a ser cambiadas. Ejemplo de ellas son
+el forzar el modo mono, invertir el estéreo, cambiar a vista/no vista de la
+bitácora, mando de volumen y un selector de audio para la Raspberry  Pi
+
+## F. Visor de la bitácora
+
+Cuando ejecutas un código, la bitácora muestra información de lo que está
+haciendo el programa. Predeterminado está el que veas un mensaje por cada
+sonido que crees con el tiempo exacto al que fue disparado el sonido. Esto
+es muy útil para depurar código y entender qué es lo que está haciendo.
+
+## G. Sistema de ayuda
+
+Finalmente, una de las partes más importantes del interface de Sonic Pi
+es el sistema de ayuda que aparece en la parte baja de la ventana.
+Esta puede ser activada o desactivada al apretar el botón azul «ayuda».
+El sistema de ayuda contiene información de todos los aspectos de 
+Sonic Pi incluídos en este tutorial, listado de sintetizadores disponibles, 
+sampleos, ejemplos, FX y una lista de todas las funciones que Sonic Pi
+provee para codificar música.

etc/doc/tutorial/es/01.3-Learning-through-Play.md

@@ -0,0 +1,33 @@
+1.3 Aprender jugando
+
+# Aprender jugando
+
+Sonic Pi te incita a aprender computación y música a través de jugar
+y experimentar. Lo más importante es que te diviertas y sin darte 
+cuenta, estarás aprendiendo a codificar, componer y ejecutar.
+
+## Los errores no existen
+
+Hablando de eso, déjame darte un consejo, aprendido a través de mis
+años de escribir código musical en vivo: «no hay errores, sólo 
+oportunidades». Esto es algo que he escuchado a menudo en relación 
+al jazz, pero funciona igualmente bien en el live-coding.
+No importa lo experimentado que seas -de completo principiante a
+un algoraver, alguna vez ejecutarás código que salga de maneras
+inesperadas -  Podría sonar increíblemente o no, pero no importa, lo
+que sí importa es lo que hagas la próxima vez con él. Toma sonido,
+manipulalo y conviértelo en algo alucinante. El público se volverá
+« loco».
+
+## Comienza sencillo
+
+Cuando estás aprendiendo es tentador querer hacer cosas «ya».
+Sin embargo, mantén ese deseo como un objetivo para «después».
+Por ahora, piensa en lo más simple que puedas escribir que pueda ser
+divertido y satisfactorio, que sea un simple paso para ese increíble
+objetivo que tienes en la mente. Una vez tengas una idea de ese simple 
+paso, intenta y constrúyelo, juega y mira qué nuevas ideas te trae.
+En poco tiempo estarás demasiado ocupado y haciendo progresos 
+enormes.
+
+Sólo asegúrate de compartir tu trabajo con los demás!

etc/doc/tutorial/es/02-Synths.md

@@ -0,0 +1,17 @@
+2 Sintetizadores
+
+# Sintetizadores
+
+OK, suficiente de introducciones - hagamos algo de sonido.
+
+En esta sección cubriremos las bases de disparar y manipular 
+un sintetizador, que no es más que una palabra rebuscada para
+algo que produce sonidos. Típicamente los sintetizadores son
+bastante complicados de usarse - especialmente los análogos con
+tantos cables para unir los patches y módulos. Sin embargo, 
+Sonic-Pi te da mucho de ese poder en una manera mucho más
+sencilla.
+
+No te confundas con la sencillez del interfaz de Sonic-Pi. Puedes llegar
+a manipular con mucha profundidad el sonido, si eso te interesa. Mantente
+atento...