El repositorio con el formato oficial es: https://github.com/PyCampES/python-docs-es
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:
-
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): -
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. Cuando el PR es aceptado y "mergeado" a master la documentación se va a actualizar automaticamente en Read the Docs