Расширенные параметры

Расширенные параметры > Расширенные параметры (текущая)

Содержание

• Аргументы командной строки
• Аргументы
• Аргументы GUI
• #### Руководство по настройке ограничения скорости
• ##### Ограничение скорости RPM (запросов в минуту)
• ##### Ограничение количества одновременных подключений
• ##### Лучшие практики
• Частичный перевод
• Указание исходного и целевого языков
• Перевод с исключениями
• Пользовательский промпт
• Пользовательская конфигурация
• Пропуск очистки
• Кэш перевода
• Развертывание как публичный сервис
• Аутентификация и приветственная страница
• Поддержка глоссария

Аргументы командной строки

Выполните команду перевода в командной строке, чтобы сгенерировать переведенный документ example-mono.pdf и двуязычный документ example-dual.pdf в текущей рабочей директории. В качестве сервиса перевода по умолчанию используется Google. Дополнительные поддерживаемые сервисы перевода можно найти ЗДЕСЬ.

В следующей таблице перечислены все расширенные параметры для справки:

Аргументы

Аргументы GUI

⬆️ Наверх

Руководство по настройке ограничения скорости

При использовании служб перевода правильная настройка ограничения скорости крайне важна для предотвращения ошибок API и оптимизации производительности. В этом руководстве объясняется, как настроить параметры --qps и --pool-max-worker в зависимости от ограничений различных вышестоящих служб.

Ограничение скорости RPM (запросов в минуту)

Если вышестоящий сервис имеет ограничения RPM, используйте следующий расчет:

Формула расчета: - qps = floor(rpm / 60) - pool_size = qps * 10

Пример: Если ваша служба перевода имеет ограничение в 600 RPM: - qps = floor(600 / 60) = 10 - pool_size = 10 * 10 = 100

pdf2zh example.pdf --qps 10 --pool-max-worker 100

Ограничение количества одновременных подключений

Если вышестоящий сервис имеет ограничения на количество одновременных подключений (например, официальный сервис GLM), используйте этот подход:

Формула расчета: - pool_size = max(floor(0.9 * official_concurrent_limit), official_concurrent_limit - 20) - qps = pool_size

Пример: Если ваша служба перевода позволяет 50 одновременных подключений: - pool_size = max(floor(0.9 * 50), 50 - 20) = max(45, 30) = 45 - qps = 45

pdf2zh example.pdf --qps 45 --pool-max-worker 45

Лучшие практики

⬆️ Наверх

Частичный перевод

Используйте параметр --pages для перевода части документа.

• Если номера страниц идут подряд, можно записать это так:

pdf2zh_next example.pdf --pages 1-3

pdf2zh_next example.pdf --pages 25-

• Если страницы не идут подряд, вы можете использовать запятую , для их разделения.

Например, если вы хотите перевести первую и третью страницы, вы можете использовать следующую команду:

pdf2zh_next example.pdf --pages "1,3"

• Если страницы включают как последовательные, так и непоследовательные диапазоны, вы также можете соединить их запятой, например:

pdf2zh_next example.pdf --pages "1,3,10-20,25-"

Эта команда переведет первую страницу, третью страницу, страницы с 10 по 20 и все страницы с 25 до конца.

⬆️ Наверх

Указание исходного и целевого языков

См. Google Languages Codes, DeepL Languages Codes

pdf2zh_next example.pdf --lang-in en -lang-out ja

⬆️ Наверх

Перевод с исключениями

Используйте регулярные выражения для указания шрифтов формул и символов, которые необходимо сохранить:

pdf2zh_next example.pdf --formular-font-pattern "(CM[^RT].*|MS.*|.*Ital)" --formular-char-pattern "(\(|\||\)|\+|=|\d|[\u0080-\ufaff])"

Сохранять шрифты Latex, Mono, Code, Italic, Symbol и Math по умолчанию:

pdf2zh_next example.pdf --formular-font-pattern "(CM[^R]|MS.M|XY|MT|BL|RM|EU|LA|RS|LINE|LCIRCLE|TeX-|rsfs|txsy|wasy|stmary|.*Mono|.*Code|.*Ital|.*Sym|.*Math)"

⬆️ Наверх

Пользовательский запрос

Пользовательский системный запрос для перевода. В основном используется для добавления инструкции '/no_think' Qwen 3 в запрос.

pdf2zh_next example.pdf --custom-system-prompt "/no_think You are a professional and reliable machine translation engine responsible for translating the input text into zh_CN.When translating, strictly follow the instructions below to ensure translation quality and preserve all formatting, tags, and placeholders:"

⬆️ Наверх

Пользовательская конфигурация

Существует несколько способов изменения и импорта файла конфигурации.

• Изменение конфигурации через аргументы командной строки

В большинстве случаев вы можете напрямую передать желаемые настройки через аргументы командной строки. Подробнее см. в разделе Аргументы командной строки.

Например, если вы хотите включить окно GUI, можно использовать следующую команду:

pdf2zh_next --gui

• Изменение конфигурации через переменные среды

Вы можете заменить -- в аргументах командной строки на PDF2ZH_, соединять параметры с помощью =, а также заменять - на _ в качестве переменных окружения.

Например, если вы хотите включить окно GUI, вы можете использовать следующую команду:

PDF2ZH_GUI=TRUE pdf2zh_next

• Пользовательский Файл конфигурации

Вы можете указать файл конфигурации, используя следующий аргумент командной строки:

pdf2zh_next --config-file '/path/config.toml'

Если вы не уверены в формате конфигурационного файла, обратитесь к стандартному конфигурационному файлу, описанному ниже.

• Файл конфигурации по умолчанию

Файл конфигурации по умолчанию находится в ~/.config/pdf2zh.
Пожалуйста, не изменяйте файлы конфигурации в каталоге default.
Настоятельно рекомендуется ознакомиться с содержимым этого файла конфигурации и использовать Пользовательскую конфигурацию для реализации собственного файла конфигурации.

⬆️ Наверх

Пропустить очистку

Когда этот параметр установлен в значение True, шаг очистки PDF будет пропущен, что может повысить совместимость и избежать некоторых проблем с обработкой шрифтов.

Использование:

pdf2zh_next example.pdf --skip-clean

Или использование переменных окружения:

PDF2ZH_SKIP_CLEAN=TRUE pdf2zh_next example.pdf

Кэш перевода

PDFMathTranslate кэширует переведенные тексты для увеличения скорости и избежания ненужных вызовов API для одинакового содержимого. Вы можете использовать опцию --ignore-cache, чтобы игнорировать кэш перевода и принудительно выполнить повторный перевод.

pdf2zh_next example.pdf --ignore-cache

⬆️ Наверх

Развертывание в качестве общедоступных сервисов

При развертывании графического интерфейса pdf2zh в общедоступных сервисах вам следует изменить конфигурационный файл, как описано ниже.

Вот пример рабочей конфигурации:

[basic]
gui = true

[gui_settings]
enabled_services = "Bing,OpenAI"
disable_gui_sensitive_input = true
disable_config_auto_save = true

⬆️ Наверх

Аутентификация и приветственная страница

При использовании аутентификации и приветственной страницы для указания, какой пользователь может использовать Web UI и настройки страницы входа:

пример auth.txt Каждая строка содержит два элемента: имя пользователя и пароль, разделенные запятой.

admin,123456
user1,password1
user2,abc123
guest,guest123
test,test123

пример welcome.html

<!DOCTYPE html>
<html>
<head>
    <title>Simple HTML</title>
</head>
<body>
    <h1>Hello, World!</h1>
    <p>Welcome to my simple HTML page.</p>
</body>
</html>

Вот пример рабочей конфигурации:

[basic]
gui = true

[gui_settings]
auth_file = "/path/to/auth/file"
welcome_page = "/path/to/welcome/html/file"

⬆️ Наверх

Поддержка глоссария

PDFMathTranslate поддерживает таблицу глоссария. Файл таблицы глоссария должен быть в формате csv. В файле три столбца. Вот демонстрационный файл глоссария:

Для пользователей CLI: Вы можете использовать несколько файлов для глоссария. Разные файлы должны быть разделены ,.

pdf2zh_next example.pdf --glossaries "glossary1.csv,glossary2.csv,glossary3.csv"

Для пользователей WebUI:

Теперь вы можете загрузить свой собственный файл глоссария. После загрузки файла вы можете проверить его, нажав на его имя, и содержимое отобразится ниже.

⬆️ Наверх