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文字列と、オリジナルおよび翻訳済みテキストのペアのリスト。