Merge branch 'main' into docs/python-package-build-tools-to-spanish

Author: flpm

.all-contributorsrc

@@ -5,6 +5,7 @@
   "imageSize": 100,
   "commit": false,
   "commitConvention": "angular",
+  "contributorsSortAlphabetically": true,
   "contributors": [
     {
       "login": "eriknw",
@@ -96,7 +97,8 @@
       "profile": "https://jon-e.net",
       "contributions": [
         "code",
-        "design"
+        "design",
+        "ideas"
       ]
     },
     {
@@ -690,7 +692,8 @@
       "contributions": [
         "code",
         "review",
-        "translation"
+        "translation",
+        "ideas"
       ]
     },
     {
@@ -730,7 +733,8 @@
       "profile": "https://www.linkedin.com/in/ncclementi/",
       "contributions": [
         "code",
-        "review"
+        "review",
+        "translation"
       ]
     },
     {
@@ -763,7 +767,8 @@
         "code",
         "review",
         "doc",
-        "translation"
+        "translation",
+        "ideas"
       ]
     },
     {
@@ -784,6 +789,24 @@
         "review",
         "translation"
       ]
+    },
+    {
+      "login": "melissawm",
+      "name": "Melissa Weber Mendonça",
+      "avatar_url": "https://avatars.githubusercontent.com/u/3949932?v=4",
+      "profile": "http://melissawm.github.io",
+      "contributions": [
+        "question"
+      ]
+    },
+    {
+      "login": "OriolAbril",
+      "name": "Oriol Abril-Pla",
+      "avatar_url": "https://avatars.githubusercontent.com/u/23738400?v=4",
+      "profile": "http://oriolabrilpla.cat",
+      "contributions": [
+        "question"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.pre-commit-config.yaml

@@ -40,8 +40,8 @@ repos:
     hooks:
       - id: vale
 
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v3.1.0
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.3.3
     hooks:
       - id: prettier
         types_or: [yaml, html, css, scss, javascript, json, toml]

README.md

@@ -265,7 +265,7 @@ When you submit a PR for a translation, you should only include changes to one l
 
 Translations PRs will be tagged with a label indicating the language to make them easier to identify and review. For example, contributions to the Spanish translation will be tagged with 'lang-es'.
 
-TODO: This tagging could be automated with a GitHub action.
+TODO: This tagging could be automated with a GitHub Actions.
 
 When you submit the PR, make sure to include a short description of the changes you made and any context that might be helpful for the reviewer (e.g., you translated new strings, you reviewed fuzzy entries, you fixed typos, etc.)
 
@@ -340,7 +340,7 @@ TODO: There are many approaches here, some projects release a translation as soo
 
 ### How can I get help with my translation?
 
-If you have any questions or need help with your translation, you can create an issue in the repository if you encounter any problems or need assistance.
+If you have any questions or need help with your translation, you can create an issue in the repository.
 
 TODO: Maybe [Discourse](https://pyopensci.discourse.group/) could be used as a way for contributors to ask for help with translations or the translation workflow?
 

TRANSLATING.md

@@ -211,6 +211,45 @@ html[data-theme="dark"] {
   --pyos-h1-color: var(--pyos-color-light);
 }
 
+/* --------------------------------------
+De-jumble header items.
+See https://github.com/pydata/pydata-sphinx-theme/pull/1784
+*/
+
+.bd-header .bd-header__inner {
+  padding: 0 1rem;
+}
+
+.bd-header .navbar-item {
+  height: unset;
+  max-height: unset;
+}
+
+@media (max-width: 960px) {
+  .bd-header .navbar-header-items {
+    flex-wrap: wrap;
+    row-gap: 0.5rem;
+  }
+}
+
+.bd-header .navbar-header-items__end,
+.bd-header .navbar-header-items__center,
+.bd-header .navbar-header-items__start {
+  flex-flow: nowrap;
+}
+
+.bd-header .navbar-header-items__start {
+  width: unset;
+}
+
+.bd-header .navbar-header-items__center {
+  margin-right: 0.25em !important;
+}
+
+.bd-header ul.navbar-nav {
+  flex-wrap: wrap;
+}
+
 /* -------------------------------------- */
 /* Generated by https://gwfh.mranftl.com/ */
 

_static/pyos.css

@@ -6,7 +6,7 @@ syntax. It is the default syntax used in Jupyter Notebooks. There are tools that
 colored call out blocks and other custom elements to your documentation, you will
 need to use either **myST** or **rST**.
 1. [rST (ReStructured Text):](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html). **rST** is the native syntax that sphinx supports. rST was the default syntax used for documentation for many years. However, in recent years myST has risen to the top as a favorite for documentation given the flexibility that it allows.
-1. [myST:](https://myst-parser.readthedocs.io/en/latest/intro.html) myST is a combination of vanilla of `markdown` and `rST` syntax. It is a nice option if you are comfortable writing markdown. `myst` is preferred by many because it offers both the rich functionality
+1. [myST:](https://myst-parser.readthedocs.io/en/latest/intro.html) myST is a combination of `markdown` and `rST` syntax. It is a nice option if you are comfortable writing markdown. `myst` is preferred by many because it offers both the rich functionality
 of rST combined with a simple-to-write markdown syntax.
 
 While you can chose to use any of the syntaxes listed above, we suggest using

documentation/hosting-tools/myst-markdown-rst-doc-syntax.md

@@ -96,6 +96,15 @@ The first round of our community-developed, how to create a Python package tutor
 :::
 ::::
 
+::::{grid-item}
+:::{card} ✿ Reference Guides ✿
+:class-card: left-aligned
+
+* [Command Line Reference Guide](/tutorials/command-line-reference)
+
+:::
+::::
+
 :::::
 
 

index.md

@@ -22,94 +22,107 @@ msgstr ""
 
 #: ../../tutorials/add-license-coc.md:1
 msgid "Add a `LICENSE` & `CODE_OF_CONDUCT` to your Python package"
-msgstr ""
+msgstr "Agrega `LICENSE` y `CODE_OF_CONDUCT` a tu paquete de Python"
 
 #: ../../tutorials/add-license-coc.md:3
 msgid "In the [previous lesson](add-readme) you:"
-msgstr ""
+msgstr "En la [sección anterior](add-readme) tu:"
 
 #: ../../tutorials/add-license-coc.md:5
 msgid ""
 "<i class=\"fa-solid fa-circle-check\" style=\"color: #703c87;\"></i> "
 "Created a basic `README.md` file for your scientific Python package"
-msgstr ""
+msgstr "Creaste un archivo `README.md` para tu paquete the Python científico"
 
 #: ../../tutorials/add-license-coc.md:7
 msgid ""
 "<i class=\"fa-solid fa-circle-check\" style=\"color: #703c87;\"></i> "
 "Learned about the core components that are useful to have in a `README` "
 "file."
-msgstr ""
+msgstr "Aprendiste acerca de los componentes principales que son útiles de tener en "
+"un archivo `README`."
 
 #: ../../tutorials/add-license-coc.md:9 ../../tutorials/add-readme.md:10
 msgid "Learning objectives"
-msgstr ""
+msgstr "Objetivos de aprendizaje"
 
 #: ../../tutorials/add-license-coc.md:12 ../../tutorials/add-readme.md:12
 #: ../../tutorials/installable-code.md:41 ../../tutorials/pyproject-toml.md:22
 #: ../../tutorials/setup-py-to-pyproject-toml.md:15
 msgid "In this lesson you will learn:"
-msgstr ""
+msgstr "En esta lección aprenderas:"
 
 #: ../../tutorials/add-license-coc.md:14
 msgid ""
 "How to select a license and add a `LICENSE` file to your package "
 "repository, with a focus on the GitHub interface."
-msgstr ""
+msgstr "Como seleccionar una licencia y agregar un archivo `LICENSE` al "
+"repositorio de tu paquete, con enfoque en la interface de Github"
 
 #: ../../tutorials/add-license-coc.md:15
 msgid "How to add a `CODE_OF_CONDUCT` file to your package repository."
-msgstr ""
+msgstr "Como agregar un archivo `CODE_OF_CONDUCT` al repositorio de tu paquete"
 
 #: ../../tutorials/add-license-coc.md:16
 msgid ""
 "How you can use the Contributors Covenant website to add generic language"
 " as a starting place for your `CODE_OF_CONDUCT`."
-msgstr ""
+msgstr "Como usar el sitio web de Contributors Covenant para agregar lenguage"
+" genérico como punto de partida para tu `CODE_OF_CONDUCT`"
 
 #: ../../tutorials/add-license-coc.md:19
 msgid "What is a license?"
-msgstr ""
+msgstr "¿Qué es una licencia?"
 
 #: ../../tutorials/add-license-coc.md:21
 msgid ""
 "A license contains legal language about how users can use and reuse your "
 "software. To set the `LICENSE` for your project, you:"
-msgstr ""
+msgstr "Una licencia contiene lenguaje legal acerca de como los usuarios pueden "
+"usar y reusar tu software. Para establecer un archivo `LICENSE` para tu"
+" projecto, tu: "
 
 #: ../../tutorials/add-license-coc.md:23
 msgid ""
 "create a `LICENSE` file in your project directory that specifies the "
 "license that you choose for your package and"
-msgstr ""
+msgstr "creas un archivo `LICENSE` en el directorio de tu proyecto que "
+"especifique la licencia que que elejiste para tu paquete y"
 
 #: ../../tutorials/add-license-coc.md:24
 msgid "reference that file in your `pyproject.toml` data where metadata are set."
-msgstr ""
+msgstr "haces referencia a ese archivo en el `pyproject.toml` donde la metadata"
+" es especificada"
 
 #: ../../tutorials/add-license-coc.md:26
 msgid ""
 "By adding the `LICENSE` file to your `pyproject.toml` file, the `LICENSE`"
 " will be included in your package's metadata which is used to populate "
 "your package's PyPI landing page. The `LICENSE` is also used in your "
 "GitHub repository's landing page interface."
-msgstr ""
+msgstr "Al incluir el archivo `LICENSE` en tu archivo `pyproject.toml`, la "
+"`LICENSE` sera incluída en la metadata de tu paquete y esta es utilizada para"
+" rellenar la página de entrada de tu paquete en PyPI. La `LICENSE` también es "
+" utilizada en la página de entrada de tu repositorio de GitHub"
 
 #: ../../tutorials/add-license-coc.md:28
 msgid "What license should you use?"
-msgstr ""
+msgstr "¿Qué licencia deberías elegir?"
 
 #: ../../tutorials/add-license-coc.md:30
 msgid ""
 "We suggest that you use a permissive license that accommodates the other "
 "most commonly used licenses in the scientific Python ecosystem (MIT[^mit]"
 " and BSD-3[^bsd3]). If you are unsure, use MIT given it's the generally "
 "recommended license on [choosealicense.com](https://choosealicense.com/)."
-msgstr ""
+msgstr "Nosotros sugerimos que uses una licencia permissiva que acomode otras"
+" licencias comúnmente usadas en el ecosistema de Python científico (MIT[^mit]"
+" and BSD-3[^bsd3]). Si tienes dudas, usa MIT dado que es la licencia"
+" generalmente recomendada en [choosealicense.com](https://choosealicense.com/)"
 
 #: ../../tutorials/add-license-coc.md:33
 msgid "Licenses for the scientific Python ecosystem"
-msgstr ""
+msgstr "Licencias para el ecosistema de Python científico"
 
 #: ../../tutorials/add-license-coc.md:34
 msgid ""