Opciones avanzadas

Opciones avanzadas > Opciones avanzadas (actual)

Tabla de Contenidos

• Argumentos de Línea de Comandos
• Argumentos
• Argumentos de GUI
• #### Guía de Configuración de Límite de Tasa
• #### Limitación de tasa RPM (Solicitudes Por Minuto)
• #### Limitación de conexiones concurrentes
• #### Mejores prácticas
• Traducción parcial
• Especificar idiomas de origen y destino
• Traducir con excepciones
• Prompt personalizado
• Configuración personalizada
• Omitir limpieza
• Caché de traducción
• Despliegue como servicios públicos
• Autenticación y página de bienvenida
• Soporte de glosario

Argumentos de la 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 el servicio de traducción predeterminado. Puedes encontrar más servicios de traducción soportados AQUÍ.

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

Argumentos

Argumentos de GUI

⬆️ Volver arriba

Guía de Configuración de Límite de Tasa

Al utilizar servicios de traducción, una configuración adecuada del límite 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 limitaciones de diferentes servicios ascendentes.

Limitación de tasa 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 arriba

Traducción parcial

Utiliza 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 deseas 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 arriba

Especificar idiomas de origen y destino

Consulta los Códigos de idioma de Google y los Códigos de idioma de DeepL

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

⬆️ Volver arriba

Traducir con excepciones

Usar expresiones regulares 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 arriba

Indicaciones personalizadas

Indicaciones personalizadas del sistema para traducción. Se utiliza principalmente para agregar la instrucción '/no_think' de Qwen 3 en la indicación.

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 arriba

Configuración personalizada

Existen múltiples formas de modificar e importar el archivo de configuración.

• Modificación de la configuración mediante Argumentos de la línea de comandos

En la mayoría de los casos, puedes pasar directamente tus configuraciones deseadas a través de argumentos de la línea de comandos. Consulta Argumentos de la 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

• Modificación de la configuración mediante variables de entorno

Puedes reemplazar el -- en los argumentos de la línea de comandos con PDF2ZH_, conectar 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

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

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

Si no está seguro del 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 utilizar Configuración personalizada para implementar tu propio archivo de configuración.

⬆️ Volver arriba

Omitir limpieza

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

Uso:

pdf2zh_next example.pdf --skip-clean

O utilizando 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 los mismos contenidos. 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 arriba

Despliegue como servicios públicos

Al desplegar una GUI de pdf2zh en servicios públicos, debes 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 arriba

Autenticación y página de bienvenida

Al usar Autenticación y página de bienvenida para especificar qué usuario debe usar Web UI 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

ejemplo 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 arriba

Soporte de glosario

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

Para usuarios de CLI: Puedes usar múltiples archivos para el glosario. Y los diferentes archivos deben estar separados 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