Opciones avanzadas

Opciones avanzadas > Opciones avanzadas (actual)

Tabla de Contenidos

• Argumentos de línea de comandos
• Guía de configuración de límites de tasa
• Traducción parcial
• Especificar idiomas de origen y destino
• Traducir con excepciones
• Custom prompt
• Configuración personalizada
• Omitir limpieza
• Caché de traducción
• Despliegue como servicios públicos
• Autenticación y página de bienvenida
• Glosario de soporte

Argumentos de línea de comandos

Ejecuta el comando de traducción en la línea de comandos para generar el documento traducido example-mono.pdf y el documento bilingüe example-dual.pdf en el directorio de trabajo actual. Utiliza Google como servicio de traducción predeterminado. Más servicios de traducción compatibles se pueden encontrar AQUÍ.

En la siguiente tabla, enumeramos todas las opciones avanzadas para referencia:

Argumentos

Argumentos de GUI

⬆️ Volver al inicio

Guía de configuración de límites de tasa

Al usar servicios de traducción, una configuración adecuada de límites de tasa es crucial para evitar errores de API y optimizar el rendimiento. Esta guía explica cómo configurar los parámetros --qps y --pool-max-worker según las diferentes limitaciones de los servicios ascendentes.

Límite de RPM (Solicitudes Por Minuto)

Cuando el servicio ascendente tiene limitaciones de RPM, utiliza el siguiente cálculo:

Fórmula de cálculo: - qps = floor(rpm / 60) - pool_size = qps * 10

Ejemplo: Si tu servicio de traducción tiene un límite de 600 RPM: - qps = floor(600 / 60) = 10 - pool_size = 10 * 10 = 100

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

Limitación de conexiones concurrentes

Cuando el servicio ascendente tiene limitaciones de conexiones concurrentes (como el servicio oficial de GLM), utiliza este enfoque:

Fórmula de cálculo: - pool_size = max(floor(0.9 * official_concurrent_limit), official_concurrent_limit - 20) - qps = pool_size

Ejemplo: Si tu servicio de traducción permite 50 conexiones concurrentes: - pool_size = max(floor(0.9 * 50), 50 - 20) = max(45, 30) = 45 - qps = 45

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

Mejores prácticas

⬆️ Volver al inicio

Traducción parcial

Usa el parámetro --pages para traducir una parte de un documento.

• Si los números de página son consecutivos, puedes escribirlo así:

pdf2zh_next example.pdf --pages 1-3

pdf2zh_next example.pdf --pages 25-

• Si las páginas no son consecutivas, puedes usar una coma , para separarlas.

Por ejemplo, si quieres traducir la primera y tercera página, puedes usar el siguiente comando:

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

• Si las páginas incluyen rangos tanto consecutivos como no consecutivos, también puedes conectarlos con una coma, así:

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

Este comando traducirá la primera página, la tercera página, las páginas 10-20 y todas las páginas desde la 25 hasta el final.

⬆️ Volver al inicio

Especificar idiomas de origen y destino

Consulte Google Languages Codes, DeepL Languages Codes

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

⬆️ Volver al inicio

Traducir con excepciones

Usar regex para especificar fuentes de fórmulas y caracteres que deben preservarse:

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

Preservar las fuentes Latex, Mono, Code, Italic, Symbol y Math por defecto:

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)"

⬆️ Volver al inicio

Custom prompt

Custom prompt para la traducción. Se utiliza principalmente para agregar la instrucción '/no_think' de Qwen 3 en el prompt.

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

⬆️ Volver al inicio

Configuración personalizada

Hay varias formas de modificar e importar el archivo de configuración.

• Modificar configuración mediante argumentos de línea de comandos

Para la mayoría de los casos, puedes pasar directamente tu configuración deseada a través de argumentos de línea de comandos. Por favor, consulta Argumentos de línea de comandos para obtener más información.

Por ejemplo, si deseas habilitar una ventana GUI, puedes usar el siguiente comando:

pdf2zh_next --gui

• Modificar configuración mediante Variables de entorno

Puedes reemplazar el -- en los argumentos de línea de comandos con PDF2ZH_, conectar los parámetros usando =, y reemplazar - con _ como variables de entorno.

Por ejemplo, si deseas habilitar una ventana GUI, puedes usar el siguiente comando:

PDF2ZH_GUI=TRUE pdf2zh_next

• Archivo de Configuración Especificado por el Usuario

Puede especificar un archivo de configuración utilizando el siguiente argumento de línea de comandos:

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

Si no está seguro sobre el formato del archivo de configuración, consulte el archivo de configuración predeterminado que se describe a continuación.

• Archivo de configuración predeterminado

El archivo de configuración predeterminado se encuentra en ~/.config/pdf2zh. Por favor, no modifiques los archivos de configuración en el directorio default. Se recomienda encarecidamente consultar el contenido de este archivo de configuración y usar Configuración personalizada para implementar tu propio archivo de configuración.

⬆️ Volver al inicio

Omitir limpieza

Cuando este parámetro se establece en True, se omitirá el paso de limpieza de PDF, lo que puede mejorar la compatibilidad y evitar algunos problemas de procesamiento de fuentes.

Uso:

pdf2zh_next example.pdf --skip-clean

O usando variables de entorno:

PDF2ZH_SKIP_CLEAN=TRUE pdf2zh_next example.pdf

Caché de traducción

PDFMathTranslate almacena en caché los textos traducidos para aumentar la velocidad y evitar llamadas API innecesarias para contenidos iguales. Puedes usar la opción --ignore-cache para ignorar la caché de traducción y forzar la retraducción.

pdf2zh_next example.pdf --ignore-cache

⬆️ Volver al inicio

Despliegue como servicios públicos

Al desplegar una GUI de pdf2zh en servicios públicos, debe modificar el archivo de configuración como se describe a continuación.

Una configuración utilizable es la siguiente:

[basic]
gui = true

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

⬆️ Volver al inicio

Autenticación y página de bienvenida

Al usar Autenticación y página de bienvenida para especificar qué usuario puede usar la interfaz de usuario web y personalizar la página de inicio de sesión:

ejemplo auth.txt Cada línea contiene dos elementos, nombre de usuario y contraseña, separados por una coma.

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>

Una configuración utilizable es la siguiente:

[basic]
gui = true

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

⬆️ Volver al inicio

Glosario de soporte

PDFMathTranslate admite la tabla de glosario. El archivo de tabla de glosario debe ser un archivo csv. Hay tres columnas en el archivo. Aquí hay un archivo de glosario de demostración:

Para usuario de CLI: Puede utilizar múltiples archivos para el glosario. Y los diferentes archivos deben separarse por ,.

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

Para usuarios de WebUI:

Ahora puedes subir tu propio archivo de glosario. Después de subir el archivo, puedes verificarlo haciendo clic en su nombre y el contenido se mostrará a continuación.

⬆️ Volver al inicio