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

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

Оглавление

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

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

Выполните команду перевода в командной строке, чтобы сгенерировать переведенный документ 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

example 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:

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

⬆️ Наверх