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

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.

Esta página contiene la Memoria de Traducción, con todos los términos dudosos que hemos ido

resolviendo, coordinandonos en cuál era la mejor traducción dado el contexto.

También incluye una serie de reglas de estilo extraídas de fuentes reconocidas.

Para términos que aún no han sido resueltos, se lista a continuación las fuentes consultadas más

habituales y con cierta referencialidad en el mundo hispanohablante o de la traducción:

Fuentes recomendadas

:Diccionario Panhispánico de dudas:

https://www.rae.es/dpd/

Obra orientada a resolver dudas en diferentes áreas de la lengua española: ortografía, sintaxis,

gramática ...

:Wordreference:

https://www.wordreference.com/

Diccionario y traductor multilingue

:Linguee.es:

https://www.linguee.es/

Diccionario y traductor multilíngue con millones de traducciones indexadas. De los creadores

de DeepL

:Fundéu BBVA - Fundación para el español urgente:

https://www.fundeu.es/

Fundación dedicada a la resolución de dudas. Creada originalmente por la agencia estatal

española de noticias EFE, a partir de su departamento y libro de estilo.

:IATE - European Union terminology:

https://iate.europa.eu/home

Base de datos de las traducciones oficiales de la Unión Europea. Permite búsqueda por término

y sector.

Dividimos esta sección en dos partes, los términos que se traducen y los que mantenemos el original.

auditing event

evento de auditoría ``library/tempfile`` and many others

Nota: en ocasiones es mejora mantener callable, especialmente cuando se refiere directamente

a la anotación de typing Callable

gestor ``tutorial/errors.po``

gestionar [una] excepción. ``tutorial/inputoutput.po``

gestionar excepciones

i. e.

en otras palabras. ``library/sqlite3.po``

lista por comprensión / listas por comprensión.

named tuple.

pythonic

*pythónico*

idiomático

Estes dos términos son próximos en el contexto que se usan, utilizar complementariamente

según el contexto. Referencia: https://docs.python-guide.org/writing/style/

release

return / returns

retorna / retornar ``library/sqlite3.po``

return type

tipo de retorno ``library/typing.po``

tipo retornado

tipo devuelto

Nota: en algunos contextos es mejor usar el participio (retornado/devuelto), se prefiere

retornado por semejanza con el original inglés "return".

slice

segmento ``datamodel.po``

slicing

segmentación ``datamodel.po``

string

cadena de caracteres ``datamodel.po``

strings

cadenas de caracteres ``datamodel.po``

Nota: úsese como sinónimo de *type hint*, aunque en el texto se sobreentiende que anotación

es algo accesorio, un comentario, y type hint implica que el Validador hará comprobaciones

underscore

guión bajo ``glossary.po``

widget

widget ``library/tkinter``

En general, estos términos no se traducen, con las excepciones donde una traducción menos literal

hace omitir o substituír el término. Al ser extranjerismos deben estar en cursiva (rodeados con

asterísticos).

bytes

bytecodes

docstring

script

token

unicode

Puedes revisar los términos no traducidos usando la siguiente regex en tu IDE:

``\*[^*]+\*``

Si quieres buscar esos términos sólo en el texto traducido en el archivo dado en input, puedes emplear el siguiente comando:

``msgexec --input library/datetime.po grep -E --regexp="\*[^*]+\*"``

* Al incluír voces latinas (in situ, a priori ...) se recomienda el uso de *cursiva* salvo en

aquellas expresiones más habituales como etcetera o viceversa, por ser considerados

extranjerismos.

Referencia: https://www.fundeu.es/recomendacion/locuciones-latinas-latinismos-errores-frecuentes-621/