view release on metacpan or  search on metacpan

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

        다음 [sed(1)](http://man.he.net/man1/sed) 명령으로 원본 파일을 복구할 수 있습니다.

            sed -e '/^<<<<<<< /d' -e '/^=======$/,/^>>>>>>> /d'

    - **colon**, _:::::::_

        원본 텍스트와 번역된 텍스트는 마크다운의 사용자 정의 컨테이너 스타일로 출력됩니다.

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

        위의 텍스트는 HTML에서 다음과 같이 번역됩니다.

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

        콜론 개수는 기본적으로 7입니다. `:::::`와 같이 콜론 순서를 지정하면 콜론 7개 대신 사용됩니다.

    - **ifdef**

        원본 텍스트와 변환된 텍스트는 [cpp(1)](http://man.he.net/man1/cpp) `#ifdef` 형식으로 인쇄됩니다.

            #ifdef ORIGINAL
            original text
            #endif
            #ifdef JA
            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**