view release on metacpan or  search on metacpan

i18n/src/xlate.deepl-JA.pod  view on Meta::CPAN

=item B<colon>, I<:::::::>

元のテキストと翻訳されたテキストは、マークダウンのカスタム・コンテナ・スタイルで出力されます。

    ::::::: ORIGINAL
    original text
    :::::::
    ::::::: JA
    translated Japanese text
    :::::::

上記のテキストはHTMLでは以下のように翻訳されます。

    <div class="ORIGINAL">
    original text
    </div>
    <div class="JA">
    translated Japanese text
    </div>

コロンの数はデフォルトでは7です。C<::::>のようにコロン列を指定すると、7コロンの代わりにそれが使われます。

=item B<ifdef>

原文と訳文はL<cpp(1)> C<#ifdef>形式で出力されます。

    #ifdef ORIGINAL
    original text
    #endif
    #ifdef JA
    translated Japanese text
    #endif

B<unifdef>コマンドで日本語のテキストだけを取り出すことができます：

    unifdef -UORIGINAL -DJA foo.ja.pm

=item B<space>

=item B<space+>

変換前のテキストと変換後のテキストは1行の空白行で区切られて出力されます。C<space+>の場合は、変換後のテキストの後に改行も出力されます。

=item B<xtxt>

形式がC<xtxt>（翻訳済みテキスト）または未知の場合は、翻訳済みテキストのみが印刷されます。

=back

=item B<--xlate-maxlen>=I<chars> (Default: 0)

API に一度に送信するテキストの最大長を指定します。 デフォルト値の 0 は、エンジン独自の制限を意味します。DeepLの無料アカウントサービスの場合、API (B<--xlate>) では128K、クリップボ...

=item B<--xlate-maxline>=I<n> (Default: 0)

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

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

=item B<--xlate-prompt>=I<text>

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

=item B<--xlate-context>=I<text>

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

=item B<--xlate-context-window>=I<n>

(Context-aware engines only, e.g. C<gpt5> on the llm backend)
変更されたブロックを再翻訳する際に、参照コンテキストとして渡されます、そのブロックを囲む翻訳済みブロックの数（デフォルトは 2）。このコンテキストには、変更された領域をå›...

=item B<--xlate-cache-seed>=I<file>

別のドキュメントのキャッシュファイルから、新しいドキュメントのキャッシュを初期化します。定期的なレポートの作成に有用です。新しい号のキャッシュに前の号のキャッシュをシã...

=item B<--xlate-anonymize>=I<file>

機密性の高い文字列を翻訳APIに送信する前に匿名化し、出力時に復元します。辞書ファイルには、項目ごとに1つのエントリが記載されます：JSON形式（標準的、機械生成可能）

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

または、シンプルな行形式（正規表現C</.../>の場合は `C<category pattern>, `）で指定します。各項目は `` などのカテゴリタグに置換されますC<< <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 は許容されます。フロントマター行形式の値には、値の直後ではなく、その行の末尾にのみコメントを付加できます。

=item B<--xlate-anonymize-mark>[=I<regex>]

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

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

代替表記を設定することも可能です。例えば、C<@@person:NAME@@> 形式のマークには C<< --xlate-anonymize-mark='@@(?<category>[a-z][a-z0-9_]*):(?<text>[^\n]+?)@@' >> を使用したり、レンダリングされた Markdown で...

=item B<--xlate-template>[=I<regex>]

テンプレート式（デフォルト：Jinja2 C<{{ ... }}>、C<{% ... %}>、C<{# ... #}>）を不透明なプレースホルダーとして扱います。モデルに対して、それらをそのままコピーし、ブロックごとに、応答...

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

=item B<--xlate-frontmatter>

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

閉じタグ C<---> の後には常に空行を挿入してください。段落形式のマッチパターンを使用する場合、本文に直接続くフロントマターは、除外処理では抑制できない1つのまたがりブロックã...

=item B<--xlate-glossary>=I<glossary>

翻訳に使用する用語集IDを指定します。このオプションは、DeepL エンジンを使用する場合にのみ使用できます。用語集 ID は、DeepL アカウントから取得する必要があり、特定の用語の一貫ã...

=item B<--xlate-dryrun>