Skip to content

Commit 9705b44

Browse files
euribateseuribates
committed
Merge branch 'traduccion-library-stdtypes' of github.com:euribates/python-docs-es into traduccion-library-stdtypes
2 parents 82e10ad + 332a7e3 commit 9705b44

File tree

12 files changed

+1679
-379
lines changed

12 files changed

+1679
-379
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

‎.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
@@ -15,6 +15,7 @@ Claudia Millán Nebot (@clacri @cheshireminima)
1515
María José Molina Contreras (@mjmolina)
1616
María Andrea Vignau (@mavignau @marian-vignau)
1717
Marco Richetta (@marcorichetta)
18+
Pablo Lobariñas (@Qkolnek)
1819
Sergio Delgado Quintero (@sdelquin)
1920
Silvina Tamburini (@silvinabt87)
2021
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 & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,8 @@ bdist
144144
bdist
145145
big-endian
146146
bloqueante
147+
booleano
148+
booleanos
147149
buffer
148150
bug
149151
build
@@ -163,8 +165,10 @@ comilla
163165
command
164166
compilada
165167
computacionalmente
168+
configúrelo
166169
consolelib
167170
conversor
171+
correlacionan
168172
corrutina
169173
corrutinas
170174
criptográficamente
@@ -176,6 +180,7 @@ datagramas
176180
debugueando
177181
default
178182
desalojable
183+
desambiguar
179184
desasigna
180185
desasignación
181186
desasignada
@@ -205,6 +210,7 @@ estáticamente
205210
except
206211
exclude
207212
exit
213+
explícitamente
208214
exponenciación
209215
f
210216
flag
@@ -225,6 +231,8 @@ host
225231
i
226232
idiomáticas
227233
if
234+
implementaciones
235+
implementación
228236
implementadores
229237
import
230238
imports
@@ -276,13 +284,18 @@ manejador
276284
manejadores
277285
manifesto
278286
mantenibilidad
287+
mapear
279288
mapeo
280289
mapeos
281290
metaclase
282291
metaclases
283292
metadatos
284293
metadatos
285294
mezclarlos
295+
microsegundo
296+
microsegundos
297+
milisegundo
298+
milisegundos
286299
mini
287300
modularidad
288301
monoespaciada
@@ -296,11 +309,16 @@ multiprocesamiento
296309
mutex
297310
mxBase
298311
mxBase
312+
naíf
313+
naífs
299314
ncurses
300315
nonlocal
316+
normalización
301317
object
302318
octal
303319
onexit
320+
operando
321+
operandos
304322
operandos
305323
option
306324
or
@@ -325,6 +343,9 @@ post
325343
posteriori
326344
precompilado
327345
predeclarando
346+
preinstalar
347+
proléptico
348+
prolépticos
328349
prompt
329350
prompts
330351
proxy
@@ -348,6 +369,7 @@ redefinir
348369
redimensionable
349370
redimensionables
350371
redimensionado
372+
redireccionamiento
351373
redondeándolo
352374
ref
353375
refactorización
@@ -399,6 +421,7 @@ sub
399421
subcarpetas
400422
subcomandos
401423
subdirectorio
424+
subdirectorios
402425
submódulo
403426
submódulos
404427
subpaquete
@@ -416,7 +439,6 @@ tabulación
416439
takefocus
417440
tar
418441
tarball
419-
tarball
420442
termcap
421443
testeo
422444
timestamp

0 commit comments

Comments
 (0)