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

Author: cmaureir

.github/workflows/main.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - 3.*
+  pull_request:
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Preparar Python v3.8
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.8
+      - name: Sincronizar con CPython
+        run: |
+          git submodule sync
+          git submodule update --init --force cpython
+      - name: Instalar dependencias
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y hunspell hunspell-es gettext
+          python -m pip install -r requirements.txt
+          pip list
+          pospell --version
+          powrap --version
+      - name: Powrap
+        run: powrap --check --quiet **/*.po
+      - name: Pospell
+        run: |
+          python scripts/create_dict.py
+          pospell -p dict.txt -l es_ES **/*.po
+      - name: Construir documentación
+        run: PYTHONWARNINGS=ignore::FutureWarning sphinx-build -j auto -W --keep-going -b html -d cpython/Doc/_build/doctree -D language=es . cpython/Doc/_build/html

.overrides/faq.rst

@@ -26,8 +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::
 
-    awk 1 dict dictionaries/*.txt > dict.txt
-    pospell -p dict.txt -l es_AR -l es_ES path/tu_fichero.po
+    python scripts/create_dict.py  # para crear el archivo 'dict.txt'
+    pospell -p dict.txt -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í:

.overrides/reviewers-guide.rst

@@ -33,11 +33,11 @@ Para esto, Github te ofrece opciones para afrontar una PR (ver botón *Review Ch
 
 * PRs de más de 1000 líneas: Te sugerimos hacer un comentario al principio del PR para indicar hasta qué línea haz hecho el review y qué hay que revisar hasta ese hito. También si tú mismo vas a continuar la review, pero no puedes hacerla de una sola vez, es útil para saber donde retomar tu trabajo.
 * El uso de la opción "Needs work" en poedit genera en la línea anterior al párrafo un comentario "#, fuzzy" para que el traductor revise esa línea. Se puede usar cuando la traducción necesita revisión y en ese momento no puedes sugerir una traducción alternativa. Ten en cuenta que los párrafos con esa marca no aparecerán traducidos en el build. Como revisor, también podrías incluir ese comentario tu mismo como sugerencia.
-* Al igual que cuando uno traduce, en el proceso de revisión puedes consultar y emplear las herramientas que tenemos. Por ejemplo, si no estás seguro sobre la traducción de un término sobre el que puede que ya hayamos tomado una decisión consensuada, puedes consultar la memoria de traducción [,](https://github.com/python/python-docs-es/blob/3.8/.overrides/translation-memory.rst) usar `scripts/find_in_po.py` o incluso comentarlo en nuestro grupo de Telegram.
+* Al igual que cuando uno traduce, en el proceso de revisión puedes consultar y emplear las herramientas que tenemos. Por ejemplo, si no estás seguro sobre la traducción de un término sobre el que puede que ya hayamos tomado una decisión consensuada, puedes consultar la :doc:`memoria de traducción <translation-memory>` usar `scripts/find_in_po.py` o incluso comentarlo en nuestro grupo de Telegram.
 
 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.
+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 :doc:`Guía para contribuir en la traducción <CONTRIBUTING>`), contamos con herramientas en este proyecto que pueden fallar en ciertos casos, y que como revisor/a deberás tener en cuenta.
 
 Tres razones por las que puede fallar el *build* de Travis:
 

.overrides/tools/templates/customsourcelink.html

@@ -4,9 +4,24 @@ <h3>{{ _('This Page') }}</h3>
     <ul class="this-page-menu">
         <li><a href="{{ pathto('bugs') }}">{% trans %}Report a Bug{% endtrans %}</a></li>
         <li>
-            <a href="https://github.com/python/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"
-               rel="nofollow">{{ _('Show Source') }}
-            </a>
+            {# 
+                Las siguientes líneas están para que se pueda redireccionar
+                al correctamente el código fuente en python-docs-es.readthedocs.io/
+            #}
+            {% set overriden_pages = ['coc', 'CONTRIBUTING', 'faq', 'reviewers-guide','progress', 'translation-memory', 'upgrade-python-version'] %}
+            {% if pagename in overriden_pages %}
+                <li>
+                    <a href="https://github.com/python/python-docs-es/blob/{{ version }}/.overrides/{{ sourcename|replace('.rst.txt', '.rst') }}"
+                    rel="nofollow">{{ _('Show Source') }}
+                    </a>
+                </li>
+            {% else %}
+                <li>
+                    <a href="https://github.com/python/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"
+                    rel="nofollow">{{ _('Show Source') }}
+                    </a>
+                </li>
+            {% endif %}
         </li>
     </ul>
 </div>

.overrides/translation-memory.rst

@@ -52,7 +52,7 @@ Fuentes recomendadas
 
   https://www.linguee.es/
 
-Diccionario y traductor multilíngue con millones de traducciones indexadas. De los creadores
+  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:
@@ -77,153 +77,156 @@ 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``
+.. glossary::
 
-     slash and backslash
-      barra y barra invertida ``c-api``,``tutorial``,``library/functions.po``
+   auditing event
+     evento de auditoría ``library/tempfile`` and many others
 
-     built-in
-       incorporada ``glossary.po``
+   awaitable
+     aguardable ``glossary``
 
-     built-in exceptions
-       excepciones predefinidas ``tutorial/errors.po``
+   slash and backslash
+     barra y barra invertida ``c-api``, ``tutorial``, ``library/functions.po``
 
-     bytecodes
-       queda igual ``glossary.po``
+   built-in
+     incorporada ``glossary.po``
 
-     callable
-       invocable ``glossary.po``, ``library/functions.po``
+   built-in exceptions
+     excepciones predefinidas ``tutorial/errors.po``
 
-       Nota: en ocasiones es mejora mantener callable, especialmente cuando se refiere directamente
-       a la anotación de typing Callable
+   bytecodes
+     queda igual ``glossary.po``
+  
+   callable
+     invocable ``glossary.po``, ``library/functions.po``
 
-     checksum
-       suma de comprobación ``howto/clinic.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``
+   checksum
+     suma de comprobación ``howto/clinic.po``
 
-     context manager
-       gestor de contexto
+   code object
+     objeto código ``c-api``, ``library/functions.po``
 
-     deallocated
-       desalojable ``glossary.po``
+   context manager
+     gestor de contexto
 
-     docstring
-       docstring. ``library/idle.po``
+   deallocated
+     desalojable ``glossary.po``
+
+   docstring
+     docstring. ``library/idle.po``
 
-     key
-       clave
+   key
+     clave
 
-     keyword argument
-       argumento por palabra clave / argumento de palabra clave
+   keyword argument
+     argumento por palabra clave / argumento de palabra clave
 
-     handler
-       gestor ``tutorial/errors.po``
+   handler
+     gestor ``tutorial/errors.po``
 
-     handle exception
-       gestionar [una] excepción. ``tutorial/inputoutput.po``
-       gestionar excepciones
+   handle exception
+     gestionar [una] excepción. ``tutorial/inputoutput.po``
+     gestionar excepciones
 
-     i. e.
-       en otras palabras. ``library/sqlite3.po``
+   i. e.
+     en otras palabras. ``library/sqlite3.po``
 
-     in-place, in place
-       in situ. Aunque estrictamente no es español, su uso es generalizado.
+   in-place, in place
+     in situ. Aunque estrictamente no es español, su uso es generalizado.
 
-     library
-       biblioteca. ``library/sqlite3.po``
+   library
+     biblioteca. ``library/sqlite3.po``
 
-     list comprehension / list comprehensions
-       lista por comprensión / listas por comprensión.
+   list comprehension / list comprehensions
+     lista por comprensión / listas por comprensión.
 
-     locale
-       Configuración regional. ``library/functions.po`` and others
+   locale
+     Configuración regional. ``library/functions.po`` and others
 
-     helper function
-       función auxiliar  ``library/typing.po``
+   helper function
+     función auxiliar  ``library/typing.po``
 
-     loop
-       bucle ``tutorial/controlflow.po``
+   loop
+     bucle ``tutorial/controlflow.po``
 
-     mapping
-       mapeo ``glossary.po``
+   mapping
+     mapeo ``glossary.po``
 
-     named tuple.
-       tupla nombrada ``glossary.po``
+   named tuple.
+     tupla nombrada ``glossary.po``
 
-     overload, overloading
-       sobrecargar, sobrecarga
+   overload, overloading
+     sobrecargar, sobrecarga
 
-     override, overriding
-       sobreescribir, sobreescritura
+   override, overriding
+     sobreescribir, sobreescritura
 
-     path
-       ruta ``glossary.po``
+   path
+     ruta ``glossary.po``
 
-     pythonic
-       *pythónico*
+   pythonic
+     *pythónico*
 
-       idiomático
+     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/
+     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``
+   raise
+     lanzar, lanza. (referido a excepciones)  ``library/functions.po``, ``c-api``
 
-     release
-       version ``HOWTO``
+   release
+     version ``HOWTO``
 
-     return / returns
-       retorna / retornar ``library/sqlite3.po``
+   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".
+   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``
+   runtime
+     tiempo de ejecución ``tutorial/classes.po``
 
-     slice
-      segmento ``datamodel.po``
+   slice
+    segmento ``datamodel.po``
 
-     slicing
-      segmentación ``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.
+   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``
+   string
+    cadena de caracteres ``datamodel.po``
 
-     strings
-      cadenas de caracteres ``datamodel.po``
+   strings
+    cadenas de caracteres ``datamodel.po``
 
-     third-party
-       de terceros ``library/typing.po``
+   third-party
+     de terceros ``library/typing.po``
 
-     type hint
-       indicador de tipo  ``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
+   type annotation
+     anotación de tipo ``library/typing.po``
+     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``
+   underscore
+     guión bajo ``glossary.po``
 
-     widget
-       widget ``library/tkinter``
+   widget
+     widget ``library/tkinter``
 
 
 

.pre-commit-config.yaml

@@ -7,11 +7,11 @@ repos:
     hooks:
     -   id: merge-dicts
         name: merge-dicts
-        entry: ./scripts/merge-dicts.sh
-        language: script
+        entry: python ./scripts/create_dict.py
+        language: python
 # This one requires package ``hunspell-es_es`` in Archlinux
 -   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']
+        args: ['--personal-dict', 'dict.txt', '--modified', '--language', 'es_ES']