Skip to content

Commit 4850caa

Browse files
kikocorreosokikocorreoso
authored
Merge branch '3.7' into inputoutput
2 parents e699e3f + 2cfd151 commit 4850caa

File tree

8 files changed

+376
-12
lines changed

8 files changed

+376
-12
lines changed

CONTRIBUTING.rst renamed to .overrides/CONTRIBUTING.rst

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,9 @@ Actualmente se puede colaborar utilizando una de las dos siguientes formas que:
1818
Desde GitHub
1919
------------
2020

21-
#. Crea un fork del repositorio.
21+
#. Crea un fork del repositorio_.
22+
23+
.. _repositorio: https://github.com/PyCampES/python-docs-es
2224

2325
.. note::
2426

@@ -38,6 +40,10 @@ Desde GitHub
3840

3941
git remote add upstream https://github.com/pycampes/python-docs-es.git
4042

43+
#. Crea una branch nueva en base al artículo en el que vayas a trabajar.
44+
45+
git checkout -b traduccion_glosario
46+
4147
#. Mira que archivo necesita ser traducido. El siguiente comando te mostrará una lista de archivos y los porcentajes traducidos.
4248
Elige uno que no esté completo::
4349

@@ -48,7 +54,7 @@ Desde GitHub
4854
#. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a GitHub de nuevo::
4955

5056
git commit -am 'Traducido archivo {nombre de archivo}'
51-
git push origin update-translation
57+
git push origin traduccion_glosario
5258

5359
#. Luego ve a tu página de GitHub y propone hacer un Pull Request
5460

‎.overrides/README.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
Overrides
2+
=========
3+
4+
This directory is recursively copied into `cpython/Doc`.
5+
It needs to have the same structure than `cpython/Doc`.
6+
7+
It allows us
8+
9+
- to have our own `CONTRIBUTING.rst` guide
10+
- change the index sidebar with links that are interesting for translators
11+
- etc

‎.overrides/tools/templates/customsourcelink.html‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
{%- if show_source and has_source and sourcename %}
2+
<div role="note" aria-label="source link">
3+
<h3>{{ _('This Page') }}</h3>
4+
<ul class="this-page-menu">
5+
<li><a href="{{ pathto('bugs') }}">{% trans %}Report a Bug{% endtrans %}</a></li>
6+
<li>
7+
<a href="https://github.com/PyCampES/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"
8+
rel="nofollow">{{ _('Show Source') }}
9+
</a>
10+
</li>
11+
</ul>
12+
</div>
13+
{%- endif %}

‎.overrides/tools/templates/indexsidebar.html‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
<h3>¡Ayúdanos a traducir!</h3>
2+
<ul>
3+
<li><a href="CONTRIBUTING.html">Guía para contribuir</a></li>
4+
</ul>
5+
6+
<h3>Recursos</h3>
7+
<ul>
8+
<li><a href="https://mail.python.org/mailman3/lists/docs-es.python.org/">Lista de correos</a></li>
9+
<li><a href="https://t.me/python_docs_es">Canal de Télegram</a></li>
10+
<li><a href="https://github.com/PyCampES/python-docs-es">Repositorio GitHub</a></li>
11+
</ul>

‎conf.py‎

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,22 @@
3333

3434
os.system('mkdir -p cpython/locales/es/')
3535
os.system('ln -nfs `pwd` cpython/locales/es/LC_MESSAGES')
36-
os.system('ln -nfs `pwd`/CONTRIBUTING.rst cpython/Doc/CONTRIBUTING.rst')
36+
37+
38+
# Override all the files from ``.overrides`` directory
39+
import glob
40+
for root, dirs, files in os.walk('.overrides'):
41+
for fname in files:
42+
if fname == 'README.rst' and root == '.overrides':
43+
continue
44+
destroot = root.replace('.overrides', '').lstrip('/')
45+
outputdir = os.path.join(
46+
'cpython',
47+
'Doc',
48+
destroot,
49+
fname,
50+
)
51+
os.system(f'ln -nfs `pwd`/{root}/{fname} {outputdir}')
3752

3853
gettext_compact = False
3954
locale_dirs = ['../locales', 'cpython/locales'] # relative to the sourcedir
@@ -50,8 +65,8 @@ def add_contributing_banner(app, doctree):
5065
from docutils import nodes, core
5166

5267
message = '¡Ayúdanos a traducir la documentación oficial de Python al Español! ' \
53-
f'Puedes encontrar más información en `Como contribuir </es/{version}/CONTRIBUTING.html>`_ ' \
54-
'y así ayudarnos a acercar Python a más personas de habla hispana.'
68+
f'Puedes encontrar más información en `Como contribuir </es/{version}/CONTRIBUTING.html>`_. ' \
69+
'Ayuda a acercar Python a más personas de habla hispana.'
5570

5671
paragraph = core.publish_doctree(message)[0]
5772
banner = nodes.warning(ids=['contributing-banner'])

0 commit comments

Comments
 (0)