AI（Mistral AI と Open AI）搭載のMarkdown翻訳スクリプトを、私のプロジェクトのREADME（GitLabのStable Diffusion）に対して使用していたところ、重大な問題に直面しました。一部のテキストが翻訳されていなかったり、いくつかのコードブロックが誤って翻訳されてしまったのです。本記事では、この重要な問題を解決するために行った改善について説明します。
発生した問題
Stable DiffusionのREADMEを翻訳する際、スクリプトが一部の箇所でコードブロックと通常のテキストを正しく区別できませんでした。これにより、変更されるべきではない内容が不適切に翻訳される事態が発生し、コードブロックの取り扱いをより厳密に行う必要性が浮き彫りになりました。
解決戦略
この問題を解決するため、スクリプトを改良して、AIによる翻訳の前にコードブロックを正確に検出して抽出し、翻訳後に正しく復元するようにしました。このアプローチにより、意図しない内容の改変を防ぎます。
改善の仕組み
- 正確な検出と抽出：改良した正規表現を用いることで、コードブロックを明確に識別し、翻訳前に抽出するようになりました。これによりコードブロックの改変を回避します。
- 適切な復元：翻訳後にコードブロックを元の位置へ再挿入することで、最終的なコンテンツの忠実性を保証します。
改善の利点
- コードブロックの保持：コードはそのまま保持され、技術的な正確性が保たれます。翻訳がコードブロックに影響を与えることはありません。
- 信頼性の向上：スクリプトはコードブロックを多く含む複雑なMarkdown文書を信頼して扱えるようになりました。翻訳は完全に自動化され、手作業での修正を不要にし、効率と速度を向上させます。
- より良い区別：コードブロック検出の改善により、翻訳すべきテキストと保持すべきコードブロックをより正確に区別できるようになりました。これにより翻訳ミスが減少し、より正確で一貫した結果が得られます。
翻訳の結果
改善の効果を確認するには、プロジェクトの元のフランス語READMEの翻訳版をご覧ください（翻訳内容はそれぞれのリンク先で確認できます）：
- 英語のREADME（gpt-4-1106-previewで翻訳、未編集）
- スペイン語のREADME（gpt-4-1106-previewで翻訳、未編集）
- 中国語のREADME（gpt-4-1106-previewで翻訳、未編集）
これらの翻訳は、改良されたスクリプトがコードブロックを効果的に扱い、さまざまな言語に対して正確で一貫した翻訳を提供できることを示しています。すべて手作業での修正は行っていません。
改良スクリプトへのアクセス
改良したスクリプトはプロジェクトで公開しています：AI搭載Markdown翻訳ツール。利用や改変はニーズに合わせて可能です。
新機能と改善点
コードブロックの検出と管理の改善に加えて、AI搭載Markdown翻訳スクリプトにはいくつかの更新と改良が加えられました。以下は新機能の概要です。
出力ファイルの改善された管理
スクリプトは翻訳を開始する前に出力ファイルの存在を確認するようになりました。出力ファイルが既に存在し、かつオプション --force が有効でない場合、スクリプトは翻訳を行わず次のファイルに進む旨のメッセージを表示します。これにより重複した翻訳を避け、時間を節約できます。
既存ファイル検出の改善
既存ファイルの検出は glob ライブラリを使用して改善されました。スクリプトは、使用されたモデルに関係なく、元ファイルの基本名とターゲット言語に対応するファイルを検索して、既に翻訳が存在するかどうかを確認します。
出力ファイル名におけるモデルと言語の反転
出力ファイル名の形式を、ターゲット言語と使用モデルをより明確に反映するように変更しました。これにより、出力ファイル名は以前の {base}-{modèle}-{langue_cible}.md 形式ではなく、{base}-{langue_cible}-{modèle}.md 形式になります。
オプション --force の追加
新しいオプション --force がスクリプトに追加されました。これを有効にすると、入力ファイルに対して既に翻訳が存在する場合でも強制的に翻訳を行います。新しいモデルで翻訳を更新したい場合や、翻訳パラメータを変更したい場合に便利です。
これらの改善と新機能により、AI搭載のMarkdown翻訳スクリプトはさらに強力で柔軟になり、Markdownドキュメントの管理と翻訳が容易になります。
結論
今回のアップデートは、Markdown翻訳ツールにとって大きな前進です。技術文書を扱う能力が拡張され、オープンソースプロジェクトへのアクセスを世界中のユーザーにとってより容易にすることを目指しています。
今後も生成AIと自動化の分野でのさらなる更新とイノベーションにご期待ください！
このドキュメントは gpt-5-mini モデルを使用して fr バージョンから ja 言語に翻訳されました。翻訳プロセスの詳細については、https://gitlab.com/jls42/ai-powered-markdown-translator をご覧ください。