translate_backends プログラム仕様

Format-aware translation backends for HTML, Markdown, and reStructuredText.

このモジュールは、HTML、Markdown、およびreStructuredTextドキュメントの形式を考慮した翻訳バックエンドを提供します。 構造化されたテキストコンテンツ(HTMLタグ、Markdown/RSTの書式、コードブロックなど)を保護しつつ、 表示可能なテキストや散文のみを翻訳します。これにより、翻訳後も元のドキュメントの構造と機能が維持されます。

技術ドキュメント: translate_backends.py

translate_backends.translate_html_document(html, prompt, cfg)

HTMLドキュメント内の表示可能なテキストを翻訳します。

BeautifulSoupを使用してHTMLを解析し、スクリプト、スタイル、プリフォーマットされたコードなどの 特定のタグ内のコンテンツを除く、すべてのテキストノードを走査します。 各テキストノードは _translate_block を使用して翻訳されます。 HTMLの構造は維持されます。

パラメータ:
  • html -- str: 翻訳するHTML文字列。

  • prompt -- str: 翻訳プロンプト。

  • cfg -- configparser.SectionProxy: 翻訳設定を含む設定オブジェクト。

戻り値:

tuple[str, list[dict]]: 翻訳されたHTML文字列と、オリジナルおよび翻訳済みテキストのペアのリスト。

translate_backends.translate_markdown_document(text, prompt, cfg)

Markdownドキュメント内のプロース(散文)を翻訳します。

Markdownのフロントマター(---で囲まれた部分)、コードフェンス(```または~~~)、 インデントされたコードブロック、およびHTMLコメントをスキップし、 Markdownのインライン書式を保護しながらテキスト行を翻訳します。

パラメータ:
  • text -- str: 翻訳するMarkdown文字列。

  • prompt -- str: 翻訳プロンプト。

  • cfg -- configparser.SectionProxy: 翻訳設定を含む設定オブジェクト。

戻り値:

tuple[str, list[dict]]: 翻訳されたMarkdown文字列と、オリジナルおよび翻訳済みテキストのペアのリスト。

translate_backends.translate_rst_document(text, prompt, cfg)

reStructuredText (RST) ドキュメント内のプロース(散文)を翻訳します。

Sphinxディレクティブ (例: .. note::)、参照定義 (例: .. _label:)、 フィールドリスト、セクションタイトル区切り線、およびリテラルブロックを保護しつつ、 RSTのインライン書式を考慮しながらテキスト行を翻訳します。

パラメータ:
  • text -- str: 翻訳するreStructuredText文字列。

  • prompt -- str: 翻訳プロンプト。

  • cfg -- configparser.SectionProxy: 翻訳設定を含む設定オブジェクト。

戻り値:

tuple[str, list[dict]]: 翻訳されたreStructuredText文字列と、オリジナルおよび翻訳済みテキストのペアのリスト。