|
| 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``. |
0 commit comments