version:2

updates:

-package-ecosystem:"github-actions"

directory:"/"

schedule:

interval:"weekly"

name:Test

runs-on:ubuntu-22.04

steps:

-uses:actions/checkout@v2

-uses:actions/checkout@v4

-name:Preparar Python v3.11

uses:actions/setup-python@v2

uses:actions/setup-python@v4

with:

python-version:"3.11"

cache:"pip"

-name:Sincronizar con CPython

run:|

-name:Powrap

run:powrap --check --quiet **/*.po

-name:Sphinx lint

run:|

-name:Pospell

run:|

[submodule "tutorialpyar"]

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

Antes de comenzar

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.

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:

#. 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!

#.Selecciona un:ref:`archivo para traducir<que-archivo-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

esperamos en nuestro chat en telegram. ¡Gracias!

..note::

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

Previsualizar los cambios

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/

* listas de correo python-ideas, core-mentorship, python-dev, docs

* Todas las demás listas de correo alojadas en python.org

* Servidor de chat *Zulip* de la *Python Software Foundation*

* Servidor *Discourse* alojado en discuss.python.org

* Repositorios de código, rastreadores de problemas y solicitudes de extracción realizadas contra

cualquier organización GitHub controlada por la *Python Software Foundation*

Utilizando el gestor de paquetes de tu distribución::

pero por el momento el chequeo que hacemos es con los diccionarios es_AR y es_ES.

localmente alguna otra variación.

¿Cómo agrego una palabra al diccionario?

Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::

¡Eso es todo!

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.

``powrap`` no muestra cambios locales, pero sí en el CI

Asegúrate que tengas instalado el paquete ``gettext`` 0.21 pues es el que se

utiliza en el CI, que es una dependencia de ``powrap``.

..note::

Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.10``.

Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.11``.

En progreso

..runblock::console

$ potodo --offline --path .

$ potodo --path .

Completados

Para facilitar la comparación de ficheros se emplea este programa que va a hacer que todas las líneas tengan el mismo tamaño. Solucionar este problema en nuestra traducción es muy sencillo, solo hay que instalar la herramienta powrap en nuestro entorno y ejecutar el comando ``powrap nuestro_fichero.po``

``sphinx-lint`` falla

El formato en el que la documentación de python está escrito

(`reStructredText<https://es.wikipedia.org/wiki/ReStructuredText>`_ , o rst)

puede ser difícil de manejar y escribir correctamente.

``sphinx-lint`` ayuda a encontrar errores comunes al momento de escribir

entradas en este formato, y advierte al respecto.

Entre los errores más comunes están:

* Textos literales no están separados por un espacio

respecto a las palabras que lo rodean:

* Mal::literal:`no hay espacio antes del\`\`literal\`\``

* Mal::literal:`después del\`\`literal\`\`no hay un espacio`

* Bien::literal:`hay espacio antes del\`\`literal\`\` y después también`

* Textos literales comienzan o terminan con espacios:

* Mal::literal:`\`\` literal empieza con un espacio\`\``

* Mal::literal:`\`\`literal termina con un espacio\`\``

* Bien::literal:`\`\`literal no termina ni empieza con espacios\`\``

* Textos literales no están delineados con dos acentos fuertes:

* Mal::literal:`\`\`falta uno al final :(\``

* Mal::literal:`\`falta uno al principio :(\`\``

* Bien::literal:`\`\`todo bien :)\`\``

* Enlaces no terminan en un guión bajo: