..note::

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

También puedes unirte a `nuestro canal de Telegram`_ si necesitas ayuda.

El proceso general de traducción son tres pasos, de los cuales el primero tendrás que

realizar solo una vez. Te los detallamos a continuación.

Antes de comenzar

Paso 0: Configuración de Github

Esta configuración la tienes que realizar sólo una vez, y con ello

podrás realizar todas las contribuciones que quieras.

#. Para enviar una traducción, necesitas tener un **fork** delrepositorio_

oficial, haciendo click en el botón encerrado en rojo.

¡Comienza a traducir!

.. _que-archivo-traducir:

Paso 1: ¿Qué archivo traducir?

Tenemos una `lista de issues en GitHub`_ en dónde vamos coordinando el trabajo

realizado para no traducir dos veces lo mismo. El proceso para traducir un

archivo es el siguiente:

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

#. Elige cualquiera de los issues que *no están asignados* a otra persona.

#. Deja un comentario en el issue diciendo que quieres trabajar en él.

#. Espera a que un administrador te asigne el issue.

#. ¡Empieza a traducir!

Paso 2: ¡Comienza a traducir!

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

#. Verifica que estás en la rama principal del repositorio, **3.11** (esto es muy

importante para evitar crear una nueva rama a partir de una traducción

#. Crea una rama nueva en base al artículo en el que vayas a trabajar. Por

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

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

similar a::

#. Una vez que hayas elegido el archivo, lo puedes abrir con el editorpoedit_ y

empezar a traducir.

#. **Formato de columnas**: Si utilizaspoedit_ es posible que tu archivo tenga

la estructura adecuada, pero te invitamos a comprobarlo con la herramienta

powrap_, la cual puedes instalar y utilizar por la línea de comandos.

Ejecuta::

Recuerda que tu archivo puede estar dentro de un ``<directorio>``, como

``library``, con lo que tendrás que ejecutar el comando ``powrap

library/tu_archivo.po`` si no te encuentras en el mismo directorio de tu

archivo.

..note::Si estás en Windows y tienes problemas, mira los comentarios de

:ref:`powrap_windows` para más información.

#. **Corrección ortográfica**: Para verificar la ortografía de tu archivo

puedes utilizar la herramientapospell_ para que verifiques que todas las

palabras están aceptadas o incluidas en diccionarios. Para ello tenemos

un script de conveniencia que puedes utilizar::

Si alguna palabra no es reconocida, y es una palabra válida, tienes que

agregarla al diccionario correspondiente en el directorio dictionaries/.

Busca el archivo que corresponde al que estás traduciendo y si no existe, créalo.

Por ejemplo el diccionario del archivo ``library/ast.po`` se encuentra en

``dictionaries/library_ast.po``.

..note::Si estás en Windows y tienes problemas, mira los comentarios de

:ref:`pospell_windows` para más información.

#. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a

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

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

Si estuvieras trabajando en el archivo ``library/ast.po`` los pasos serían::

..note::

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

de realizar el *Pull Request*.

.. _que-archivo-traducir:

¿Qué archivo traducir?

Tenemos una `lista de issues en GitHub`_ en dónde vamos coordinando el trabajo

realizado para no traducir dos veces lo mismo. El proceso para traducir un

archivo es el siguiente:

#. Elige cualquiera de los issues que *no están asignados* a otra persona.

#. Deja un comentario en el issue diciendo que quieres trabajar en él.

#. Espera a que un administrador te asigne el issue.

#. ¡Empieza a traducir!

.. _a-tener-en-cuenta:

A tener en cuenta

Tenemos una:doc:`Memoria de Traducción<translation-memory>`, que usamos para tener consistencia con algunos

términos.

términos.

Si tienes alguna duda respecto a cómo traducir alguna palabra no te olvides de revisar este contenido.

Del mismo modo, si luego de trabajar sobre un término *complicado* llegas a un acuerdo con otros colaboradores:

Del mismo modo, si luego de trabajar sobre un término *complicado* llegas a un acuerdo con otros colaboradores:

no se olviden de agregarlo.

.. _ayuda oficial de GitHub para crear un Pull Request:

.. _poedit:https://poedit.net/

.. _powrap:https://github.com/AFPy/powrap

.. _pospell:https://github.com/AFPy/pospell

.. _nuestro canal de Telegram:https://t.me/python_docs_es

.. _la traducción al Portugués:https://docs.python.org/pt-br/3/

Puedes suscribirte ingresando aquí_.

.. _aquí:https://mail.python.org/mailman3/lists/docs-es.python.org/

.. _powrap_windows:

Utilizar ``powrap`` en Windows

Si no estás usando MinGW o el Subsistema de Linux en Windows como entorno

de trabajo, la única opción que tienes es utilizar la herramienta ``poedit``

para traducir y ajustar el largo de cada línea.

Si vas a *Preferences -> Advanced* podrás encontrar una forma de seleccionar

que los *Line endings* sean *Unix (recommended)* y que la opción **Wrap

at** esté activada y tenga el valor **70**.

La razón de estos problemas, es que ``powrap`` utiliza una dependencia

llamada ``msgcat`` que provee el paquete ``gettext`` que usualmente

se puede instalar en macOS y Linux, pero no en Windows.

.. _pospell_windows:

Utilizar ``pospell`` en Windows

La herramienta ``pospell`` depende de un paquete llamado ``hunspell``, y que no

se instala por defecto mediante ``pip``. Para instalar la dependencia tienes

dos opciones:

#. Utilizar el paquete que provee una iniciativa llamada

*exwinports*, que puedes seleccionar desde esta

`lista de archivos<https://sourceforge.net/projects/ezwinports/files/>`_.

Luego descomprimes el archivo en algún lugar como ``C:\hunspell\``,

y agregas dicho directorio al ``PATH``::

y finalmente, descarga un diccionario ``es_ES`` de algún lugar,

por ejemplo, de `acá<https://kitscenarist.ru/downloads/hunspell/>`_.

#. Utilizar el subsistema Linux, y configurar todo desde dicho sistema,

clonando el repositorio y todo desde ahí. Luego ejecutas la instalación

de ``pospell`` (via pip) y ``hunspell`` (via apt-get) para utilizar

las herramientas desde ahí.

..note::Tendrás que tener todo configurado en el subsistema Linux para

poder utilizar esta opción.

"Project-Id-Version:Python 3.8\n"

"Report-Msgid-Bugs-To:\n"

"POT-Creation-Date:2022-10-25 19:47+0200\n"

"PO-Revision-Date:2021-08-01 20:17+0200\n"

"Last-Translator:Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"

"Language:es\n"

"PO-Revision-Date:2022-10-30 16:51-0300\n"

"Last-Translator:Sofía Denner <sofi.denner@gmail.com>\n"

"Language-Team:python-doc-es\n"

"Plural-Forms:nplurals=2; plural=(n != 1);\n"

"Language:es\n"

"MIME-Version:1.0\n"

"Content-Type:text/plain; charset=utf-8\n"

"Content-Transfer-Encoding:8bit\n"

"Plural-Forms:nplurals=2; plural=(n != 1);\n"

"Generated-By:Babel 2.10.3\n"

"X-Generator:Poedit 3.2\n"