Tutorial de Python en Español
Esta traducción cubre la versión 3.6.3 del tutorial de Python.
Utilizando la carpeta Doc/tutorial y el archivo descargado fue este:
La versión OnLine de esta documentación se puede encontrar en:
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
-
Fijarse en https://github.com/python/cpython/releases cuál es la última versión publicada
-
Descargar el
.tar.gzque aparece al lado del nombre de la versión -
Abrir el
.tar.gzy descomprimir los archivos de la carpetaDoc/tutorial/*.rsten nuestro respositorio bajo el directoriooriginal/ -
Ver las diferencias entre la versión traducida y la nueva haciendo
git diff -
Traducir únicamente lo que ha cambiado entre versión y versión, haciendo los cambios en los archivos dentro del directorio
traducidos/ -
Actualizar las variales
versionyreleasedel archivotraducidos/conf.py. -
Actualizar la fecha en el archivo
traducidos/imagenes/pag1.svg -
Crear las versiones HTML, eBook y PDF (para crear esta version es necesario tener instalado
pdftk2.01):
fab create_html
fab create_ebook
fab create_pdf
fab change_htmlindex_version
-
Verificar que el PDF y eBook se abre correctamente con Evince y Firefox (preview)
-
Si tenés permisos de
adminen el servidor, ejecutar:
fab deploy_all
-
Actualizar el README.md (la sección que indica qué versión del tutorial está traducida, al principio)
-
Crear un commit para esta nueva revision:
git commit -am "Actualización del tutorial"
- Crear una etiqueta de git:
git tag v3.6.3
git push --tags
- Una vez actualizada la traducción, enviar un mail a la lista de correo de Python Argentina para informar sobre esta actualización.