Skip to content

Commit db2b755

Browse files
cmaureircmaureir
committed
Merge branch '3.8' into pr-705
2 parents 58830ce + 53a410c commit db2b755

Some content is hidden

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

43 files changed

+3568
-1071
lines changed

‎.overrides/CONTRIBUTING.rst

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ A tener en cuenta
142142

143143
* Colaborar **haciendo revisiones** también es muy muy importante, así que si
144144
tienes un rato libre puedes comenzar por mirar los PRs pendientes de revisar.
145-
(mira la `Guía del revisor`_)
145+
(mira la :doc:`Guía del revisor <reviewers-guide>`)
146146

147147
* La documentación es ENORME, cualquier traba que encuentres siempre puedes
148148
marcar el texto como **"fuzzy"** o para revisar en el futuro.
@@ -159,8 +159,8 @@ A tener en cuenta
159159
ejemplo un artículo a Wikipedia). En caso de que no haya una traducción del
160160
artículo en Wikipedia deja el título sin traducir.
161161

162-
* Tenemos una `Memoria de Traducción`_, que usamos para tener consistencia con
163-
algunos términos.
162+
* Tenemos una :doc:`Memoria de Traducción <translation-memory>`, que usamos para tener
163+
consistencia con algunos términos.
164164

165165
* Si tienes una **duda sobre una palabra o término**, escríbelo como mejor suene
166166
para vos y marca ese párrafo como "Need work" / "Necesita trabajo" en
@@ -210,10 +210,6 @@ Tendrás que navegar hasta el archivo que hayas cambiado para ver cómo se visua
210210
.. _poedit: https://poedit.net/
211211

212212
.. _nuestro canal de Telegram: https://t.me/python_docs_es
213-
.. _Memoria de traducción:
214-
https://python-docs-es.readthedocs.io/page/translation-memory.html
215-
.. _Guía del revisor:
216-
https://python-docs-es.readthedocs.io/page/reviewers-guide.html
217213
.. _la traducción al Portugués: https://docs.python.org/pt-br/3/
218214
.. _lista de issues en GitHub:
219215
https://github.com/python/python-docs-es/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+no%3Aassignee+translate

‎.overrides/pospell_fallo_spelling.png

35.5 KB
Loading

‎.overrides/pospell_warning_and_english_words.png

133 KB
Loading

‎.overrides/powrap_fail.png

32.9 KB
Loading

‎.overrides/reviewers-guide.rst

Lines changed: 38 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,13 @@
33
================================
44
Guía para revisar una traducción
55
================================
6+
7+
Antes que nada, queremos compartir contigo `unos videos`_ que uno de nuestros colaboradores ha preparado donde se explica el resumen del proceso a través de un ejemplo.
8+
9+
Asimismo, si nunca has hecho una revisión pero ya has colaborado con el proyecto, te recomendamos que pruebes esta otra manera de colaborar, ya que permite ponerse en el lugar de otra persona, y muchas veces ayuda a mejorar las traducciones propias.
10+
11+
.. _`unos videos`: https://www.youtube.com/watch?v=uIaQMTuwtoU&list=PLma583Z70SlztPF8SitlWJZx3SW1aAePk&index=3&t=7s&ab_channel=Cristi%C3%A1nMaureira-Fredes
12+
613
El costado humano
714
=================
815
Teniendo en cuenta que todes somos voluntaries en este proyecto, es importante que la forma de comunicarnos sea clara, concisa y amable. Como revisor/a, ayudarás a voluntaries de diferentes culturas y lugares del mundo para que su traducción sea lo más acertada posible y podamos acercar Python a las comunidades de habla hispana. Recuerda que del otro lado de un PR hay una persona que ha dedicado tiempo y esfuerzo; es por eso es la forma en que le des una devolución sobre su trabajo influirá en su actitud hacia el proyecto…¡y en sus ganas de seguir participando de nuestra comunidad!
@@ -32,8 +39,34 @@ El costado técnico
3239
==================
3340
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.
3441

35-
Cuatro razones por las que puede fallar el *build* de Travis:
36-
* `powrap` falla
37-
* `pospell` falla
38-
* Dict está duplicado
39-
* Sphinx falla
42+
Tres razones por las que puede fallar el *build* de Travis:
43+
44+
``powrap`` falla
45+
---------------------
46+
47+
.. image:: powrap_fail.png
48+
49+
Para facilitar la comparación de ficheros se emplea este programa que va a hacer que todas las líneas tengan el mismo tamaño. Solucionar este problema en nuestra traducción es muy sencillo, solo hay que instalar la herramienta powrap en nuestro entorno y ejecutar el comando ``powrap nuestro_fichero.po``
50+
51+
52+
``pospell`` falla
53+
---------------------
54+
55+
Los fallos en pospell pueden ser variados y según con que nos encontremos tenemos que actuar de una manera u otra. En principio es un chequeo de ortografía contra un diccionario de español, por lo que nos va a fallar tanto si usamos palabras en otro idioma, como si usamos palabras en español mal escritas como si usamos palabras que simplemente no están en el diccionario. Por ejemplo:
56+
57+
.. image:: pospell_fallo_spelling.png
58+
59+
En este primer caso simplemente hay un error en la ortografía por lo que solucionarlo en nuestra traducción será lo únicoque tengamos que hacer.
60+
61+
.. image:: pospell_warning_and_english_words.png
62+
63+
En este segundo, en cambio, vemos un par de cosas más interesantes. En primer lugar, tenemos un warning de rst, donde nos da un error porque unas comillas no han sido reconocidas como final de una palabra. Si te fijas en el texto esto ocurre donde están los paréntesis pegados a la expresión entre comillas dobles SNDCTL_DSP_SYNC. Añadir un espacio allí solucionará nuestro problema. Por otro lado, nos lanza una serie de palabras que han fallado en pospell, pero como vemos, son o bien términos técnicos, o nombres en inglés (en este caso posiblemente parte de un nombre propio) y una palabra que está correctamente escrita en español pero es un poco técnica. Por tanto, en este caso no queremos cambiarlas en nuestra traducción, sino que queremos que sean una excepción en el chequeo de pospell. Para ello, lo que debemos hacer es o bien crear o bien incluir (si ya está creado) en un diccionario llamado como nuestro fichero y que se emplace en la carpeta dictionaries las palabras que deben ser una excepción. Por ejemplo, los diccionarios para el fichero clinic o argparse los encontramos dentro de ./dictionaries como howto_clinic.txt y library_argparse.txt. Cuando se haga el build se tendrán en cuenta estas excepciones y no tendremos ese error de pospell.
64+
65+
Sphinx falla:
66+
---------------------
67+
68+
Durante la renderización de la documentación hay toda una serie de referencias cruzadas, que deben permanecer igual en español que en inglés. Un fallo habitual es el siguiente:
69+
70+
.. image:: sphinx_warnings_example_inconsistent_terms.png
71+
72+
Indica que alguna de las referencias falta en la traducción. Lo más probable es que al traducir se haya cambiado algo de la sintaxis particular como las comillas, y por eso no esté siendo reconocida.

‎.overrides/sphinx_warnings_example_inconsistent_terms.png

64.8 KB
Loading

‎.overrides/translation-memory.rst

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -36,34 +36,34 @@ Fuentes recomendadas
3636
====================
3737

3838
:Diccionario Panhispánico de dudas:
39-
39+
4040
https://www.rae.es/dpd/
4141

4242
Obra orientada a resolver dudas en diferentes áreas de la lengua española: ortografía, sintaxis,
4343
gramática ...
4444

4545
:Wordreference:
46-
46+
4747
https://www.wordreference.com/
4848

4949
Diccionario y traductor multilingue
5050

5151
:Linguee.es:
52-
52+
5353
https://www.linguee.es/
54-
54+
5555
Diccionario y traductor multilíngue con millones de traducciones indexadas. De los creadores
5656
de DeepL
5757

5858
:Fundéu BBVA - Fundación para el español urgente:
59-
59+
6060
https://www.fundeu.es/
6161

6262
Fundación dedicada a la resolución de dudas. Creada originalmente por la agencia estatal
6363
española de noticias EFE, a partir de su departamento y libro de estilo.
6464

6565
:IATE - European Union terminology:
66-
66+
6767
https://iate.europa.eu/home
6868

6969
Base de datos de las traducciones oficiales de la Unión Europea. Permite búsqueda por término
@@ -79,7 +79,7 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
7979

8080
auditing event
8181
evento de auditoría ``library/tempfile`` and many others
82-
82+
8383
awaitable
8484
aguardable ``glossary``
8585

@@ -91,7 +91,7 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
9191

9292
built-in exceptions
9393
excepciones predefinidas ``tutorial/errors.po``
94-
94+
9595
bytecodes
9696
queda igual ``glossary.po``
9797

@@ -101,9 +101,12 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
101101
Nota: en ocasiones es mejora mantener callable, especialmente cuando se refiere directamente
102102
a la anotación de typing Callable
103103

104+
checksum
105+
suma de comprobación ``howto/clinic.po``
106+
104107
code object
105108
objeto código ``c-api``, ``library/functions.po``
106-
109+
107110
context manager
108111
gestor de contexto
109112

@@ -118,7 +121,7 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
118121

119122
keyword argument
120123
argumento por palabra clave / argumento de palabra clave
121-
124+
122125
handler
123126
gestor ``tutorial/errors.po``
124127

@@ -152,7 +155,7 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
152155

153156
named tuple.
154157
tupla nombrada ``glossary.po``
155-
158+
156159
overload, overloading
157160
sobrecargar, sobrecarga
158161

@@ -164,9 +167,9 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
164167

165168
pythonic
166169
*pythónico*
167-
170+
168171
idiomático
169-
172+
170173
Estes dos términos son próximos en el contexto que se usan, utilizar complementariamente
171174
según el contexto. Referencia: https://docs.python-guide.org/writing/style/
172175

@@ -175,7 +178,7 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
175178

176179
release
177180
version ``HOWTO``
178-
181+
179182
return / returns
180183
retorna / retornar ``library/sqlite3.po``
181184

‎TRANSLATORS

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,7 @@ José Miguel Hernández Cabrera (@miguelheca)
3131
Sergio Infante (@neosergio)
3232
Martín Gaitán (@mgaitan)
3333
Manuel Kaufmann (@humitos)
34-
Sergio Infante (@neosergio)
35-
Luis Llave (@llaveluis)
34+
Angelica Landazabal (@ALandazabal)
3635
Pablo Lobariñas (@Qkolnek)
3736
Alvar Maciel (@alvarmaciel @amaciel)
3837
Briceida Mariscal (@BriceidaMars)
@@ -65,6 +64,7 @@ Adolfo Hristo David Roque Gámez (@hristoroque)
6564
Luis Llave (@llaveluis)
6665
Marcos Sánchez Provencio (@rapto)
6766
Francisco Jesús Sevilla García (@fjsevilla-dev)
67+
Bruno Geninatti (@bgeninatti)
6868
María Camila Guerrero Giraldo (@macaguegi)
6969
José Miguel Hernández Cabrera (@miguelheca)
7070
Carlos Bernad (@carlos-bernad)
@@ -90,3 +90,8 @@ Rishabh Mishra (@rishabhmishra25)
9090
Carlos Martel Lamas (@Letram)
9191
Jonathan Aguilar (@drawsoek)
9292
David Lorenzo (@David-Lor)
93+
Antonio González Fernández (@iam-agf)
94+
Yennifer Paola Herrera Ariza (@Yenniferh)
95+
Willian Garcia (@wgarcia1309)
96+
Ana Medina Bernal (@ana-med)
97+
Juan Biondi (@yeyeto2788)

‎dictionaries/library_asyncio_eventloop.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
loop
2+
renderizar
3+
monotónicos
4+
monotónico
5+
Futures
6+
reordenamientos
7+
monitorear

‎dictionaries/library_binhex.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
binhex

‎dictionaries/library_curses.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Cian
2+
editable
3+
Desinicializa
4+
redibujado

‎dictionaries/library_netrc.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
netrc
2+
ftp
3+
home
4+
hosts

‎dictionaries/library_othergui.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
kits
2+
GUI

‎dictionaries/library_platform.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
libc
2+
patchlevel
3+
uname
4+
reordenación

‎dictionaries/library_plistlib.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
plist
2+
plists
3+
Autodetecta
4+
Expat

‎dictionaries/library_sunau.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Sun

‎dictionaries/library_tarfile.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
lzma
2+
TarFile
3+
TarInfo
4+
Output
5+
GiB
6+
bsdtar
7+
libarchive

‎dictionaries/library_token.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
tokenizados

‎dictionaries/using_unix.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Debian
2+
OpenSuse
3+
Fedora
4+
Slackware
5+
OpenSolaris

‎distutils/packageindex.po

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,33 +6,40 @@
66
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
77
# get the list of volunteers
88
#
9-
#, fuzzy
109
msgid ""
1110
msgstr ""
1211
"Project-Id-Version: Python 3.8\n"
1312
"Report-Msgid-Bugs-To: \n"
1413
"POT-Creation-Date: 2020-05-05 12:54+0200\n"
15-
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
16-
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14+
"PO-Revision-Date: 2020-10-04 15:28-0500\n"
1715
"Language-Team: python-doc-es\n"
1816
"MIME-Version: 1.0\n"
19-
"Content-Type: text/plain; charset=utf-8\n"
17+
"Content-Type: text/plain; charset=UTF-8\n"
2018
"Content-Transfer-Encoding: 8bit\n"
2119
"Generated-By: Babel 2.8.0\n"
20+
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
21+
"Last-Translator: \n"
22+
"Language: es\n"
23+
"X-Generator: Poedit 2.4.1\n"
2224

2325
#: ../Doc/distutils/packageindex.rst:7
2426
msgid "The Python Package Index (PyPI)"
25-
msgstr ""
27+
msgstr "El Indice de Paquetes de Python (PyPI)"
2628

2729
#: ../Doc/distutils/packageindex.rst:9
2830
msgid ""
2931
"The `Python Package Index (PyPI)`_ stores metadata describing distributions "
3032
"packaged with distutils and other publishing tools, as well the distribution "
3133
"archives themselves."
3234
msgstr ""
35+
"El `Python Package Index (PyPI)`_ almacena metadatos describiendo "
36+
"distribuciones empaquetadas con distutils y otras herramientas de "
37+
"publicación, así como los propios archivos de la distribución."
3338

3439
#: ../Doc/distutils/packageindex.rst:13
3540
msgid ""
3641
"References to up to date PyPI documentation can be found at :ref:`publishing-"
3742
"python-packages`."
3843
msgstr ""
44+
"Las referencias vigentes de la documentación de PyPI pueden ser consultadas "
45+
"en :ref:`publishing-python-packages`."

‎library/archiving.po

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
# Copyright (C) 2001-2020, Python Software Foundation
22
# This file is distributed under the same license as the Python package.
3-
# Maintained by the python-doc-es workteam.
3+
# Maintained by the python-doc-es workteam.
44
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
55
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
66
#
7-
#, fuzzy
87
msgid ""
98
msgstr ""
109
"Project-Id-Version: Python 3.8\n"
1110
"Report-Msgid-Bugs-To: \n"
1211
"POT-Creation-Date: 2019-05-06 11:59-0400\n"
13-
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
14-
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
12+
"PO-Revision-Date: 2020-10-05 12:34+0200\n"
1513
"Language-Team: python-doc-es\n"
1614
"MIME-Version: 1.0\n"
1715
"Content-Type: text/plain; charset=UTF-8\n"
1816
"Content-Transfer-Encoding: 8bit\n"
17+
"Last-Translator: \n"
18+
"X-Generator: Poedit 2.4.1\n"
1919

2020
#: ../Doc/library/archiving.rst:5
2121
msgid "Data Compression and Archiving"
22-
msgstr ""
22+
msgstr "Compresión de datos y archivado"
2323

2424
#: ../Doc/library/archiving.rst:7
2525
msgid ""
@@ -28,3 +28,7 @@ msgid ""
2828
"format archives. See also :ref:`archiving-operations` provided by the :mod:"
2929
"`shutil` module."
3030
msgstr ""
31+
"Los módulos descritos en este capítulo soportan compresión de datos con los "
32+
"algoritmos zlib, gzip, bzip2 e lzma, y la creación de archivos con formato "
33+
"ZIP y tar. Véase también :ref:`archiving-operations` provistos por el "
34+
"módulo :mod:`shutil`."

0 commit comments

Comments
 (0)