translate sphinx-python-package-documentation-tools.md

Also included is a small grammar fix in the source .md file

Author: yardasol

documentation/hosting-tools/sphinx-python-package-documentation-tools.md

@@ -46,7 +46,7 @@ and themes. A few examples include:
 * You can apply documentation themes for quick generation of beautiful documentation.
 * You can [automatically create documentation for your package's functions and classes (the package's API) from docstrings in your code using the autodoc extension](https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html)
 * You can [run and test code examples in your docstrings using the doctest extension](https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html)
-* While Sphinx natively supports the `rST` syntax. You can add custom syntax parsers to support easier-to-write syntax using tools such as [the MyST parser](https://myst-parser.readthedocs.io/).
+* While Sphinx natively supports the `rST` syntax, you can add custom syntax parsers to support easier-to-write syntax using tools such as [the MyST parser](https://myst-parser.readthedocs.io/).
 
 ### Commonly used Sphinx themes
 

locales/es/LC_MESSAGES/documentation.po

@@ -135,7 +135,7 @@ msgid ""
 "Most of your core Python package text files, such as your README.md file,"
 " are already in `.md` format"
 msgstr ""
-"La mayoría de tus archivos de texto de paquetes primarios de Python, "
+"La mayoría de tus archivos de texto de paquetes principales de Python, "
 "como tu archivo README.md, ya están en formato `.md`."
 
 #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:18
@@ -298,7 +298,7 @@ msgstr ""
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:1
 msgid "Using Sphinx to Build Python Package Documentation"
-msgstr ""
+msgstr "Usando Sphinx para construir documentación de paquetes de Python"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:17
 msgid ""
@@ -309,41 +309,54 @@ msgid ""
 "[mkdocs](https://www.mkdocs.org/) which is gaining popularity in the "
 "Python packaging ecosystem."
 msgstr ""
+"En esta página discutimos utilizando [Sphinx](https://www.sphinx-doc.org/) "
+"para construir la documentación orientado al usuario de tu paquete. Aunque "
+"Sphinx está la herramienta más común en la ecosistma de Python cientifica, "
+"puedes explorar otras herramientas para construir documentación como "
+"[mkdocs](https://www.mkdocs.org/) que está ganando popularidad en la "
+"ecosistema de empaquetado de Python."
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:25
 msgid "Examples of documentation websites that we love:"
-msgstr ""
+msgstr "Ejemplos de sitios del web de documentación que queremos:" 
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:27
 msgid "[GeoPandas](https://geopandas.org/en/stable/)"
-msgstr ""
+msgstr "[GeoPandas](https://geopandas.org/en/stable/)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:28
 msgid ""
 "[View rst to create landing "
 "page](https://raw.githubusercontent.com/geopandas/geopandas/main/doc/source/index.rst)"
 msgstr ""
+"[Ver rst para crear pagina de "
+"entrada](https://raw.githubusercontent.com/geopandas/geopandas/main/doc/source/index.rst)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:29
 msgid "[verde](https://www.fatiando.org/verde/latest/)"
-msgstr ""
+msgstr "[verde](https://www.fatiando.org/verde/latest/)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:30
 msgid ""
 "[View verde landing page code - rst "
 "file.](https://github.com/fatiando/verde/blob/main/doc/index.rst)"
 msgstr ""
+"[Ver verde codigo de página de entrada - rst "
+"archivo.](https://github.com/fatiando/verde/blob/main/doc/index.rst)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:31
 msgid ""
 "[Here is our documentation if you want to see a myST example of a landing"
 " page.](https://github.com/pyOpenSci/python-package-"
 "guide/blob/main/index.md)"
 msgstr ""
+"[Aquí está nuestra documentación si deseas leer un ejemplo de página de "
+"entrada de myST.](https://github.com/pyOpenSci/python-package-"
+"guide/blob/main/index.md)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:34
 msgid "Sphinx - a static site generator"
-msgstr ""
+msgstr "Sphinx - un generador de sitios estáticos"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:36
 msgid ""
@@ -354,26 +367,36 @@ msgid ""
 "\"Statically\" which means that there is no generation or modification of"
 " the files on the fly."
 msgstr ""
+"Sphinx es un [generador de  "
+"sitios estáticos](https://www.cloudflare.com/es-es/learning/performance/static-site-"
+"generator/). Un generador de sitios estáticos es una herramienta que crea "
+"html para un sitio del web por archivos de plantillas. Los archivos html "
+"se sirven \"estáticamente\" que significa no hay generación ni modificación "
+"de lo archivos instantánea."
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:39
 msgid "Sphinx is written using Python."
-msgstr ""
+msgstr "Sphinx se escribe con Python"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:41
 msgid "Sphinx sites can be customized using extensions and themes"
-msgstr ""
+msgstr "Sitios de Sphinx puede ser personalizado con extensiones y temas"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:43
 msgid ""
 "The functionality of Sphinx can be extended using extensions and themes. "
 "A few examples include:"
 msgstr ""
+"La funcionalidad de Sphinx puede ser extendido con extensiones y temas. "
+"Algunos ejemplos incluye:"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:46
 msgid ""
 "You can apply documentation themes for quick generation of beautiful "
 "documentation."
 msgstr ""
+"Puedes usar temas de documentación para generación rápida de documentación"
+"hermosa."
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:47
 msgid ""
@@ -382,47 +405,59 @@ msgid ""
 "autodoc extension](https://www.sphinx-"
 "doc.org/en/master/usage/extensions/autodoc.html)"
 msgstr ""
+"Puedes [generar automaticamente documentación para los funciones y clases "
+"(el API del paquete) de los docstrings en el código por la extensión "
+"autodoc](https://www.sphinx-"
+"doc.org/en/master/usage/extensions/autodoc.html)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:48
 msgid ""
 "You can [run and test code examples in your docstrings using the doctest "
 "extension](https://www.sphinx-"
 "doc.org/en/master/usage/extensions/doctest.html)"
 msgstr ""
+"Puedes [ejecutar y probar ejemplos del codigo en los docstrings por la "
+"extensión doctest](https://www.sphinx-"
+"doc.org/en/master/usage/extensions/doctest.html)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:49
 msgid ""
-"While Sphinx natively supports the `rST` syntax. You can add custom "
+"While Sphinx natively supports the `rST` syntax, you can add custom "
 "syntax parsers to support easier-to-write syntax using tools such as [the"
 " MyST parser](https://myst-parser.readthedocs.io/)."
 msgstr ""
+"Aunque Sphinx apoya sintaxis `rST` nativamente, puedes añadir analidores de "
+"sintaxis personalizadas para apoyar sintaxis más fácil con herramientas como "
+"[el analizador MyST](https://myst-parser.readthedocs.io/)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:51
 msgid "Commonly used Sphinx themes"
-msgstr ""
+msgstr "Temas comúnes en Sphinx"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:53
 msgid ""
 "You are free to use whatever Sphinx theme that you prefer. However, the "
 "most common Sphinx themes used in the Python scientific community "
 "include:"
 msgstr ""
+"Puedes usar cualquiera tema de Sphinx que prefieres. Sin embargo, las "
+"temas más comúnes utilizadas en la comunidad de Python cientifica incluyen:"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:57
 msgid "[pydata-sphinx-theme](https://pydata-sphinx-theme.readthedocs.io/)"
-msgstr ""
+msgstr "[pydata-sphinx-theme](https://pydata-sphinx-theme.readthedocs.io/)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:58
 msgid "[sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/)"
-msgstr ""
+msgstr "[sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:59
 msgid "[furo](https://pradyunsg.me/furo/quickstart/)"
-msgstr ""
+msgstr "[furo](https://pradyunsg.me/furo/quickstart/)"
 
 #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:63
 msgid "This book is created using Sphinx and the `furo` theme."
-msgstr ""
+msgstr "Este libro se crea con Sphinx y la tema `furo`."
 
 #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:1
 msgid "Optimizing your documentation so search engines (and other users) find it"