Auto i18n

Auto-I18N : Chatgpt를 사용한 자동 다국어 번역 도구

Auto-I18N은 Markdown 파일을 Chatgpt를 사용하여 다국어로 자동으로 변환하는 도구입니다. 블로그 게시물 i18N (국제화)의 전체 자동화를 구현합니다. GitHub 동작이있는 여러 언어로 자동으로 번역하려면 블로그 게시물을 GitHub 저장소로 푸시하면됩니다. (영어, 스페인어 및 아랍어는 현재 지원되며 향후 더 많은 언어 지원이 제공 될 것입니다)

Auto-I18N의 주요 특징 :

• 배치 다국어 번역 : Auto-I18N은 배치 번역 기능을 제공하여 모든 Markdown 문서를 한 번에 전체 경로로 한 번에 변환 할 수 있으므로 다국어 프로젝트의 효율성을 크게 향상시킵니다.
• Front Matter : Auto-I18N Markdown Front Matter 구문과 호환되면 다른 필드에 대한 번역 또는 교체 규칙을 사용자 정의 할 수 있습니다.
• 고정 컨텐츠 교체 : Auto-I18N은 고정 컨텐츠 교체도 지원합니다. 문서의 일부 중복 필드의 변환이 변경되지 않은 상태로 유지하려면이 기능을 사용하면 일관된 문서를 달성하는 데 도움이 될 수 있습니다.
• 자동화 된 워크 플로 : GitHub 동작을 사용하여 자동 번역 프로세스를 구현할 수 있습니다. 수동 개입이 없으면 번역 작업은 자동으로 문서를 진행하고 업데이트하여 콘텐츠에 더 집중할 수 있습니다.

빨리 시작하십시오

1. 로컬로 리포지토리를 복제하고 env_template.py env.py 로 바꾸고 chatgpt API를 제공합니다. 자신의 API가없는 경우 GPT_API_FREE에서 무료 API를 신청할 수 있습니다. go-chatgpt-api를 사용하여 chatgpt의 웹 버전을 API로 변환 할 수도 있습니다.
2. 필요한 모듈을 설치하십시오 : pip install -r requirements.txt .
3. python auto-translater.py 명령을 실행하여 프로그램을 실행하여 테스트 디렉토리 testdir/to-translate 에서 모든 Markdown 파일을 자동으로 처리하고 Batch를 영어, 스페인어 및 아랍어로 번역합니다. (앞으로 더 많은 언어 지원이 제공 될 것입니다)

자세한 설명

auto-translater.py 프로그램의 실행되는 논리는 다음과 같습니다.

1. 이 프로그램은 테스트 디렉토리 testdir/to-translate 의 모든 Markdown 파일을 자동으로 처리합니다. exclude_list 변수로 번역 할 필요가없는 파일을 제외 할 수 있습니다.
2. 처리 된 파일 이름은 자동으로 생성 된 processed_list.txt 에 기록됩니다. 다음에 프로그램이 실행될 때 처리 된 파일은 다시 번역되지 않습니다.
3. 원래 영어로 작성된 기사의 경우이 프로그램은 영어로 다시 전환하지 않으며 중국어로 다시 번역되지 않지만 다른 언어로 번역됩니다. 기사에 필드를 추가해야합니다 > This post was originally written in English. (프로그램이 인식하기 위해 각 상단과 하단에 빈 줄이 있습니다). 테스트 article_en.md를 참조하십시오.
4. 지정된 기사를 다시 변환 해야하는 경우 (예 : 번역 결과가 부정확하거나 기사의 내용이 변경된 등) 기사에 필드 [translate] 추가 할 수 있습니다 (또한 상단 및 하단에 빈 줄을 남겨 두어야 함). 이것은 exclude_list 및 processed_list 규칙을 무시하고 번역 처리를 강제로 무시합니다. 테스트 article_force-mark.md를 참조하십시오.
5. Markdown 파일에 Front Matter가 포함되어 있으면 다음 처리 방법이 프로그램의 규칙에 따라 front_matter_translation_rules 선택합니다.
   1. 자동 번역 : Chatgpt에 의해 번역. 기사 제목 또는 기사 설명 필드에 적용됩니다.
   2. 고정 필드 교체 : 카테고리 또는 레이블 필드에 적용됩니다. 예를 들어, 동일한 중국 레이블 이름이 다른 영어 레이블로 변환되기를 원하지 않으면 인덱스 오류가 발생합니다.
   3. 처리가 완료되지 않습니다 : 위의 두 규칙에 필드가 나타나지 않으면 원래 텍스트가 유지되고 처리가 수행되지 않습니다. 현재까지 적용 가능, URL 등

GitHub 액션 자동화 안내서

프로젝트 저장소에서 .github/workflows/ci.yml 만들 수 있습니다. GitHub 저장소가 감지되면 GitHub 작업을 사용하여 자동으로 번역 및 처리하고 자동으로 원래 저장소로 다시 커밋 할 수 있습니다.

ci.yml 의 내용은 템플릿으로 참조 할 수 있습니다 : ci_template.yml

저장소 Settings 에 Secrets and variables - Repository secrets : CHATGPT_API_BASE 및 CHATGPT_API_KEY auto-translater.py import env 가지 비밀을 추가해야합니다.

오류 문제 해결

1. ChatGpt API 키의 가용성을 확인 해야하는 경우 프로그램 verify-api-key.py를 사용하여 테스트 할 수 있습니다. 국가에서 공식 API를 사용하는 경우 현지 대리가 있어야합니다.
2. Markdown의 Front Matter를 정상적으로 인식 할 수없는 경우 Detect_front_matter.py를 사용하여 테스트 할 수 있습니다.
3. GitHub 조치를 사용하여 문제가 발생하면 경로 참조가 올바른지 확인하는 우선 순위를 정하십시오 (예 : dir_to_translate dir_translated_en dir_translated_es dir_translated_ar processed_list ).

해결해야 할 문제

1. 일부 특별한 상황에서는 번역이 부정확하거나 일부 필드가 번역되지 않을 수 있습니다. 번역 후 기사를 수동으로 확인하는 것이 좋습니다.
2. (해결) Front Matter가 Markdown에 포함되면 Front Matter의 원래 내용이 유지됩니다. 전면 문제 일부 매개 변수 변환 기능이 개발 중입니다.

기여하다

이 프로젝트의 개선에 참여하는 데 오신 것을 환영합니다! 코드를 기여하거나 질문을보고하거나 제안을하려면 기여 가이드를 확인하십시오.

저작권 및 라이센스

이 프로젝트는 MIT 라이센스를 채택합니다.

질문과 지원

Auto-I18N과 관련된 문제가 있거나 기술 지원이 필요한 경우 자유롭게 문제를 제출하십시오.

내 블로그는 Auto-I18N을 사용하여 다국어 지원을 구현하며 Power 's Wiki로 이동하여 데모 효과를 볼 수 있습니다.

감사의 말

• 무료 chatgpt API 키에 대한 chatanywhere/gpt_api_free에 감사드립니다.
• 웹에서 chatgpt를 API로 변환하는 메소드를 위해 Linweiyuan/Go-Chatgpt-API 덕분에 감사합니다.