view release on metacpan or  search on metacpan

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

일본어 텍스트만 검색하려면 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>

번역 API를 호출하지 말고, 대신 진행 상황 표시를 통해 각 페이로드를 (익명화 및 마스킹 후) 전송될 그대로 정확히 보여주십시오. 이는 시스템에서 ì–´ë–¤ 데이터가 전송되는지 확인하고 실í–...

=item B<-->[B<no->]B<xlate-progress> (Default: True)

STDERR 출력에서 번역 결과를 실시간으로 확인할 수 있습니다. C<From> 페이로드는 익명화 및 마스킹 처리 후 전송되는 그대로 표시됩니다.

=item B<--xlate-stripe>

일치하는 부분을 지브라 스트라이프 방식으로 표시하려면 L<App::Greple::stripe> 모듈을 사용합니다. 이 옵션은 일치하는 부분이 연속적으로 연결될 때 유용합니다.

색상 팔레트는 단말기의 배경색에 따라 전환됩니다. 명시적으로 지정하고 싶으면 B<--지연 스트라이프-밝음> 또는 B<--지연 스트라이프-어두움>을 사용할 수 있습니다.

=item B<--xlate-mask>

마스킹 기능을 수행하여 변환된 텍스트를 복원하지 않고 그대로 표시합니다.

=item B<--match-all>

파일의 전체 텍스트를 대상 영역으로 설정합니다.

=item B<--lineify-cm>

=item B<--lineify-colon>

C<cm> 및 C<colon> 형식의 경우 출력이 한 줄씩 분할되어 형식이 지정됩니다. 따라서 한 줄의 일부만 번역해야 하는 경우 예상되는 결과를 얻을 수 없습니다. 이 필터는 한 줄의 일부를 정상적인...

현재 구현에서는 한 줄의 여러 부분이 번역되는 경우 독립된 줄로 출력됩니다.

=back

=head1 CACHE OPTIONS

B<엑스레이트> 모듈은 각 파일에 대한 번역 텍스트를 캐시하여 저장하고 실행 전에 읽어들여 서버에 요청하는 오버헤드를 없앨 수 있습니다. 기본 캐시 ì „ëžµ C<auto>를 사용하면 대상 파일에 ë...