translate_url プログラム仕様
HTMLページを取得し、そのテキストノードをDeepLまたはLLMで翻訳します。
このスクリプトは、指定されたURLからHTMLコンテンツをフェッチし、その中のテキストノードを 設定された翻訳API(DeepL、OpenAI、Gemini、LM Studio)を使用して翻訳します。 翻訳結果は新しいHTMLファイルとして保存されます。
参考
translate_url.py Documentation (利用ガイドラインや詳細な使用例はこちら)
- translate_url.build_parser()
コマンドライン引数を解析するためのArgumentParserを設定します。
- 戻り値:
設定されたArgumentParserオブジェクト。
- 戻り値の型:
- translate_url.fetch_html(url, encoding, timeout)
指定されたURLからHTMLコンテンツを取得します。
HTTP GETリクエストを実行し、リダイレクトを処理します。 また、文字エンコーディングを自動検出するか、指定されたエンコーディングを強制的に適用します。
- translate_url.main()
スクリプトのエントリポイント関数。
コマンドライン引数を解析し、翻訳設定を解決します。 その後、指定されたURLからHTMLを取得し、その内容を翻訳し、結果をファイルに保存します。 必要なAPIキーやモデルが設定されていない場合はエラーで終了します。
- translate_url.output_path(url, requested)
翻訳済みHTMLの出力パスを決定します。
指定された出力パスがある場合はそれを直接使用し、ない場合は元のURLから ファイル名を生成します。生成されるファイル名には"_en"サフィックスを追加します。
- パラメータ:
- 戻り値:
翻訳済みHTMLの出力パス。
- 戻り値の型:
- translate_url.resolve_config(args)
コマンドライン引数と環境変数から翻訳設定を解決・構成します。
.envファイルから設定を読み込み、選択されたAPIに応じたデフォルトモデルを設定し、 最終的な翻訳設定オブジェクトを構築します。
- パラメータ:
args (argparse.Namespace) -- コマンドライン引数。
- 戻り値:
構成された翻訳設定オブジェクト。
- 戻り値の型:
- translate_url.translate_html(html, prompt, cfg, quiet=False)
取得したHTMLコンテンツのテキストノードを翻訳します。
translate_html_document 関数を使用して、HTMLドキュメント内の翻訳対象テキストノードを走査し、 設定されたAPI(DeepLまたはLLM)で翻訳を実行します。