GitLab에 있는 제 프로젝트 Stable Diffusion sur GitLab의 README를 AI 기반 마크다운 번역 스크립트(Mistral AI 및 Open AI)로 번역하는 동안, 저는 심각한 문제를 발견했습니다. 텍스트의 일부가 번역되지 않았고 일부 코드 블록은 잘못 번역되었습니다. 이 글은 이 심각한 문제를 해결하기 위해 도입한 개선을 소개합니다.
직면한 문제
Stable Diffusion의 README를 번역할 때, 스크립트가 특정 위치에서 코드 블록과 일반 텍스트를 제대로 구분하지 못했습니다. 이로 인해 변경되지 않아야 할 내용이 부적절하게 번역되어 코드 블록 처리를 보다 정교하게 해야 할 필요가 드러났습니다.
해결 전략
이 문제를 해결하기 위해, 번역 전에 코드 블록을 정확히 식별하고 추출한 후 AI로 번역한 뒤 올바르게 복원하도록 스크립트를 개선했습니다. 이 접근법은 원치 않는 내용 변형을 방지합니다.
개선 메커니즘
- 정확한 식별 및 추출 : 향상된 정규식 덕분에 코드 블록이 이제 명확히 식별되어 번역 전에 추출되므로 변형을 방지합니다.
- 적절한 복원 : 번역 후 코드 블록을 원래 위치에 재삽입하여 최종 콘텐츠의 충실도를 보장합니다.
개선의 장점
- 코드 블록 보존 : 코드가 그대로 유지되어 기술적 정확성을 보장합니다. 번역이 더 이상 코드 블록을 훼손하지 않아 기술 문서의 무결성이 유지됩니다.
- 신뢰성 향상 : 스크립트가 이제 중요한 코드 블록을 포함한 복잡한 마크다운 문서를 신뢰성 있게 처리합니다. 번역은 완전히 자동화되어 수동 수정이 필요하지 않아 효율성과 속도가 향상됩니다.
- 더 나은 구분 능력 : 코드 블록 감지의 향상으로 번역 대상 텍스트와 보존해야 할 코드 블록을 더 잘 구분할 수 있게 되었습니다. 이는 번역 오류를 줄이고 보다 정확하고 일관된 결과를 보장합니다.
번역 결과
개선 사항을 직접 확인하려면 프로젝트의 원문 README 번역 버전들을 살펴보세요 :
- 영어 README (gpt-4-1106-preview로 번역, 전혀 손대지 않음)
- 스페인어 README (gpt-4-1106-preview로 번역, 전혀 손대지 않음)
- 중국어 README (gpt-4-1106-preview로 번역, 전혀 손대지 않음)
이 번역들은 개선된 스크립트가 코드 블록을 효과적으로 처리하고 다양한 언어에 대해 정확하고 일관된 번역을 제공할 수 있음을 보여줍니다. 모두 수동 수정 없이 이루어졌습니다.
개선된 스크립트 접근
개선된 스크립트는 프로젝트 AI-Powered Markdown Translator에서 확인할 수 있으며, 필요에 따라 사용하거나 수정할 수 있습니다.
새로운 기능 및 개선 사항
코드 블록 감지 및 처리 개선 외에도, AI 기반 마크다운 번역 스크립트에는 여러 업데이트와 개선이 적용되었습니다. 다음은 새로운 기능의 개요입니다 :
출력 파일 처리 개선
스크립트는 이제 번역을 시작하기 전에 출력 파일의 존재 여부를 확인합니다. 출력 파일이 이미 존재하고 옵션 --force이 활성화되지 않은 경우, 스크립트는 번역을 수행하지 않고 다음 파일로 넘어간다는 메시지를 표시합니다. 이를 통해 중복 번역을 방지하고 시간을 절약할 수 있습니다.
기존 파일 감지 향상
기존 파일 감지는 glob 라이브러리를 사용하여 개선되었습니다. 스크립트는 이제 번역이 이미 존재하는지, 사용된 모델과 관계없이 원본 파일의 기본 이름과 대상 언어에 해당하는 파일을 검색하여 확인합니다.
출력 파일명에서 모델과 언어 반전
출력 파일명 형식이 대상 언어와 사용된 모델을 더 잘 반영하도록 변경되었습니다. 이제 출력 파일명은 {base}-{langue_cible}-{modèle}.md 형식이 되며 이전의 {base}-{modèle}-{langue_cible}.md 대신 사용됩니다.
--force 옵션 추가
새로운 옵션 --force가 스크립트에 추가되었습니다. 이 옵션이 활성화되면 입력 파일에 대해 이미 번역이 존재하더라도 강제로 번역을 수행합니다. 이는 최신 모델로 번역을 업데이트하거나 번역 설정을 변경하려는 경우에 유용합니다.
이러한 개선과 새로운 기능들은 AI 기반 마크다운 번역 스크립트를 더욱 강력하고 유연하게 만들어 마크다운 문서의 관리 및 번역을 용이하게 합니다.
결론
이번 업데이트는 마크다운 번역 도구에 있어 중요한 진전으로, 기술 문서를 처리하는 능력을 확장합니다. 이 도구를 지속적으로 개선함으로써 오픈 소스 프로젝트를 전 세계 청중이 더 쉽게 접근할 수 있도록 하는 것이 목표입니다.
생성형 AI와 자동화의 흥미로운 세계에서 더 많은 업데이트와 혁신을 기대해 주세요!
이 문서는 gpt-5-mini 모델을 사용하여 프랑스어 버전(fr)에서 한국어(ko)로 번역되었습니다. 번역 과정에 대한 자세한 정보는 https://gitlab.com/jls42/ai-powered-markdown-translator