Skip to content

CONTRIBUTING.rst

Latest commit

 

History

History
96 lines (52 loc) · 2.87 KB

CONTRIBUTING.rst

File metadata and controls

96 lines (52 loc) · 2.87 KB

Guía para contribuir en la traducción

¡Muchas gracias por tu interés en participar de la traducción de la documentación oficial de Python al Español! Necesitamos mucho de tu ayuda para poder seguir adelante con este proyecto.

Actualmente se puede colaborar utilizando una de las dos siguientes formas que:

  1. Utilizando el repositorio de GitHub y el editor poedit
  2. Realizando traducciones directamente en Transifex

Note

Si tienes cualquier duda, puedes enviarnos un email a docs-es@python.org.

Desde GitHub

  1. Crea un fork del repositorio.

    Note

    Puedes consular la ayuda oficial de GitHub, si lo deseas.

  2. Clona el repositorio:

    git clone git@github.com:<TU-USUARIO>/python-docs-es.git

  3. Ingresa en la carpeta que git clone creó en tu computadora:

    cd python-docs-es/

  4. Agrega el repositorio original como "upstream":

    git remote add upstream https://github.com/pycampes/python-docs-es.git

  5. Mira que archivo necesita ser traducido. El siguiente comando te mostrará una lista de archivos y los porcentajes traducidos. Elige uno que no esté completo:

    make progress

  6. Una vez que hayas elegido el archivo, lo puedes abrir con el editor poedit y empezar a traducir.

  7. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a GitHub de nuevo:

    git commit -am 'Traducido archivo {nombre de archivo}'
git push origin update-translation

  8. Luego ve a tu página de GitHub y propone hacer un Pull Request

    Note

    Puedes consultar la ayuda oficial de GitHub para crear un Pull Request si lo deseas.

Previsualizar los cambios

Hay dos formas de visualizar, junto con el resultado final de la documentación, los cambios que has hecho.

Read the Docs

Una vez que hayas hecho un Pull Request en GitHub, este mostrará al final de página una sección de "check". Ahí, debería haber uno que diga docs/readthedocs.org:python-docs-es, y al lado un link de "Details". Haciendo click en ese link, deberías poder ver una versión de la documentación con tus cambios.

Construcción local

Desde el mismo directorio python-docs-es/ que se creó cuando hiciste git clone, puedes ejecutar:

make build

Este comando demorará unos minutos y generará toda la documentación en formato HTML en tu computadora. Puedes ver el con tu navegador de internet (Firefox, Chrome, etc) ejecutando:

make serve

Y luego accediendo a http://localhost:8000/

Utilizando Transifex

ToDo.