python-docs-es icon indicating copy to clipboard operation
python-docs-es copied to clipboard

Mejorar script para encontrar diferencias de formato

Open cmaureir opened this issue 4 years ago • 1 comments

Este script puede ser utilizaro en archivos, directorios, o en todo el proyecto (sin argumentos)

La idea es encontrar inconsistencias en los archivos traducidos relacionados al formato de rst y sphinx.

cmaureir avatar Dec 20 '21 11:12 cmaureir

Un par de detalles, el resto se ve bien.

Gracias por los comentarios, había olvidado este parche :P

Al leer el código para tratar de entender la funcionalidad de cumple, me recordó a los checks que hace sphinx mismo de asegurarse que los roles que aparecen en el original también aparecen en la traducción (y que hacen fallar el build cuando no se cumple).

¿Es la intención de este script hacer ese mismo chequeo, pero de forma más light de tal forma que se pueda agregar al pre-commit? Si la respuesta es "sí", entonces creo que sacaría los patrones de bold e italics porque esos dan varios falsos positivos, y además ajustaría la lógica para que el texto dentro de los roles no tenga que ser exactamente igual, sino que la referencia tenga que ser la misma (i.e., parsear lo que hay dentro de <> si es que están presentes los caracteres).

Complementario diría yo, sphinx no detecta inconsistencias entre los bold e italic por ejemplo, que por lo general terminan en errores de formato. Agregué los patrones de otras sentencias de sphinx "ya que estamos buscando inconsistencias". Pensé que si alguien lo usa, querrá notar las otras diferencias también.

Por otro lado, si la intención inicial no era esa, sino más bien dar un feedback más manual, qué tal si ajustamos el script para que tenga las dos funcionalidades? O creamos uno aparte? Voy a experimentar un poco y poner acá mis resultados.

No pensé realmente un uso de todas las personas, solamente que estaba haciendo el paso a mano de buscar inconsistencias entre frases donde quien haya traducido olvidara texto en bold, o alguna otra cosa de sphinx que se nos hubiera pasado por alto.

Si tienes alguna idea de como mejorarla para dar esa dualidad me dices!

cmaureir avatar Oct 25 '22 11:10 cmaureir