view release on metacpan or  search on metacpan

README.deepl-KO.md  view on Meta::CPAN

            translated Japanese text
            #endif

        일본어 텍스트만 검색하려면 **unifdef** 명령으로 검색할 수 있습니다:

            unifdef -UORIGINAL -DJA foo.ja.pm

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

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

    - **xtxt**

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

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

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

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

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

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

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

    또는 간단한 줄 형식(ì •ê·œ 표현식의 경우 `category pattern`, `/.../`)으로 제공됩니다. 각 항목은 `<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) 라인 형식의 값은 해당 줄 끝에만 주석을 달 수 있으며, 값 뒤에는 주석을 달 수 없습니다.

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

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

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

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

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

    템플릿 표현식(기본값: Jinja2 `{{ ... }}`, `{% ... %}`, `{# ... #}`)을 불투명한 자리 표시자로 취급합니다. 모델에 이를 변경 없이 복사하도록 지시하고, 블록별로 응답에 정확히 동일한 표현식이...

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

- **--xlate-frontmatter**

    선두에 있는 `---` ... `---` 블록을 YAML 프론트 매터로 취급합니다: 번역 및 2단계 컨텍스트 슬라이스에서 이를 제외하고, 안전 장치로서 해당 블록의 평면 `key: value` 값을 익명화 규칙(ì¹´í…Œê³...

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

- **--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-mask**

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

- **--match-all**

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

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

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

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

# CACHE OPTIONS

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

캐시 관리를 시작하거나 기존의 모든 캐시 데이터를 정리하려면 **--xlate-cache=clear**를 사용합니다. 이 옵션을 실행하면 캐시 파일이 없는 경우 새 캐시 파일이 생성되고 이후 자동으로 유지 ê...