Contribuindo para o projeto

Obrigado pelo seu interesse neste projeto! Antes de começar a contribuir, 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. Internacionalização/tradução da documentação
2. Contribuições relacionadas à infraestrutura principal, como API HTTP, etc.
3. Problemas explicitamente marcados como "No help needed" (incluindo problemas nos repositórios Byaidu/PDFMathTranslate e PDFMathTranslate/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 mencionados acima.

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/<feature-name>.
3. Desenvolva e certifique-se de que seu código atenda aos requisitos.
4. Faça commit do seu código:

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

5. Envie para o seu repositório: git push origin feature/<feature-name>.
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 sejam aprovadas.

Requisitos básicos

1. Fluxo de trabalho

• Por favor, faça um fork a partir 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 cruz 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 Teste

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

3. Formatação de Código

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

4. Atualizações de Dependências

• Se você introduzir novas dependências, 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 enviado 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 de 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 de documentação em outros idiomas são opcionais.

Adicionando um mecanismo de tradução

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

Estrutura do Projeto

• config folder: Sistema de configuração.
• translator folder: 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).

Entre em contato conosco

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