Declara dependencia en sphinx-lint 0.6.7

Ya que de versión a versión nuevos chequeos pueden ser agregados, preferí hacer un pin de la versión y así asegurar la estabilidad de las corridas. Un dependabot podría luego chequear si hay versiones nuevas y mostrarnos si acaso hay errores nuevos en el linteo o no.
python · cmaureir · Dec 2, 2022 · Nov 28, 2022 · Nov 28, 2022 · Nov 28, 2022
commit ec94dddb0a07a654328e58d2473ca8dbabb9fddb
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -32,6 +32,9 @@ jobs:
           diff -Naur TRANSLATORS <(LANG=es python scripts/sort.py < TRANSLATORS)
       - name: Powrap
         run: powrap --check --quiet **/*.po
+      - name: Sphinx lint
+        run: |
+          sphinx-lint */*.po
       - name: Pospell
         run: |
           python scripts/check_spell.py

diff --git a/.overrides/reviewers-guide.rst b/.overrides/reviewers-guide.rst
@@ -48,6 +48,43 @@ Tres razones por las que puede fallar el *build* de Travis:
 
 Para facilitar la comparación de ficheros se emplea este programa que va a hacer que todas las líneas tengan el mismo tamaño. Solucionar este problema en nuestra traducción es muy sencillo, solo hay que instalar la herramienta powrap en nuestro entorno y ejecutar el comando ``powrap nuestro_fichero.po``
 
+``sphinx-lint`` falla
+---------------------
+
+El formato en el que la documentación de python está escrito
+(`reStructredText <https://es.wikipedia.org/wiki/ReStructuredText>`_ , o rst)
+puede ser difícil de manejar y escribir correctamente.
+``sphinx-lint`` ayuda a encontrar errores comunes al momento de escribir
+entradas en este formato, y advierte al respecto.
+
+Entre los errores más comunes están:
+
+* Textos literales no están separados por un espacio
+  respecto a las palabras que lo rodean:
+
+  * Mal: :literal:`no hay espacio antes del\`\`literal\`\``
+  * Mal: :literal:`después del \`\`literal \`\`no hay un espacio`
+  * Bien: :literal:`hay espacio antes del \`\`literal\`\` y después también`
+
+* Textos literales comienzan o terminan con espacios:
+
+  * Mal: :literal:`\`\` literal empieza con un espacio\`\``
+  * Mal: :literal:`\`\`literal termina con un espacio \`\``
+  * Bien: :literal:`\`\`literal no termina ni empieza con espacios\`\``
+
+* Textos literales no están delineados con dos acentos fuertes:
+
+  * Mal: :literal:`\`\`falta uno al final :(\``
+  * Mal: :literal:`\`falta uno al principio :(\`\``
+  * Bien: :literal:`\`\`todo bien :)\`\``
+
+* Enlaces no terminan en un guión bajo:
+
+  * Mal: :literal:`\`<https://python.org>\``
+  * Mal: :literal:`\`Python <https://python.org>\``
+  * Bien: :literal:`\`<https://python.org>\`_`
+  * Bien: :literal:`\`Python <https://python.org>\`_`
+
 
 ``pospell`` falla
 ---------------------

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -11,3 +11,9 @@ repos:
         language: python
         additional_dependencies: ['pospell>=1.1']
         files: \.po$
+    -   id: lint
+        name: Run sphinx linting
+        entry: sphinx-lint
+        language: python
+        additional_dependencies: ['sphinx-lint==0.6.7']
+        files: \.po$
diff --git a/Makefile b/Makefile
@@ -99,6 +99,10 @@ progress: venv
 spell: venv
 	$(VENV)/bin/python scripts/check_spell.py
 
+.PHONY: lint
+lint: venv
+	$(VENV)/bin/python -m sphinxlint */*.po
+
 
 .PHONY: wrap
 wrap: venv

diff --git a/requirements.txt b/requirements.txt
@@ -13,4 +13,5 @@ pre-commit
 sphinx-autorun
 sphinxemoji
 sphinx-tabs
+sphinx-lint==0.6.7
 tabulate