view release on metacpan or  search on metacpan

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

=encoding utf-8

=head1 NAME

App::Greple::xlate - модуль поддержки перевода для greple

=head1 SYNOPSIS

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

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

=head1 VERSION

Version 2.01

=head1 DESCRIPTION

B<Greple> B<xlate> модуль находит нужные текстовые блоки и заменяет их переведённым текстом. Основным движком является GPT-5.5 (F<llm/gpt5.pm>), который вы...

Переводы кэшируются по файлам, поэтому повторный запуск команды не требует затрат для неизменённого текста. При редактировании докумен...

Если вы хотите перевести обычные блоки текста в документе, написанном в стиле pod языка Perl, используйте команду B<greple> с модулями C<--xlate-engine g...

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

В этой команде шаблонная строка C<^([\w\pP].*\n)+> означает последовательные строки, начинающиеся с букв алфавитно-цифрового ряда и знаков преп...

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

Затем добавьте опцию C<--xlate> для перевода выделенного фрагмента. После этого система найдёт нужные фрагменты и заменит их результатом раÐ...

По умолчанию оригинальный и транслированный текст печатается в формате "маркер конфликта", совместимом с L<git(1)>. Используя формат C<ifdef>, мÐ...

=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>. Поскольку сравнивÐ...

    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

Поэтому используйте первый шаблон для текста, который должен быть обработан путем объединения нескольких строк в одну, а второй - для прÐ...

=head1 MASKING

Иногда встречаются части текста, которые не нужно переводить. Например, теги в файлах формата markdown. На сайте DeepL предлагается в таких слуÑ...

    --xlate-setopt maskfile=MASKPATTERN

Это будет интерпретировать каждую строку файла C<MASKPATTERN> как регулярное выражение, переводить строку, соответствующую ему, и возвращать Ð...

Сложный шаблон можно записать на нескольких строках с использованием обратного слеша для экранирования символа новой строки.

Как текст преобразуется при маскировании, можно увидеть с помощью опции B<--xlate-mask>.

Маскировка защищает разметку от перевода. Чтобы скрыть конфиденциальные строки от самого сервиса перевода, см. L</ANONYMIZATION AND TEMPLATES>; оба меÑ...

Этот интерфейс является экспериментальным и может быть изменен в будущем.

=head1 ANONYMIZATION AND TEMPLATES

Конфиденциальные строки можно скрыть перед отправкой в API перевода и восстановить в выходных данных. Доступны три источника правил анон...

Для документов-шаблонов (квартальных отчётов и т. п.) заранее определите участники и ссылайтесь на них в тексте:

    ---
    報告者: 山田太郎
    発注会社: アクメ株式会社
    ---

i18n/src/xlate.deepl-RU.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> поддерживает длинные опции в стиле GNU, такие как C<--to-lang>, C<--from-lang>, C<--engine> и C<--file>. Используйте C<xlate -h>, чтобы увидеть все доступÐ...

Команда C<xlate> работает совместно со средой Docker, поэтому даже если у вас ничего не установлено, вы можете использовать ее, пока доступен Dock...

Операции Docker выполняются командой L<App::dozo>, которая также может использоваться как отдельная команда. Команда C<dozo> поддерживает конфигур...

Кроме того, поскольку в комплекте поставляются make-файлы для различных стилей документов, перевод на другие языки возможен без специальн...

Вы также можете комбинировать опции Docker и C<make>, чтобы запустить C<make> в среде Docker.

Выполнение C<xlate -C> запустит оболочку с подключенным текущим рабочим git-репозиторием.

Подробности читайте в японской статье в разделе L</SEE ALSO>.

=head1 EMACS

Загрузите файл F<xlate.el>, включенный в репозиторий, чтобы использовать команду C<xlate> из редактора Emacs. Функция C<xlate-region> переводит заданный Ñ€Ð...

=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, используемый устаревшими движками B<gpty>. Движок B<gpt5>, основанный на C<llm>, также считывает эту переменную, но ключи...

=item GREPLE_XLATE_CACHE

Установите стратегию кэширования по умолчанию (см. L</CACHE OPTIONS>).

=back

=head1 INSTALL

=head2 CPANMINUS

    $ cpanm App::Greple::xlate

=head2 TOOLS

Установите инструмент командной строки для используемого вами движка: C<llm> для движка B<gpt5>, C<deepl> для DeepL, C<gpty> для устаревших движков GPT.

L<https://llm.datasette.io/>

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

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

=head1 SEE ALSO

=head2 MODULES

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

L<App::dozo> - общий Docker runner, используемый xlate для операций с контейнерами.

=head2 RELATED MODULES

=over 2

=item * L<App::Greple>

Подробную информацию о шаблоне целевого текста см. в руководстве B<greple>. Используйте опции B<--inside>, B<--outside>, B<--include>, B<--exclude> для ограничения Ð...

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

Вы можете использовать модуль C<-Mupdate> для модификации файлов по результатам команды B<greple>.

=item * L<App::sdif>

Используйте B<sdif>, чтобы показать формат маркера конфликта бок о бок с опцией B<-V>.