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")