python
diff --git a/‎.overrides/CONTRIBUTING.rst
+3-7 b/‎.overrides/CONTRIBUTING.rst
+3-7
diff --git a/‎.overrides/pospell_fallo_spelling.png
35.5 KB b/‎.overrides/pospell_fallo_spelling.png
35.5 KB
diff --git a/‎.overrides/pospell_warning_and_english_words.png
133 KB b/‎.overrides/pospell_warning_and_english_words.png
133 KB
diff --git a/‎.overrides/powrap_fail.png
32.9 KB b/‎.overrides/powrap_fail.png
32.9 KB
diff --git a/‎.overrides/reviewers-guide.rst
+38-5 b/‎.overrides/reviewers-guide.rst
+38-5
diff --git a/‎.overrides/sphinx_warnings_example_inconsistent_terms.png
64.8 KB b/‎.overrides/sphinx_warnings_example_inconsistent_terms.png
64.8 KB
diff --git a/‎TRANSLATORS
+4-1 b/‎TRANSLATORS
+4-1
diff --git a/‎dictionaries/library_binhex.txt
+1 b/‎dictionaries/library_binhex.txt
+1
diff --git a/‎dictionaries/library_mailbox.txt
+8 b/‎dictionaries/library_mailbox.txt
+8
diff --git a/‎dictionaries/library_othergui.txt
+2 b/‎dictionaries/library_othergui.txt
+2
diff --git a/‎dictionaries/library_plistlib.txt
+4 b/‎dictionaries/library_plistlib.txt
+4
diff --git a/‎library/binhex.po
+35-10 b/‎library/binhex.po
+35-10
diff --git a/‎library/datetime.po
+3-3 b/‎library/datetime.po
+3-3
@@ -142,7 +142,7 @@ A tener en cuenta
 
 * Colaborar **haciendo revisiones** también es muy muy importante, así que si
   tienes un rato libre puedes comenzar por mirar los PRs pendientes de revisar.
-  (mira la `Guía del revisor`_)
+  (mira la :doc:`Guía del revisor <reviewers-guide>`)
 
 * La documentación es ENORME, cualquier traba que encuentres siempre puedes
   marcar el texto como **"fuzzy"** o para revisar en el futuro.
@@ -159,8 +159,8 @@ A tener en cuenta
   ejemplo un artículo a Wikipedia). En caso de que no haya una traducción del
   artículo en Wikipedia deja el título sin traducir.
 
-* Tenemos una `Memoria de Traducción`_, que usamos para tener consistencia con
-  algunos términos.
+* Tenemos una :doc:`Memoria de Traducción <translation-memory>`, que usamos para tener
+  consistencia con algunos términos.
 
 * Si tienes una **duda sobre una palabra o término**, escríbelo como mejor suene
   para vos y marca ese párrafo como "Need work" / "Necesita trabajo" en
@@ -210,10 +210,6 @@ Tendrás que navegar hasta el archivo que hayas cambiado para ver cómo se visua
 .. _poedit: https://poedit.net/
 
 .. _nuestro canal de Telegram: https://t.me/python_docs_es
-.. _Memoria de traducción:
-   https://python-docs-es.readthedocs.io/page/translation-memory.html
-.. _Guía del revisor:
-   https://python-docs-es.readthedocs.io/page/reviewers-guide.html
 .. _la traducción al Portugués: https://docs.python.org/pt-br/3/
 .. _lista de issues en GitHub:
    https://github.com/python/python-docs-es/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+no%3Aassignee+translate
@@ -3,6 +3,13 @@
 ================================
 Guía para revisar una traducción
 ================================
+
+Antes que nada, queremos compartir contigo `unos videos`_ que uno de nuestros colaboradores ha preparado donde se explica el resumen del proceso a través de un ejemplo.
+
+Asimismo, si nunca has hecho una revisión pero ya has colaborado con el proyecto, te recomendamos que pruebes esta otra manera de colaborar, ya que permite ponerse en el lugar de otra persona, y muchas veces ayuda a mejorar las traducciones propias.
+
+.. _`unos videos`: https://www.youtube.com/watch?v=uIaQMTuwtoU&list=PLma583Z70SlztPF8SitlWJZx3SW1aAePk&index=3&t=7s&ab_channel=Cristi%C3%A1nMaureira-Fredes
+
 El costado humano
 =================
 Teniendo en cuenta que todes somos voluntaries en este proyecto, es importante que la forma de comunicarnos sea clara, concisa y amable. Como revisor/a, ayudarás a voluntaries de diferentes culturas y lugares del mundo para que su traducción sea lo más acertada posible y podamos acercar Python a las comunidades de habla hispana. Recuerda que del otro lado de un PR hay una persona que ha dedicado tiempo y esfuerzo; es por eso es la forma en que le des una devolución sobre su trabajo influirá en su actitud hacia el proyecto…¡y en sus ganas de seguir participando de nuestra comunidad!
@@ -32,8 +39,34 @@ El costado técnico
 ==================
 Al revisar una traducción, deberás tener en cuenta ciertos aspectos propios de una traducción técnica de esta índole. Además de que debe entenderse el texto en español y que debes respetar el contenido de la documentación original (ver "A tener en cuenta" en la `Guía para contribuir en la traducción <https://python-docs-es.readthedocs.io/es/3.8/CONTRIBUTING.html>`_), contamos con herramientas en este proyecto que pueden fallar en ciertos casos, y que como revisor/a deberás tener en cuenta.
 
-Cuatro razones por las que puede fallar el *build* de Travis:
-* `powrap` falla
-* `pospell` falla
-* Dict está duplicado
-* Sphinx falla
+Tres razones por las que puede fallar el *build* de Travis:
+
+``powrap`` falla
+---------------------
+
+.. image:: powrap_fail.png
+
+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``
+
+
+``pospell`` falla
+---------------------
+
+Los fallos en pospell pueden ser variados y según con que nos encontremos tenemos que actuar de una manera u otra. En principio es un chequeo de ortografía contra un diccionario de español, por lo que nos va a fallar tanto si usamos palabras en otro idioma, como si usamos palabras en español mal escritas como si usamos palabras que simplemente no están en el diccionario. Por ejemplo:
+
+.. image:: pospell_fallo_spelling.png
+
+En este primer caso simplemente hay un error en la ortografía por lo que solucionarlo en nuestra traducción será lo únicoque tengamos que hacer.
+
+.. image:: pospell_warning_and_english_words.png
+
+En este segundo, en cambio, vemos un par de cosas más interesantes. En primer lugar, tenemos un warning de rst, donde nos da un error porque unas comillas no han sido reconocidas como final de una palabra. Si te fijas en el texto esto ocurre donde están los paréntesis pegados a la expresión entre comillas dobles SNDCTL_DSP_SYNC. Añadir un espacio allí solucionará nuestro problema. Por otro lado, nos lanza una serie de palabras que han fallado en pospell, pero como vemos, son o bien términos técnicos, o nombres en inglés (en este caso posiblemente parte de un nombre propio) y una palabra que está correctamente escrita en español pero es un poco técnica. Por tanto, en este caso no queremos cambiarlas en nuestra traducción, sino que queremos que sean una excepción en el chequeo de pospell. Para ello, lo que debemos hacer es o bien crear o bien incluir (si ya está creado) en un diccionario llamado como nuestro fichero y que se emplace en la carpeta dictionaries las palabras que deben ser una excepción. Por ejemplo, los diccionarios para el fichero clinic o argparse los encontramos dentro de ./dictionaries como howto_clinic.txt y library_argparse.txt. Cuando se haga el build se tendrán en cuenta estas excepciones y no tendremos ese error de pospell.
+
+Sphinx falla: 
+---------------------
+
+Durante la renderización de la documentación hay toda una serie de referencias cruzadas, que deben permanecer igual en español que en inglés. Un fallo habitual es el siguiente:
+
+.. image:: sphinx_warnings_example_inconsistent_terms.png
+
+Indica que alguna de las referencias falta en la traducción. Lo más probable es que al traducir se haya cambiado algo de la sintaxis particular como las comillas, y por eso no esté siendo reconocida.
@@ -80,10 +80,11 @@ Naryie Vásquez Martínez (@narvmtz)
 María Andrea Vignau (@mavignau @marian-vignau)
 David Revillas (@r3v1)
 Xavi Rambla Centellas (@xavirambla)
+Rodrigo Poblete Diaz (@rodpoblete)
 Elias Urios Alacreu (@Buzzeitor30)
 Santiago E Fraire Willemoes (@Woile)
-Alfonso Reyes (@mxarc)
 Gustavo Adolfo Huarcaya Delgado (@diavolo)
+Alfonso Reyes (@mxarc)
 Enrique Giménez (@fenriquegimenez)
 Rishabh Mishra (@rishabhmishra25)
 Carlos Martel Lamas (@Letram)
@@ -93,3 +94,5 @@ Antonio González Fernández (@iam-agf)
 Yennifer Paola Herrera Ariza (@Yenniferh)
 Willian Garcia (@wgarcia1309)
 Ana Medina Bernal (@ana-med)
+Juan Biondi (@yeyeto2788)
+Iracema Cabllero (@iracaballero)
@@ -0,0 +1 @@
+binhex
@@ -0,0 +1,8 @@
+Maildir
+mbox
+Babyl
+Wikipedia
+Rmail
+qmail
+reformateados
+moverlos
@@ -0,0 +1,2 @@
+kits
+GUI
@@ -0,0 +1,4 @@
+plist
+plists
+Autodetecta
+Expat
@@ -1,46 +1,55 @@
 # 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 <EMAIL@ADDRESS>\n"
+"PO-Revision-Date: 2020-10-06 13:42+0200\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"
+"X-Generator: Poedit 2.4.1\n"
+"Last-Translator: \n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: es_ES\n"
 
 #: ../Doc/library/binhex.rst:2
 msgid ":mod:`binhex` --- Encode and decode binhex4 files"
-msgstr ""
+msgstr ":mod:`binhex` --- Codificar y decodificar archivos binhex4"
 
 #: ../Doc/library/binhex.rst:7
 msgid "**Source code:** :source:`Lib/binhex.py`"
-msgstr ""
+msgstr "**Código fuente:** :source:`Lib/binhex.py`"
 
 #: ../Doc/library/binhex.rst:11
 msgid ""
 "This module encodes and decodes files in binhex4 format, a format allowing "
 "representation of Macintosh files in ASCII. Only the data fork is handled."
 msgstr ""
+"Este módulo codifica y descodifica archivos en formato binhex4, un formato "
+"que permite la representación de archivos Macintosh en ASCII. Solo se maneja "
+"\"data fork\"."
 
 #: ../Doc/library/binhex.rst:14
 msgid "The :mod:`binhex` module defines the following functions:"
-msgstr ""
+msgstr "El módulo :mod:`binhex` define las siguientes funciones:"
 
 #: ../Doc/library/binhex.rst:19
 msgid ""
 "Convert a binary file with filename *input* to binhex file *output*. The "
 "*output* parameter can either be a filename or a file-like object (any "
 "object supporting a :meth:`write` and :meth:`close` method)."
 msgstr ""
+"Convierta un archivo binario con nombre de archivo *input* a archivo binhex "
+"*output*. El parámetro *output* puede ser un nombre de archivo o un objeto "
+"similar a un archivo (cualquier objeto que admita un método :meth:`write` y :"
+"meth:`close`)."
 
 #: ../Doc/library/binhex.rst:26
 msgid ""
@@ -49,39 +58,55 @@ msgid ""
 "is written to a file named *output*, unless the argument is ``None`` in "
 "which case the output filename is read from the binhex file."
 msgstr ""
+"Descodificar un archivo binhex *input*. *input* puede ser un nombre de "
+"archivo o un objeto similar a un archivo que admita los métodos :meth:`read` "
+"y :meth:`close`. El archivo resultante se escribe en un archivo denominado "
+"*output*, a menos que el argumento sea ``None`` en cuyo caso el nombre de "
+"archivo de salida se lee desde el archivo binhex."
 
 #: ../Doc/library/binhex.rst:31
 msgid "The following exception is also defined:"
-msgstr ""
+msgstr "También se define la siguiente excepción:"
 
 #: ../Doc/library/binhex.rst:36
 msgid ""
 "Exception raised when something can't be encoded using the binhex format "
 "(for example, a filename is too long to fit in the filename field), or when "
 "input is not properly encoded binhex data."
 msgstr ""
+"Excepción que se produce cuando algo no se puede codificar con el formato "
+"binhex (por ejemplo, un nombre de archivo demasiado largo para caber en el "
+"campo de nombre de archivo) o cuando la entrada no está codificada "
+"correctamente como datos binhex."
 
 #: ../Doc/library/binhex.rst:43
 msgid "Module :mod:`binascii`"
-msgstr ""
+msgstr "Módulo :mod:`binascii`"
 
 #: ../Doc/library/binhex.rst:44
 msgid ""
 "Support module containing ASCII-to-binary and binary-to-ASCII conversions."
 msgstr ""
+"Módulo de soporte que contiene conversiones ASCII a binario y de binario a "
+"ASCII."
 
 #: ../Doc/library/binhex.rst:50
 msgid "Notes"
-msgstr ""
+msgstr "Notas"
 
 #: ../Doc/library/binhex.rst:52
 msgid ""
 "There is an alternative, more powerful interface to the coder and decoder, "
 "see the source for details."
 msgstr ""
+"Hay una interfaz alternativa más potente al codificador y decodificador, ver "
+"la fuente para más detalles."
 
 #: ../Doc/library/binhex.rst:55
 msgid ""
 "If you code or decode textfiles on non-Macintosh platforms they will still "
 "use the old Macintosh newline convention (carriage-return as end of line)."
 msgstr ""
+"Si codifica o decodifica ficheros de texto en plataformas no Macintosch, aún "
+"así se usará la antigua convención de nueva línea de Macintosh (retorno de "
+"carro al final de la línea)."
@@ -11,7 +11,7 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-05-05 12:54+0200\n"
-"PO-Revision-Date: 2020-05-20 18:27+0200\n"
+"PO-Revision-Date: 2020-10-06 11:06-0400\n"
 "Language-Team: python-doc-es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -20,15 +20,15 @@ msgstr ""
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "Last-Translator: \n"
 "Language: es_ES\n"
-"X-Generator: Poedit 2.3\n"
+"X-Generator: Poedit 2.3.1\n"
 
 #: ../Doc/library/datetime.rst:2
 msgid ":mod:`datetime` --- Basic date and time types"
 msgstr ":mod:`datetime` --- Tipos básicos de fecha y hora"
 
 #: ../Doc/library/datetime.rst:11
 msgid "*Source code:* :source:`Lib/datetime.py`"
-msgstr "*Código fuente:* :fuente:`Lib/datetime.py`"
+msgstr "*Código fuente:* :source:`Lib/datetime.py`"
 
 #: ../Doc/library/datetime.rst:17
 msgid ""
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +plist
 +plists
 +Autodetecta
 +Expat