view release on metacpan or  search on metacpan

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

=encoding utf-8

=head1 NAME

App::Greple::xlate - Greple용 번역 지원 모듈

=head1 SYNOPSIS

    greple -Mxlate::deepl --xlate pattern target-file

    greple -Mxlate::gpt5 --xlate pattern target-file

    greple -Mxlate --xlate-engine gpt5 --xlate pattern target-file

=head1 VERSION

Version 1.0202

=head1 DESCRIPTION

B<Greple> B<xlate> 모듈은 원하는 텍스트 블록을 찾아 번역된 텍스트로 대체합니다. 현재 DeepL (F<deepl.pm>) 및 GPT-5.5 (F<gpt5.pm>) 모듈이 백엔드 엔진으로 구현되어 있습니다.

Perl의 포드 스타일로 작성된 문서에서 일반 텍스트 블록을 번역하려면 다음과 같이 B<greple> 명령과 C<xlate::deepl> 및 C<perl> 모듈을 사용합니다:

    greple -Mxlate::deepl -Mperl --pod --re '^([\w\pP].*\n)+' --all foo.pm

이 명령에서 패턴 문자열 C<^([\w\pP].*\n)+>은 영숫자 및 구두점으로 시작하는 연속된 줄을 의미합니다. 이 명령은 번역할 영역을 강조 표시합니다. 옵션 B<--all>은 전체 텍스트를 생성하는 데 사...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/select-area.png">
</p>

그런 다음 C<--엑스레이트> 옵션을 추가하여 선택한 영역을 번역합니다. 그런 다음 원하는 섹션을 찾아 B<딥> 명령 출력으로 대체합니다.

기본적으로 원본 및 번역된 텍스트는 L<git(1)>과 호환되는 "충돌 마커" 형식으로 인쇄됩니다. C<ifdef> 형식을 사용하면 L<unifdef(1)> 명령으로 원하는 부분을 쉽게 얻을 수 있습니다. 출력 형식은 ...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/format-conflict.png">
</p>

전체 텍스트를 번역하려면 B<--match-all> 옵션을 사용합니다. 이는 전체 텍스트와 일치하는 C<(?s).+> 패턴을 지정하는 단축키입니다.

충돌 마커 형식 데이터는 L<sdif|App::sdif> 명령과 C<-V> 옵션을 사용하여 나란히 나란히 ë³¼ 수 있습니다. 문자열 단위로 비교하는 것은 의미가 없으므로 C<--no-cdif> 옵션을 사용하는 것이 좋습니ë‹...

    sdif -V --no-filename --no-tc --no-cdif data_shishin.deepl-EN-US.cm

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/sdif-cm-view.png">
</p>

=head1 NORMALIZATION

처리는 지정된 단위로 수행되지만 비어 있지 않은 여러 줄의 텍스트 시퀀스의 경우 한 줄로 함께 변환됩니다. 이 작업은 다음과 같이 수행됩니다:

=over 2

=item *

각 줄의 시작과 끝에서 공백을 제거합니다.

=item *

한 줄이 전폭 구두점 문자로 끝나면 다음 줄로 연결합니다.

=item *

한 줄이 전폭 문자로 끝나고 다음 줄이 전폭 문자로 시작되는 경우 두 줄을 연결합니다.

=item *

한 줄의 끝이나 시작이 전폭 문자가 아닌 경우 공백 문자를 삽입하여 연결합니다.

=back

캐시 데이터는 정규화된 텍스트를 기반으로 관리되므로 정규화 결과에 영향을 미치지 않는 수정이 이루어지더라도 캐시된 번역 데이터는 여전히 유효합니다.

이 정규화 프로세스는 첫 번째(0번째) 및 짝수 패턴에 대해서만 수행됩니다. 따라서 다음과 같이 두 개의 패턴을 지정하면 첫 번째 패턴과 일치하는 텍스트는 정규화 후 처리되고 두 번째 패...

    greple -Mxlate -E normalized -E not-normalized

따라서 여러 줄을 한 줄로 결합하여 처리할 텍스트에는 첫 번째 패턴을 사용하고, 미리 서식이 지정된 텍스트에는 두 번째 패턴을 사용합니다. 첫 번째 패턴에 일치할 텍스트가 없는 경우 C<...

=head1 MASKING

간혹 번역하고 싶지 않은 텍스트 부분이 있을 수 있습니다. 예를 들어 마크다운 파일의 태그가 있습니다. DeepL 에서는 이러한 경우 제외할 텍스트 부분을 XML 태그로 변환하여 번역한 다음 번...

    --xlate-setopt maskfile=MASKPATTERN

이것은 파일 C<MASKPATTERN>의 각 줄을 정규 표현식으로 해석하고, 일치하는 문자열을 번역한 후 처리 후 원상태로 복원합니다. C<#>로 시작하는 줄은 무시됩니다.

복잡한 패턴은 백슬래시 에스파스 새줄을 사용하여 여러 줄에 작성할 수 있습니다.

마스킹을 통해 텍스트가 어떻게 변환되는지는 B<--xlate-mask> 옵션에서 확인할 수 있습니다.

이 인터페이스는 실험적이며 향후 변경될 수 있습니다.

=head1 OPTIONS

=over 7

=item B<--xlate>

=item B<--xlate-color>

=item B<--xlate-fold>

=item B<--xlate-fold-width>=I<n> (Default: 70)

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

=item --xlate-cache=I<strategy>

=over 4

=item C<auto> (Default)

캐시 파일이 있는 경우 캐시 파일을 유지 관리합니다.

=item C<create>

빈 캐시 파일을 생성하고 종료합니다.

=item C<always>, C<yes>, C<1>

타겟이 정상 파일인 한 캐시를 유지합니다.

=item C<clear>

캐시 데이터를 먼저 지웁니다.

=item C<never>, C<no>, C<0>

캐시 파일이 존재하더라도 절대 사용하지 않습니다.

=item C<accumulate>

기본 동작에 따라 사용하지 않는 데이터는 캐시 파일에서 제거됩니다. 제거하지 않고 파일에 유지하려면 C<accumulate>를 사용하세요.

=back

=item B<--xlate-update>

이 옵션은 필요하지 않은 경우에도 캐시 파일을 강제로 업데이트합니다.

=back

=head1 COMMAND LINE INTERFACE

이 모듈은 배포에 포함된 C<xlate> 명령을 사용하여 명령줄에서 쉽게 사용할 수 있습니다. 사용법은 C<xlate> 매뉴얼 페이지를 참조하세요.

C<xlate> 명령은 C<--to-lang>, C<--from-lang>, C<--engine> 및 C<--file>와 같은 GNU 스타일의 긴 옵션을 지원합니다. 사용 가능한 모든 옵션을 보려면 C<xlate -h>을 사용하세요.

C<xlate> 명령은 Docker 환경과 함께 작동하므로 아무것도 설치되어 있지 않더라도 Docker를 사용할 수 있으면 사용할 수 있습니다. C<-D> 또는 C<-C> 옵션을 사용합니다.

Docker 작업은 L<App::dozo>으로 처리되며, 독립 실행형 명령으로도 사용할 수 있습니다. C<dozo> 명령은 영구 컨테이너 설정을 위한 C<.dozorc> 구성 파일을 지원합니다.

또한 다양한 문서 스타일에 대한 메이크파일이 제공되므로 특별한 지정 없이 다른 언어로 번역이 가능합니다. C<-M> 옵션을 사용합니다.

Docker와 C<make> 옵션을 결합하여 C<make>를 Docker 환경에서 실행할 수도 있습니다.

C<xlate -C>처럼 실행하면 현재 작업 중인 git 리포지토리가 마운트된 셸이 시작됩니다.

자세한 내용은 L</또는 참조> 섹션의 일본어 기사를 참조하세요.

=head1 EMACS

저장소에 포함된 F<xlate.el> 파일을 로드하여 Emacs 편집기에서 C<xlate> 명령을 사용합니다. C<xlate-region> 함수는 지정된 지역을 번역합니다. 기본 언어는 C<EN-US>이며 접두사 인수를 사용하여 호출...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/emacs.png">
</p>

=head1 ENVIRONMENT

=over 7

=item DEEPL_AUTH_KEY

DeepL 서비스에 대한 인증 키를 설정합니다.

=item OPENAI_API_KEY

OpenAI 인증 키.

=back

=head1 INSTALL

=head2 CPANMINUS

    $ cpanm App::Greple::xlate

=head2 TOOLS

DeepL 및 ChatGPT용 명령줄 도구를 설치해야 합니다.

L<https://github.com/DeepLcom/deepl-python>

L<https://github.com/tecolicom/App-gpty>

=head1 SEE ALSO

=head2 MODULES

L<App::Greple::xlate::deepl>, L<App::Greple::xlate::gpt5>

L<App::dozo> - xlate에서 컨테이너 작업에 사용하는 일반 Docker 러너입니다.

=head2 RELATED MODULES

=over 2

=item * L<App::Greple>

대상 텍스트 패턴에 대한 자세한 내용은 B<greple> 매뉴얼을 참조하세요. B<--내부>, B<--외부>, B<--포함>, B<--제외> 옵션을 사용하여 일치하는 영역을 제한할 수 있습니다.

=item * L<App::Greple::update>

C<-Mupdate> 모듈을 사용하여 B<greple> 명령의 결과에 따라 파일을 수정할 수 있습니다.

=item * L<App::sdif>

충돌 마커 형식을 B<-V> 옵션과 함께 나란히 표시하려면 B<에스디프>를 사용합니다.

=item * L<App::Greple::stripe>

회색 B<줄무늬> 모듈은 B<--xlate-stripe> 옵션으로 사용합니다.

=back