Skip to content

Commit ce90ec7

Browse files
gilgamezhgilgamezh
authored
Merge branch '3.8' into pathlib.po
2 parents da9e9c8 + d61dc6a commit ce90ec7

File tree

12 files changed

+1668
-368
lines changed

12 files changed

+1668
-368
lines changed

‎.overrides/CONTRIBUTING.rst

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Necesitamos *mucho* de tu ayuda para poder seguir adelante con este proyecto.
2727

2828
#. Agrega el repositorio original como "upstream"::
2929

30-
git remote add upstream https://github.com/pycampes/python-docs-es.git
30+
git remote add upstream https://github.com/python/python-docs-es.git
3131

3232
#. Crea una rama nueva en base al artículo en el que vayas a trabajar.
3333
Por ejemplo, si vas a trabajar en el archivo ``glosario.po``, usa un nombre similar a::
@@ -73,6 +73,7 @@ A tener en cuenta
7373

7474
* No debes traducir el contenido de ``:ref:...`` y ``:term:...``.
7575
* Si tienes que usar palabras en inglés debes ponerlas en *italics* (rodeadas por asteriscos)
76+
* Puedes revisar las :doc:`faq` para leer sobre problemas conocidos.
7677
* Si traduces un título que es un link, por favor traduce el link también (por ejemplo un artículo a Wikipedia).
7778
En caso de que no haya una traducción del artículo en Wikipedia deja el título sin traducir.
7879
* Tenemos una `Memoria de Traducción`_, que usamos para tener consistencia con algunos términos.
@@ -117,12 +118,12 @@ Puedes ver el resultado con tu navegador de internet (Firefox, Chrome, etc) ejec
117118
Y luego accediendo a http://localhost:8000/
118119

119120

120-
.. _repositorio: https://github.com/PyCampES/python-docs-es
121+
.. _repositorio: https://github.com/python/python-docs-es
121122
.. _ayuda oficial de GitHub: https://help.github.com/es/github/getting-started-with-github/fork-a-repo
122123
.. _ayuda oficial de GitHub para crear un Pull Request: https://help.github.com/es/github/collaborating-with-issues-and-pull-requests/about-pull-requests
123124
.. _poedit: https://poedit.net/
124125

125126
.. _nuestro canal de Telegram: https://t.me/python_docs_es
126127
.. _Memoria de traducción: https://python-docs-es.readthedocs.io/page/translation-memory.html
127128
.. _la traducción al Portugués: https://docs.python.org/pt-br/3/
128-
.. _lista de issues en GitHub: https://github.com/PyCampES/python-docs-es/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
129+
.. _lista de issues en GitHub: https://github.com/python/python-docs-es/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+no%3Aassignee+translate

‎.overrides/faq.rst

Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
1+
:orphan:
2+
3+
Preguntas frecuentes
4+
====================
5+
6+
7+
No puedo resolver un problema, ¿qué hago?
8+
-----------------------------------------
9+
10+
Pregunta, |:smile:|.
11+
Tenemos un `grupo de Telegram`_ en el que hay mucha gente que te puede ayudar.
12+
13+
.. _grupo de Telegram: https://t.me/python_docs_es
14+
15+
16+
¿Cómo puedo instalar y configurar el chequeo con pospell?
17+
---------------------------------------------------------
18+
19+
Uno de los chequeos que realiza nuestro servidor de github cada vez que hacemos
20+
un pull de request es un test de corrección ortográfico usando la herramienta
21+
pospell. Pospell puede ser instalada en tu entorno de Python empleando pip
22+
(https://pypi.org/project/pospell/)::
23+
24+
pip install pospell
25+
26+
Una vez instalado, para chequear el fichero .po sobre el que estás trabajando,
27+
ejecuta desde el directorio principal del repo::
28+
29+
pospell -p dict -l es_AR -l es_ES path/tu_fichero.po
30+
31+
pospell emplea la herramienta de diccionarios hunspell. Si pospell falla dando
32+
como error que no tiene hunspell instalado, lo puedes instalar así:
33+
34+
35+
.. tabs::
36+
37+
.. tab:: Mac
38+
39+
Utilizando ``brew`` (https://formulae.brew.sh/formula/hunspell)::
40+
41+
brew install hunspell
42+
43+
Este comando instala hunspell, pero puede que todavía necesites los diccionarios.
44+
Los diccionarios de Hunspell (``*.aff`` y ``*.dic``) en Mac deben estar en la
45+
carpeta ``~/Library/Spelling/`` o ``/Library/Spelling/``. Puedes encontrar
46+
diccionarios de español en las webs de Open Office, Mozilla y otros proyectos
47+
open source (ejemplo: https://cgit.freedesktop.org/libreoffice/dictionaries/tree/).
48+
49+
.. tab:: Linux
50+
51+
Utilizando el gestor de paquetes de tu distribución::
52+
53+
# Arch Linux
54+
yay -S hunspell-es_any
55+
56+
# Ubuntu Linux
57+
apt install hunspell-es
58+
59+
60+
Estamos trabajando para unificar el uso de un mismo set de diccionarios de español,
61+
pero por el momento el chequeo que hacemos es con los diccionarios es_AR y es_ES.
62+
63+
64+
¿Cómo puedo configurar git para manejar correctamente los finales de línea en Windows?
65+
--------------------------------------------------------------------------------------
66+
67+
En la ayuda de git puedes encontrar información sobre este problema frecuente:
68+
https://help.github.com/es/github/using-git/configuring-git-to-handle-line-endings
69+
70+
71+
¿Cómo hago en Mac para utilizar las comillas correctas?
72+
-------------------------------------------------------
73+
74+
Cuando uses ``poedit`` en Mac, es muy probable que te cambie las comillas comunes que debemos utilizar
75+
por comillas *Smart Quotes* automáticamente. Debes desactivar este comportamiento para usar el que necesitamos.
76+
77+
Puedes hacerlo haciendo
78+
79+
#. click derecho con el mouse en el texto que estás editando
80+
#. *Substitutions*
81+
#. *Smart Quotes*
82+
83+
y repetir el proceso para *Smart Dashes*.
84+
85+
.. figure:: mac-smartquotes.jpg
86+
:width: 85%
87+
:align: center
88+
89+
Desactivar "Smart Quotes" y "Smart Dashes"
90+
91+
92+
¿Qué parte de ``:ref:`` debo traducir?
93+
--------------------------------------
94+
95+
Cuando veas el ``:ref:`` usado así,
96+
97+
.. code-block:: rst
98+
99+
In the :ref:`article` you can find more examples.
100+
101+
**No debes traducir** *article*, ya que es una referencia a otro lugar de la documentación.
102+
En la traducción al Español se mostrará el título de ese artículo en Español --no te preocupes.
103+
104+
Si en cambio lo ves usado así,
105+
106+
.. code-block:: rst
107+
108+
In the section :ref:`how to redirect to a file <how-to-redirect-to-file>` from the logging HOWTO guide.
109+
110+
**Sí debes traducir** la parte que dice *how to redirect to a file*,
111+
pero **no debes traducir** ``how-to-redirect-to-file``.
112+
113+
.. note::
114+
115+
Pueder leer más sobre el rol ``:ref:`` de Sphinx en su `documentación oficial`_ para entender mejor como funcionan las referencias,
116+
aunque no es necesario que lo sepas para la traducción.
117+
118+
.. _documentación oficial: https://www.sphinx-doc.org/en/stable/usage/restructuredtext/roles.html#role-ref
119+
120+
121+
¿Cómo configuro ``pre-commit``?
122+
-------------------------------
123+
124+
.. warning::
125+
126+
Requiere un poco de conocimiento de Python (para crear un entorno virtual) e instalar un paquete del sistema operativo.
127+
128+
Para utilizar ``pre-commit`` y así ejecutar unos pequeños tests antes de hacer un commit y enviar tus cambios a tu Pull Request,
129+
debes seguir estos pasos:
130+
131+
#. Instalar ``pre-commit``::
132+
133+
pip install pre-commit
134+
135+
#. Configurar ``pre-commit`` en el repositorio de ``python-docs-es``::
136+
137+
cd python-docs-es/
138+
pre-commit install
139+
140+
#. Instalar ``hunspell``::
141+
142+
# Arch Linux
143+
yay -S hunspell-es_any
144+
# Ubuntu Linux
145+
apt install hunspell-es
146+
147+
Luego, cada vez que realices un commit se ejecutará ``pre-commit`` y validará tus archivos.
148+
149+
.. note::
150+
151+
Si por cualquier motivo no está funcionando ``pre-commit`` y no te deja hacer *push* de tus cambios,
152+
lo puedes desinstalar simplemente mediante: ``pre-commit uninstall``.

‎.overrides/mac-smartquotes.jpg

97.7 KB
Loading

‎.overrides/troubleshooting.rst

Lines changed: 0 additions & 48 deletions
This file was deleted.

‎README.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
Spanish Translation of the Python Documentation
22
===============================================
33

4-
.. image:: https://travis-ci.org/PyCampES/python-docs-es.svg?branch=3.8
5-
:target: https://travis-ci.org/PyCampES/python-docs-es
4+
.. image:: https://travis-ci.org/python/python-docs-es.svg?branch=3.8
5+
:target: https://travis-ci.org/python/python-docs-es
66
:alt: Build Status
77

88
.. image:: https://readthedocs.org/projects/python-docs-es/badge/?version=3.8

‎TRANSLATORS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ Claudia Millán Nebot (@clacri @cheshireminima)
1414
María José Molina Contreras (@mjmolina)
1515
María Andrea Vignau (@mavignau @marian-vignau)
1616
Marco Richetta (@marcorichetta)
17+
Pablo Lobariñas (@Qkolnek)
1718
Sergio Delgado Quintero (@sdelquin)
1819
Silvina Tamburini (@silvinabt87)
1920
Javier Daza (@javierdaza)

‎conf.py

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,12 @@
7373
_stdauthor, 'manual'),
7474
]
7575

76+
extensions.extend([
77+
'sphinx_tabs.tabs',
78+
'sphinxemoji.sphinxemoji',
79+
])
80+
81+
7682
def setup(app):
7783

7884
def add_contributing_banner(app, doctree):

‎dict

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,7 @@ Python
9494
Pythónico
9595
Qt
9696
Randal
97+
redireccionamiento
9798
Reilly
9899
Rezinsky
99100
Rossum
@@ -107,6 +108,7 @@ Solaris
107108
Solaris
108109
Spot
109110
Stein
111+
subdirectorios
110112
TCP
111113
Tcl
112114
Tix
@@ -144,6 +146,8 @@ bdist
144146
bdist
145147
big-endian
146148
bloqueante
149+
booleano
150+
booleanos
147151
buffer
148152
bug
149153
built
@@ -162,9 +166,11 @@ comilla
162166
command
163167
compilada
164168
computacionales
169+
configúrelo
165170
computacionalmente
166171
consolelib
167172
conversor
173+
correlacionan
168174
corrutina
169175
corrutinas
170176
criptográficamente
@@ -176,6 +182,7 @@ datagramas
176182
debugueando
177183
default
178184
desalojable
185+
desambiguar
179186
desasigna
180187
desasignación
181188
desasignada
@@ -204,6 +211,7 @@ especificador
204211
estáticamente
205212
except
206213
exclude
214+
explícitamente
207215
exponenciación
208216
exit
209217
f
@@ -225,6 +233,8 @@ host
225233
i
226234
idiomáticas
227235
if
236+
implementación
237+
implementaciones
228238
implementadores
229239
import
230240
imports
@@ -275,13 +285,18 @@ manejador
275285
manejadores
276286
manifesto
277287
mantenibilidad
288+
mapear
278289
mapeo
279290
mapeos
280291
metaclase
281292
metaclases
282293
metadatos
283294
metadatos
284295
mezclarlos
296+
microsegundo
297+
microsegundos
298+
milisegundo
299+
milisegundos
285300
mini
286301
modularidad
287302
monoespaciada
@@ -304,9 +319,14 @@ multiprocesamiento
304319
mutex
305320
mxBase
306321
mxBase
322+
naíf
323+
naífs
307324
ncurses
308325
nonlocal
326+
normalización
309327
object
328+
operando
329+
operandos
310330
onexit
311331
operandos
312332
option
@@ -332,6 +352,9 @@ post
332352
posteriori
333353
precompilado
334354
predeclarando
355+
preinstalar
356+
proléptico
357+
prolépticos
335358
prompt
336359
prompts
337360
proxy

0 commit comments

Comments
 (0)