Merge branch '3.8' into traduccion-library/turtle.po

Author: cmaureir

.gitignore

@@ -65,6 +65,8 @@ coverage.xml
 .idea/
 /translation-memory.po
 /locale/
+*.swp
+*~
 
 # OSX
 .DS_Store

.overrides/CONTRIBUTING.rst

@@ -4,55 +4,28 @@ Guía para contribuir en la traducción
 =====================================
 
 ¡Muchas gracias por tu interés en participar de la traducción de la
-documentación oficial de Python al Español! Necesitamos *mucho* de tu ayuda
-para poder seguir adelante con este proyecto. Te damos la bienvenida y
-te agradecemos anticipadamente por tus futuras colaboraciones.
+documentación oficial de Python al Español!
 
 Este es el grupo de trabajo para la traducción de la
 documentación oficial de Python al Español, todo el contenido de la traducción
 es mantenido por voluntaries que aportan su tiempo y trabajo a la comunidad.
 
 Antes de comenzar tu primera traducción, y que sigas con esta guia de
-contribución, queremos señalar algunos lineamientos generales.
-
-- Esta traducción es mantenida por personas de todo el mundo que hablan el
-  idioma Español. No queremos atarla a ninguna región en particular y creemos
-  que es un valor extra la diversidad de la misma.  Vas a encontrar secciones
-  con diferentes tonalidades de países, regiones o estilos. Lo único que pedimos
-  es consistencia dentro de un mismo módulo o sección (es decir no cambiar de
-  estilo de un párrafo a otro, por ejemplo) y siempre intentar que la persona del
-  otro lado pueda entender lo que estamos escribiendo (no usar lunfardo o
-  regionalismos muy propios de un único lugar).
-
-- La documentación es ENORME, cualquier traba que encuentres siempre puedes
-  marcar el texto como “fuzzy” o para revisar en el futuro.
-  No pierdas horas buscando la palabra perfecta.
-
-- En muchos casos el mejor criterio es pensar en el vocabulario que utilizamos
-  cuando le explicamos a otra persona, o en el trabajo. En muchas ocasiones la
-  versión en inglés o “spanglish” de la palabra es mucho mejor que decir “git
-  unir” (para git merge).
-
-- Siempre vas a tener un review de lo que propongas y en ese intercambio otras
-  personas van a ayudarte a destrabar las dudas que tengas.
-
-- Colaborar haciendo reviews 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`_)
-
-- Último pero no menos importante, divertite y contá con la ayuda de todes. Te
-  esperamos en nuestro chat en telegram. ¡Gracias!
-
+contribución, queremos señalar algunos
+:ref:`lineamientos generales <a-tener-en-cuenta>`.
 
 .. note::
 
    Si tienes cualquier duda, puedes enviarnos un email a [email protected].
 
+Antes de comenzar
+-----------------
 
-¡Comienza a traducir!
----------------------
+#. Para enviar una traducción, necesitas tener un **fork** del repositorio_
+   oficial, haciendo click en el botón encerrado en rojo.
 
-#. Crea un fork del repositorio_.
+   .. image:: fork.png
+     :alt: botón fork
 
    .. note::
 
@@ -70,8 +43,35 @@ contribución, queremos señalar algunos lineamientos generales.
 
      git remote add upstream https://github.com/python/python-docs-es.git
 
+#. (Opcional) Crea un entorno virtual y actívalo::
+
+     python -m venv env
+     source env/bin/activate   # macOS y Linux
+     env\Scripts\activate.bat  # Windows
+
+#. (Opcional) Instala los requerimientos del proyecto::
+
+     pip install -r requirements.txt
+
+   .. note::
+
+      Al tener instalado los requerimientos, podrás utilizas las herramientas
+      ``powrap`` y ``pospell`` para poder verificar tus archivos traducidos,
+      y también construir la documentación localmente.
+
+¡Comienza a traducir!
+---------------------
+
+#. Selecciona un :ref:`archivo para traducir <que-archivo-traducir>`.
+
+#. Verifica que estás en la rama principal del repositorio, **3.8** (esto es muy 
+   importante para evitar crear una nueva rama a partir de una traducción 
+   anterior)::
+
+     git checkout 3.8
+
 #. Crea una rama nueva en base al artículo en el que vayas a trabajar.  Por
-   ejemplo, si vas a trabajar en el archivo ``glosario.po``, usa un nombre
+   ejemplo, si vas a trabajar en el archivo ``library/glosario.po``, usa un nombre
    similar a::
 
      git checkout -b traduccion-glosario
@@ -80,29 +80,31 @@ contribución, queremos señalar algunos lineamientos generales.
    empezar a traducir.
 
 #. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a
-   GitHub de nuevo::
-
-     git commit -am 'Traducido archivo {nombre de archivo}' git push origin
-     traduccion-glosario
-
-#. No olvides añadir tu nombre al archivo ``TRANSLATORS`` si no lo has hecho
-   todavía.  Los nombres se encuentran ordenados alfabéticamente por apellido.
+   GitHub (No olvides añadir tu nombre al archivo ``TRANSLATORS``)::
 
-#. Luego ve a tu página de GitHub y propone hacer un *Pull Request*.
+     git add library/glosario.po
+     git commit -m 'Traducido archivo library/glosario'
+     git push origin traduccion-glosario
 
    .. note::
 
+      Mira los mensajes que el último comando imprimirá por pantalla,
+      pues encontrarás un enlace para abrir un nuevo Pull-request directamente.
+
       Puedes consultar la `ayuda oficial de GitHub para crear un Pull Request`_
       si lo deseas.
 
+
 #. En la descripción de la *Pull Request* escribe ``Closes #<número de issue>``
    (así se cierra automáticamente cuando se hace *merge*)
 
    .. note::
 
       Si hace tiempo que venis trabajando en una traducción es importante
-      :ref:`mantener actualizada <mantener-actualizada>` tu copia local antes de realizar el *Pull Request*.
+      :ref:`mantener actualizada <mantener-actualizada>` tu copia local antes
+      de realizar el *Pull Request*.
 
+.. _que-archivo-traducir:
 
 ¿Qué archivo traducir?
 ----------------------
@@ -118,25 +120,51 @@ archivo es el siguiente:
 #. ¡Empieza a traducir!
 
 
+.. _a-tener-en-cuenta:
 
 A tener en cuenta
 -----------------
 
-* No debes traducir el contenido de ``:ref:...`` y ``:term:...``.
+* Esta traducción es mantenida por **personas de todo el mundo** que hablan el
+  idioma Español. No queremos atarla a ninguna región en particular y creemos
+  que es un valor extra la diversidad de la misma.  Vas a encontrar secciones
+  con diferentes tonalidades de países, regiones o estilos. Lo único que pedimos
+  es **consistencia** dentro de un mismo módulo o sección (es decir no cambiar de
+  estilo de un párrafo a otro, por ejemplo) y siempre intentar que la persona del
+  otro lado pueda entender lo que estamos escribiendo (no usar lunfardo o
+  regionalismos muy propios de un único lugar).
+
+* En muchos casos el **mejor criterio** es pensar en el vocabulario que utilizamos
+  cuando le explicamos a otra persona, o en el trabajo. En muchas ocasiones la
+  versión en inglés o “spanglish” de la palabra es mucho mejor que decir “git
+  unir” (para git merge).
+
+* Siempre vas a tener una **revisión de lo que propongas** y en ese intercambio otras
+  personas van a ayudarte a destrabar las dudas que tengas.
 
-* Si tienes que usar palabras en inglés debes ponerlas en *italics* (rodeadas
+* 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 :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.
+  No pierdas horas buscando la palabra perfecta.
+
+* **No debes** traducir el contenido de ``:ref:...``, ``:term:...``, ``:dfn:...``, etc.
+
+* 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.
+* Puedes revisar las :doc:`Preguntas Frecuentes <faq>` para leer sobre problemas conocidos.
 
-* Si traduces un título que es un link, por favor traduce el link también (por
+* Si **traduces un título que es un enlace**, por favor traduce el link también (por
   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
+* 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
   *poedit*. Además, escribe un comentario explicando cuál es el termino en ese
   párrafo con el que no estabas segura.
@@ -148,11 +176,14 @@ A tener en cuenta
   tiene una traducción al Español en la barra de la izquierda. Suelen estar
   bastante bien explicados.
 
-* Te recomendamos abrir una Pull Request aunque sea en formato borrador (marcada
+* Te recomendamos abrir una **Pull Request aunque sea en formato borrador** (marcada
   como draft) desde los primeros commits de la traducción de tu fichero. De esta
   forma, puedes recibir feedback desde el principio que puedes aplicar al resto
   de la traducción, y probar el build más a menudo.
 
+* Último pero no menos importante, **divertite y contá con la ayuda de todes**. Te
+  esperamos en nuestro chat en telegram. ¡Gracias!
+
 
 .. note::
 
@@ -181,10 +212,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

.overrides/faq.rst

@@ -26,7 +26,8 @@ pospell. Pospell puede ser instalada en tu entorno de Python empleando pip
 Una vez instalado, para chequear el fichero .po sobre el que estás trabajando,
 ejecuta desde el directorio principal del repo::
 
-    pospell -p dict -l es_AR -l es_ES path/tu_fichero.po
+    awk 1 dict dictionaries/*.txt > dict.txt
+    pospell -p dict.txt -l es_AR -l es_ES path/tu_fichero.po
 
 pospell emplea la herramienta de diccionarios hunspell. Si pospell falla dando
 como error que no tiene hunspell instalado, lo puedes instalar así:
@@ -192,12 +193,12 @@ Y luego accediendo a http://localhost:8000/
 .. _mantener-actualizada:
 
 ¿Cómo actualizar mi copia local del repositorio?
----------------------------------------------------------
+------------------------------------------------
 
-Es recomendable mantener actualizada nuestra copia local para evitar 
-posibles conflictos entre los archivos que trabajamos y la última versión disponible 
-en el repositorio remoto. 
-Primero, necesitamos bajar los cambios de *upstream* (es el nombre que asignamos al 
+Es recomendable mantener actualizada nuestra copia local para evitar
+posibles conflictos entre los archivos que trabajamos y la última versión disponible
+en el repositorio remoto.
+Primero, necesitamos bajar los cambios de *upstream* (es el nombre que asignamos al
 repositorio principal de la traducción). Se hace de la siguiente manera::
 
     git fetch upstream
@@ -206,11 +207,37 @@ Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::
 
     git checkout 3.8
     git merge upstream/3.8
-    git push origin 3.8 
+    git push origin 3.8
 
 ¡Eso es todo!
 
 
+¿Son importantes los dobles espacios en el original?
+----------------------------------------------------
+
+No.
+
+En realidad, no tienen ningún efecto. Sphinx se da cuenta automáticamente de esto y simplemente
+deja un solo espacio en la versión final. Así que, no te preocupes si ves dos espacios juntos.
+
+Si estás interesada en saber más sobré "¿Por qué se usan dobles espacios?" puedes leer este artículo:
+`How Many Spaces Should Be After a Period? <https://www.instructionalsolutions.com/blog/one-space-vs-two-after-period>`_
+
+
+¿Puedo agregar "estilo de código" a los nombres de las funciones/métodos/clases/etc?
+------------------------------------------------------------------------------------
+
+No.
+
+Si aparece el nombre de una función (por ejemplo, "IncrementalParser") en el original y no tiene ningún estilo asociado
+(no está en cursiva, ni en negrita ni en estilo de código), aunque sientas la tentación de ponerla como
+``IncrementalParser``, no debes hacerlo.
+
+En principio, no debemos cambiar el formato de estas palabras. Si está con asteriscos, lo dejamos con asteriscos.
+Si está con backticks, lo dejamos con los backticks, etc. Si realmente crees que es un error y debería
+estar con un formato distinto, debes reportarlo en el repositorio de CPython.
+
+
 ¿Tienen una lista de correo?
 ----------------------------
 

.overrides/fork.png

@@ -0,0 +1,58 @@
+:orphan:
+
+=========================
+Simplificar el `git diff`
+=========================
+
+El comando `git diff` tiene datos que pueden llegar a ser inútiles como por ejemplo:
+
+.. code-block:: diff
+
+    -#: ../Doc/library/signal.rst:406
+    +#: ../Doc/library/signal.rst:408
+
+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::
+
+         /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
+
+Una vez instalado brew, hay que instalar podiff, para ellos ejectar el siguiente comando:
+
+.. code-block:: bash
+   
+   brew install podiff
+
+Luego abrir el archivo de configuración del respositorio local y escribir al final:
+
+.. code-block:: bash
+
+   [diff "podiff"]
+   command = $(brew --prefix)/bin/podiff -D--minimal
+
+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
+
+    *.po diff=podiff
+
+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
+
+    pip install podiff
+    # o
+    pip install potools
+
+.. _Brew: https://docs.brew.sh/Installation
+.. _podiff: https://pypi.org/project/podiff/
+.. _potools: https://pypi.org/project/potools/