Skip to content

Tutorial error revision #143

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
May 9, 2020
Merged

Tutorial error revision #143

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
fdc20c1
Completar nuevas entradas de la 3.8. Revisar el resto
hectorcanto May 8, 2020
4529bb5
Actualizar memoria, abrir seccion estilo
hectorcanto May 8, 2020
a2faa28
Arreglos errores y warnings
hectorcanto May 8, 2020
eca0029
Fix missing space
hectorcanto May 8, 2020
9d87b07
Corrección importante en frase. Cambios en uso de formas verbales.
hectorcanto May 8, 2020
fc1689b
Arreglar indentacion memoria, añadir ejemplo pasiva refleja
hectorcanto May 9, 2020
4b066f7
Merge branch '3.8' into tutorial_error_revision
hectorcanto May 9, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 45 additions & 1 deletion .overrides/translation-memory.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,21 @@ Si quieres ver cómo se ha utilizado un término anteriormente, puedes utilizar
├────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤


Términos y bigramas
===================

Éstos son las palabras que hemos coordinado hasta el momento:


awaitable
aguardable ``glossary``

built-in
built-in
incorporada ``glossary.po``

built-in exceptions
excepciones predefinidas ``tutorial/errors.po``

bytecodes
queda igual ``glossary.po``

Expand All @@ -49,6 +55,9 @@ Si quieres ver cómo se ha utilizado un término anteriormente, puedes utilizar
docstring
docstring. ``library/idle.po``

handler
gestor ``tutorial/errors.po``

handle exception
Gestionar excepción. ``tutorial/inputoutput.po``

Expand All @@ -69,3 +78,38 @@ Si quieres ver cómo se ha utilizado un término anteriormente, puedes utilizar

underscore
guión bajo ``glossary.po``


Reglas de estilo
================

Estas son las reglas de estilo que hemos convenido hasta el momento:

* En títulos [de sección] sólo se usará mayúscula en la primera palabra salvo nombre propios,
en contraste con el inglés, que lo hace en todas las palabras principales (conectores no).

Referencia: https://www.rae.es/dpd/may%C3%BAsculas 4.17

Ejemplo: ``tutorial/errors.po``
`en`: Predefined Clean-up Actions
`es`: Acciones de limpieza predefinidas

* Se priorizará la segunda persona del singular no formal (tu/vos) frente al formal (usted).
Sin embargo, allí donde sea posible, se usarán formas impersonales (con se), ya que son comunes a
todas las variantes del español.

Referencia: https://www.rae.es/dpd/se punto 2

Ejemplo: ``tutorial/errors.po``
`en`: Look at the following example, [...]
`es`: Véase el siguiente ejemplo, [...]

* En general se evitará la traducción literal de la voz pasiva del original en inglés y se usará
el impersonal (pasiva refleja) en la traducción al español.

Referencia: https://www.rae.es/dpd/se punto 2

Ejemplo: ``tutorial/errors.po``
`en`: [...] where the error was detected.
`es`: [...] donde se detectó el error.
Nota cf. "fue detectado"
74 changes: 47 additions & 27 deletions tutorial/errors.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,16 @@ msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-05-06 15:59+0200\n"
"PO-Revision-Date: 2020-05-04 21:28+0200\n"
"PO-Revision-Date: 2020-05-09 01:09+0200\n"
"Last-Translator: Héctor Canto <hectorcanto@gmail.com>\n"
"Language: es\n"
"Language-Team: python-doc-es\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.8.0\n"
"X-Generator: Poedit 2.0.6\n"

#: ../Doc/tutorial/errors.rst:5
msgid "Errors and Exceptions"
Expand Down Expand Up @@ -137,7 +138,7 @@ msgstr ""

#: ../Doc/tutorial/errors.rst:80
msgid "Handling Exceptions"
msgstr "Gestionando Excepciones"
msgstr "Gestionando excepciones"

#: ../Doc/tutorial/errors.rst:82
msgid ""
Expand All @@ -148,12 +149,12 @@ msgid ""
"generated interruption is signalled by raising the :exc:`KeyboardInterrupt` "
"exception. ::"
msgstr ""
"Es posible escribir programas que gestionen determinadas excepciones. Mirá "
"Es posible escribir programas que gestionen determinadas excepciones. Véase "
"el siguiente ejemplo, que le pide al usuario una entrada hasta que ingrese "
"un entero válido, pero permite al usuario interrumpir el programa (usando :"
"kbd:`Control-C` o lo que sea que el sistema operativo soporte); notá que una "
"interrupción generada por el usuario se señaliza generando la excepción :exc:"
"`KeyboardInterrupt`. ::"
"kbd:`Control-C` o lo que soporte el sistema operativo); nótese que una "
"interrupción generada por el usuario es señalizada generando la excepción :"
"exc:`KeyboardInterrupt`. ::"

#: ../Doc/tutorial/errors.rst:96
msgid "The :keyword:`try` statement works as follows."
Expand Down Expand Up @@ -184,7 +185,7 @@ msgid ""
msgstr ""
"Si ocurre una excepción durante la ejecución de la cláusula *try* el resto "
"de la cláusula se omite. Entonces, si el tipo de excepción coincide con la "
"excepción indicada después de la :keyword:`except`, la cláusula `except` se "
"excepción indicada después de la :keyword:`except`, la cláusula *except* se "
"ejecuta, y la ejecución continua después de la :keyword:`try`."

#: ../Doc/tutorial/errors.rst:109
Expand All @@ -197,7 +198,7 @@ msgstr ""
"Si ocurre una excepción que no coincide con la indicada en la cláusula "
"*except* se pasa a los :keyword:`try` más externos; si no se encuentra un "
"gestor, se genera una *unhandled exception* (excepción no gestionada) y la "
"ejecución se interrumpen con un mensaje como el que se muestra arriba."
"ejecución se interrumpe con un mensaje como el que se muestra arriba."

# en desacuerdo con manejadores, serían, por ejemplo gestores. en mi opinión
# se debería discutir y acordar.
Expand All @@ -223,8 +224,8 @@ msgid ""
"class). For example, the following code will print B, C, D in that order::"
msgstr ""
"Una clase en una cláusula :keyword:`except` es compatible con una excepción "
"si la misma está en la misma clase o una clase base de la misma (pero no de "
"la otra manera --- una clausula *except* listando una clase derivada no es "
"si es de la misma clase o de una clase derivada de la misma (pero no de la "
"otra manera --- una cláusula *except* listando una clase derivada no es "
"compatible con una clase base). Por ejemplo, el siguiente código imprimirá "
"B, C y D, en ese orden::"

Expand All @@ -246,10 +247,10 @@ msgid ""
"exception as well)::"
msgstr ""
"El último *except* puede omitir el nombre de la excepción capturada y servir "
"como comodín. Usá esto con extremo cuidado, ya que de esta manera es fácil "
"ocultar un error real de programación. También puede usarse para mostrar un "
"mensaje de error y luego re-generar la excepción (permitiéndole al que "
"llama, gestionar también la excepción)::"
"como comodín. Se debe usar esta posibilidad con extremo cuidado, ya que de "
"esta manera es fácil ocultar un error real de programación. También puede "
"usarse para mostrar un mensaje de error y luego re-generar la excepción "
"(permitiéndole al que llama, gestionar también la excepción)::"

#: ../Doc/tutorial/errors.rst:169
msgid ""
Expand Down Expand Up @@ -294,10 +295,10 @@ msgid ""
"reference ``.args``. One may also instantiate an exception first before "
"raising it and add any attributes to it as desired. ::"
msgstr ""
"El *except* puede especificar una variable luego del nombre de excepción. "
"La variable se vincula a una instancia de excepción con los argumentos "
"almacenados en ``instance.args``. Por conveniencia, la instancia de "
"excepción define :meth:`__str__` para que se pueda mostrar los argumentos "
"La cláusula *except* puede especificar una variable después del nombre de "
"excepción. La variable se vincula a una instancia de la excepción con los "
"argumentos almacenados en ``instance.args``. Por conveniencia, la instancia "
"de excepción define :meth:`__str__` para que se pueda mostrar los argumentos "
"directamente, sin necesidad de hacer referencia a ``.args``. También se "
"puede instanciar la excepción primero, antes de generarla, y agregarle los "
"atributos que se desee::"
Expand All @@ -317,14 +318,14 @@ msgid ""
"the try clause, but also if they occur inside functions that are called "
"(even indirectly) in the try clause. For example::"
msgstr ""
"Los gestores de excepciones no gestionan solamente las excepciones que "
"Los gestores de excepciones no se encargan solamente de las excepciones que "
"ocurren en el *bloque try*, también gestionan las excepciones que ocurren "
"dentro de las funciones que se llaman (inclusive indirectamente) dentro del "
"*bloque try*. Por ejemplo::"

#: ../Doc/tutorial/errors.rst:237
msgid "Raising Exceptions"
msgstr "Levantando excepciones"
msgstr "Lanzando excepciones"

#: ../Doc/tutorial/errors.rst:239
msgid ""
Expand Down Expand Up @@ -354,9 +355,9 @@ msgid ""
"handle it, a simpler form of the :keyword:`raise` statement allows you to re-"
"raise the exception::"
msgstr ""
"Si necesitás determinar si una excepción fue lanzada pero no querés "
"gestionarla, una versión simplificada de la instrucción :keyword:`raise` te "
"permite relanzarla::"
"Si es necesario determinar si una excepción fue lanzada pero sin intención "
"de gestionarla, una versión simplificada de la instrucción :keyword:`raise` "
"te permite relanzarla::"

#: ../Doc/tutorial/errors.rst:273
msgid "User-defined Exceptions"
Expand Down Expand Up @@ -412,7 +413,7 @@ msgstr ""

#: ../Doc/tutorial/errors.rst:328
msgid "Defining Clean-up Actions"
msgstr "Definiendo Acciones de Limpieza"
msgstr "Definiendo acciones de limpieza"

#: ../Doc/tutorial/errors.rst:330
msgid ""
Expand All @@ -432,6 +433,11 @@ msgid ""
"statement produces an exception. The following points discuss more complex "
"cases when an exception occurs:"
msgstr ""
"Si una cláusula :keyword:`finally` está presente, el bloque :keyword:`!"
"finally` se ejecutará al final antes de que todo el bloque :keyword:`try` se "
"complete. La cláusula :keyword:`!finally` se ejecuta independientemente de "
"que la cláusula :keyword:`!try` produzca o no una excepción. Los siguientes "
"puntos explican casos más complejos en los que se produce una excepción:"

#: ../Doc/tutorial/errors.rst:350
msgid ""
Expand All @@ -440,13 +446,21 @@ msgid ""
"not handled by an :keyword:`!except` clause, the exception is re-raised "
"after the :keyword:`!finally` clause has been executed."
msgstr ""
"Si ocurre una excepción durante la ejecución de la cláusula :keyword:`!try`, "
"la excepción podría ser gestionada por una cláusula :keyword:`except`. Si la "
"excepción no es gestionada por una cláusula :keyword:`!except`, la excepción "
"es relanzada después de que se ejecute el bloque de la cláusula :keyword:`!"
"finally`."

#: ../Doc/tutorial/errors.rst:356
msgid ""
"An exception could occur during execution of an :keyword:`!except` or :"
"keyword:`!else` clause. Again, the exception is re-raised after the :keyword:"
"`!finally` clause has been executed."
msgstr ""
"Podría aparecer una excepción durante la ejecución de una cláusula :keyword:"
"`!except` o :keyword:`!else`. De nuevo, la excepción será relanzada después "
"de que el bloque de la cláusula :keyword:`!finally` se ejecute."

#: ../Doc/tutorial/errors.rst:360
msgid ""
Expand All @@ -455,6 +469,9 @@ msgid ""
"will execute just prior to the :keyword:`!break`, :keyword:`!continue` or :"
"keyword:`!return` statement's execution."
msgstr ""
"Si el bloque :keyword:`!try` llega a una sentencia :keyword:`break`, :"
"keyword:`continue` o :keyword:`return`, la cláusula :keyword:`!finally` se "
"ejecutará justo antes de la ejecución de dicha sentencia."

#: ../Doc/tutorial/errors.rst:366
msgid ""
Expand All @@ -463,14 +480,17 @@ msgid ""
"keyword:`!return` statement, not the value from the :keyword:`!try` "
"clause's :keyword:`!return` statement."
msgstr ""
"Si una cláusula :keyword:`!finally` incluye una sentencia :keyword:`!"
"return`, el valor retornado será el de la cláusula :keyword:`!finally`, no "
"la del de la sentencia :keyword:`!return` de la cláusula :keyword:`!try`."

#: ../Doc/tutorial/errors.rst:372
msgid "For example::"
msgstr ""
msgstr "Por ejemplo::"

#: ../Doc/tutorial/errors.rst:383
msgid "A more complicated example::"
msgstr ""
msgstr "Un ejemplo más complicado::"

#: ../Doc/tutorial/errors.rst:408
msgid ""
Expand Down