* No debes traducir el contenido de ``:ref:...`` y ``:term:...``.

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

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

por asteriscos)

* Puedes revisar las:doc:`faq` para leer sobre problemas conocidos.

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ónBrew_.

..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 ejemplopodiff_ 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/

<ulclass="this-page-menu">

<li><ahref="{{ pathto('bugs') }}">{% trans %}Report a Bug{% endtrans %}</a></li>

<ahref="https://github.com/PyCampES/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"

<ahref="https://github.com/python/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"

rel="nofollow">{{ _('Show Source') }}

<li><ahref="https://mail.python.org/mailman3/lists/docs-es.python.org/">Lista de correos</a></li>

<li><ahref="https://t.me/python_docs_es">Canal de Télegram</a></li>

<li><ahref="https://github.com/PyCampES/python-docs-es">Repositorio GitHub</a></li>

<li><ahref="https://github.com/python/python-docs-es">Repositorio GitHub</a></li>

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

y coordinamos cuál era la mejor traducción dado el contexto.

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.

Si quieres ver cómo se ha utilizado un término anteriormente, puedes utilizar la herramienta

``find_in_po.py`` que muestra dónde se usó ese término: original y traducción lado a lado:

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

https://www.wordreference.com/

Diccionario y traductor multilingue

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.

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.

Términos y bigramas

Éstos son las palabrasquehemos coordinado hastaelmomento:

Dividimos esta sección en dos partes, los términosquese traducen y los que mantenemoseloriginal.

auditing event

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

awaitable

aguardable ``glossary``

built-in exceptions

excepciones predefinidas ``tutorial/errors.po``

bytecodes

queda igual ``glossary.po``

callable

invocable ``glossary.po``, ``library/functions.po``

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

a la anotación de typing Callable

code object

objeto código ``c-api``, ``library/functions.po``

keyword argument

argumento por palabra clave / argumento de palabra clave

handler

gestor ``tutorial/errors.po``, ``library/functions.po``

gestor ``tutorial/errors.po``

handle exception

gestionar excepción. ``tutorial/inputoutput.po``

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

gestionar excepciones

i. e.

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

mapping

mapeo ``glossary.po``

named tuple

named tuple.

tupla nombrada ``glossary.po``

overload, overloading

sobrecargar, sobrecarga

path

ruta ``glossary.po``

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/

raise

lanzar, lanza. (referido a excepciones) ``library/functions.po``, ``c-api``

release

version ``HOWTO``

return / returns

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

return

retorna. ``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".

runtime

tiempo de ejecución ``tutorial/classes.po``

type annotation ``library/typing.po``

anotación de tipo

Nota: úsese como sinónimo de *type hint*

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``

auditing event

evento de auditoria ``library/tempfile``

widget

widget ``library/tkinter``

Términos que no se traducen

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="\*[^*]+\*"``

Reglas de estilo

`en`: Predefined Clean-up Actions

`es`: Acciones de limpieza predefinidas

* Se priorizará la segunda persona del singular no formal (tu/vos) frente al formal (usted).

Sin embargo, allí donde sea posible, se usarán formas impersonales (con se), ya que son comunes a

todas las variantes del español.

`en`: Look at the following example, [...]

`es`: Véase el siguiente ejemplo, [...]

* En general se evitará la traducción literal de la voz pasiva del original en inglés y se usará

el impersonal (pasiva refleja) en la traducción al español.

`en`: [...] where the error was detected.

`es`: [...] donde se detectó el error.

Nota cf. "fue detectado"

* 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/

entry:./scripts/merge-dicts.sh

language:script

-repo:https://github.com/humitos/pospell

rev:pre-commit

-repo:https://github.com/JulienPalard/pospell

rev:v1.0.5

hooks:

-id:pospell

args:['--personal-dict', 'dict.txt', '--modified', '--language', 'es_ES', '--language', 'es_AR']

VENV :=$(shell realpath ./venv)

PYTHON :=$(shell which python3)

CPYTHON_WORKDIR := cpython

OUTPUT_DOCTREE :=$(CPYTHON_WORKDIR)/Doc/_build/doctree

OUTPUT_HTML :=$(CPYTHON_WORKDIR)/Doc/_build/html

OUTPUT_DOCTREE :=$(CPYTHON_WORKDIR)/Doc/build/doctree

OUTPUT_HTML:=$(CPYTHON_WORKDIR)/Doc/build/html

LOCALE_DIR :=$(CPYTHON_WORKDIR)/locale

TRANSIFEX_PROJECT := python-docs-es

POSPELL_TMP_DIR := .pospell

Sergio Infante (@neosergio)

Martín Gaitán (@mgaitan)

Manuel Kaufmann (@humitos)

Sergio Infante (@neosergio)

Luis Llave (@llaveluis)

Pablo Lobariñas (@Qkolnek)

Alvar Maciel (@alvarmaciel @amaciel)

David Revillas (@r3v1)

Xavi Rambla Centellas (@xavirambla)

Santiago E Fraire Willemoes (@Woile)

Alfonso Reyes (@mxarc)

Gustavo Adolfo Huarcaya Delgado (@diavolo)