view release on metacpan or  search on metacpan

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

# NAME

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

# SYNOPSIS

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

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

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

# VERSION

Version 1.0202

# DESCRIPTION

**Greple** **xlate** модуль находит нужные текстовые блоки и заменяет их переведенным текстом. В настоящее время DeepL (`deepl.pm`) и модуль GPT-5.5 (`gpt5.pm`) ре...

Если вы хотите переводить обычные текстовые блоки в документе, написанном в стиле pod языка Perl, используйте команду **greple** с модулями `xlate::d...

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

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

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

Затем добавьте опцию `--xlate` для перевода выбранной области. После этого будут найдены нужные разделы и заменены выводом команды **deepl**.

По умолчанию исходный и переведенный текст выводятся в формате «маркер конфликта», совместимом с [git(1)](http://man.he.net/man1/git). Используя формат ...

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

Если вы хотите перевести весь текст, используйте опцию **--match-all**. Это сокращение для указания шаблона `(?s).+`, который соответствует всему т...

Данные в формате маркеров конфликтов можно просматривать в поколоночном виде командой [sdif](https://metacpan.org/pod/App%3A%3Asdif) с опцией `-V`. Поскольку Ð...

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

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

# NORMALIZATION

Обработка выполняется в заданных единицах, но в случае последовательности из нескольких строк непустого текста они преобразуются вмесÑ...

- Удалите пробелы в начале и в конце каждой строки.
- Если строка заканчивается полноширинным знаком препинания, объедините с следующей строкой.
- Если строка заканчивается полноширинным символом и следующая строка начинается полноширинным символом, объедините строки.
- Если либо конец, либо начало строки не является полноширинным символом, объедините их, вставив пробел.

Данные кэша управляются на основе нормализованного текста, поэтому даже если вносятся изменения, не влияющие на результаты нормализаци...

Этот процесс нормализации выполняется только для первого (0-го) и четных шаблонов. Таким образом, если указаны два шаблона, как показано н...

    greple -Mxlate -E normalized -E not-normalized

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

# MASKING

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

    --xlate-setopt maskfile=MASKPATTERN

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

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

То, как текст преобразуется при маскировании, можно увидеть с опцией **--xlate-mask**.

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

# OPTIONS

- **--xlate**
- **--xlate-color**
- **--xlate-fold**
- **--xlate-fold-width**=_n_ (Default: 70)

    Запустить процесс перевода для каждой совпавшей области.

    Без этой опции **greple** работает как обычная команда поиска. Так вы можете проверить, какая часть файла будет подвергнута переводу, прежд...

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

    Опция **--xlate** вызывает опцию **--xlate-color** с опцией **--color=never**.

    С опцией **--xlate-fold** преобразованный текст переносится по указанной ширине. Ширина по умолчанию — 70 и может быть задана опцией **--xlate-fold-wi...

- **--xlate-engine**=_engine_

    Указывает, какой использовать движок перевода. Если вы укажете модуль движка напрямую, например `-Mxlate::deepl`, эту опцию можно не использоÐ...

    В настоящее время доступны следующие движки

    - **deepl**: DeepL API
    - **gpt3**: gpt-3.5-turbo
    - **gpt4o**: gpt-4o-mini

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

    В текущей реализации, если переводятся несколько частей одной строки, они выводятся как независимые строки.

# CACHE OPTIONS

Модуль **xlate** может кэшировать переводы для каждого файла и читать их перед выполнением, чтобы устранить накладные расходы на обращение Ð...

Используйте **--xlate-cache=clear** для инициализации управления кэшем или очистки всех существующих кэш-данных. После выполнения с этой опцией нÐ...

- --xlate-cache=_strategy_
    - `auto` (Default)

        Поддерживать кэш-файл, если он существует.

    - `create`

        Создать пустой кэш-файл и выйти.

    - `always`, `yes`, `1`

        В любом случае поддерживать кеш, если целевой объект — обычный файл.

    - `clear`

        Сначала очистите данные кеша.

    - `never`, `no`, `0`

        Никогда не используйте файл кеша, даже если он существует.

    - `accumulate`

        По умолчанию неиспользуемые данные удаляются из файла кеша. Если вы не хотите их удалять и хотите сохранить в файле, используйте `accum...
- **--xlate-update**

    Эта опция принудительно обновляет файл кеша, даже если в этом нет необходимости.

# COMMAND LINE INTERFACE

Вы можете легко использовать этот модуль из командной строки с помощью команды `xlate`, включенной в дистрибутив. См. страницу руководства `...

Команда `xlate` поддерживает длинные параметры в стиле GNU, такие как `--to-lang`, `--from-lang`, `--engine` и `--file`. Используйте `xlate -h` для просмотра всех досту...

Команда `xlate` работает совместно со средой Docker, поэтому, даже если у вас ничего не установлено, вы можете использовать её при наличии Docker. Ð...

Операции Docker обрабатываются с помощью [App::dozo](https://metacpan.org/pod/App%3A%3Adozo), который также можно использовать как самостоятельную команду. Коман...

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

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

Запуск вида `xlate -C` откроет оболочку с примонтированным текущим рабочим репозиторием git.

Подробности см. в японской статье в разделе ["SEE ALSO"](#see-also).

# EMACS

Загрузите файл `xlate.el`, включённый в репозиторий, чтобы использовать команду `xlate` из редактора Emacs. Функция `xlate-region` переводит заданный рег...

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

# ENVIRONMENT

- DEEPL\_AUTH\_KEY

    Установите свой ключ аутентификации для сервиса DeepL.

- OPENAI\_API\_KEY

    Ключ аутентификации OpenAI.

# INSTALL

## CPANMINUS

    $ cpanm App::Greple::xlate

## TOOLS

Необходимо установить инструменты командной строки для DeepL и ChatGPT.

[https://github.com/DeepLcom/deepl-python](https://github.com/DeepLcom/deepl-python)

[https://github.com/tecolicom/App-gpty](https://github.com/tecolicom/App-gpty)

# SEE ALSO

## MODULES

[App::Greple::xlate::deepl](https://metacpan.org/pod/App%3A%3AGreple%3A%3Axlate%3A%3Adeepl), [App::Greple::xlate::gpt5](https://metacpan.org/pod/App%3A%3AGreple%3A%3Axlate%3A%3Agpt5)

[App::dozo](https://metacpan.org/pod/App%3A%3Adozo) — универсальный запускатель Docker, используемый xlate для операций с контейнерами

## RELATED MODULES

- [App::Greple](https://metacpan.org/pod/App%3A%3AGreple)

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

- [App::Greple::update](https://metacpan.org/pod/App%3A%3AGreple%3A%3Aupdate)

    Вы можете использовать модуль `-Mupdate` для изменения файлов по результатам команды **greple**.

- [App::sdif](https://metacpan.org/pod/App%3A%3Asdif)

    Используйте **sdif** для отображения формата маркера конфликта рядом с опцией **-V**.

- [App::Greple::stripe](https://metacpan.org/pod/App%3A%3AGreple%3A%3Astripe)

    Модуль Greple **stripe** используется опцией **--xlate-stripe**.

## RESOURCES

- [https://hub.docker.com/r/tecolicom/xlate](https://hub.docker.com/r/tecolicom/xlate)

    Образ контейнера Docker.

- [https://github.com/tecolicom/getoptlong](https://github.com/tecolicom/getoptlong)