He recibido algunos comentarios en el sentido de que es dificil seguir el curso de programación en el blog. Efectivamente, cuando uno está leyendo un tutorial o curso se hace necesario poder seguir el orden de los capítulos, acceder a la tabla de contenidos y saber que viene antes y que viene después. El formato del blog no permite esto. Así que con el fin de remediar esta incomodidad he decidido traspasar el texto del curso a un formato distinto.
He decidido que voy a usar Sphinx, una herramienta bastante popular entre los desarrolladores Pyhton, de hecho es usada para escribir la documentación de Python.
Esto tiene varias ventajas adicionales, entre otras:
- Podré mantener el texto en un repositorio Git.
- Es facil con Sphinx generar otros formatos, como PDF, por ejemplo.
- Permitirá separar el contenido del blog con el del curso.
Así que les pido un poco de paciencia, mientras hago este cambio, pronto retomaremos el curso. Lo bueno es que podremos tocar otros temas en el blog.
Encuentro que es una muy buena idea utilizar sphinx para escribir el curso, he visto desarrolladores que escriben libros utilizando esta práctica. Incluso esta herramienta se puede darle muchos otros usos{2}
Además podría aprovechar, las facilidades de github{1}, para publicar la versión en desarrollo del curso.
Una duda, ¿por qué no está utilizando la convención de guardar las imágenes en _static?
Yo traté de clonar un repositorio git de programando.org, y hacer un branch para Python 2.X , pero la verdad es que me enredé con git, durante la semana, voy a probar de nuevo.
Saludos
{1} http://pages.github.com/
{2} https://github.com/jrovegno/constitucion_chile