diff --git a/Makefile b/Makefile index af4788b25f..1ea92bac21 100644 --- a/Makefile +++ b/Makefile @@ -89,7 +89,7 @@ progress: venv .PHONY: spell spell: venv - # 'cat' tenia el problema que algunos archivos no tenían una nueva línea al final + # 'cat' tenia el problema que algunos archivos no tenía una nueva línea al final # 'awk 1' agregará una nueva línea en caso que falte. awk 1 dict dictionaries/*.txt > dict.txt $(VENV)/bin/pospell -p dict.txt -l es_ES **/*.po diff --git a/dictionaries/library_email.txt b/dictionaries/library_email.txt new file mode 100644 index 0000000000..64eab53877 --- /dev/null +++ b/dictionaries/library_email.txt @@ -0,0 +1,11 @@ +submódulo +subcomponentes +parser +serializada +serializado +instanciando +serializa +serializarlo +serializan +extensibilidad +Unicode diff --git a/dictionaries/reference_toplevel_components.txt b/dictionaries/reference_toplevel_components.txt new file mode 100644 index 0000000000..d6ed7f90f2 --- /dev/null +++ b/dictionaries/reference_toplevel_components.txt @@ -0,0 +1 @@ +mínimamente \ No newline at end of file diff --git a/library/email.po b/library/email.po index b706497a8f..6160366479 100644 --- a/library/email.po +++ b/library/email.po @@ -1,29 +1,31 @@ # Copyright (C) 2001-2020, Python Software Foundation # This file is distributed under the same license as the Python package. -# Maintained by the python-doc-es workteam. +# Maintained by the python-doc-es workteam. # docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/ # Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers -# -#, fuzzy +# msgid "" msgstr "" "Project-Id-Version: Python 3.8\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2019-05-06 11:59-0400\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2020-10-16 11:13-0500\n" "Language-Team: python-doc-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" +"Last-Translator: \n" +"Language: es\n" +"X-Generator: Poedit 2.4.1\n" #: ../Doc/library/email.rst:2 msgid ":mod:`email` --- An email and MIME handling package" -msgstr "" +msgstr ":mod:`email` --- Un paquete de manejo de correo electrónico y MIME" #: ../Doc/library/email.rst:11 msgid "**Source code:** :source:`Lib/email/__init__.py`" -msgstr "" +msgstr "**Código fuente** :source:`Lib/email/__init__.py`" #: ../Doc/library/email.rst:15 msgid "" @@ -35,6 +37,13 @@ msgid "" "well as such MIME-related RFCs as :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, :" "rfc:`2183`, and :rfc:`2231`." msgstr "" +"El paquete :mod:`email` es una biblioteca para administrar mensajes de " +"correo electrónico. *No* esta diseñado específicamente para enviar mensajes " +"de correo electrónico SMTP (:rfc:`2821`), NNTP u otros servidores; esas son " +"funciones de módulos como :mod:`smtplib` y :mod:`nntplib`. El paquete :mod:" +"`email` intenta ser lo más compatible con RFC, admitiendo :rfc:`5233` y :rfc:" +"`6532`, así como RFC relacionados con MIME como :rfc:`2045`, :rfc:`2046`, :" +"rfc:`2047`, :rfc:`2183`, y :rfc:`2231`." #: ../Doc/library/email.rst:23 msgid "" @@ -42,6 +51,9 @@ msgid "" "components, plus a fourth component that controls the behavior of the other " "components." msgstr "" +"La estructura general del paquete de correo electrónico se puede dividir en " +"tres componentes principales, más un cuarto componente que controla el " +"comportamiento de los otros componentes." #: ../Doc/library/email.rst:27 msgid "" @@ -55,6 +67,17 @@ msgid "" "model is a tree structure of objects that all provide the :class:`~email." "message.EmailMessage` API." msgstr "" +"El componente central del paquete es un \"modelo de objetos\" que representa " +"los mensajes de correo electrónico. Una aplicación interactúa con el paquete " +"principalmente a través de la interfaz del modelo de objetos definida en el " +"submódulo :mod:`~email.message`. La aplicación puede usar esta API para " +"hacer preguntas sobre un correo electrónico existente, para construir un " +"nuevo correo electrónico o para agregar o eliminar subcomponentes de correo " +"electrónico que utilizan la misma interfaz de modelo de objetos. Es decir, " +"siguiendo la naturaleza de los mensajes de correo electrónico y sus " +"subcomponentes MIME, el modelo de objetos de correo electrónico es una " +"estructura de árbol de objetos que proporcionan la API :class:`~email." +"message.EmailMessage`." #: ../Doc/library/email.rst:37 msgid "" @@ -67,6 +90,14 @@ msgid "" "but this usage is discouraged as it is too easy to end up with messages that " "are not valid in one way or another.)" msgstr "" +"Los otros dos componentes principales del paquete son :mod:`~email.parser` " +"y :mod:`~email.generator`. El parser toma la versión serializada de un " +"mensaje de correo electrónico (una secuencia de bytes) Y la convierte en un " +"árbol de objetos :class:`~email.message.EmailMessage`. El generador toma un :" +"class:`~email.message.EmailMessage` y lo convierte de nuevo en un flujo de " +"bytes serializado. (El analizador y el generador también manejan flujos de " +"caracteres de texto, pero se desaconseja este uso ya que es demasiado fácil " +"terminar con mensajes que no son válidos de una forma u otra)." #: ../Doc/library/email.rst:46 msgid "" @@ -82,6 +113,18 @@ msgid "" "from disk, but to serialize it using standard SMTP settings when sending it " "to an email server." msgstr "" +"El componente de control es el módulo de :mod:`~email.policy`. Cada :class:" +"`~email.message.EmailMessage` cada :mod:`~email.generator`, y cada :mod:" +"`~email.parser` tiene un objeto de :mod:`~email.policy` asociado que " +"controla su comportamiento. Por lo general, una aplicación solo necesita " +"especificar la política cuando se crea un :class:`~email.message." +"EmailMessage` , ya sea instanciando directamente un :class:`~email.message." +"EmailMessage` para crear un nuevo correo electrónico o analizando un flujo " +"de entrada con un :mod:`~email.parser`. Pero la política se puede cambiar " +"cuando el mensaje se serializa mediante un :mod:`~email.generator`. Esto " +"permite, por ejemplo, analizar un mensaje de correo electrónico genérico " +"desde el disco, pero serializarlo utilizando la configuración estándar de " +"SMTP al enviarlo a un servidor de correo electrónico." #: ../Doc/library/email.rst:58 msgid "" @@ -99,6 +142,21 @@ msgid "" "modern internet software (not just email), this will be a familiar concept " "to many programmers." msgstr "" +"El paquete de correo electrónico hace todo lo posible para ocultar los " +"detalles de las diversas RFC que rigen de la aplicación. Conceptualmente, la " +"aplicación debería poder tratar el mensaje de correo electrónico como un " +"árbol estructurado de texto Unicode y archivos adjuntos binarios, sin tener " +"que preocuparse por cómo se representan estos cuando se serializan. En la " +"práctica, sin embargo, a menudo es necesario conocer al menos algunas de las " +"reglas que rigen los mensajes MIME y su estructura, específicamente los " +"nombres y la naturaleza de los «tipos de contenido» MIME y cómo identifican " +"los documentos de varias partes. En su mayor parte, este conocimiento solo " +"debería ser necesario para aplicaciones más complejas, e incluso entonces " +"debería ser solo la estructura de alto nivel en cuestión, y no los detalles " +"de cómo se representan esas estructuras. Dado que los tipos de contenido " +"MIME se utilizan ampliamente en el software moderno de Internet (no solo en " +"el correo electrónico), este será un concepto familiar para muchos " +"programadores." #: ../Doc/library/email.rst:71 msgid "" @@ -109,6 +167,12 @@ msgid "" "mod:`~email.policy` controls, which completes the treatment of the main " "components of the library." msgstr "" +"Las siguientes secciones describen la funcionalidad del paquete :mod:" +"`email`. Comenzamos con el modelo de objetos :mod:`~email.message`, que es " +"la interfaz principal que usará una aplicación, y lo seguimos con los " +"componentes del :mod:`~email.parser` y :mod:`~email.generator` . Luego " +"cubrimos los controles de la :mod:`~email.policy`, lo que completa el " +"tratamiento de los principales componentes de la biblioteca." #: ../Doc/library/email.rst:78 msgid "" @@ -121,12 +185,23 @@ msgid "" "messages, but also document their extensibility APIs, which will be of " "interest to advanced applications." msgstr "" +"Las siguientes tres secciones cubren las excepciones que puede generar el " +"paquete y los defectos (incumplimiento de las RFC) que el :mod:`~email." +"parser` puede detectar. Luego cubrimos los subcomponentes :mod:`~email." +"headerregistry` y :mod:`~email.contentmanager`, que proporcionan " +"herramientas para realizar una manipulación más detallada de los encabezados " +"y cargas útiles, respectivamente. Ambos componentes contienen " +"características relevantes para consumir y producir mensajes no triviales, " +"pero también documentan sus API de extensibilidad, que serán de interés para " +"aplicaciones avanzadas." #: ../Doc/library/email.rst:87 msgid "" "Following those is a set of examples of using the fundamental parts of the " "APIs covered in the preceding sections." msgstr "" +"A continuación, se muestra un conjunto de ejemplos del uso de las partes " +"fundamentales de las API cubiertas en las secciones anteriores." #: ../Doc/library/email.rst:90 msgid "" @@ -140,67 +215,81 @@ msgid "" "relevant for applications that are still using the :mod:`~email.policy." "compat32` API for backward compatibility reasons." msgstr "" +"Lo anterior representa la API moderna (compatible con Unicode) del paquete " +"de correo electrónico. Las secciones restantes, comenzando con la clase :" +"class:`~email.message.Message`, cubren la API :data:`~email.policy.compat32` " +"heredada que trata mucho más directamente con los detalles de cómo se " +"representan los mensajes de correo electrónico. La API :data:`~email.policy." +"compat32` no oculta los detalles de las RFC de la aplicación, pero para las " +"aplicaciones que necesitan operar a ese nivel, pueden ser herramientas " +"útiles. Esta documentación también es relevante para las aplicaciones que " +"todavía usan la API :mod:`~email.policy.compat32` por razones de " +"compatibilidad con versiones anteriores." #: ../Doc/library/email.rst:100 msgid "" "Docs reorganized and rewritten to promote the new :class:`~email.message." "EmailMessage`/:class:`~email.policy.EmailPolicy` API." msgstr "" +"Documentos reorganizados y reescritos para promover la nueva API :class:" +"`~email.message.EmailMessage`/:class:`~email.policy.EmailPolicy`." #: ../Doc/library/email.rst:105 msgid "Contents of the :mod:`email` package documentation:" -msgstr "" +msgstr "Contenido de la documentación del paquete :mod:`email`:" #: ../Doc/library/email.rst:120 msgid "Legacy API:" -msgstr "" +msgstr "API heredada:" #: ../Doc/library/email.rst:136 msgid "Module :mod:`smtplib`" -msgstr "" +msgstr "Módulo :mod:`smtplib`" #: ../Doc/library/email.rst:136 msgid "SMTP (Simple Mail Transport Protocol) client" -msgstr "" +msgstr "Cliente SMTP (Protocolo simple de transporte de correo)" #: ../Doc/library/email.rst:139 msgid "Module :mod:`poplib`" -msgstr "" +msgstr "Módulo :mod:`poplib`" #: ../Doc/library/email.rst:139 msgid "POP (Post Office Protocol) client" -msgstr "" +msgstr "Cliente POP (Protocolo de oficina postal)" #: ../Doc/library/email.rst:142 msgid "Module :mod:`imaplib`" -msgstr "" +msgstr "Módulo :mod:`imaplib`" #: ../Doc/library/email.rst:142 msgid "IMAP (Internet Message Access Protocol) client" -msgstr "" +msgstr "Cliente IMAP (Protocolo de acceso a mensajes de Internet)" #: ../Doc/library/email.rst:145 msgid "Module :mod:`nntplib`" -msgstr "" +msgstr "Módulo :mod:`nntplib`" #: ../Doc/library/email.rst:145 msgid "NNTP (Net News Transport Protocol) client" -msgstr "" +msgstr "Cliente NNTP (Protocolo de transporte de noticias de red)" #: ../Doc/library/email.rst:149 msgid "Module :mod:`mailbox`" -msgstr "" +msgstr "Módulo :mod:`mailbox`" #: ../Doc/library/email.rst:148 msgid "" "Tools for creating, reading, and managing collections of messages on disk " "using a variety standard formats." msgstr "" +"Herramientas para crear, leer y administrar colecciones de mensajes en disco " +"utilizando una variedad de formatos estándar." #: ../Doc/library/email.rst:151 msgid "Module :mod:`smtpd`" -msgstr "" +msgstr "Módulo :mod:`smtpd`" #: ../Doc/library/email.rst:152 msgid "SMTP server framework (primarily useful for testing)" -msgstr "" +msgstr "Marco del servidor SMTP (principalmente útil para pruebas)" diff --git a/reference/toplevel_components.po b/reference/toplevel_components.po index d091176578..a36c9404b4 100644 --- a/reference/toplevel_components.po +++ b/reference/toplevel_components.po @@ -1,25 +1,27 @@ # Copyright (C) 2001-2020, Python Software Foundation # This file is distributed under the same license as the Python package. -# Maintained by the python-doc-es workteam. +# Maintained by the python-doc-es workteam. # docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/ # Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers -# -#, fuzzy +# msgid "" msgstr "" "Project-Id-Version: Python 3.8\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2019-05-06 11:59-0400\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2020-10-18 16:24-0500\n" "Language-Team: python-doc-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" +"Last-Translator: \n" +"Language: es\n" +"X-Generator: Poedit 2.4.1\n" #: ../Doc/reference/toplevel_components.rst:6 msgid "Top-level components" -msgstr "" +msgstr "Componentes de nivel superior" #: ../Doc/reference/toplevel_components.rst:10 msgid "" @@ -28,10 +30,14 @@ msgid "" "interactively, from a module source file, etc. This chapter gives the " "syntax used in these cases." msgstr "" +"El intérprete de Python puede obtener su entrada de varias fuentes: de un " +"script que se le pasa como entrada estándar o como argumento del programa, " +"escrito interactivamente, de un archivo fuente de módulo, etc. Este capítulo " +"proporciona la sintaxis utilizada en estos casos." #: ../Doc/reference/toplevel_components.rst:19 msgid "Complete Python programs" -msgstr "" +msgstr "Programas completos de Python" #: ../Doc/reference/toplevel_components.rst:28 msgid "" @@ -44,12 +50,22 @@ msgid "" "`__main__`. The latter is used to provide the local and global namespace " "for execution of the complete program." msgstr "" +"Si bien una especificación de lenguaje no necesita prescribir cómo se invoca " +"al intérprete de lenguaje, es útil tener una noción de un programa completo " +"de Python. Un programa completo de Python se ejecuta en un entorno " +"mínimamente inicializado: todos los módulos estándar e integrados están " +"disponibles, pero ninguno ha sido inicializado, excepto :mod:`sys` (varios " +"servicios del sistema), :mod:`builtins` (funciones integradas, excepciones y " +"``Ninguno``) y :mod:`__main__`. Este último se utiliza para proporcionar el " +"espacio de nombres local y global para la ejecución del programa completo." #: ../Doc/reference/toplevel_components.rst:36 msgid "" "The syntax for a complete Python program is that for file input, described " "in the next section." msgstr "" +"La sintaxis de un programa completo de Python es la entrada de archivos, que " +"se describe en la siguiente sección." #: ../Doc/reference/toplevel_components.rst:43 msgid "" @@ -59,6 +75,11 @@ msgid "" "identical to that of a complete program; each statement is executed in the " "namespace of :mod:`__main__`." msgstr "" +"El intérprete también puede invocarse en modo interactivo; en este caso, no " +"lee ni ejecuta un programa completo, sino que lee y ejecuta una instrucción " +"(posiblemente compuesta) a la vez. El entorno inicial es idéntico al de un " +"programa completo; cada instrucción se ejecuta en el espacio de nombres de :" +"mod:`__main__`." #: ../Doc/reference/toplevel_components.rst:55 msgid "" @@ -68,38 +89,48 @@ msgid "" "is a tty device, the interpreter enters interactive mode; otherwise, it " "executes the file as a complete program." msgstr "" +"Se puede pasar un programa completo al intérprete en tres formas: con la " +"opción :option:`-c` *string* de línea de comando, como un archivo pasado " +"como primer argumento de línea de comando o como entrada estándar. Si el " +"archivo o la entrada estándar es un dispositivo tty, el intérprete ingresa " +"al modo interactivo; de lo contrario, ejecuta el archivo como un programa " +"completo." #: ../Doc/reference/toplevel_components.rst:65 msgid "File input" -msgstr "" +msgstr "Entrada de archivo" #: ../Doc/reference/toplevel_components.rst:67 msgid "All input read from non-interactive files has the same form:" msgstr "" +"Todas las entradas leídas de archivos no interactivos tienen la misma forma:" #: ../Doc/reference/toplevel_components.rst:72 msgid "This syntax is used in the following situations:" -msgstr "" +msgstr "Esta sintaxis se utiliza en las siguientes situaciones:" #: ../Doc/reference/toplevel_components.rst:74 msgid "when parsing a complete Python program (from a file or from a string);" msgstr "" +"al analizar un programa completo de Python (desde un archivo o desde una " +"cadena);" #: ../Doc/reference/toplevel_components.rst:76 msgid "when parsing a module;" -msgstr "" +msgstr "al analizar un módulo;" #: ../Doc/reference/toplevel_components.rst:78 msgid "when parsing a string passed to the :func:`exec` function;" -msgstr "" +msgstr "al analizar una cadena pasada a la función: :func:`exec`;" #: ../Doc/reference/toplevel_components.rst:84 msgid "Interactive input" -msgstr "" +msgstr "Entrada interactiva" #: ../Doc/reference/toplevel_components.rst:86 msgid "Input in interactive mode is parsed using the following grammar:" msgstr "" +"La entrada en modo interactivo se analiza utilizando la siguiente gramática:" #: ../Doc/reference/toplevel_components.rst:91 msgid "" @@ -107,13 +138,19 @@ msgid "" "in interactive mode; this is needed to help the parser detect the end of the " "input." msgstr "" +"Tenga en cuenta que una declaración compuesta (de nivel superior) debe ir " +"seguida de una línea en blanco en modo interactivo; esto es necesario para " +"ayudar al analizador sintáctico a detectar el final de la entrada." #: ../Doc/reference/toplevel_components.rst:98 msgid "Expression input" -msgstr "" +msgstr "Entrada de expresión" #: ../Doc/reference/toplevel_components.rst:103 msgid "" ":func:`eval` is used for expression input. It ignores leading whitespace. " "The string argument to :func:`eval` must have the following form:" msgstr "" +":func:`eval` se utiliza para la entrada de expresiones. Ignora los espacios " +"en blanco iniciales. El argumento de cadena para :func:`eval` debe tener la " +"siguiente forma:"