view release on metacpan or  search on metacpan

i18n/src/xlate.deepl-KO.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+>

원본 텍스트와 변환된 텍스트는 하나의 빈 줄로 구분하여 인쇄됩니다. C<스페이스+>의 경우 변환된 텍스트 뒤에 줄 바꿈도 출력합니다.

=item B<xtxt>

형식이 C<xtxt>(번역된 텍스트) 또는 알 수 없는 경우 번역된 텍스트만 인쇄됩니다.

=back

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

API에 한 번에 전송할 텍스트의 최대 길이를 지정합니다. 기본값 0은 엔진 자체의 제한을 의미합니다. 무료 DeepL 계정 서비스의 경우 API(B<--xlate>)는 128K, 클립보드 인터페이스(B<--xlate-labor>)는 5...

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

한 번에 API로 전송할 텍스트의 최대 줄 수를 지정합니다.

한 번에 한 줄씩 번역하려면 이 값을 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로 전송하기 전에 익명화하고, 출력 시 원본을 복원합니다. 사전 파일은 항목당 하나의 항목을 제공하며, JSON 형식(표준, 기계 생성 가능)

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

또는 간단한 라인 형식(C<category pattern>,  는C</.../> 정규식)으로 지정할 수 있습니다. 각 항목은  와 같은 카테고리 태그로 대체됩니다C<< <person id="1" /> >>. 동일한 문자열에는 항상 동일한 태그ê...

사전(dictionary)은 외부 도구(예: 민감한 엔티티를 추출하는 로컬 모델)를 통해 생성될 수 있습니다:

    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은 허용됩니다. 프론트 매터(front matter) 라인 형식의 값은 해당 줄 끝에만 주석을 달 수 있으며, 값 뒤에는 주석을 달 수 없습니다.

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

문서 자체의 인라인 마크에서 익명화 항목을 수집합니다. 첫 번째 출현을 C<{{ person("山田太郎") }}>와 같이 표시하면 문서 전체에서 해당 문자열이 나타나는 모든 위치가 익명화됩니다. 마크 ...

이와 같이 값이 선택적인 옵션의 경우, 뒤따르는 파일 인수가 값으로 간주된다는 점에 유의하십시오. 기본 표기법을 사용할 때는 C<--xlate-anonymize-mark=>(뒤에 C<=>가 붙은 형태)를 작성하십시오...

대체 표기법을 구성할 수 있습니다. 예를 들어, C<@@person:NAME@@> 스타일의 마크에 대해 C<< --xlate-anonymize-mark='@@(?<category>[a-z][a-z0-9_]*):(?<text>[^\n]+?)@@' >>을 사용하거나, 렌더링된 마크다운에서 ë³´ì...

=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<---> 뒤에는 항상 빈 줄을 남겨야 합니다. 단락 스타일의 일치 패턴을 사용할 경우, 본문 텍스트와 바로 이어지는 프론트 매터는 하나의 걸쳐 있는 블록을 형성하며, 이 블록은 제...

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

번역에 사용할 용어집 ID를 지정합니다. 이 옵션은 DeepL 엔진을 사용할 때만 사용할 수 있습니다. 용어집 ID는 DeepL 계정에서 가져와야 하며 특정 용어의 일관된 번역을 보장합니다.

=item B<--xlate-dryrun>