translate5.py ダウンロード/コピー

translate5.py をダウンロード

translate5.py
translate5.py
   1"""
   2translate5.py - ドキュメント翻訳・校正ツール
   3
   4このモジュールは、さまざまなファイル形式(.docx, .pptx, .pdf, .html, .md, .rst, .txt)に対応し、
   5AIモデル(OpenAI, Gemini, LM Studio, DeepL)を使用して文書の翻訳および校正を行う
   6コマンドラインツールを提供します。
   7多言語対応、翻訳単位の選択、プロンプトのカスタマイズなどの高度な機能が含まれています。
   8
   9:doc:`translate5_usage`
  10"""
  11import os
  12import sys
  13import argparse
  14import time
  15import re
  16from pathlib import Path
  17from types import SimpleNamespace
  18from urllib.parse import urlparse
  19from configparser import ConfigParser
  20
  21missing = []
  22for lib in [
  23    "chardet",
  24    "bs4",
  25    "jinja2",
  26    "html2text",
  27    "pdf2docx",
  28    "docx",
  29    "pptx",
  30    "markitdown",
  31]:
  32    try:
  33        __import__(lib)
  34    except ImportError:
  35        missing.append(lib)
  36
  37if missing:
  38    print(f"Error: Missing libraries:\n{', '.join(missing)}")
  39    input("\nPress ENTER to terminate>>\n")
  40    sys.exit(1)
  41
  42import chardet
  43from bs4 import BeautifulSoup
  44from jinja2 import Environment, FileSystemLoader
  45import html2text
  46
  47from pdf2docx import Converter
  48from docx import Document
  49from pptx import Presentation
  50from pptx.enum.shapes import MSO_SHAPE_TYPE
  51from markitdown import MarkItDown
  52
  53# LLMへの問い合わせは、OpenAI / Gemini / LM Studioを共通に扱う。
  54from tkai_lib_litellm import read_ai_config, query_ai, query_ai_compatible, extract_text
  55from translate_core import configure_translation_cfg, translate as translate_core
  56from translate_backends import (
  57    translate_html_document,
  58    translate_markdown_document,
  59    translate_rst_document,
  60)
  61
  62
  63#=========================================================
  64# 初期化
  65#=========================================================
  66
  67parser = None
  68
  69
  70def initialize():
  71    """
  72    プログラムの設定を初期化し、コマンドライン引数を定義します。
  73
  74    SimpleNamespaceオブジェクトで設定を管理し、argparseで多数のCLI引数を設定します。
  75    APIキーやモデル、翻訳モード、処理単位などの詳細な設定が含まれます。
  76
  77    :returns:
  78        tuple[types.SimpleNamespace, argparse.ArgumentParser]:
  79            - `cfg`: プログラム設定を含むSimpleNamespaceオブジェクト。
  80            - `p`: コマンドライン引数パーサー。
  81    """
  82    cfg = SimpleNamespace()
  83    cfg.config_path = "translate5.env"
  84    cfg.common_config_path = "ai.env"
  85
  86    # APIキーや共通設定は従来どおり .env / ai.env から
  87    read_ai_config(cfg.config_path, read_account_inf=False)
  88    read_ai_config(cfg.common_config_path)
  89
  90    p = argparse.ArgumentParser(description="Translate/Revise .docx/.pptx/.pdf/.html/.md")
  91
  92    p.add_argument("--mode", default="je", help="Translation mode (je, ej, jj, etc.)")
  93    p.add_argument(
  94        "--infile", "-i",
  95        default="translate_test.docx",
  96        help="Input file (.docx/.pptx/.pdf/.html/.md/.rst/.txt)",
  97    )
  98    p.add_argument(
  99        "--output_html_path",
 100        default=None,
 101        help="Path for the output HTML file (comparison report, optional)",
 102    )
 103    p.add_argument(
 104        "--html_template_path",
 105        default="template_translate.html",
 106        help="Path to the HTML template file for comparison report",
 107    )
 108
 109    p.add_argument(
 110        "--api",
 111        default="openai5",
 112        choices=["openai", "gemini", "lmstudio", "deepl", "openai5", "google"],
 113        help="Translation API to use",
 114    )
 115    p.add_argument("--model", default=None, help="Override API model")
 116    p.add_argument("--endpoint", default=os.getenv("endpoint"), help="API endpoint")
 117
 118    p.add_argument(
 119        "--max_tokens",
 120        type=int,
 121        default=int(os.getenv("max_tokens", "2000")),
 122        help="Maximum number of tokens / output length",
 123    )
 124    p.add_argument(
 125        "--openai_api_key",
 126        default=os.getenv("OPENAI_API_KEY"),
 127        help="OpenAI API key",
 128    )
 129    p.add_argument(
 130        "--openai_model",
 131        default=os.getenv("openai_model", "gpt-4o"),
 132        help="OpenAI model to use",
 133    )
 134    p.add_argument(
 135        "--temperature",
 136        type=float,
 137        default=float(os.getenv("temperature", "0.3")),
 138        help="Sampling temperature",
 139    )
 140    p.add_argument(
 141        "--openai_model5",
 142        default=os.getenv("openai_model5", "gpt-5.2"),
 143        help="OpenAI GPT-5 model",
 144    )
 145    p.add_argument(
 146        "--reasoning-effort", "--reasoning_effort",
 147        dest="reasoning_effort",
 148        default=os.getenv("reasoning_effort", "low"),
 149        help=(
 150            "Reasoning effort. For LM Studio Qwen3.8: low, medium, xhigh "
 151            "(default: low)"
 152        ),
 153    )
 154    p.add_argument(
 155        "--google_api_key",
 156        default=os.getenv("GOOGLE_API_KEY"),
 157        help="Google API key",
 158    )
 159    p.add_argument(
 160        "--google_model",
 161        default=os.getenv("google_model", "gemini-2.5-flash"),
 162        help="Google/Gemini model to use",
 163    )
 164    p.add_argument(
 165        "--lmstudio_model",
 166        default=os.getenv("lmstudio_model") or os.getenv("LMSTUDIO_MODEL"),
 167        help="LM Studio model to use when --api lmstudio",
 168    )
 169    p.add_argument(
 170        "--deepl_api_key",
 171        default=os.getenv("DEEPL_API_KEY"),
 172        help="DeepL API key",
 173    )
 174
 175    p.add_argument(
 176        "--force_server_charcode",
 177        default=os.getenv("force_server_charcode", "utf-8"),
 178        help="force_server_charcode",
 179    )
 180    p.add_argument(
 181        "--tsleep_rpm",
 182        type=float,
 183        default=0.5,
 184        help="Sleep time to avoid rpm (seconds)",
 185    )
 186
 187    p.add_argument("--use_md", action="store_true", help="Convert to markdown and process")
 188    p.add_argument(
 189        "--limit_to_multibyte_str",
 190        action="store_true",
 191        help="When set, only translate text containing multibyte chars (e.g. Japanese)",
 192    )
 193
 194    p.add_argument(
 195        "--process_unit",
 196        default="paragraph",
 197        choices=["paragraph", "run"],
 198        help="Unit of processing for docx/pptx/html",
 199    )
 200    p.add_argument(
 201        "--min_translate_length",
 202        type=int,
 203        default=int(os.getenv("min_translate_length", "5")),
 204        help="Minimum length of text to translate",
 205    )
 206    p.add_argument(
 207        "--allowed_translation_length_ratio",
 208        type=float,
 209        default=float(os.getenv("allowed_translation_length_ratio", "5.0")),
 210        help="Max allowed ratio (translated_len / original_len)",
 211    )
 212
 213    # ★ CLI からは prompt 本文のみ上書き可能(roleは統合済み)
 214    p.add_argument(
 215        "--translate_prompt",
 216        type=str,
 217        default="",
 218        help="Override translation prompt (full instructions incl. 'あなたは〜').",
 219    )
 220    p.add_argument(
 221        "--reformat_prompt",
 222        type=str,
 223        default="",
 224        help="Override reformat prompt (full instructions).",
 225    )
 226
 227    return cfg, p
 228
 229
 230def _prompt_from_section(cp: ConfigParser, section: str) -> str | None:
 231    """
 232    ConfigParserから指定されたセクションのプロンプトを読み込みます。
 233
 234    既存の`role`と`prompt`の構文を維持し、それらを結合して単一のプロンプト文字列を生成します。
 235    `role`のみが存在する場合も考慮します。
 236
 237    :param cp: プロンプト設定が格納されたConfigParserオブジェクト。
 238    :type cp: configparser.ConfigParser
 239    :param section: 読み込むセクション名。
 240    :type section: str
 241    :returns: 結合されたプロンプト文字列、またはセクションが存在しない場合はNone。
 242    :rtype: str or None
 243    """
 244    if not cp.has_section(section):
 245        return None
 246    role_val = cp.get(section, "role", fallback="").strip()
 247    prompt_val = cp.get(section, "prompt", fallback="").lstrip("\n")
 248    if role_val and prompt_val:
 249        return (role_val + "\n" + prompt_val).strip()
 250    return prompt_val.strip() or role_val or None
 251
 252
 253def _default_translate_prompt(mode: str) -> str:
 254    """
 255    指定された翻訳モードに対応するデフォルトの翻訳プロンプトを生成します。
 256
 257    翻訳の方向(例: `je` = 日本語から英語)に応じて、プロンプトのターゲット言語を調整します。
 258    AIアシスタントに専門的な文書翻訳の条件を指示します。
 259
 260    :param mode: 翻訳モード(例: "je", "ej")。
 261    :type mode: str
 262    :returns: デフォルトの翻訳プロンプト文字列。
 263    :rtype: str
 264    """
 265    target = "自然な米国英語" if mode == "je" else "自然で専門的な日本語"
 266    return (
 267        "あなたは専門的な文書を正確かつプロフェッショナルに翻訳・校正するアシスタントです。\n"
 268        f"以下の条件を守り、*#翻訳してほしいテキスト*以降のテキストを{target}に翻訳してください。\n"
 269        "条件1:元の意味を変えない。テキストに書かれていない解釈・内容は追加しない。\n"
 270        "条件2:文字数を大きく増やさない(目安 ±30%)。\n"
 271        "条件3:動詞を含まない短いフレーズはスライド見出しとして扱い、完全な文にしない。\n"
 272        "条件4:数式・記号・固有名詞・プレースホルダは可能な限り保持する。\n"
 273        "{{additional_prompt}}\n\n#翻訳してほしいテキスト\n{{text}}"
 274    )
 275
 276
 277def load_prompt_config_from_ini(args: argparse.Namespace, cfg: SimpleNamespace) -> SimpleNamespace:
 278    """
 279    `translate5.ini` ファイルからプロンプト設定を読み込み、CLI引数やデフォルト値と結合します。
 280
 281    `translate5.ini` をカレントディレクトリ、入力ファイルディレクトリ、スクリプトディレクトリの順に探し、
 282    見つかった場合は `[translate]`, `[translate_je]`, `[translate_ej]`, `[reformat]` セクションから
 283    プロンプトを読み込みます。CLI引数が最優先され、次にINIファイル、最後に組み込みデフォルトプロンプトが適用されます。
 284
 285    :param args: コマンドライン引数オブジェクト。
 286    :type args: argparse.Namespace
 287    :param cfg: 現在の設定オブジェクト。
 288    :type cfg: types.SimpleNamespace
 289    :returns: プロンプト設定が更新された設定オブジェクト。
 290    :rtype: types.SimpleNamespace
 291    """
 292
 293    ini_name = "translate5.ini"
 294    candidate_paths = []
 295
 296    # 1. 作業ディレクトリ
 297    candidate_paths.append(os.path.join(os.getcwd(), ini_name))
 298
 299    # 2. 入力ファイルディレクトリ
 300    if getattr(args, "infile", None):
 301        infile_abs = os.path.abspath(args.infile)
 302        infile_dir = os.path.dirname(infile_abs)
 303        candidate_paths.append(os.path.join(infile_dir, ini_name))
 304
 305    # 3. スクリプトディレクトリ
 306    script_dir = os.path.dirname(os.path.abspath(__file__))
 307    candidate_paths.append(os.path.join(script_dir, ini_name))
 308
 309    ini_path = None
 310    for p in candidate_paths:
 311        if os.path.isfile(p):
 312            ini_path = p
 313            break
 314
 315    translate_prompts_ini = {}
 316    reformat_prompt_ini = None
 317
 318    if ini_path:
 319        print(f"  Using prompt config file: {ini_path}")
 320        cp = ConfigParser()
 321        cp.read(ini_path, encoding="utf-8")
 322
 323        # Direction-specific sections are preferred.  [translate] remains a
 324        # backward-compatible fallback for old INI files.
 325        fallback_prompt = _prompt_from_section(cp, "translate")
 326        for mode in ("je", "ej"):
 327            translate_prompts_ini[mode] = (
 328                _prompt_from_section(cp, f"translate_{mode}") or fallback_prompt
 329            )
 330
 331        # [reformat]
 332        if cp.has_section("reformat"):
 333            role_val = cp.get("reformat", "role", fallback="").strip()
 334            prompt_val = cp.get("reformat", "prompt", fallback="")
 335            prompt_val = prompt_val.lstrip("\n")
 336            if role_val and prompt_val:
 337                reformat_prompt_ini = (role_val + "\n" + prompt_val).strip()
 338            elif prompt_val:
 339                reformat_prompt_ini = prompt_val.strip()
 340            elif role_val:
 341                reformat_prompt_ini = role_val
 342    else:
 343        print("  translate5.ini not found. Using built-in default prompts.")
 344
 345    # ---- 組込みデフォルト (role+prompt一体型) ----
 346
 347    for mode in ("je", "ej"):
 348        if not translate_prompts_ini.get(mode):
 349            translate_prompts_ini[mode] = _default_translate_prompt(mode)
 350
 351    if not reformat_prompt_ini:
 352        reformat_prompt_ini = (
 353            "あなたは専門的な英語文書を、内容を変えずに読みやすく整形するアシスタントです。\n"
 354            "以下の*#テキスト*以降は PDF やスライドから抽出したテキストであり、"
 355            "改行位置や段落順が乱れたり、文が途中で分断されている可能性があります。\n"
 356            "元の意味・情報を一切削除・要約・追加せず、文や段落のつながりが自然になるように"
 357            "並び替えと改行のみを調整してください。\n"
 358            "箇条書きや見出しらしき部分は、その構造を保ってください。\n"
 359            "出力はプレーンテキストのみとし、余計な説明文は付けないでください。\n\n"
 360            "#テキスト\n{{ text }}"
 361        )
 362
 363    # ---- 優先順位適用: CLI > ini/結合 > デフォルト ----
 364    selected_mode = (args.mode or "je").lower()
 365    cfg.translate_prompts = translate_prompts_ini
 366    cfg.translate_prompt = (
 367        args.translate_prompt
 368        if args.translate_prompt
 369        else translate_prompts_ini.get(selected_mode, translate_prompts_ini["je"])
 370    )
 371    cfg.reformat_prompt = args.reformat_prompt if args.reformat_prompt else reformat_prompt_ini
 372
 373    # role は内部的には空文字で扱う(全部入りプロンプトで運用)
 374    cfg.translate_role = ""
 375    cfg.reformat_role = ""
 376
 377    return cfg
 378
 379
 380def update_variables(cfg: SimpleNamespace, p: argparse.ArgumentParser) -> SimpleNamespace:
 381    """
 382    コマンドライン引数を解析し、設定オブジェクト (`cfg`) を更新します。
 383
 384    argparseで解析された引数から、API、モデル、言語モード、ファイルパスなどの設定を
 385    `cfg` オブジェクトにコピー・正規化します。また、翻訳エンジン(`translate_core`)の
 386    設定も行います。
 387
 388    :param cfg: プログラム設定を保持するSimpleNamespaceオブジェクト。
 389    :type cfg: types.SimpleNamespace
 390    :param p: コマンドライン引数パーサー。
 391    :type p: argparse.ArgumentParser
 392    :returns: 更新された設定オブジェクト。
 393    :rtype: types.SimpleNamespace
 394    """
 395    args = p.parse_args()
 396
 397    # 旧名は受け付けるが、以後はtkai_lib_litellmのprovider名へ正規化する。
 398    api_aliases = {"openai5": "openai", "google": "gemini"}
 399    normalized_api = api_aliases.get(args.api, args.api)
 400
 401    # モデル上書き
 402    if args.model is not None:
 403        if args.api == "openai5":
 404            args.openai_model5 = args.model
 405        elif args.api == "openai":
 406            args.openai_model = args.model
 407        elif args.api in ("google", "gemini"):
 408            args.google_model = args.model
 409        elif args.api == "lmstudio":
 410            args.lmstudio_model = args.model
 411
 412    # mode から言語方向
 413    if args.mode[0] == "j":
 414        args.source_lang = "JA"
 415        # GUI側で既に設定済みでも、CLI/デフォルトロジックに合わせて再度設定
 416        if not args.limit_to_multibyte_str:
 417            args.limit_to_multibyte_str = True
 418    else:
 419        args.source_lang = "EN"
 420        if args.mode[0] != "j":
 421            # 英語ソースの場合は明示的にFalseにする
 422            args.limit_to_multibyte_str = False
 423
 424    if args.mode[1] == "j":
 425        args.target_lang = "JA"
 426    else:
 427        args.target_lang = "EN"
 428
 429    # cfg に基本情報コピー
 430    cfg.infile = args.infile
 431    cfg.api = normalized_api
 432    cfg.openai_model = args.openai_model
 433    cfg.openai_model5 = args.openai_model5
 434    cfg.google_model = args.google_model
 435    cfg.lmstudio_model = args.lmstudio_model or "qwen/qwen3.8-27b"
 436    cfg.deepl_api_key = args.deepl_api_key
 437    cfg.endpoint = args.endpoint
 438    cfg.max_tokens = args.max_tokens
 439    cfg.temperature = args.temperature
 440    cfg.reasoning_effort = args.reasoning_effort
 441    cfg.tsleep_rpm = args.tsleep_rpm
 442    cfg.use_md = args.use_md
 443    cfg.limit_to_multibyte_str = args.limit_to_multibyte_str
 444    cfg.process_unit = args.process_unit
 445    cfg.min_translate_length = args.min_translate_length
 446    cfg.allowed_translation_length_ratio = args.allowed_translation_length_ratio
 447    cfg.mode = args.mode
 448    cfg.source_lang = args.source_lang
 449    cfg.target_lang = args.target_lang
 450    cfg.html_template_path = args.html_template_path
 451
 452    cfg.openai_api_key = args.openai_api_key
 453    cfg.google_api_key = args.google_api_key
 454
 455    if cfg.api == "lmstudio":
 456        cfg.model = cfg.lmstudio_model
 457    elif args.api == "openai5":
 458        cfg.model = cfg.openai_model5
 459    elif cfg.api == "gemini":
 460        cfg.model = cfg.google_model
 461    else:
 462        cfg.model = cfg.openai_model
 463
 464    configure_translation_cfg(
 465        cfg,
 466        api=args.api,
 467        model=cfg.model,
 468        mode=args.mode,
 469        endpoint=args.endpoint,
 470        deepl_api_key=args.deepl_api_key,
 471        temperature=args.temperature,
 472        max_tokens=cfg.max_tokens,
 473        reasoning_effort=cfg.reasoning_effort,
 474        min_translate_length=cfg.min_translate_length,
 475        allowed_translation_length_ratio=cfg.allowed_translation_length_ratio,
 476        limit_to_multibyte_str=cfg.limit_to_multibyte_str,
 477        tsleep_rpm=cfg.tsleep_rpm,
 478    )
 479
 480    # ini + デフォルト + CLI 上書きで prompt を確定(roleは内部で空)
 481    cfg = load_prompt_config_from_ini(args, cfg)
 482
 483    return cfg
 484
 485
 486def usage():
 487    """
 488    コマンドライン引数の使用法を出力します。
 489
 490    argparse.ArgumentParserオブジェクトの`print_usage()`メソッドを呼び出します。
 491
 492    :returns: なし
 493    :rtype: None
 494    """
 495    global parser
 496    if parser:
 497        parser.print_usage()
 498
 499
 500# ------------------------------------------------------
 501# ユーティリティ
 502# ------------------------------------------------------
 503def process_template(template: str, context: dict) -> str:
 504    """
 505    テンプレート文字列内のプレースホルダーを置換し、特殊文字を展開します。
 506
 507    テンプレート文字列中の`\\t`, `\\n`, `\\r`を実際の特殊文字に変換し、
 508    `{{ key }}`形式のプレースホルダーを`context`辞書の値で置換します。
 509
 510    :param template: 処理対象のテンプレート文字列。
 511    :type template: str
 512    :param context: プレースホルダーの置換に使うキーと値の辞書。
 513    :type context: dict
 514    :returns: 置換・展開済みの文字列。
 515    :rtype: str
 516    """
 517    template = template.replace(r"\t", "\t")
 518    template = template.replace(r"\n", "\n")
 519    template = template.replace(r"\r", "\r")
 520
 521    def replace_placeholder(match):
 522        key = match.group(1).strip()
 523        return str(context.get(key, f"{{{{ {key} }}}}"))
 524
 525    return re.sub(r"\{\{\s*(.*?)\s*\}\}", replace_placeholder, template)
 526
 527
 528def save(path: str, text: str):
 529    """
 530    指定されたパスにテキストをUTF-8エンコーディングで保存します。
 531
 532    :param path: ファイルを保存するパス。
 533    :type path: str
 534    :param text: 保存するテキスト内容。
 535    :type text: str
 536    :returns: なし
 537    :rtype: None
 538    """
 539    with open(path, "w", encoding="utf-8") as f:
 540        f.write(text)
 541
 542
 543def read_file(path: str) -> str:
 544    """
 545    指定されたパスのファイルをUTF-8エンコーディングで読み込みます。
 546
 547    ファイルが存在しない場合はエラーメッセージを出力し、プログラムを終了します。
 548
 549    :param path: 読み込むファイルのパス。
 550    :type path: str
 551    :returns: ファイルの内容。
 552    :rtype: str
 553    """
 554    if not os.path.exists(path):
 555        print(f"\nError in read_file(): File [{path}] does not exist\n")
 556        sys.exit(1)
 557    with open(path, "r", encoding="utf-8") as fp:
 558        return fp.read()
 559
 560
 561def replace_path(path: str, ext: str) -> str:
 562    """
 563    ファイルパスの拡張子を新しいものに置換します。
 564
 565    :param path: 元のファイルパス。
 566    :type path: str
 567    :param ext: 新しい拡張子(例: ".docx", ".md")。
 568    :type ext: str
 569    :returns: 拡張子が置換された新しいファイルパス。
 570    :rtype: str
 571    """
 572    return os.path.splitext(path)[0] + ext
 573
 574
 575def check_multibyte_str(text: str, limit_to_multibyte_str: bool) -> bool:
 576    """
 577    テキストがマルチバイト文字を含むか、またはマルチバイト文字の有無にかかわらず処理対象とするかを判断します。
 578
 579    `limit_to_multibyte_str`が`True`の場合、テキストに日本語などのマルチバイト文字が
 580    含まれているかをチェックします。`False`の場合は常に`True`を返します。
 581
 582    :param text: チェック対象のテキスト。
 583    :type text: str
 584    :param limit_to_multibyte_str: マルチバイト文字を含むテキストのみを対象とするかどうかのフラグ。
 585    :type limit_to_multibyte_str: bool
 586    :returns: テキストが処理対象であるかを示す真偽値。
 587    :rtype: bool
 588    """
 589    if not limit_to_multibyte_str:
 590        return True
 591    pattern = re.compile(r"[\u0800-\uFFFF]")
 592    return bool(pattern.search(text))
 593
 594
 595def html_to_markdown(html_file_path: str) -> str:
 596    """
 597    HTMLファイルを読み込み、その内容をMarkdown形式に変換します。
 598
 599    :param html_file_path: 入力HTMLファイルのパス。
 600    :type html_file_path: str
 601    :returns: 変換されたMarkdownテキスト。
 602    :rtype: str
 603    """
 604    with open(html_file_path, "r", encoding="utf-8") as html_file:
 605        html_content = html_file.read()
 606    return html2text.html2text(html_content)
 607
 608
 609def convert_to_md(infile: str) -> str:
 610    """
 611    指定された入力ファイルをMarkdown形式に変換します。
 612
 613    ファイルがHTMLの場合は`html2text`を使用し、それ以外の場合は`MarkItDown`ライブラリを
 614    使用してMarkdownに変換します。
 615
 616    :param infile: 入力ファイルのパス。
 617    :type infile: str
 618    :returns: 変換されたMarkdownテキスト。
 619    :rtype: str
 620    """
 621    if ".html" in infile.lower():
 622        return html_to_markdown(infile)
 623    else:
 624        print(f"Convert {infile} to markdown")
 625        md = MarkItDown()
 626        result = md.convert(infile)
 627        return result.text_content
 628
 629
 630def n_leading_chars(s: str, c: str = "#") -> int:
 631    """
 632    文字列の先頭にある指定された文字の数を数えます。
 633
 634    主にMarkdownの見出しレベル(`#`)やリストアイテム(`*`)の数を判断するために使用されます。
 635
 636    :param s: 検査対象の文字列。
 637    :type s: str
 638    :param c: 数える対象の文字(デフォルトは`#`)。
 639    :type c: str
 640    :returns: 先頭に連続する指定文字の数。
 641    :rtype: int
 642    """
 643    return len(s) - len(s.lstrip(c))
 644
 645
 646def pdf_to_docx(pdf_file: str, docx_file: str):
 647    """
 648    PDFファイルをWord文書(.docx)に変換します。
 649
 650    :param pdf_file: 入力PDFファイルのパス。
 651    :type pdf_file: str
 652    :param docx_file: 出力Wordファイルのパス。
 653    :type docx_file: str
 654    :returns: なし
 655    :rtype: None
 656    """
 657    cv = Converter(pdf_file)
 658    cv.convert(docx_file, start=0, end=None)
 659    cv.close()
 660    print(f"Converted '{pdf_file}' to '{docx_file}' successfully.")
 661
 662
 663def get_filetype(path: str) -> str | None:
 664    """
 665    ファイルパスからファイルの種類(拡張子に基づく)を判定します。
 666
 667    :param path: 判定対象のファイルパス。
 668    :type path: str
 669    :returns: ファイルの種類を示す文字列
 670              ("pdf", "docx", "pptx", "html", "txt", "md", "rst")
 671              または認識できない場合はNone。
 672    :rtype: str or None
 673    """
 674    ext = os.path.splitext(path)[1].lower()
 675    if ext == ".pdf":
 676        return "pdf"
 677    if ext == ".docx":
 678        return "docx"
 679    if ext == ".pptx":
 680        return "pptx"
 681    if ext in (".html", ".htm"):
 682        return "html"
 683    if ext in (".txt", ".text"):
 684        return "txt"
 685    if ext == ".md":
 686        return "md"
 687    if ext == ".rst":
 688        return "rst"
 689    return None
 690
 691
 692def to_translate(text: str | None, min_translate_length: int, limit_to_multibyte_str: bool) -> bool:
 693    """
 694    特定のテキストブロックが翻訳対象であるかを判断します。
 695
 696    テキストがNoneでないか、空でないか、最小翻訳長以上であるか、そしてマルチバイト文字制限が
 697    有効な場合はマルチバイト文字を含むかをチェックします。
 698
 699    :param text: 翻訳対象として考慮するテキスト。
 700    :type text: str or None
 701    :param min_translate_length: 翻訳するテキストの最小文字長。
 702    :type min_translate_length: int
 703    :param limit_to_multibyte_str: マルチバイト文字を含むテキストのみを翻訳対象とするかどうかのフラグ。
 704    :type limit_to_multibyte_str: bool
 705    :returns: テキストが翻訳対象であるかを示す真偽値。
 706    :rtype: bool
 707    """
 708    if text is None:
 709        return False
 710    text0 = text.strip()
 711    if text0 == "":
 712        return False
 713    if len(text0) < min_translate_length:
 714        return False
 715
 716    is_mb = check_multibyte_str(text0, limit_to_multibyte_str)
 717
 718    if not is_mb and not bool(re.search("[a-zA-Z]", text0)):
 719        return False
 720
 721    return is_mb if limit_to_multibyte_str else True
 722
 723
 724# ------------------------------------------------------
 725# 翻訳系ラッパ
 726# ------------------------------------------------------
 727def revise_with_llm(text: str, prompt: str, cfg: SimpleNamespace) -> str:
 728    """
 729    LLM(OpenAI, Gemini, LM Studio)を呼び出してテキストを翻訳または校正します。
 730
 731    `tkai_lib_litellm`を介してAIモデルと対話し、与えられたプロンプトに基づいてテキストを処理します。
 732    LM Studioの場合、`reasoning_effort`を`extra_body`で渡します。
 733
 734    :param text: LLMで処理する元のテキスト。
 735    :type text: str
 736    :param prompt: LLMに与えるプロンプト。テンプレートとして処理されます。
 737    :type prompt: str
 738    :param cfg: API設定、モデル名、温度、最大トークン数などが含まれる設定オブジェクト。
 739    :type cfg: types.SimpleNamespace
 740    :returns: LLMによって処理されたテキスト。
 741    :rtype: str
 742    """
 743    prompt_text = process_template(
 744        prompt,
 745        {
 746            "text": text,
 747            "additional_prompt": (
 748                "翻訳・校正結果のみを出力してください。"
 749                "前置きや後付けのメッセージは不要です。"
 750            ),
 751        },
 752    )
 753
 754    if cfg.api == "lmstudio":
 755        # Qwen3.8の推論量はLM Studio OpenAI互換APIのextra_bodyへ渡す。
 756        call_kwargs = {
 757            "temperature": cfg.temperature,
 758            "max_tokens": cfg.max_tokens,
 759        }
 760        if cfg.reasoning_effort:
 761            call_kwargs["extra_body"] = {
 762                "reasoning_effort": cfg.reasoning_effort,
 763            }
 764        response = query_ai(
 765            prompt=prompt_text,
 766            model=cfg.model,
 767            role="",
 768            provider="lmstudio",
 769            **call_kwargs,
 770        )
 771    else:
 772        response = query_ai_compatible(
 773            prompt=prompt_text,
 774            model=cfg.model,
 775            role="",
 776            provider=cfg.api,
 777            temperature=cfg.temperature,
 778            max_tokens=cfg.max_tokens,
 779            reasoning_effort=cfg.reasoning_effort,
 780        )
 781
 782    text_out = extract_text(response)
 783    if not text_out:
 784        return ""
 785
 786    usage = getattr(response, "usage", None)
 787    if usage:
 788        print(f"  prompt_tokens     : {getattr(usage, 'prompt_tokens', 'n/a')}")
 789        print(f"  completion_tokens: {getattr(usage, 'completion_tokens', 'n/a')}")
 790
 791    if cfg.tsleep_rpm > 0:
 792        time.sleep(cfg.tsleep_rpm)
 793
 794    return text_out.strip()
 795
 796
 797def translate_with_deepl(
 798    text: str,
 799    deepl_api_key: str,
 800    endpoint: str,
 801    source_lang: str = "JA",
 802    target_lang: str = "EN",
 803    cfg: SimpleNamespace | None = None
 804) -> str:
 805    """
 806    DeepL APIを使用してテキストを翻訳します。
 807
 808    `tkai_lib`をインポートし、DeepL APIを呼び出してテキストを翻訳します。
 809    成功した場合は翻訳結果を返し、失敗した場合はエラーメッセージを出力し元のテキストを返します。
 810
 811    :param text: 翻訳する元のテキスト。
 812    :type text: str
 813    :param deepl_api_key: DeepL APIのキー。
 814    :type deepl_api_key: str
 815    :param endpoint: DeepL APIのエンドポイントURL。
 816    :type endpoint: str
 817    :param source_lang: (オプション) ソース言語のコード(デフォルト: "JA")。
 818    :type source_lang: str
 819    :param target_lang: (オプション) ターゲット言語のコード(デフォルト: "EN")。
 820    :type target_lang: str
 821    :param cfg: (オプション) 設定オブジェクト。`tsleep_rpm`のために使用。
 822    :type cfg: types.SimpleNamespace or None
 823    :returns: DeepLによって翻訳されたテキスト、またはエラーの場合は元のテキスト。
 824    :rtype: str
 825    :raises RuntimeError: DeepLを使用する場合に`tkai_lib.py`が見つからない場合。
 826    """
 827    # DeepL はLLM APIではないため、必要時だけ従来ライブラリを読み込む。
 828    try:
 829        from tkai_lib import query_deepl, extract_deepl_text
 830    except ImportError as exc:
 831        raise RuntimeError(
 832            "DeepLを使う場合は従来の tkai_lib.py も必要です。"
 833        ) from exc
 834
 835    response = query_deepl(
 836        text,
 837        source_lang,
 838        target_lang,
 839        deepl_api_key=deepl_api_key,
 840        endpoint=endpoint,
 841    )
 842
 843    if cfg and cfg.tsleep_rpm > 0:
 844        time.sleep(cfg.tsleep_rpm)
 845
 846    if response.status_code == 200:
 847        return extract_deepl_text(response)
 848    else:
 849        print(f"Error: {response.status_code}, {response.text}")
 850        return text
 851
 852
 853def translate(text: str, api: str, prompt: str, cfg: SimpleNamespace) -> str:
 854    """
 855    翻訳処理の中核となるラッパー関数。
 856
 857    `translate_core`モジュールからインポートされた翻訳関数を呼び出します。
 858    この関数がLLMの種類に応じて実際の翻訳処理を分岐させます。
 859
 860    :param text: 翻訳するテキスト。
 861    :type text: str
 862    :param api: 使用するAPIの種類(例: "openai", "gemini", "deepl")。
 863    :type api: str
 864    :param prompt: 翻訳に使用するプロンプト。
 865    :type prompt: str
 866    :param cfg: 翻訳設定オブジェクト。
 867    :type cfg: types.SimpleNamespace
 868    :returns: 翻訳されたテキスト。
 869    :rtype: str
 870    """
 871    # translate_core は URL/COM 版とも共有する唯一のAPI分岐点。
 872    return translate_core(text, prompt, cfg)
 873
 874
 875# ------------------------------------------------------
 876# 翻訳結果チェック
 877# ------------------------------------------------------
 878def check_translation(text: str, translated: str | None, allowed_translation_length_ratio: float) -> bool:
 879    """
 880    翻訳結果が適切であるかを複数の基準でチェックします。
 881
 882    翻訳結果が空でないか、Markdownのコードブロック記号で始まっていないか、
 883    見出しレベルが極端に増加していないか、元のテキストに対する翻訳テキストの
 884    長さの比率が許容範囲内であるかなどを確認します。
 885
 886    :param text: 翻訳元のテキスト。
 887    :type text: str
 888    :param translated: 翻訳されたテキスト。
 889    :type translated: str or None
 890    :param allowed_translation_length_ratio: 翻訳されたテキストの長さが元のテキストの
 891                                             何倍まで許容されるかの比率。
 892    :type allowed_translation_length_ratio: float
 893    :returns: 翻訳結果が許容できる場合はTrue、そうでない場合はFalse。
 894    :rtype: bool
 895    """
 896    if translated is None:
 897        return False
 898    if translated.startswith("'''"):
 899        return False
 900    if translated.startswith("```"):
 901        return False
 902
 903    ntranslated = n_leading_chars(translated, "#")
 904    ntext = n_leading_chars(text, "#")
 905    if ntranslated > ntext:
 906        return False
 907
 908    ntranslated = n_leading_chars(translated, "*")
 909    ntext = n_leading_chars(text, "*")
 910    if ntranslated == ntext + 1:
 911        return False
 912
 913    if len(text) > 0 and len(translated) > len(text) * allowed_translation_length_ratio:
 914        return False
 915
 916    return True
 917
 918
 919# ------------------------------------------------------
 920# 各フォーマット別処理
 921# ------------------------------------------------------
 922def translate_html(text: str, api: str, api_model: str, prompt: str, cfg: SimpleNamespace) -> tuple[str | None, list]:
 923    """
 924    HTMLドキュメントのテキストコンテンツを翻訳します。
 925
 926    `translate_backends`モジュールから`translate_html_document`を呼び出し、
 927    HTMLからスクリプト、スタイル、コードを除外したテキストを翻訳します。
 928
 929    :param text: 入力HTMLコンテンツ。
 930    :type text: str
 931    :param api: 使用するAPIの種類。
 932    :type api: str
 933    :param api_model: 使用するAPIモデル。
 934    :type api_model: str
 935    :param prompt: 翻訳に使用するプロンプト。
 936    :type prompt: str
 937    :param cfg: 翻訳設定オブジェクト。
 938    :type cfg: types.SimpleNamespace
 939    :returns: 翻訳されたHTMLコンテンツと翻訳データのリスト。
 940    :rtype: tuple[str or None, list]
 941    """
 942    print("\n>>> Analyzing HTML (script/style/code are excluded)...")
 943    return translate_html_document(text, prompt, cfg)
 944
 945
 946def translate_pptx(ppt: Presentation, api: str, api_model: str, prompt: str, cfg: SimpleNamespace) -> tuple[Presentation, list]:
 947    """
 948    PowerPointプレゼンテーション (.pptx) の内容を翻訳します。
 949
 950    各スライド内のテキストフレーム、テーブル、グループ化されたシェイプ、ノート、
 951    チャートのタイトルやデータラベルなどを走査し、テキストを翻訳します。
 952    `process_unit`設定に基づいて段落単位またはラン(文字の連続)単位で処理します。
 953
 954    :param ppt: 翻訳対象のPresentationオブジェクト。
 955    :type ppt: pptx.Presentation
 956    :param api: 使用するAPIの種類。
 957    :type api: str
 958    :param api_model: 使用するAPIモデル。
 959    :type api_model: str
 960    :param prompt: 翻訳に使用するプロンプト。
 961    :type prompt: str
 962    :param cfg: 翻訳設定オブジェクト。
 963    :type cfg: types.SimpleNamespace
 964    :returns: 翻訳されたPresentationオブジェクトと翻訳データのリスト。
 965    :rtype: tuple[pptx.Presentation, list]
 966    """
 967    cfg.translate_master = False
 968
 969    data = []
 970    print()
 971    print(">>> Translating PPTX (shapes, groups, tables, notes, charts)...")
 972
 973    def translate_paragraph(paragraph):
 974        nonlocal data
 975        if cfg.process_unit == "paragraph":
 976            text = paragraph.text
 977            if to_translate(text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
 978                original_text = text
 979                try:
 980                    revised_text = translate(text, api, prompt, cfg)
 981                except Exception as e:
 982                    print(f"  *** Translation failed for this paragraph. Skipping. Error: {e}")
 983                    return # 失敗時は元のテキストを保持
 984                    
 985                print(f"[Original] {original_text}")
 986                print(f"  -> [Revised] {revised_text}")
 987                if check_translation(original_text, revised_text, cfg.allowed_translation_length_ratio):
 988                    paragraph.text = revised_text
 989                    data.append({"original": original_text, "translated": revised_text})
 990                else:
 991                    print("  *** This translation is rejected")
 992        else:
 993            for run in paragraph.runs:
 994                if to_translate(run.text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
 995                    original_text = run.text
 996                    try:
 997                        revised_text = translate(run.text, api, prompt, cfg)
 998                    except Exception as e:
 999                        print(f"  *** Translation failed for this run. Skipping. Error: {e}")
1000                        continue # 失敗時は元のテキストを保持
1001                        
1002                    print(f"[Original] {original_text}")
1003                    print(f"  -> [Revised] {revised_text}")
1004                    if check_translation(original_text, revised_text, cfg.allowed_translation_length_ratio):
1005                        run.text = revised_text
1006                        data.append({"original": original_text, "translated": revised_text})
1007                    else:
1008                        print("  *** This translation is rejected")
1009
1010    def translate_shape(shape):
1011        if shape.has_text_frame:
1012            for paragraph in shape.text_frame.paragraphs:
1013                translate_paragraph(paragraph)
1014
1015        if shape.has_table:
1016            for row in shape.table.rows:
1017                for cell in row.cells:
1018                    for paragraph in cell.text_frame.paragraphs:
1019                        translate_paragraph(paragraph)
1020
1021        if shape.shape_type == MSO_SHAPE_TYPE.GROUP:
1022            for shp in shape.shapes:
1023                translate_shape(shp)
1024
1025        if hasattr(shape, "has_chart") and shape.has_chart:
1026            chart = shape.chart
1027
1028            if chart.has_title and chart.chart_title.has_text_frame:
1029                for paragraph in chart.chart_title.text_frame.paragraphs:
1030                    translate_paragraph(paragraph)
1031
1032            if hasattr(chart, "category_axis"):
1033                ax = chart.category_axis
1034                if getattr(ax, "has_title", False) and ax.axis_title.has_text_frame:
1035                    for paragraph in ax.axis_title.text_frame.paragraphs:
1036                        translate_paragraph(paragraph)
1037
1038            if hasattr(chart, "value_axis"):
1039                ax = chart.value_axis
1040                if getattr(ax, "has_title", False) and ax.axis_title.has_text_frame:
1041                    for paragraph in ax.axis_title.text_frame.paragraphs:
1042                        translate_paragraph(paragraph)
1043
1044            for series in chart.series:
1045                for pt in getattr(series, "points", []):
1046                    lbl = getattr(pt, "data_label", None)
1047                    if lbl is not None and getattr(lbl, "has_text_frame", False):
1048                        for paragraph in lbl.text_frame.paragraphs:
1049                            translate_paragraph(paragraph)
1050
1051    for slide_idx, slide in enumerate(ppt.slides, start=1):
1052        print(f"\n--- Slide {slide_idx} ---")
1053        for shape in slide.shapes:
1054            translate_shape(shape)
1055
1056        if slide.has_notes_slide:
1057            notes_slide = slide.notes_slide
1058            ntf = getattr(notes_slide, "notes_text_frame", None)
1059            if ntf is not None:
1060                print("  Translating notes...")
1061                for paragraph in ntf.paragraphs:
1062                    translate_paragraph(paragraph)
1063
1064    # マスタースライド翻訳フラグ(無指定時は従来通り True 扱い)
1065    if getattr(cfg, "translate_master", True):
1066        print("\n>>> Translating slide masters and layouts (static text)...")
1067        for master in ppt.slide_masters:
1068            for shape in master.shapes:
1069                translate_shape(shape)
1070            for layout in master.slide_layouts:
1071                for shape in layout.shapes:
1072                    translate_shape(shape)
1073    else:
1074        print("\n>>> Skipping translation of slide masters and layouts (static text).")
1075
1076    return ppt, data
1077
1078
1079def translate_docx(doc: Document, api: str, api_model: str, prompt: str, cfg: SimpleNamespace) -> tuple[Document, list]:
1080    """
1081    Word文書 (.docx) の内容を翻訳します。
1082
1083    文書内の段落とテーブルのセルを走査し、`process_unit`設定に基づいて
1084    段落単位またはラン(文字の連続)単位でテキストを翻訳します。
1085
1086    :param doc: 翻訳対象のDocumentオブジェクト。
1087    :type doc: docx.Document
1088    :param api: 使用するAPIの種類。
1089    :type api: str
1090    :param api_model: 使用するAPIモデル。
1091    :type api_model: str
1092    :param prompt: 翻訳に使用するプロンプト。
1093    :type prompt: str
1094    :param cfg: 翻訳設定オブジェクト。
1095    :type cfg: types.SimpleNamespace
1096    :returns: 翻訳されたDocumentオブジェクトと翻訳データのリスト。
1097    :rtype: tuple[docx.Document, list]
1098    """
1099    data = []
1100    print()
1101    print(">>> Processing paragraphs/runs...")
1102
1103    if cfg.process_unit == "paragraph":
1104        for paragraph in doc.paragraphs:
1105            if to_translate(paragraph.text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
1106                original_text = paragraph.text
1107                try:
1108                    revised_text = translate(paragraph.text, api, prompt, cfg)
1109                except Exception as e:
1110                    print(f"  *** Translation failed for this paragraph. Skipping. Error: {e}")
1111                    continue
1112                    
1113                print(f"[Original] {original_text}")
1114                print(f"  -> [Revised] {revised_text}")
1115                if check_translation(original_text, revised_text, cfg.allowed_translation_length_ratio):
1116                    paragraph.text = revised_text
1117                    data.append({"original": original_text, "translated": revised_text})
1118                else:
1119                    print("  *** This translation is rejected")
1120    else:
1121        for paragraph in doc.paragraphs:
1122            for run in paragraph.runs:
1123                if to_translate(run.text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
1124                    original_text = run.text
1125                    try:
1126                        revised_text = translate(run.text, api, prompt, cfg)
1127                    except Exception as e:
1128                        print(f"  *** Translation failed for this run. Skipping. Error: {e}")
1129                        continue
1130                        
1131                    print(f"[Original] {original_text}")
1132                    print(f"  -> [Revised] {revised_text}")
1133                    if check_translation(original_text, revised_text, cfg.allowed_translation_length_ratio):
1134                        run.text = revised_text
1135                        data.append({"original": original_text, "translated": revised_text})
1136                    else:
1137                        print("  *** This translation is rejected")
1138
1139    print(">>> Processing tables...")
1140    for table in doc.tables:
1141        for row in table.rows:
1142            for cell in row.cells:
1143                for paragraph in cell.paragraphs:
1144                    if cfg.process_unit == "paragraph":
1145                        if to_translate(paragraph.text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
1146                            original_text = paragraph.text
1147                            try:
1148                                revised_text = translate(paragraph.text, api, prompt, cfg)
1149                            except Exception as e:
1150                                print(f"  *** Translation failed for this table cell (paragraph). Skipping. Error: {e}")
1151                                continue
1152                                
1153                            print(f"[Original] {original_text}")
1154                            print(f"  -> [Revised] {revised_text}")
1155                            if check_translation(original_text, revised_text, cfg.allowed_translation_length_ratio):
1156                                paragraph.text = revised_text
1157                                data.append({"original": original_text, "translated": revised_text})
1158                            else:
1159                                print("  *** This translation is rejected")
1160                    else:
1161                        for run in paragraph.runs:
1162                            if to_translate(run.text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
1163                                original_text = run.text
1164                                try:
1165                                    revised_text = translate(run.text, api, prompt, cfg)
1166                                except Exception as e:
1167                                    print(f"  *** Translation failed for this table cell (run). Skipping. Error: {e}")
1168                                    continue
1169                                    
1170                                print(f"[Original] {original_text}")
1171                                print(f"  -> [Revised] {revised_text}")
1172                                if check_translation(original_text, revised_text, cfg.allowed_translation_length_ratio):
1173                                    run.text = revised_text
1174                                    data.append({"original": original_text, "translated": revised_text})
1175                                else:
1176                                    print("  *** This translation is rejected")
1177    return doc, data
1178
1179
1180def translate_text(text: str, api: str, api_model: str, prompt: str, cfg: SimpleNamespace) -> tuple[str, list]:
1181    """
1182    プレーンテキストブロック全体を翻訳します。
1183
1184    入力されたテキストが翻訳条件を満たす場合、`translate`関数を使用して
1185    テキスト全体を翻訳します。
1186
1187    :param text: 翻訳対象のプレーンテキスト。
1188    :type text: str
1189    :param api: 使用するAPIの種類。
1190    :type api: str
1191    :param api_model: 使用するAPIモデル。
1192    :type api_model: str
1193    :param prompt: 翻訳に使用するプロンプト。
1194    :type prompt: str
1195    :param cfg: 翻訳設定オブジェクト。
1196    :type cfg: types.SimpleNamespace
1197    :returns: 翻訳されたテキストと翻訳データのリスト。
1198    :rtype: tuple[str, list]
1199    """
1200    data = []
1201    print(">>> Translating plain text...")
1202    revised_text = text
1203    if to_translate(text, cfg.min_translate_length, cfg.limit_to_multibyte_str):
1204        original_text = text
1205        try:
1206            revised_text = translate(text, api, prompt, cfg)
1207        except Exception as e:
1208            print(f"  *** Translation failed for the entire text block. Skipping. Error: {e}")
1209            revised_text = original_text # 失敗時は元のテキストを保持
1210            
1211        print(f"[Original] {original_text}")
1212        print(f"  -> [Revised] {revised_text}")
1213        data.append({"original": original_text, "translated": revised_text})
1214    return revised_text, data
1215
1216
1217# ------------------------------------------------------
1218# メイン実行
1219# ------------------------------------------------------
1220def execute(cfg: SimpleNamespace):
1221    """
1222    メインの翻訳処理を実行します。
1223
1224    入力ファイルのタイプに応じて適切な翻訳ロジックを選択し、ファイルを読み込み、
1225    LLMまたはDeepLで翻訳し、結果を保存します。翻訳中にエラーが発生した場合でも、
1226    部分的にでも結果を保存しようと試みます。
1227    最終的に、翻訳前後のテキストを比較するHTMLレポートも生成します。
1228
1229    :param cfg: 全てのプログラム設定を含むSimpleNamespaceオブジェクト。
1230    :type cfg: types.SimpleNamespace
1231    :returns: なし
1232    :rtype: None
1233    """
1234    filetype = get_filetype(cfg.infile)
1235
1236    if filetype is None:
1237        print(f"\nError in execute(): Invalid extension in [{cfg.infile}]\n")
1238        sys.exit(1)
1239
1240    # ------------------ ファイルパス設定 ------------------
1241    # NOTE: GUI側のロジックと重複するが、ここではCUI実行時のパスを決定する
1242    if filetype == "md":
1243        outfile = replace_path(cfg.infile, "_revised.md")
1244    elif filetype == "rst":
1245        outfile = replace_path(cfg.infile, "_revised.rst")
1246    elif cfg.use_md:
1247        mdfile = replace_path(cfg.infile, ".md")
1248        outfile = replace_path(cfg.infile, "_revised.md")
1249    elif filetype == "pdf":
1250        outfile = replace_path(cfg.infile, "_revised.md" if cfg.use_md else "_revised.docx")
1251    elif filetype == "docx":
1252        outfile = replace_path(cfg.infile, "_revised.docx")
1253    elif filetype == "html":
1254        outfile = replace_path(cfg.infile, "_revised.html")
1255    elif filetype == "pptx":
1256        outfile = replace_path(cfg.infile, "_revised.pptx")
1257    elif filetype == "txt":
1258        outfile = replace_path(cfg.infile, "_revised.txt")
1259    else:
1260        print(f"\nError in execute(): Unsupported extension in [{cfg.infile}]\n")
1261        sys.exit(1)
1262
1263    output_comparison_html_path = replace_path(cfg.infile, "_compare.html")
1264    output_reformat_md = replace_path(cfg.infile, "_reformat.md")
1265    output_docx = replace_path(cfg.infile, ".docx")
1266
1267    print("=== Translate and revise file ===")
1268    print(f"  Input file              : {cfg.infile}")
1269    # ... (設定情報の出力は省略) ...
1270    print(f"  Output file             : {outfile}")
1271
1272    if not os.path.isfile(cfg.infile):
1273        print(f"Error: File [{cfg.infile}] does not exist")
1274        usage()
1275        sys.exit(1)
1276
1277    data = []
1278    translated_document = None # 翻訳済みドキュメントオブジェクト/テキストを保持する変数
1279    
1280    # ------------------ 翻訳処理本体 (Tryブロックで囲む) ------------------
1281    try:
1282        # ---- md/txt ----
1283        if filetype in ("md", "rst", "txt"):
1284            print(f"Read [{cfg.infile}]")
1285            text = read_file(cfg.infile)
1286            if filetype == "md":
1287                text, data = translate_markdown_document(text, cfg.translate_prompt, cfg)
1288            elif filetype == "rst":
1289                text, data = translate_rst_document(text, cfg.translate_prompt, cfg)
1290            else:
1291                text, data = translate_text(text, cfg.api, cfg.openai_model, cfg.translate_prompt, cfg)
1292            translated_document = text
1293            if text is None:
1294                print(f"Error for filetype = {filetype}: Could not get text")
1295
1296        # ---- use_md モード ----
1297        elif cfg.use_md:
1298            print(f"Read [{cfg.infile}] and convert to markdown")
1299            text = convert_to_md(cfg.infile)
1300            if text is None:
1301                print("Error for md: Could not get text")
1302                
1303            print(f"=== Saving markdown to {mdfile} ===")
1304            save(mdfile, text)
1305
1306            if filetype == "pdf":
1307                print(f"Reformatting [{mdfile}] by API...")
1308                # reformat → translate
1309                text2 = translate(text, cfg.api, cfg.reformat_prompt, cfg)
1310                if not text2:
1311                    print("Error: Could not get reformatted text")
1312                else:
1313                    print(f"Reformatted MD file is saved to [{output_reformat_md}]")
1314                    save(output_reformat_md, text2)
1315                    text = text2
1316
1317            text, data = translate_markdown_document(text, cfg.translate_prompt, cfg)
1318            translated_document = text
1319            if text is None:
1320                print("Error in getting translated text: Could not get text")
1321                
1322        # ---- 通常モード (docx, pptx, html, pdf -> docx) ----
1323        else:
1324            if filetype == "pdf":
1325                print(f"Converting [{cfg.infile}] to [{output_docx}]")
1326                pdf_to_docx(cfg.infile, output_docx)
1327                print(f"Read [{output_docx}]")
1328                doc = Document(output_docx)
1329                translated_document, data = translate_docx(doc, cfg.api, cfg.openai_model, cfg.translate_prompt, cfg)
1330
1331            elif filetype == "pptx":
1332                ppt = Presentation(cfg.infile)
1333                translated_document, data = translate_pptx(ppt, cfg.api, cfg.openai_model, cfg.translate_prompt, cfg)
1334
1335            elif filetype == "docx":
1336                print(f"Read [{cfg.infile}]")
1337                doc = Document(cfg.infile)
1338                translated_document, data = translate_docx(doc, cfg.api, cfg.openai_model, cfg.translate_prompt, cfg)
1339
1340            elif filetype == "html":
1341                print(f"Read [{cfg.infile}]")
1342                html = read_file(cfg.infile)
1343                translated_document, data = translate_html(html, cfg.api, cfg.openai_model, cfg.translate_prompt, cfg)
1344
1345    except Exception as e:
1346        # 翻訳中にエラーが発生した場合、メッセージを出力して保存処理へ進む
1347        print(f"\n[ERROR] Translation process interrupted by an exception: {e}")
1348        # スタックトレースはGUI側で表示されるため、ここでは簡易的なメッセージに留める
1349        # ここで処理を終了せずに、以下の保存処理に進むのが重要
1350
1351    # ------------------ 翻訳結果の保存 (エラーに関わらず実行) ------------------
1352    print()
1353    if translated_document is not None:
1354        try:
1355            if filetype in ("md", "rst", "txt") or cfg.use_md:
1356                # md, txt, または use_mdモードの場合
1357                print(f"=== Saving revised text to {outfile} ===")
1358                save(outfile, translated_document)
1359            elif filetype == "html" and not cfg.use_md:
1360                # html の場合
1361                print(f"=== Saving revised html to {outfile} ===")
1362                save(outfile, translated_document)
1363            elif filetype in ("docx", "pdf", "pptx") and not cfg.use_md:
1364                # docx, pdf (docx), pptx のドキュメントオブジェクトの場合
1365                save_doc_type = "docx" if filetype in ("docx", "pdf") else "pptx"
1366                print(f"=== Saving revised {save_doc_type} to {outfile} ===")
1367                translated_document.save(outfile)
1368        except Exception as save_e:
1369            print(f"[ERROR] Failed to save the partially translated file to {outfile}: {save_e}")
1370            
1371    # ------------------------------------------------------
1372    # 比較HTML生成
1373    # ------------------------------------------------------
1374    print()
1375    print(f"Creating comparison HTML file from template [{cfg.html_template_path}]")
1376
1377    if not data and translated_document is None:
1378        print("--- [WARNING] No translation data or document object available. Skipping HTML report.")
1379        return # 保存対象がないためここで終了
1380
1381    context = cfg.__dict__.copy()
1382    context["data"] = data
1383
1384    current_dir = os.getcwd()
1385    script_dir = os.path.dirname(os.path.abspath(__file__))
1386    
1387    # テンプレートファイルの探索ロジック(そのまま維持)
1388    if not os.path.isfile(cfg.html_template_path):
1389        template_filename = os.path.basename(cfg.html_template_path)
1390        cand = os.path.join(current_dir, template_filename)
1391        if os.path.isfile(cand):
1392            cfg.html_template_path = cand
1393    if not os.path.isfile(cfg.html_template_path):
1394        template_filename = os.path.basename(cfg.html_template_path)
1395        cand = os.path.join(script_dir, template_filename)
1396        if os.path.isfile(cand):
1397            cfg.html_template_path = cand
1398
1399    print(f"  Template path: [{cfg.html_template_path}]")
1400
1401    if os.path.isfile(cfg.html_template_path):
1402        try:
1403            template_dir = os.path.dirname(cfg.html_template_path)
1404            template_file = os.path.basename(cfg.html_template_path)
1405
1406            env = Environment(loader=FileSystemLoader(template_dir))
1407            template = env.get_template(template_file)
1408
1409            rendered_html = template.render(context)
1410
1411            print()
1412            print(f"Save translation data to [{output_comparison_html_path}]")
1413            with open(output_comparison_html_path, "w", encoding="utf-8") as f:
1414                f.write(rendered_html)
1415            print(f"  Finished.\n")
1416        except Exception as html_e:
1417            print(f"[ERROR] Failed to generate comparison HTML report: {html_e}")
1418    else:
1419        print()
1420        print(f"--- [WARNING] Template file '{cfg.html_template_path}' not found.")
1421        print(f"---           Looked in current and script directories.")
1422        print("---           Skipping generation of comparison HTML report.")
1423    print()
1424
1425
1426def main():
1427    """
1428    プログラムのエントリポイント。
1429
1430    `initialize()`で設定とCLIパーサーを準備し、`update_variables()`でCLI引数を解析して
1431    設定を更新し、`execute()`で実際の翻訳処理を開始します。
1432
1433    :returns: なし
1434    :rtype: None
1435    """
1436    global parser
1437    cfg, parser = initialize()
1438    cfg = update_variables(cfg, parser)
1439    execute(cfg)
1440
1441
1442if __name__ == "__main__":
1443    main()
1444    print()
1445    usage()
1446    input("\nPress ENTER to terminate>>\n")