lusudev / tutorial

Traducción al Español del "Tutorial de Python" oficial

Tutorial de Python en Español

Esta traducción cubre la versión 3.5.1 del tutorial de Python.

Utilizando la carpeta Doc/tutorial y el archivo descargado fue este:

• https://hg.python.org/cpython/file/v3.5.1/Doc/tutorial/

La versión OnLine de esta documentación se puede encontrar en:

• http://tutorial.python.org.ar/

Configurar entorno para generar el HTML / PDF

Hay un script (dev/install_dependencies.sh) que instala las dependencias necesarias para generar el tutorial en todos sus formatos.

Abrir el archivo ANTES de ejecutarlo para estar SEGUROS que hace lo que queremos...

Actualizar el tutorial

1. Fijarse en http://hg.python.org/cpython/tags cuál es la última versión publicada

2. Hacer click en la versión a la que estamos interesados actualizar

3. Ir al link Browse y llegar a la carpeta Doc/tutorial

4. Descargar el .bz2 desde la barra del lateral izquierdo

5. Abrir el .bz2 y descomprimir los archivos de la carpeta Doc/tutorial/*.rst en nuestro respositorio bajo el directorio original/

6. Ver las diferencias entre la versión traducida y la nueva haciendo git diff

7. Traducir únicamente lo que ha cambiado entre versión y versión, haciendo los cambios en los archivos dentro del directorio traducidos/

8. Actualizar las variales version y release del archivo traducidos/conf.py.

9. Actualizar la fecha en el archivo traducidos/imagenes/pag1.svg

10. Crear las versiones HTML, eBook y PDF (para crear esta version es necesario tener instalado pdftk 2.01):

fab create_html
fab create_ebook
fab create_pdf
fab change_htmlindex_version

1. Verificar que el PDF y eBook se abre correctamente con Evince y Firefox (preview)

2. Si tenés permisos de admin en el servidor, ejecutar:

fab deploy_all

1. Actualizar el README.md (la sección que indica qué versión del tutorial está traducida, al principio)

2. Crear un commit para esta nueva revision:

git commit -am "Actualización del tutorial"

1. Crear una etiqueta de git:

git tag v3.5.0
git push --tags

1. Una vez actualizada la traducción, enviar un mail a la lista de correo de Python Argentina para informar sobre esta actualización.