Skip to content

Commit 3bbed72

Browse files
committed
Merge branch 'traduccion-codeop' of https://github.com/paaaron/python-docs-es into traduccion-codeop
2 parents 037a51a + 30159ee commit 3bbed72

File tree

121 files changed

+5099
-2406
lines changed

Some content is hidden

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

121 files changed

+5099
-2406
lines changed

.overrides/CONTRIBUTING.rst

+4-2
Original file line numberDiff line numberDiff line change
@@ -57,14 +57,16 @@ Antes de comenzar
5757

5858
Al tener instalado los requerimientos, podrás utilizas las herramientas
5959
``powrap`` y ``pospell`` para poder verificar tus archivos traducidos,
60-
y también contruir la documentación localmente.
60+
y también construir la documentación localmente.
6161

6262
¡Comienza a traducir!
6363
---------------------
6464

6565
#. Selecciona un :ref:`archivo para traducir <que-archivo-traducir>`.
6666

67-
#. Verifica que estás en la rama principal del repositorio, **3.8**::
67+
#. Verifica que estás en la rama principal del repositorio, **3.8** (esto es muy
68+
importante para evitar crear una nueva rama a partir de una traducción
69+
anterior)::
6870

6971
git checkout 3.8
7072

.overrides/faq.rst

+32-6
Original file line numberDiff line numberDiff line change
@@ -193,12 +193,12 @@ Y luego accediendo a http://localhost:8000/
193193
.. _mantener-actualizada:
194194

195195
¿Cómo actualizar mi copia local del repositorio?
196-
---------------------------------------------------------
196+
------------------------------------------------
197197

198-
Es recomendable mantener actualizada nuestra copia local para evitar
199-
posibles conflictos entre los archivos que trabajamos y la última versión disponible
200-
en el repositorio remoto.
201-
Primero, necesitamos bajar los cambios de *upstream* (es el nombre que asignamos al
198+
Es recomendable mantener actualizada nuestra copia local para evitar
199+
posibles conflictos entre los archivos que trabajamos y la última versión disponible
200+
en el repositorio remoto.
201+
Primero, necesitamos bajar los cambios de *upstream* (es el nombre que asignamos al
202202
repositorio principal de la traducción). Se hace de la siguiente manera::
203203

204204
git fetch upstream
@@ -207,11 +207,37 @@ Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::
207207

208208
git checkout 3.8
209209
git merge upstream/3.8
210-
git push origin 3.8
210+
git push origin 3.8
211211

212212
¡Eso es todo!
213213

214214

215+
¿Son importantes los dobles espacios en el original?
216+
----------------------------------------------------
217+
218+
No.
219+
220+
En realidad, no tienen ningún efecto. Sphinx se da cuenta automáticamente de esto y simplemente
221+
deja un solo espacio en la versión final. Así que, no te preocupes si ves dos espacios juntos.
222+
223+
Si estás interesada en saber más sobré "¿Por qué se usan dobles espacios?" puedes leer este artículo:
224+
`How Many Spaces Should Be After a Period? <https://www.instructionalsolutions.com/blog/one-space-vs-two-after-period>`_
225+
226+
227+
¿Puedo agregar "estilo de código" a los nombres de las funciones/métodos/clases/etc?
228+
------------------------------------------------------------------------------------
229+
230+
No.
231+
232+
Si aparece el nombre de una función (por ejemplo, "IncrementalParser") en el original y no tiene ningún estilo asociado
233+
(no está en cursiva, ni en negrita ni en estilo de código), aunque sientas la tentación de ponerla como
234+
``IncrementalParser``, no debes hacerlo.
235+
236+
En principio, no debemos cambiar el formato de estas palabras. Si está con asteriscos, lo dejamos con asteriscos.
237+
Si está con backticks, lo dejamos con los backticks, etc. Si realmente crees que es un error y debería
238+
estar con un formato distinto, debes reportarlo en el repositorio de CPython.
239+
240+
215241
¿Tienen una lista de correo?
216242
----------------------------
217243

TRANSLATORS

+12-1
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ Carlos Joel Delgado Pizarro (@c0x6a)
2222
Sergio Delgado Quintero (@sdelquin)
2323
Nicolás Demarchi (@gilgamezh)
2424
Ignacio Dopazo (@ignaciodopazo)
25+
Natalia Elvira Astoreca (@nea23)
2526
Nahuel Espinosa (@nahueespinosa)
2627
Xavi Francisco (@srxavi)
2728
Santiago E Fraire Willemoes (@Woile)
@@ -31,6 +32,9 @@ José Miguel Hernández Cabrera (@miguelheca)
3132
Sergio Infante (@neosergio)
3233
Martín Gaitán (@mgaitan)
3334
Manuel Kaufmann (@humitos)
35+
Julieta Kogan Moyano (@JuliKM3)
36+
Sergio Infante (@neosergio)
37+
Luis Llave (@llaveluis)
3438
Angelica Landazabal (@ALandazabal)
3539
Pablo Lobariñas (@Qkolnek)
3640
Alvar Maciel (@alvarmaciel @amaciel)
@@ -95,5 +99,12 @@ Yennifer Paola Herrera Ariza (@Yenniferh)
9599
Willian Garcia (@wgarcia1309)
96100
Ana Medina Bernal (@ana-med)
97101
Juan Biondi (@yeyeto2788)
102+
Hugo Valencia Vargas(@psicobloc)
98103
Iracema Cabllero (@iracaballero)
99-
Pedro Aaron (@paaaron)
104+
Pedro Aaron (@paaaron)
105+
Andreu Vallbona Plazas (@avallbona)
106+
Javier Artiga Garijo (@jartigag)
107+
Ayose Figuera (@ayosefiguera)
108+
Alvaro Cárdenas (@alvaruz)
109+
Daniel Vera Nieto (@dveni)
110+
Andros Fenollosa Hurtado (@tanrax)

c-api/codec.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ msgstr ""
171171
"problemática de caracteres o bytes y su desplazamiento en la cadena original "
172172
"(consulte :ref:`unicodeexceptions` para funciones para extraer esta "
173173
"información). La devolución de llamada debe generar la excepción dada o "
174-
"devolver una tupla de dos elementos que contiene el reemplazo de la "
174+
"retornar una tupla de dos elementos que contiene el reemplazo de la "
175175
"secuencia problemática, y un número entero que proporciona el desplazamiento "
176176
"en la cadena original en la que se debe reanudar la codificación / "
177177
"decodificación."

c-api/contextvars.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -226,5 +226,5 @@ msgid ""
226226
"returns ``0`` on success and ``-1`` on error."
227227
msgstr ""
228228
"Restablece el estado de la variable de contexto *var* a la que estaba antes :"
229-
"c:func:`PyContextVar_Set` que devolvió el *token* fue llamado. Esta función "
229+
"c:func:`PyContextVar_Set` que retornó el *token* fue llamado. Esta función "
230230
"retorna ``0`` en caso de éxito y ``-1`` en caso de error."

c-api/gcsupport.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,7 @@ msgstr ""
230230
"*self*, siendo los parámetros a *visit* el objeto contenido y el valor *arg* "
231231
"pasado al controlador. La función *visit* no debe llamarse con un argumento "
232232
"de objeto ``NULL``. Si *visit* retorna un valor distinto de cero, ese valor "
233-
"debe devolverse inmediatamente."
233+
"debe retornarse inmediatamente."
234234

235235
#: ../Doc/c-api/gcsupport.rst:117
236236
msgid ""

c-api/init.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -1468,7 +1468,7 @@ msgid ""
14681468
"acquired it."
14691469
msgstr ""
14701470
"Libere el bloqueo global del intérprete (si se ha creado) y restablezca el "
1471-
"estado del hilo a ``NULL``, devolviendo el estado del hilo anterior (que no "
1471+
"estado del hilo a ``NULL``, retornando el estado del hilo anterior (que no "
14721472
"es ``NULL``). Si se ha creado el bloqueo, el hilo actual debe haberlo "
14731473
"adquirido."
14741474

c-api/intro.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -857,7 +857,7 @@ msgstr ""
857857
"Como principio general, una función que llama a otra función para realizar "
858858
"alguna tarea debe verificar si la función llamada generó una excepción y, de "
859859
"ser así, pasar el estado de excepción a quien la llama (*caller*). Debe "
860-
"descartar cualquier referencia de objeto que posea y devolver un indicador "
860+
"descartar cualquier referencia de objeto que posea y retornar un indicador "
861861
"de error, pero *no* debe establecer otra excepción --- que sobrescribirá la "
862862
"excepción que se acaba de generar y perderá información importante sobre la "
863863
"causa exacta del error."

c-api/mapping.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ msgstr ""
138138
#: ../Doc/c-api/mapping.rst:84 ../Doc/c-api/mapping.rst:93
139139
#: ../Doc/c-api/mapping.rst:102
140140
msgid "Previously, the function returned a list or a tuple."
141-
msgstr "Anteriormente, la función devolvía una lista o una tupla."
141+
msgstr "Anteriormente, la función retornaba una lista o una tupla."
142142

143143
#: ../Doc/c-api/mapping.rst:90
144144
msgid ""

c-api/structures.po

+1-1
Original file line numberDiff line numberDiff line change
@@ -761,7 +761,7 @@ msgid ""
761761
"It should return a new reference on success or ``NULL`` with a set exception "
762762
"on failure."
763763
msgstr ""
764-
"Debe devolver una nueva referencia en caso de éxito o ``NULL`` con una "
764+
"Debe retornar una nueva referencia en caso de éxito o ``NULL`` con una "
765765
"excepción establecida en caso de error."
766766

767767
#: ../Doc/c-api/structures.rst:370

c-api/typeobj.po

+10-10
Original file line numberDiff line numberDiff line change
@@ -1905,7 +1905,7 @@ msgid ""
19051905
msgstr ""
19061906
"El valor ``-1`` no debe retornarse como un valor de retorno normal; Cuando "
19071907
"se produce un error durante el cálculo del valor *hash*, la función debe "
1908-
"establecer una excepción y devolver ``-1``."
1908+
"establecer una excepción y retornar ``-1``."
19091909

19101910
#: ../Doc/c-api/typeobj.rst:878
19111911
msgid ""
@@ -1990,7 +1990,7 @@ msgid ""
19901990
"representation that will be used, among other things, by the :func:`print` "
19911991
"function."
19921992
msgstr ""
1993-
"La función debe devolver una cadena de caracteres o un objeto Unicode. Debe "
1993+
"La función debe retornar una cadena de caracteres o un objeto Unicode. Debe "
19941994
"ser una representación de cadena \"amigable\" del objeto, ya que esta es la "
19951995
"representación que será utilizada, entre otras cosas, por la función :func:"
19961996
"`print`."
@@ -2852,9 +2852,9 @@ msgid ""
28522852
"it must return ``NULL`` too. Its presence signals that the instances of "
28532853
"this type are iterators."
28542854
msgstr ""
2855-
"Cuando el iterador está agotado, debe devolver ``NULL``; a la excepción :exc:"
2855+
"Cuando el iterador está agotado, debe retornar ``NULL``; a la excepción :exc:"
28562856
"`StopIteration` puede o no establecerse. Cuando se produce otro error, "
2857-
"también debe devolver ``NULL``. Su presencia indica que las instancias de "
2857+
"también debe retornar ``NULL``. Su presencia indica que las instancias de "
28582858
"este tipo son iteradores."
28592859

28602860
#: ../Doc/c-api/typeobj.rst:1456
@@ -2864,7 +2864,7 @@ msgid ""
28642864
"a new iterator instance)."
28652865
msgstr ""
28662866
"Los tipos de iterador también deberían definir la función :c:member:"
2867-
"`~PyTypeObject.tp_iter`, y esa función debería devolver la instancia de "
2867+
"`~PyTypeObject.tp_iter`, y esa función debería retornar la instancia de "
28682868
"iterador en sí (no una nueva instancia de iterador)."
28692869

28702870
#: ../Doc/c-api/typeobj.rst:1460
@@ -3409,7 +3409,7 @@ msgstr ""
34093409
"const:`Py_TPFLAGS_HAVE_GC`. Pero algunos tipos tienen una mezcla de "
34103410
"instancias asignadas estáticamente y dinámicamente, y las instancias "
34113411
"asignadas estáticamente no son coleccionables. Tales tipos deberían definir "
3412-
"esta función; debería devolver ``1`` para una instancia coleccionable y "
3412+
"esta función; debería retornar ``1`` para una instancia coleccionable y "
34133413
"``0`` para una instancia no coleccionable. La firma es::"
34143414

34153415
#: ../Doc/c-api/typeobj.rst:1793
@@ -3707,7 +3707,7 @@ msgstr ""
37073707
"operandos e implementar las conversiones necesarias (al menos uno de los "
37083708
"operandos es una instancia del tipo definido). Si la operación no está "
37093709
"definida para los operandos dados, las funciones binarias y ternarias deben "
3710-
"retornar ``Py_NotImplemented``, si se produce otro error, deben devolver "
3710+
"retornar ``Py_NotImplemented``, si se produce otro error, deben retornar "
37113711
"``NULL`` y establecer una excepción."
37123712

37133713
#: ../Doc/c-api/typeobj.rst:2054
@@ -3875,7 +3875,7 @@ msgid ""
38753875
"c:member:`~PyNumberMethods.nb_inplace_add` slot."
38763876
msgstr ""
38773877
"Esta función es utilizada por :c:func:`PySequence_InPlaceConcat` y tiene la "
3878-
"misma firma. Debería modificar su primer operando y devolverlo. Este espacio "
3878+
"misma firma. Debería modificar su primer operando y retornarlo. Este espacio "
38793879
"puede dejarse en ``NULL``, en este caso :c:func:`!PySequence_InPlaceConcat` "
38803880
"volverá a :c:func:`PySequence_Concat`. También es utilizado por la "
38813881
"asignación aumentada ``+=``, después de intentar la suma numérica en el "
@@ -3891,7 +3891,7 @@ msgid ""
38913891
"via the :c:member:`~PyNumberMethods.nb_inplace_multiply` slot."
38923892
msgstr ""
38933893
"Esta función es utilizada por :c:func:`PySequence_InPlaceRepeat` y tiene la "
3894-
"misma firma. Debería modificar su primer operando y devolverlo. Este espacio "
3894+
"misma firma. Debería modificar su primer operando y retornarlo. Este espacio "
38953895
"puede dejarse en ``NULL``, en este caso :c:func:`!PySequence_InPlaceRepeat` "
38963896
"volverá a :c:func:`PySequence_Repeat`. También es utilizado por la "
38973897
"asignación aumentada ``*=``, después de intentar la multiplicación numérica "
@@ -4142,7 +4142,7 @@ msgid ""
41424142
"member:`~PyTypeObject.tp_basicsize`."
41434143
msgstr ""
41444144
"El propósito de esta función es separar la asignación de memoria de la "
4145-
"inicialización de memoria. Debería devolver un puntero a un bloque de "
4145+
"inicialización de memoria. Debería retornar un puntero a un bloque de "
41464146
"memoria de longitud adecuada para la instancia, adecuadamente alineado e "
41474147
"inicializado a ceros, pero con :attr:`ob_refcnt` establecido en ``1`` y :"
41484148
"attr:`ob_type` establecido en argumento de tipo. Si el tipo :c:member:"

0 commit comments

Comments
 (0)