Awesome
Go con Ejemplos
Contenido, herramientas y servidor web de Go con Ejemplos.
Información General
El sitio de Go con Ejemplos se construye analizando el código y los
comentarios de los archivos fuente en el folder examples
y mostrando esta
información en el sitio usando templates
(plantillas). Los programas que
realizan este proceso de publicación se encuentran en el directorio tools
.
El proceso de publicación produce un directorio de archivos estáticos
(public
) perfecto para ser servido por cualquier servidor HTTP moderno.
Además, se incluye un servidor web Go ligero en server.go
.
Versiones de Go soportadas
Las herramientas incluídas en tools/
han sido probadas con 1.2.x, 1.3.x y 1.4.x, pero podrían funcionar
con otras versiones.
Compilación de ejemplos
Para compilar el sitio:
$ go get github.com/extemporalgenome/slug
$ go get github.com/russross/blackfriday
$ ./tools/build
Para compilar constantemente en un ciclo:
$ ./tools/build-loop
Despliegue local
Para lanzar un servidor local que puedes consultar en 127.0.0.1:8000.
$ ./tools/server
Instrucciones para colaborar
Para colaborar revisa la lista de pendientes y escoge una traducción pendiente.
Una vez que sepas cuál ejercicio te gustaría traducir, sigue estos pasos:
- Revisa
examples.txt
y busca el nombre del ejercicio en idioma original, por ejemploReading Files
. - Revisa el directorio
examples/
e identifica el directorio que corresponde al nombre del ejercicio. Generalmente es el mismo nombre convertido a minúsculas y reemplazando caracteres especiales y espacios con-
. Por ejemploReading Files
se convertiría enreading-files
. - Cambia el nombre del ejercicio en
examples.txt
por el nombre en español, en nuestro ejemplo seríaLectura de Archivos
. - Usa
git mv
para cambiar el nombre del directorio al que corresponda de acuerdo al nuevo nombre en español, por ejemplolectura-de-archivos
. En caso de tener un nombre con acentos el directorio deberá usar una letra minúscula sin acento. Por ejemploAnálisis de Formato de Fecha
se convertiría enanalisis-de-formato-de-fecha
. - Usa
git mv
para cambiar el nombre de los archivos.go
y.sh
dentro del nuevo directorio a su nuevo nombre en español. - Verifica tu traducción corriendo
tools/build
. - Haz un pull request para que aceptemos tu traducción y cerremos el pendiente de la lista.
Verifica que hayas traducido también las variables en el código, así como los mensajes de salida y comentarios.
No olvides que además de traducir comentarios, el código también es importante! Mantener el idioma español como estándar en el repositorio ayudará a comprender mejor cada ejercicio.
License
This work is copyright Mark McGranaghan and licensed under a Creative Commons Attribution 3.0 Unported License.
The Go Gopher is copyright Renée French and licensed under a Creative Commons Attribution 3.0 Unported License.
Traducciones
Algunas traducciones hechas por contribuidores:
Gracias
Gracias a Jeremy Ashkenas por Docco, lo que inspiró este proyecto.