view release on metacpan or  search on metacpan

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

# NAME

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

# SYNOPSIS

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

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

# VERSION

Version 2.01

# DESCRIPTION

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

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

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

    greple -Mxlate --xlate-engine gpt5 -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` для перевода выбранной области. После этого будут найдены нужные разделы и заменены выводом механизма перево...

По умолчанию исходный и переведенный текст выводятся в формате «маркер конфликта», совместимом с [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**.

Маскирование защищает разметку от перевода. Чтобы скрыть конфиденциальные строки от самой службы перевода, см. ["ANONYMIZATION AND TEMPLATES"](#anonymizatio...

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

# ANONYMIZATION AND TEMPLATES

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

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

    ---
    報告者: 山田太郎
    発注会社: アクメ株式会社
    ---
    本件について {{ 報告者 }} が調査を行った。

Переведите шаблон один раз для каждого языка с `--xlate-template` (и `--xlate-frontmatter`, когда значения сохраняются в файле), затем визуализируйте каждыÐ...

    greple -Mxlate --xlate --xlate-engine=gpt5 --xlate-to=EN-US \
           --xlate-template= --xlate-format=xtxt \
           --match-paragraph --all --need=0 \
           report-template.md > report-template.EN.md
    pandoc-embedz --standalone report-template.EN.md \
                  -c case-123.yaml -o report-123.EN.md < /dev/null

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

    # macros.yaml           # macros-redacted.yaml

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

- GREPLE\_XLATE\_CACHE

    Установите стратегию кэша по умолчанию (см. ["CACHE OPTIONS"](#cache-options)).

# INSTALL

## CPANMINUS

    $ cpanm App::Greple::xlate

## TOOLS

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

[https://llm.datasette.io/](https://llm.datasette.io/)

[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::llm](https://metacpan.org/pod/App%3A%3AGreple%3A%3Axlate%3A%3Allm), [App::Greple::xlate::deepl](https://metacpan.org/pod/App%3A%3AGreple%3A%3Axlate%3A%3Adeepl)

[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