Jupyter Notebook(.ipynb)翻訳:コードはそのまま動かせて、マークダウンはきちんと読めますか?
現状の主要診断
“データ分析レポートは通常、実行可能なコード・実行結果・マークダウンによる説明テキストが混在しており、すべてを翻訳するとコードが動作しなくなったり、出力結果が改変されたりする場合があります。”
根本原因の分析
1
セルタイプのインテリジェントな分岐
商訳AIは、JSON構造の`cell_type`フィールドに基づき分岐します:`markdown`セルは翻訳エンジンに送り、`code`セルは厳密に固定します。`raw`セルについては、必要に応じてユーザーが翻訳するかどうかを選択できます。
2
Markdown セル内の数式保護
Markdown セルには、しばしば LaTeX 形式の数式(例:`$E=mc^2$`)が含まれます。AI エンジンは `$` という区切り記号を認識し、その中身を「不変トークン」として扱い、数式の周囲の解説文のみを翻訳します。
3
出力(Output)データのクレンジング
通常、アップロード前に出力を消去することを推奨しますが、テキスト型出力(エラーログや print 結果など)が含まれる場合、AI は設定に応じて自然言語部分のみを翻訳し、Traceback の構造を維持します。
最終ソリューションまとめ
Kaggle コンペティションの共有や教育用ノートのローカライズ要件に完全に適合し、コードのロジックと説明文書が常に同期されることを保証します。