Contribuindo para o projeto

Obrigado pelo seu interesse neste projeto! Antes de começar a contribuir, por favor, reserve um tempo para ler as seguintes diretrizes para garantir que sua contribuição possa ser aceita sem problemas.

Tipos de Contribuições Não Aceitas

1. Documentação de internacionalização/tradução
2. Contribuições relacionadas à infraestrutura central, como API HTTP, etc.
3. Problemas explicitamente marcados como "Sem necessidade de ajuda" (incluindo problemas no repositório Byaidu/PDFMathTranslate e no repositório PDFMathTranslate-next/PDFMathTranslate-next).
4. Outras contribuições consideradas inadequadas pelos mantenedores.
5. Contribuição com documentação, mas alterando a documentação em idiomas diferentes do inglês.
6. PRs que exigem modificação de arquivos PDF.
7. PRs que modificam o arquivo pdf2zh_next/gui_translation.yaml.

Por favor, NÃO envie PRs relacionados aos tipos acima.

PRs que são recomendados discutir com os mantenedores via Issue antes da submissão

Para os seguintes tipos de PRs, é recomendado discutir com os mantenedores primeiro antes da submissão:

1. PRs relacionados à funcionalidade de compartilhamento multi-usuário. (Este projeto é projetado principalmente para uso de usuário único e não pretende introduzir um sistema multi-usuário abrangente).

Processo de Contribuição

1. Faça um fork deste repositório e clone-o localmente.
2. Crie uma nova branch: git checkout -b feature/<nome-do-recurso>.
3. Desenvolva e certifique-se de que seu código atende aos requisitos.
4. Faça commit do seu código:

   git add .
   git commit -m "<mensagem de commit semântica>"
   

5. Envie para o seu repositório: git push origin feature/<nome-do-recurso>.
6. Crie um PR no GitHub, forneça uma descrição detalhada e solicite uma revisão de @awwaawwa.
7. Certifique-se de que todas as verificações automatizadas passem.

Requisitos básicos

1. Fluxo de trabalho

• Por favor, faça um fork do branch main e desenvolva no seu branch bifurcado.
• Ao enviar um Pull Request (PR), forneça uma descrição detalhada das suas alterações.
• Se o seu PR não passar nas verificações automatizadas (indicado por checks failed e um "x" vermelho), revise os details correspondentes e modifique sua submissão para garantir que o novo PR passe em todas as verificações.

2. Desenvolvimento e Testes

• Use o comando pip install -e . para desenvolvimento e teste.

3. Formatação de Código

• Configure a ferramenta pre-commit e habilite black e flake8 para formatação de código.

4. Atualizações de Dependências

• Se você introduzir novas dependências, por favor atualize a lista de dependências no arquivo pyproject.toml em tempo hábil.

5. Atualizações da Documentação

• Se você adicionar novas opções de linha de comando, atualize a lista de opções de linha de comando em todas as versões de idioma do arquivo README.md de acordo.

6. Mensagens de Commit

• Use Conventional Commits, por exemplo: feat(translator): add openai.

7. Estilo de Codificação

• Certifique-se de que o código submetido adere aos padrões básicos de estilo de codificação.
• Use snake_case ou camelCase para nomeação de variáveis.

8. Formatação da Documentação

• Para a formatação de README.md, siga as Diretrizes de Redação em Chinês.
• Certifique-se de que a documentação em inglês e chinês esteja sempre atualizada; as atualizações da documentação em outros idiomas são opcionais.

Adicionando um mecanismo de tradução

1. Adicione uma nova classe de configuração do tradutor no arquivo pdf2zh/config/translate_engine_model.py.
2. Adicione uma instância da nova classe de configuração do tradutor ao alias de tipo TRANSLATION_ENGINE_SETTING_TYPE no mesmo arquivo.
3. Adicione a nova classe de implementação do tradutor na pasta pdf2zh/translator/translator_impl.

Estrutura do Projeto

• pasta config: Sistema de configuração.
• pasta translator: Implementações relacionadas ao tradutor.
• gui.py: Fornece a interface GUI.
• const.py: Algumas constantes.
• main.py: Fornece a ferramenta de linha de comando.
• high_level.py: Interfaces de alto nível baseadas no BabelDOC.
• http_api.py: Fornece API HTTP (não iniciada).

Peça à IA para entender o projeto: DeepWiki

Contate-nos

Se você tiver alguma dúvida, por favor, envie feedback via Issue ou entre no nosso Grupo do Telegram. Obrigado pela sua contribuição!