docs/es/community/Contribution-Guide.md

Contribuir al proyecto

Los mantenedores actuales del proyecto están investigando la internacionalización automatizada de la documentación. Por lo tanto, ¡NO se aceptarán PRs relacionados con la internacionalización/traducción de la documentación!

¡Por favor, NO envíes PRs relacionados con la internacionalización/traducción de la documentación!

Gracias por tu interés en este proyecto. Antes de empezar a contribuir, por favor tómate un tiempo para leer las siguientes pautas para asegurar que tu contribución pueda ser aceptada sin problemas.

Tipos de contribuciones no aceptadas

1. Internacionalización/traducción de documentación
2. Contribuciones relacionadas con la infraestructura central, como API HTTP, etc.
3. Problemas marcados explícitamente como "No se necesita ayuda" (incluyendo problemas en los repositorios Byaidu/PDFMathTranslate y PDFMathTranslate-next/PDFMathTranslate-next).
4. Otras contribuciones consideradas inapropiadas por los mantenedores.
5. Contribuir a la documentación, pero modificando la documentación en idiomas distintos al inglés.
6. PRs que requieran modificar archivos PDF.
7. PRs que modifiquen el archivo pdf2zh_next/gui_translation.yaml.

Por favor, NO envíes PRs relacionados con los tipos mencionados anteriormente.

Si deseas contribuir con la documentación, por favor solo modifiques la versión en inglés de la documentación. Las versiones en otros idiomas son traducidas por los propios colaboradores.

• Add new translation services
• Add new features
• Modify the project structure

---

TRANSLATION RESULT

PR que se recomienda discutir con los mantenedores mediante un Issue antes de enviarlo

• Agregar nuevos servicios de traducción

• Agregar nuevas características

• Modificar la estructura del proyecto

• Add new translation services

• Add new features

• Modify the project structure

---

TRANSLATION RESULT

Para los siguientes tipos de PR, se recomienda discutir primero con los mantenedores antes de enviarlos:

• Agregar nuevos servicios de traducción
• Agregar nuevas características
• Modificar la estructura del proyecto

2. PRs that involve modifying the project's core architecture. (We welcome improvements, but please discuss them first).
3. PRs that add new dependencies. (We aim to keep the project lightweight).

---

TRANSLATION RESULT

1. PR relacionados con la funcionalidad de uso compartido para múltiples usuarios. (Este proyecto está diseñado principalmente para uso de un solo usuario y no tiene la intención de introducir un sistema completo para múltiples usuarios).
2. PR que impliquen modificar la arquitectura central del proyecto. (Damos la bienvenida a las mejoras, pero por favor discútelas primero).
3. PR que agreguen nuevas dependencias. (Nuestro objetivo es mantener el proyecto liviano).

Proceso de contribución

1. Haz un fork de este repositorio y clónalo localmente.
2. Crea una nueva rama: git checkout -b feature/<feature-name>.
3. Desarrolla y asegúrate de que tu código cumpla con los requisitos.
4. Confirma tus cambios:

   git add .
   git commit -m "<semantic commit message>"
   

5. Sube los cambios a tu repositorio: git push origin feature/<feature-name>.
6. Crea un PR en GitHub, proporciona una descripción detallada y solicita una revisión a @awwaawwa.
7. Asegúrate de que todas las verificaciones automatizadas pasen.

No es necesario esperar hasta que tu desarrollo esté completamente terminado para crear un PR. Crear uno temprano nos permite revisar tu implementación y proporcionar sugerencias.

Si tienes alguna pregunta sobre el código fuente o asuntos relacionados, por favor contacta al mantenedor en aw@funstory.ai.

Los archivos de recursos para la versión 2.0 se comparten con BabelDOC. El código para descargar los recursos relacionados está en BabelDOC. Si deseas agregar nuevos archivos de recursos, por favor contacta al mantenedor de BabelDOC en aw@funstory.ai.

Requisitos básicos

1. Flujo de trabajo

• Por favor, haz un fork desde la rama main y desarrolla en tu rama bifurcada.
• Al enviar una Pull Request (PR), proporciona una descripción detallada de tus cambios.
• Si tu PR no pasa las verificaciones automatizadas (indicadas por checks failed y una cruz roja), revisa los details correspondientes y modifica tu envío para asegurar que la nueva PR pase todas las verificaciones.

2. Desarrollo y Pruebas

• Usa el comando pip install -e . para desarrollo y pruebas.

3. Formato de código

• Configura la herramienta pre-commit y habilita black y flake8 para el formato del código.

4. Actualizaciones de dependencias

• Si introduces nuevas dependencias, actualiza la lista de dependencias en el archivo pyproject.toml de manera oportuna.

5. Actualizaciones de documentación

• Si agregas nuevas opciones de línea de comandos, por favor actualiza la lista de opciones de línea de comandos en todas las versiones de idioma del archivo README.md correspondientemente.

6. Mensajes de commit

• Usa Conventional Commits, por ejemplo: feat(translator): add openai.

7. Estilo de codificación

• Asegúrate de que el código enviado cumpla con los estándares básicos de estilo de codificación.
• Utiliza snake_case o camelCase para el nombrado de variables.

8. Formato de documentación

• Para el formato de README.md, sigue las Directrices de redacción en chino.
• Asegúrate de que tanto la documentación en inglés como en chino estén siempre actualizadas; las actualizaciones de la documentación en otros idiomas son opcionales.

Agregar un motor de traducción

1. Agrega una nueva clase de configuración de traductor en el archivo pdf2zh/config/translate_engine_model.py.
2. Agrega una instancia de la nueva clase de configuración de traductor al alias de tipo TRANSLATION_ENGINE_SETTING_TYPE en el mismo archivo.
3. Agrega la nueva clase de implementación de traductor en la carpeta pdf2zh/translator/translator_impl.

Este proyecto no tiene la intención de admitir ningún motor de traducción con un RPS (solicitudes por segundo) inferior a 4. Por favor, no envíe soporte para dichos motores. Los siguientes tipos de traductores tampoco se integrarán:

• Traductores que han sido discontinuados por los mantenedores upstream (como deeplx)
• Traductores con grandes dependencias (como aquellos que dependen de pytorch)
• Traductores inestables
• Traductores basados en API de ingeniería inversa

Cuando no esté seguro de si un traductor cumple con los requisitos, puede enviar un problema para discutirlo con los mantenedores.

Estructura del proyecto

• config folder: Sistema de configuración.
• translator folder: Implementaciones relacionadas con el traductor.
• gui.py: Proporciona la interfaz gráfica de usuario.
• const.py: Algunas constantes.
• main.py: Proporciona la herramienta de línea de comandos.
• high_level.py: Interfaces de alto nivel basadas en BabelDOC.
• http_api.py: Proporciona API HTTP (no iniciado).

Pregunta a la IA para entender el proyecto: DeepWiki

Contáctanos

Si tienes alguna pregunta, por favor envía tus comentarios a través de Issue o únete a nuestro Grupo de Telegram. ¡Gracias por tu contribución!

Immersive Translate patrocina códigos de membresía Pro mensuales para los contribuyentes activos de este proyecto. Para más detalles, consulta: Reglas de recompensa para contribuyentes de BabelDOC/PDFMathTranslate

Parte del contenido de esta página ha sido traducido por GPT y puede contener errores.