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.gz
que aparece al lado del nombre de la versión -
Abrir el
.tar.gz
y descomprimir los archivos de la carpetaDoc/tutorial/*.rst
en 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
version
yrelease
del 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
pdftk
2.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