Advertencia

¡Ayúdanos a traducir la documentación oficial de Python al Español! Puedes encontrar más información en Como contribuir. Ayuda a acercar Python a más personas de habla hispana.

Memoria de traducción

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:

$ python scripts/find_in_po.py docstring
╒════════════════════════════════════════════════════════════════════════════════════════════════╤═══════════════════════════════════════════════════════════════════════════════════════════════╕
│ The first statement of the function body can optionally be a string literal; this string       │ La primera sentencia del cuerpo de la función puede ser opcionalmente una cadena de texto     │
│ literal is the function's documentation string, or :dfn:`docstring`. (More about docstrings    │ literal; esta es la cadena de texto de documentación de la función, o :dfn:`docstring`.       │
│ can be found in the section :ref:`tut-docstrings`.) There are tools which use docstrings to    │ (Puedes encontrar más acerca de docstrings en la sección :ref:`tut-docstrings`.). Existen     │
│ automatically produce online or printed documentation, or to let the user interactively browse │ herramientas que usan las ``docstrings`` para producir documentación imprimible o disponible  │
│ through code; it's good practice to include docstrings in code that you write, so make a habit │ en línea, o para dejar que los usuarios busquen interactivamente a través del código; es una  │
│ of it.                                                                                         │ buena práctica incluir ``docstrings`` en el código que escribes, y hacerlo un buen hábito.    │
├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
│ Here is an example of a multi-line docstring::                                                 │ Este es un ejemplo de un ``docstring`` multi-línea::                                          │
├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
│ Use docstrings.                                                                                │ Usar ``docstrings``.                                                                          │
├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤

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.

Términos y bigramas

Dividimos esta sección en dos partes, los términos que se traducen y los que mantenemos el original. Éstas son las palabras que hemos coordinado hasta el momento:

auditing event

evento de auditoría library/tempfile and many others

awaitable

aguardable glossary

slash and backslash

barra y barra invertida c-api,``tutorial``,``library/functions.po``

built-in

incorporada glossary.po

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

checksum

suma de comprobación howto/clinic.po

code object

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

context manager

gestor de contexto

deallocated

desalojable glossary.po

docstring

docstring. library/idle.po

key

clave

keyword argument

argumento por palabra clave / argumento de palabra clave

handler

gestor tutorial/errors.po

handle exception

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

i. e.

en otras palabras. library/sqlite3.po

in-place, in place

in situ. Aunque estrictamente no es español, su uso es generalizado.

library

biblioteca. library/sqlite3.po

list comprehension / list comprehensions

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

locale

Configuración regional. library/functions.po and others

helper function

función auxiliar library/typing.po

loop

bucle tutorial/controlflow.po

mapping

mapeo glossary.po

named tuple.

tupla nombrada glossary.po

overload, overloading

sobrecargar, sobrecarga

override, overriding

sobreescribir, sobreescritura

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

slice

segmento datamodel.po

slicing

segmentación datamodel.po

static type checker

Validador estático de tipos Notas: mantener la mayúscula, usar validación cuando se refiera a la acción y no al agente.

string

cadena de caracteres datamodel.po

strings

cadenas de caracteres datamodel.po

third-party

de terceros library/typing.po

type hint

indicador de tipo library/typing.po

type annotation library/typing.po
anotación de tipo

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

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

Estas son las reglas de estilo que hemos convenido hasta el momento:

  • En títulos [de sección] sólo se usará mayúscula en la primera palabra salvo nombre propios, en contraste con el inglés, que lo hace en todas las palabras principales (conectores no).

    Referencia: https://www.rae.es/dpd/may%C3%BAsculas 4.17

    Ejemplo: tutorial/errors.po 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.

    Referencia: https://www.rae.es/dpd/se punto 2

    Ejemplo: tutorial/errors.po 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.

    Referencia: https://www.rae.es/dpd/se punto 2

    Ejemplo: tutorial/errors.po 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/