Skip to content

Commit 6c2f28c

Browse files
cmaureircmaureir
committed
Merge branch '3.8' into pr-498
2 parents 3703328 + 3f9db29 commit 6c2f28c

File tree

503 files changed

+6679
-1563
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

503 files changed

+6679
-1563
lines changed

‎.overrides/CONTRIBUTING.rst

Lines changed: 80 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -4,55 +4,28 @@ Guía para contribuir en la traducción
44
=====================================
55

66
¡Muchas gracias por tu interés en participar de la traducción de la
7-
documentación oficial de Python al Español! Necesitamos *mucho* de tu ayuda
8-
para poder seguir adelante con este proyecto. Te damos la bienvenida y
9-
te agradecemos anticipadamente por tus futuras colaboraciones.
7+
documentación oficial de Python al Español!
108

119
Este es el grupo de trabajo para la traducción de la
1210
documentación oficial de Python al Español, todo el contenido de la traducción
1311
es mantenido por voluntaries que aportan su tiempo y trabajo a la comunidad.
1412

1513
Antes de comenzar tu primera traducción, y que sigas con esta guia de
16-
contribución, queremos señalar algunos lineamientos generales.
17-
18-
- Esta traducción es mantenida por personas de todo el mundo que hablan el
19-
idioma Español. No queremos atarla a ninguna región en particular y creemos
20-
que es un valor extra la diversidad de la misma. Vas a encontrar secciones
21-
con diferentes tonalidades de países, regiones o estilos. Lo único que pedimos
22-
es consistencia dentro de un mismo módulo o sección (es decir no cambiar de
23-
estilo de un párrafo a otro, por ejemplo) y siempre intentar que la persona del
24-
otro lado pueda entender lo que estamos escribiendo (no usar lunfardo o
25-
regionalismos muy propios de un único lugar).
26-
27-
- La documentación es ENORME, cualquier traba que encuentres siempre puedes
28-
marcar el texto como “fuzzy” o para revisar en el futuro.
29-
No pierdas horas buscando la palabra perfecta.
30-
31-
- En muchos casos el mejor criterio es pensar en el vocabulario que utilizamos
32-
cuando le explicamos a otra persona, o en el trabajo. En muchas ocasiones la
33-
versión en inglés o “spanglish” de la palabra es mucho mejor que decir “git
34-
unir” (para git merge).
35-
36-
- Siempre vas a tener un review de lo que propongas y en ese intercambio otras
37-
personas van a ayudarte a destrabar las dudas que tengas.
38-
39-
- Colaborar haciendo reviews también es muy muy importante, así que si
40-
tienes un rato libre puedes comenzar por mirar los PRs pendientes de revisar.
41-
(mira la `Guía del revisor`_)
42-
43-
- Último pero no menos importante, divertite y contá con la ayuda de todes. Te
44-
esperamos en nuestro chat en telegram. ¡Gracias!
45-
14+
contribución, queremos señalar algunos
15+
:ref:`lineamientos generales <a-tener-en-cuenta>`.
4616

4717
.. note::
4818

4919
Si tienes cualquier duda, puedes enviarnos un email a docs-es@python.org.
5020

21+
Antes de comenzar
22+
-----------------
5123

52-
¡Comienza a traducir!
53-
---------------------
24+
#. Para enviar una traducción, necesitas tener un **fork** del repositorio_
25+
oficial, haciendo click en el botón encerrado en rojo.
5426

55-
#. Crea un fork del repositorio_.
27+
.. image:: fork.png
28+
:alt: botón fork
5629

5730
.. note::
5831

@@ -70,8 +43,33 @@ contribución, queremos señalar algunos lineamientos generales.
7043

7144
git remote add upstream https://github.com/python/python-docs-es.git
7245

46+
#. (Opcional) Crea un entorno virtual y actívalo::
47+
48+
python -m venv env
49+
source env/bin/activate # macOS y Linux
50+
env\Scripts\activate.bat # Windows
51+
52+
#. (Opcional) Instala los requerimientos del proyecto::
53+
54+
pip install -r requirements.txt
55+
56+
.. note::
57+
58+
Al tener instalado los requerimientos, podrás utilizas las herramientas
59+
``powrap`` y ``pospell`` para poder verificar tus archivos traducidos,
60+
y también contruir la documentación localmente.
61+
62+
¡Comienza a traducir!
63+
---------------------
64+
65+
#. Selecciona un :ref:`archivo para traducir <que-archivo-traducir>`.
66+
67+
#. Verifica que estás en la rama principal del repositorio, **3.8**::
68+
69+
git checkout 3.8
70+
7371
#. Crea una rama nueva en base al artículo en el que vayas a trabajar. Por
74-
ejemplo, si vas a trabajar en el archivo ``glosario.po``, usa un nombre
72+
ejemplo, si vas a trabajar en el archivo ``library/glosario.po``, usa un nombre
7573
similar a::
7674

7775
git checkout -b traduccion-glosario
@@ -80,29 +78,31 @@ contribución, queremos señalar algunos lineamientos generales.
8078
empezar a traducir.
8179

8280
#. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a
83-
GitHub de nuevo::
84-
85-
git commit -am 'Traducido archivo {nombre de archivo}' git push origin
86-
traduccion-glosario
87-
88-
#. No olvides añadir tu nombre al archivo ``TRANSLATORS`` si no lo has hecho
89-
todavía. Los nombres se encuentran ordenados alfabéticamente por apellido.
81+
GitHub (No olvides añadir tu nombre al archivo ``TRANSLATORS``)::
9082

91-
#. Luego ve a tu página de GitHub y propone hacer un *Pull Request*.
83+
git add library/glosario.po
84+
git commit -m 'Traducido archivo library/glosario'
85+
git push origin traduccion-glosario
9286

9387
.. note::
9488

89+
Mira los mensajes que el último comando imprimirá por pantalla,
90+
pues encontrarás un enlace para abrir un nuevo Pull-request directamente.
91+
9592
Puedes consultar la `ayuda oficial de GitHub para crear un Pull Request`_
9693
si lo deseas.
9794

95+
9896
#. En la descripción de la *Pull Request* escribe ``Closes #<número de issue>``
9997
(así se cierra automáticamente cuando se hace *merge*)
10098

10199
.. note::
102100

103101
Si hace tiempo que venis trabajando en una traducción es importante
104-
:ref:`mantener actualizada <mantener-actualizada>` tu copia local antes de realizar el *Pull Request*.
102+
:ref:`mantener actualizada <mantener-actualizada>` tu copia local antes
103+
de realizar el *Pull Request*.
105104

105+
.. _que-archivo-traducir:
106106

107107
¿Qué archivo traducir?
108108
----------------------
@@ -118,25 +118,51 @@ archivo es el siguiente:
118118
#. ¡Empieza a traducir!
119119

120120

121+
.. _a-tener-en-cuenta:
121122

122123
A tener en cuenta
123124
-----------------
124125

125-
* No debes traducir el contenido de ``:ref:...`` y ``:term:...``.
126+
* Esta traducción es mantenida por **personas de todo el mundo** que hablan el
127+
idioma Español. No queremos atarla a ninguna región en particular y creemos
128+
que es un valor extra la diversidad de la misma. Vas a encontrar secciones
129+
con diferentes tonalidades de países, regiones o estilos. Lo único que pedimos
130+
es **consistencia** dentro de un mismo módulo o sección (es decir no cambiar de
131+
estilo de un párrafo a otro, por ejemplo) y siempre intentar que la persona del
132+
otro lado pueda entender lo que estamos escribiendo (no usar lunfardo o
133+
regionalismos muy propios de un único lugar).
134+
135+
* En muchos casos el **mejor criterio** es pensar en el vocabulario que utilizamos
136+
cuando le explicamos a otra persona, o en el trabajo. En muchas ocasiones la
137+
versión en inglés o “spanglish” de la palabra es mucho mejor que decir “git
138+
unir” (para git merge).
139+
140+
* Siempre vas a tener una **revisión de lo que propongas** y en ese intercambio otras
141+
personas van a ayudarte a destrabar las dudas que tengas.
142+
143+
* Colaborar **haciendo revisiones** también es muy muy importante, así que si
144+
tienes un rato libre puedes comenzar por mirar los PRs pendientes de revisar.
145+
(mira la `Guía del revisor`_)
146+
147+
* La documentación es ENORME, cualquier traba que encuentres siempre puedes
148+
marcar el texto como **"fuzzy"** o para revisar en el futuro.
149+
No pierdas horas buscando la palabra perfecta.
150+
151+
* **No debes** traducir el contenido de ``:ref:...``, ``:term:...``, ``:dfn:...``, etc.
126152

127153
* Si tienes que usar palabras en inglés debes ponerlas en *cursiva* (rodeadas
128154
por asteriscos)
129155

130-
* Puedes revisar las :doc:`faq` para leer sobre problemas conocidos.
156+
* Puedes revisar las :doc:`Preguntas Frecuentes <faq>` para leer sobre problemas conocidos.
131157

132-
* Si traduces un título que es un link, por favor traduce el link también (por
158+
* Si **traduces un título que es un enlace**, por favor traduce el link también (por
133159
ejemplo un artículo a Wikipedia). En caso de que no haya una traducción del
134160
artículo en Wikipedia deja el título sin traducir.
135161

136162
* Tenemos una `Memoria de Traducción`_, que usamos para tener consistencia con
137163
algunos términos.
138164

139-
* Si tienes una duda sobre una palabra o término, escríbelo como mejor suene
165+
* Si tienes una **duda sobre una palabra o término**, escríbelo como mejor suene
140166
para vos y marca ese párrafo como "Need work" / "Necesita trabajo" en
141167
*poedit*. Además, escribe un comentario explicando cuál es el termino en ese
142168
párrafo con el que no estabas segura.
@@ -148,11 +174,14 @@ A tener en cuenta
148174
tiene una traducción al Español en la barra de la izquierda. Suelen estar
149175
bastante bien explicados.
150176

151-
* Te recomendamos abrir una Pull Request aunque sea en formato borrador (marcada
177+
* Te recomendamos abrir una **Pull Request aunque sea en formato borrador** (marcada
152178
como draft) desde los primeros commits de la traducción de tu fichero. De esta
153179
forma, puedes recibir feedback desde el principio que puedes aplicar al resto
154180
de la traducción, y probar el build más a menudo.
155181

182+
* Último pero no menos importante, **divertite y contá con la ayuda de todes**. Te
183+
esperamos en nuestro chat en telegram. ¡Gracias!
184+
156185

157186
.. note::
158187

‎.overrides/fork.png

33.6 KB
Loading

‎.overrides/tools/templates/customsourcelink.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ <h3>{{ _('This Page') }}</h3>
44
<ul class="this-page-menu">
55
<li><a href="{{ pathto('bugs') }}">{% trans %}Report a Bug{% endtrans %}</a></li>
66
<li>
7-
<a href="https://github.com/PyCampES/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"
7+
<a href="https://github.com/python/python-docs-es/blob/{{ version }}/{{ sourcename|replace('.rst.txt', '.po') }}"
88
rel="nofollow">{{ _('Show Source') }}
99
</a>
1010
</li>

‎.overrides/tools/templates/indexsidebar.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,5 @@ <h3>Recursos</h3>
88
<ul>
99
<li><a href="https://mail.python.org/mailman3/lists/docs-es.python.org/">Lista de correos</a></li>
1010
<li><a href="https://t.me/python_docs_es">Canal de Télegram</a></li>
11-
<li><a href="https://github.com/PyCampES/python-docs-es">Repositorio GitHub</a></li>
11+
<li><a href="https://github.com/python/python-docs-es">Repositorio GitHub</a></li>
1212
</ul>

‎.overrides/translation-memory.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -214,7 +214,7 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
214214
es algo accesorio, un comentario, y type hint implica que el Validador hará comprobaciones
215215

216216
underscore
217-
guión bajo ``glossary.po``
217+
guión bajo ``glossary.po``
218218

219219
widget
220220
widget ``library/tkinter``

‎Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,8 @@ LANGUAGE := es
1616
VENV := $(shell realpath ./venv)
1717
PYTHON := $(shell which python3)
1818
CPYTHON_WORKDIR := cpython
19-
OUTPUT_DOCTREE := $(CPYTHON_WORKDIR)/Doc/_build/doctree
20-
OUTPUT_HTML := $(CPYTHON_WORKDIR)/Doc/_build/html
19+
OUTPUT_DOCTREE := $(CPYTHON_WORKDIR)/Doc/build/doctree
20+
OUTPUT_HTML := $(CPYTHON_WORKDIR)/Doc/build/html
2121
LOCALE_DIR := $(CPYTHON_WORKDIR)/locale
2222
TRANSIFEX_PROJECT := python-docs-es
2323
POSPELL_TMP_DIR := .pospell

‎README.rst

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,3 @@
1-
Spanish Translation of the Python Documentation
2-
===============================================
3-
41
.. image:: https://travis-ci.org/python/python-docs-es.svg?branch=3.8
52
:target: https://travis-ci.org/python/python-docs-es
63
:alt: Build Status
@@ -10,6 +7,19 @@ Spanish Translation of the Python Documentation
107
:alt: Documentation Status
118

129

10+
Traducción al Español de la Documentación de Python
11+
===================================================
12+
13+
¿Cómo contribuir?
14+
-----------------
15+
16+
Tenemos una guía que te ayudará a contribuir en: https://python-docs-es.readthedocs.io/page/CONTRIBUTING.html.
17+
Por favor, consulta para saber más detalles.
18+
19+
20+
Spanish Translation of the Python Documentation
21+
===============================================
22+
1323
How to Contribute
1424
-----------------
1525

‎TRANSLATORS

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ Omar Mendo (@beejeke)
4444
Darwing Medina Lacayo (@darwing1210)
4545
Claudia Millán Nebot (@clacri @cheshireminima)
4646
María José Molina Contreras (@mjmolina)
47+
Manuel Ramos (@manuelramos)
4748
Álvaro Mondéjar Rubio (@mondeja)
4849
Marco Moresi (@mrcmoresi)
4950
Federico Jurío (@FedericoJurio)
@@ -57,6 +58,7 @@ Santiago Piccinini (@spiccinini)
5758
Julián Pérez (@jcpmmx)
5859
Victoria Perez Mola (@victoriapm)
5960
Agustina Quiros (@qagustina)
61+
Juan Carlos Rojas Ortega (@juancacorps)
6062
Xavi Rambla Centellas (@xavirambla)
6163
Cristian Rengifo (@ingrengifo)
6264
Marco Richetta (@marcorichetta)
@@ -79,5 +81,12 @@ Naryie Vásquez Martínez (@narvmtz)
7981
María Andrea Vignau (@mavignau @marian-vignau)
8082
David Revillas (@r3v1)
8183
Xavi Rambla Centellas (@xavirambla)
84+
Elias Urios Alacreu (@Buzzeitor30)
8285
Santiago E Fraire Willemoes (@Woile)
86+
Alfonso Reyes (@mxarc)
8387
Gustavo Adolfo Huarcaya Delgado (@diavolo)
88+
Enrique Giménez (@fenriquegimenez)
89+
Rishabh Mishra (@rishabhmishra25)
90+
Carlos Martel Lamas (@Letram)
91+
Jonathan Aguilar (@drawsoek)
92+
David Lorenzo (@David-Lor)

‎about.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# This file is distributed under the same license as the Python package.
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
5-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
5+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
66
#
77
msgid ""
88
msgstr ""

‎bugs.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org /
55
# https://mail.python.org/mailman3/lists/docs-es.python.org/
6-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
6+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
77
# get the list of volunteers
88
#
99
msgid ""

‎c-api/abstract.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# This file is distributed under the same license as the Python package.
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
5-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
5+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
66
#
77
msgid ""
88
msgstr ""

‎c-api/allocation.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# This file is distributed under the same license as the Python package.
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
5-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
5+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
66
#
77
msgid ""
88
msgstr ""

‎c-api/apiabiversion.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# This file is distributed under the same license as the Python package.
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
5-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
5+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
66
#
77
msgid ""
88
msgstr ""

‎c-api/arg.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org /
55
# https://mail.python.org/mailman3/lists/docs-es.python.org/
6-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
6+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
77
# get the list of volunteers
88
#
99
msgid ""

‎c-api/bool.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# This file is distributed under the same license as the Python package.
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
5-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
5+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
66
#
77
msgid ""
88
msgstr ""

‎c-api/buffer.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org /
55
# https://mail.python.org/mailman3/lists/docs-es.python.org/
6-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
6+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
77
# get the list of volunteers
88
#
99
msgid ""

‎c-api/bytearray.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org /
55
# https://mail.python.org/mailman3/lists/docs-es.python.org/
6-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
6+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
77
# get the list of volunteers
88
#
99
msgid ""

‎c-api/bytes.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org /
55
# https://mail.python.org/mailman3/lists/docs-es.python.org/
6-
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
6+
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
77
# get the list of volunteers
88
#
99
msgid ""

0 commit comments

Comments
 (0)