view release on metacpan or  search on metacpan

README.gpt5-JA.md  view on Meta::CPAN

            translated Japanese text
            #endif

        日本語テキストのみを取り出すには、**unifdef** コマンドを使用します:

            unifdef -UORIGINAL -DJA foo.ja.pm

    - **space**
    - **space+**

        元のテキストと変換後のテキストは、1行の空行で区切って出力されます。`space+` の場合は、変換後のテキストの後に改行も出力します。

    - **xtxt**

        形式が `xtxt`（翻訳済みテキスト）または不明な場合は、翻訳済みテキストのみが出力されます。

- **--xlate-maxlen**=_chars_ (Default: 0)

    一度にAPIへ送信するテキストの最大長を指定します。デフォルト値 0 はエンジン自身の制限を意味します: 無料のDeepLアカウントサービスでは、API 用は 128K（**--xlate**）、クリップボー...

- **--xlate-maxline**=_n_ (Default: 0)

    一度にAPIへ送信するテキストの最大行数を指定します。

    1行ずつ翻訳したい場合は、この値を 1 に設定します。このオプションは `--xlate-maxlen` オプションより優先されます。

- **--xlate-prompt**=_text_

    翻訳エンジンに送信するカスタムプロンプトを指定します。このオプションはLLMエンジン（`gpt3`、`gpt4o`、`gpt5`）で利用できますが、DeepLでは利用できません。AIモデルに具体的な指示ã...

- **--xlate-context**=_text_

    翻訳エンジンに送信する追加のコンテキスト情報を指定します。このオプションは複数回使用して、複数のコンテキスト文字列を提供できます。コンテキスト情報は翻訳エンジンが背...

- **--xlate-context-window**=_n_

    (Context-aware engines only, e.g. `gpt5` on the llm backend)
    変更されたブロックを再翻訳する際に参照コンテキストとして渡される周辺の翻訳済みブロック数（デフォルトは2）です。このコンテキストには、変更領域の周囲にある生のソースãƒ...

- **--xlate-cache-seed**=_file_

    新しい文書のキャッシュを別の文書のキャッシュファイルから初期化します。定期レポートに有用です。新しい号のキャッシュに前号のキャッシュをシードすることで、変更されてい...

- **--xlate-anonymize**=_file_

    機密文字列を翻訳APIに送信する前に匿名化し、出力で復元します。辞書ファイルは項目ごとに1つのエントリを与えます。JSON（標準的で、機械生成可能）

        [ { "category": "person",  "text": "山田太郎" },
          { "category": "company", "regex": "アクメ(株式会社)?" } ]

    または単純な行形式（regexの場合は `category pattern`、`/.../`）で指定します。各項目は `<person id=1 />` のようなカテゴリタグに置き換えられます。同じ文字列には常に同じタグが割り当てã...

    辞書は外部ツールで生成できます。たとえば、機密エンティティを抽出するローカルモデルです。

        llm -m <local-model> \
            -s 'Extract sensitive entities as a JSON array of objects
                with "category" and "text" fields.' \
            < report.md > report.anon.json
        greple -Mxlate --xlate-anonymize=report.anon.json ...

    ファイル内のUTF-8 BOMは許容されます。フロントマターの行形式における値は、値の後ではなく、それだけの行に限って末尾コメントを持つことができます。

- **--xlate-anonymize-mark**\[=_regex_\]

    文書自体のインラインマークから匿名化エントリを収集します。最初の出現箇所を `{{ person("山田太郎") }}` のようにマークすると、その文字列の文書全体のすべての出現箇所が匿名化ã...

    このような任意値オプションでは、後続のファイル引数が値として扱われることに注意してください。デフォルト表記を使用する場合は、`--xlate-anonymize-mark=`（末尾に `=` を付けて）と...

    別の表記も設定できます。たとえば `@@person:NAME@@` スタイルのマークには `--xlate-anonymize-mark='@@(?<category>[a-z][a-z0-9_]*):(?<text>[^\n]+?)@@'`、またはレンダリング済みMarkdownで不可視のままになã...

- **--xlate-template**\[=_regex_\]

    テンプレート式（デフォルト: Jinja2 `{{ ... }}`、`{% ... %}`、`{# ... #}`）を不透明なプレースホルダとして扱います。モデルにはそれらを変更せずにコピーするよう指示し、ブロックごとに...

    このようなオプション値が任意のオプションでは、後続のファイル引数が値として扱われることに注意してください。デフォルトの表記を使用する場合は、`--xlate-template=`（末尾に `=` ...

- **--xlate-frontmatter**

    先頭の `---` ... `---` ブロックを YAML フロントマターとして扱います。翻訳およびフェーズ2のコンテキストスライスから除外し、そのフラットな `key: value` 値を安全策として匿名化ルーã...

    閉じる `---` の後には必ず空行を残してください。段落スタイルのマッチパターンでは、フロントマターが本文テキストに直接続いていると、除外で抑制できないまたがりブロックが1ã...

- **--xlate-glossary**=_glossary_

    翻訳に使用する用語集IDを指定します。このオプションは DeepL エンジン使用時のみ有効です。用語集IDは DeepL アカウントから取得し、特定用語の一貫した翻訳を保証します。

- **--xlate-dryrun**

    翻訳 API を呼び出さず、代わりに進捗表示を通じて、各ペイロードを送信されるとおり（匿名化およびマスキング後）正確に表示します。マシンから何が出ていくかを確認し、実行コã...

- **--**\[**no-**\]**xlate-progress** (Default: True)

    STDERR 出力で翻訳結果をリアルタイムに確認します。`From` ペイロードは、匿名化およびマスキング後に送信されるとおりに表示されます。

- **--xlate-stripe**

    [App::Greple::stripe](https://metacpan.org/pod/App%3A%3AGreple%3A%3Astripe) モジュールを使用して、マッチした部分をゼブラストライプ風に表示します。マッチ部分が背中合わせに連結している場合にæœ...

    端末の背景色に応じてカラーパレットが切り替わります。明示的に指定したい場合は、**--xlate-stripe-light** または **--xlate-stripe-dark** を使用できます。

- **--xlate-mask**

    マスキング機能を実行し、復元せずに変換後のテキストをそのまま表示します。

- **--match-all**

    ファイル全体のテキストを対象領域として設定します。

- **--lineify-cm**
- **--lineify-colon**

    `cm` および `colon` 形式の場合、出力は行ごとに分割して整形されます。したがって、行の一部のみを翻訳すると、期待どおりの結果が得られません。これらのフィルタは、行の一部のã...

    現在の実装では、1行の複数箇所が翻訳された場合、それらは独立した行として出力されます。

# CACHE OPTIONS

**xlate** モジュールは、ファイルごとに翻訳のキャッシュテキストを保存し、実行前に読み込んでサーバーへの問い合わせのオーバーヘッドを排除できます。デフォルトのキャッシュ戦略...

**--xlate-cache=clear** を使用してキャッシュ管理を開始するか、既存のすべてのキャッシュデータをクリーンアップします。このオプションで実行すると、キャッシュファイルが存在しないå...