translate_url プログラム仕様

HTMLページを取得し、そのテキストノードをDeepLまたはLLMで翻訳します。

このスクリプトは、指定されたURLからHTMLコンテンツをフェッチし、その中のテキストノードを 設定された翻訳API(DeepL、OpenAI、Gemini、LM Studio)を使用して翻訳します。 翻訳結果は新しいHTMLファイルとして保存されます。

参考

translate_url.py Documentation (利用ガイドラインや詳細な使用例はこちら)

translate_url.build_parser()

コマンドライン引数を解析するためのArgumentParserを設定します。

戻り値:

設定されたArgumentParserオブジェクト。

戻り値の型:

argparse.ArgumentParser

translate_url.fetch_html(url, encoding, timeout)

指定されたURLからHTMLコンテンツを取得します。

HTTP GETリクエストを実行し、リダイレクトを処理します。 また、文字エンコーディングを自動検出するか、指定されたエンコーディングを強制的に適用します。

パラメータ:
  • url (str) -- 取得するURL。

  • encoding (str) -- 強制的に適用する文字エンコーディング。空の場合は自動検出。

  • timeout (float) -- HTTPリクエストのタイムアウト時間(秒)。

戻り値:

取得したHTMLテキストと最終的なURLのタプル。

戻り値の型:

tuple[str, str]

例外:

requests.exceptions.RequestException -- HTTPリクエストが失敗した場合。

translate_url.main()

スクリプトのエントリポイント関数。

コマンドライン引数を解析し、翻訳設定を解決します。 その後、指定されたURLからHTMLを取得し、その内容を翻訳し、結果をファイルに保存します。 必要なAPIキーやモデルが設定されていない場合はエラーで終了します。

translate_url.output_path(url, requested)

翻訳済みHTMLの出力パスを決定します。

指定された出力パスがある場合はそれを直接使用し、ない場合は元のURLから ファイル名を生成します。生成されるファイル名には"_en"サフィックスを追加します。

パラメータ:
  • url (str) -- 元のHTMLページのURL。

  • requested (str or None) -- ユーザーが指定した出力パス。指定がない場合はNone。

戻り値:

翻訳済みHTMLの出力パス。

戻り値の型:

pathlib.Path

translate_url.resolve_config(args)

コマンドライン引数と環境変数から翻訳設定を解決・構成します。

.envファイルから設定を読み込み、選択されたAPIに応じたデフォルトモデルを設定し、 最終的な翻訳設定オブジェクトを構築します。

パラメータ:

args (argparse.Namespace) -- コマンドライン引数。

戻り値:

構成された翻訳設定オブジェクト。

戻り値の型:

types.SimpleNamespace

translate_url.translate_html(html, prompt, cfg, quiet=False)

取得したHTMLコンテンツのテキストノードを翻訳します。

translate_html_document 関数を使用して、HTMLドキュメント内の翻訳対象テキストノードを走査し、 設定されたAPI(DeepLまたはLLM)で翻訳を実行します。

パラメータ:
  • html (str) -- 翻訳対象のHTML文字列。

  • prompt (str) -- LLM翻訳に使用するプロンプトテンプレート。DeepLの場合は無視されます。

  • cfg (types.SimpleNamespace) -- 翻訳設定オブジェクト。

  • quiet (bool) -- 翻訳されたテキストノードを標準出力に表示しない場合はTrue。

戻り値:

翻訳済みHTML文字列と翻訳データ(詳細は`translate_html_document`による)のタプル。

戻り値の型:

tuple[str, Any]