8000 Merge branch '3.8' into traduccion-library-datetime · python/python-docs-es@7834def · GitHub
[go: up one dir, main page]
Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 7834def

Browse files
mjmolinamjmolina
authored
Merge branch '3.8' into traduccion-library-datetime
2 parents 490c862 + edc0f02 commit 7834def

File tree

9 files changed

+389
-81
lines changed

9 files changed

+389
-81
lines changed

‎.overrides/CONTRIBUTING.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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.

‎.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.

‎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: 3 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
@@ -340,6 +342,7 @@ post
340342
posteriori
341343
precompilado
342344
predeclarando
345+
preinstalar
343346
proléptico
344347
prolépticos
345348
prompt

0 commit comments

Comments
 (0)
0