view release on metacpan or  search on metacpan

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

            translated Japanese text
            #endif

        **unifdef** 명령으로 일본어 텍스트만 추출할 수 있습니다:

            unifdef -UORIGINAL -DJA foo.ja.pm

    - **space**
    - **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`, regex의 경우 `/.../`)입니다. 각 항목은 `<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은 허용됩니다. front matter 줄 형식의 값은 값 뒤가 아니라 별도의 줄에만 후행 주석을 가질 수 있습니다.

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

    문서 자체의 인라인 표시에서 익명화 엔트리를 수집합니다. 첫 번째 출현을 `{{ person("山田太郎") }}`처럼 표시하면 문서 전체에서 해당 문자열의 모든 출현이 익명화됩니다. 표시 자체는 ì...

    이와 같은 선택적 값 옵션에서는 뒤따르는 파일 인수가 값으로 간주된다는 점에 유의하십시오. 기본 표기법을 사용할 때는 `--xlate-anonymize-mark=`(뒤에 `=` 포함)라고 작성하십시오.

    대체 표기법을 구성할 수 있습니다. 예를 들어 `@@person:NAME@@` 스타일 표시에는 `--xlate-anonymize-mark='@@(?<category>[a-z][a-z0-9_]*):(?<text>[^\n]+?)@@'`를, 렌더링된 Markdown에서 보이지 않는 HTML 주석 형ì‹...

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

    템플릿 표현식(기본값: Jinja2 `{{ ... }}`, `{% ... %}`, `{# ... #}`)을 불투명한 플레이스홀더로 취급합니다. 모델에 이를 변경하지 ì•Šê³  복사하도록 지시하고, 블록별로 응답에 정확히 동일한 í‘œí...

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

- **--xlate-frontmatter**

    선행 `---` ... `---` 블록을 YAML 프런트 매터로 취급합니다. 이를 번역 및 phase-2 컨텍스트 슬라이스에서 제외하고, 안전망으로 그 평면 `key: value` 값들을 익명화 규칙(범주 `var`)에 추가합니다...

    항상 닫는 `---` 뒤에 빈 줄을 남겨 두십시오. 문단 스타일의 일치 패턴에서는 본문 텍스트로 바로 이어지는 프런트 매터가 제외로 억제할 수 없는 걸친 블록 하나를 형성합니다(이 경우 ê²...

- **--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` 형식의 경우 출력이 줄 단위로 분할되어 포맷됩니다. 따라서 í•œ 줄의 일부만 번역할 경우 기대한 결과를 얻을 수 없습니다. 이 필터들은 í•œ 줄의 일부를 번역하여 출력이 손ì...

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

# CACHE OPTIONS

**xlate** 모듈은 파일별 번역 텍스트를 캐시로 저장하고 실행 전에 읽어 서버 요청 오버헤드를 제거할 수 있습니다. 기본 캐시 전략 `auto`에서는 대상 파일에 캐시 파일이 존재할 때만 캐시 데...

**--xlate-cache=clear**를 사용하여 캐시 관리를 시작하거나 기존의 모든 캐시 데이터를 정리하십시오. 이 옵션으로 í•œ 번 실행되면 캐시 파일이 없을 경우 새 캐시 파일이 생성되고 이후 자동으ë...