documentación oficial de Python al Español!

contribución, queremos señalar algunos

:ref:`lineamientos generales <a-tener-en-cuenta>`.

Antes de comenzar

.. image:: fork.png

:alt: botón fork

#. (Opcional) Crea un entorno virtual y actívalo::

#. (Opcional) Instala los requerimientos del proyecto::

¡Comienza a traducir!

#. Selecciona un :ref:`archivo para traducir <que-archivo-traducir>`.

#. Verifica que estás en la rama principal del repositorio, **3.8**::

ejemplo, si vas a trabajar en el archivo ``library/glosario.po``, usa un nombre

GitHub (No olvides añadir tu nombre al archivo ``TRANSLATORS``)::

Mira los mensajes que el último comando imprimirá por pantalla,

pues encontrarás un enlace para abrir un nuevo Pull-request directamente.

:ref:`mantener actualizada <mantener-actualizada>` tu copia local antes

de realizar el *Pull Request*.

.. _que-archivo-traducir:

.. _a-tener-en-cuenta:

* Esta traducción es mantenida por **personas de todo el mundo** que hablan el

idioma Español. No queremos atarla a ninguna región en particular y creemos

que es un valor extra la diversidad de la misma. Vas a encontrar secciones

con diferentes tonalidades de países, regiones o estilos. Lo único que pedimos

es **consistencia** dentro de un mismo módulo o sección (es decir no cambiar de

estilo de un párrafo a otro, por ejemplo) y siempre intentar que la persona del

otro lado pueda entender lo que estamos escribiendo (no usar lunfardo o

regionalismos muy propios de un único lugar).

* En muchos casos el **mejor criterio** es pensar en el vocabulario que utilizamos

cuando le explicamos a otra persona, o en el trabajo. En muchas ocasiones la

versión en inglés o “spanglish” de la palabra es mucho mejor que decir “git

unir” (para git merge).

* Siempre vas a tener una **revisión de lo que propongas** y en ese intercambio otras

personas van a ayudarte a destrabar las dudas que tengas.

* Colaborar **haciendo revisiones** también es muy muy importante, así que si

tienes un rato libre puedes comenzar por mirar los PRs pendientes de revisar.

(mira la `Guía del revisor`_)

* La documentación es ENORME, cualquier traba que encuentres siempre puedes

marcar el texto como **"fuzzy"** o para revisar en el futuro.

No pierdas horas buscando la palabra perfecta.

* **No debes** traducir el contenido de ``:ref:...``, ``:term:...``, ``:dfn:...``, etc.

* Si tienes que usar palabras en inglés debes ponerlas en *cursiva* (rodeadas

* Puedes revisar las :doc:`Preguntas Frecuentes <faq>` para leer sobre problemas conocidos.

* Si **traduces un título que es un enlace**, por favor traduce el link también (por

* Si tienes una **duda sobre una palabra o término**, escríbelo como mejor suene

* Te recomendamos abrir una **Pull Request aunque sea en formato borrador** (marcada

* Último pero no menos importante, **divertite y contá con la ayuda de todes**. Te

esperamos en nuestro chat en telegram. ¡Gracias!

Simplificar el `git diff`

El comando `git diff` tiene datos que pueden llegar a ser inútiles como por ejemplo:

.. code-block:: diff

La instalación de `podiff` mediante `pip` no se encuentra totalmente funcional, pero los usuarios de macOS

podrán continuar con estas instrucciones.

Primero debemos instalar brew. Si no lo tienes instalado puedes seguir el instructivo de instalación Brew_.

.. tabs::

.. tab:: Mac

Para instalar brew en Mac ejecutar el siguiente comando::

Una vez instalado brew, hay que instalar podiff, para ellos ejectar el siguiente comando:

.. code-block:: bash

Luego abrir el archivo de configuración del respositorio local y escribir al final:

.. code-block:: bash

Luego, si no existiese el archivo `.gitatributes` en la carpeta dónde se encuentran los

archivos .po con los que se van a trabajar, crealo, y luego, agregar la siguiente línea

.. code-block:: bash

Para las distribuciones de Linux se pueden utilizar algunas herramientas, como por ejemplo podiff_ y

potools_, que son compatibles con Python 2. Se puede utilizar `pip` para instalarlas.

.. code-block:: bash

.. _Brew: https://docs.brew.sh/Installation

.. _podiff: https://pypi.org/project/podiff/

.. _potools: https://pypi.org/project/potools/

* PRs de más de 1000 líneas: Te sugerimos hacer un comentario al principio del PR para indicar hasta qué línea haz hecho el review y qué hay que revisar hasta ese hito. También si tú mismo vas a continuar la review, pero no puedes hacerla de una sola vez, es útil para saber donde retomar tu trabajo.

* El uso de la opción "Needs work" en poedit genera en la línea anterior al párrafo un comentario "#, fuzzy" para que el traductor revise esa línea. Se puede usar cuando la traducción necesita revisión y en ese momento no puedes sugerir una traducción alternativa. Ten en cuenta que los párrafos con esa marca no aparecerán traducidos en el build. Como revisor, también podrías incluir ese comentario tu mismo como sugerencia.

* Al igual que cuando uno traduce, en el proceso de revisión puedes consultar y emplear las herramientas que tenemos. Por ejemplo, si no estás seguro sobre la traducción de un término sobre el que puede que ya hayamos tomado una decisión consensuada, puedes consultar la memoria de traducción [,](https://github.com/python/python-docs-es/blob/3.8/.overrides/translation-memory.rst) usar `scripts/find_in_po.py` o incluso comentarlo en nuestro grupo de Telegram.