Merge branch '3.7' into inputoutput

Author: kikocorreoso

CONTRIBUTING.rst .overrides/CONTRIBUTING.rstCONTRIBUTING.rst renamed to .overrides/CONTRIBUTING.rst

@@ -18,7 +18,9 @@ Actualmente se puede colaborar utilizando una de las dos siguientes formas que:
 Desde GitHub
 ------------
 
-#. Crea un fork del repositorio.
+#. Crea un fork del repositorio_.
+
+.. _repositorio: https://github.com/PyCampES/python-docs-es
 
    .. note::
 
@@ -38,6 +40,10 @@ Desde GitHub
 
     git remote add upstream https://github.com/pycampes/python-docs-es.git
 
+#. Crea una branch nueva en base al artículo en el que vayas a trabajar.
+  
+    git checkout -b traduccion_glosario
+
 #. Mira que archivo necesita ser traducido. El siguiente comando te mostrará una lista de archivos y los porcentajes traducidos.
    Elige uno que no esté completo::
 
@@ -48,7 +54,7 @@ Desde GitHub
 #. 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 update-translation
+    git push origin traduccion_glosario
 
 #. Luego ve a tu página de GitHub y propone hacer un Pull Request
 

.overrides/README.rst

@@ -0,0 +1,11 @@
+Overrides
+=========
+
+This directory is recursively copied into `cpython/Doc`.
+It needs to have the same structure than `cpython/Doc`.
+
+It allows us
+
+- to have our own `CONTRIBUTING.rst` guide
+- change the index sidebar with links that are interesting for translators
+- etc

.overrides/tools/templates/customsourcelink.html

@@ -0,0 +1,13 @@
+{%- if show_source and has_source and sourcename %}
+<div role="note" aria-label="source link">
+    <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/PyCampES/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"
+               rel="nofollow">{{ _('Show Source') }}
+            </a>
+        </li>
+    </ul>
+</div>
+{%- endif %}

.overrides/tools/templates/indexsidebar.html

@@ -0,0 +1,11 @@
+<h3>¡Ayúdanos a traducir!</h3>
+<ul>
+  <li><a href="CONTRIBUTING.html">Guía para contribuir</a></li>
+</ul>
+
+<h3>Recursos</h3>
+<ul>
+  <li><a href="https://mail.python.org/mailman3/lists/docs-es.python.org/">Lista de correos</a></li>
+  <li><a href="https://t.me/python_docs_es">Canal de Télegram</a></li>
+  <li><a href="https://github.com/PyCampES/python-docs-es">Repositorio GitHub</a></li>
+</ul>

conf.py

@@ -33,7 +33,22 @@
 
 os.system('mkdir -p cpython/locales/es/')
 os.system('ln -nfs `pwd` cpython/locales/es/LC_MESSAGES')
-os.system('ln -nfs `pwd`/CONTRIBUTING.rst cpython/Doc/CONTRIBUTING.rst')
+
+
+# Override all the files from ``.overrides`` directory
+import glob
+for root, dirs, files in os.walk('.overrides'):
+    for fname in files:
+        if fname == 'README.rst' and root == '.overrides':
+            continue
+        destroot = root.replace('.overrides', '').lstrip('/')
+        outputdir = os.path.join(
+            'cpython',
+            'Doc',
+            destroot,
+            fname,
+        )
+        os.system(f'ln -nfs `pwd`/{root}/{fname} {outputdir}')
 
 gettext_compact = False
 locale_dirs = ['../locales', 'cpython/locales']  # relative to the sourcedir
@@ -50,8 +65,8 @@ def add_contributing_banner(app, doctree):
         from docutils import nodes, core
 
         message = '¡Ayúdanos a traducir la documentación oficial de Python al Español! ' \
-        f'Puedes encontrar más información en `Como contribuir </es/{version}/CONTRIBUTING.html>`_  ' \
-        'y así ayudarnos a acercar Python a más personas de habla hispana.'
+        f'Puedes encontrar más información en `Como contribuir </es/{version}/CONTRIBUTING.html>`_.  ' \
+        'Ayuda a acercar Python a más personas de habla hispana.'
 
         paragraph = core.publish_doctree(message)[0]
         banner = nodes.warning(ids=['contributing-banner'])