Erweiterte Optionen

Erweiterte Optionen > Erweiterte Optionen (aktuell)

Inhaltsverzeichnis

• Befehlszeilenargumente
• Argumente
• GUI-Argumente
• #### Anleitung zur Ratenbegrenzungskonfiguration
• #### RPM (Anfragen pro Minute) Ratenbegrenzung
• #### Begrenzung gleichzeitiger Verbindungen
• #### Best Practices
• Partielle Übersetzung
• Quell- und Zielsprachen angeben
• Übersetzung mit Ausnahmen
• Benutzerdefinierte Eingabeaufforderung
• Benutzerdefinierte Konfiguration
• Bereinigung überspringen
• Übersetzungscache
• Bereitstellung als öffentlicher Dienst
• Authentifizierung und Willkommensseite
• Glossarunterstützung

Kommandozeilen-Argumente

Führen Sie den Übersetzungsbefehl in der Kommandozeile aus, um das übersetzte Dokument example-mono.pdf und das zweisprachige Dokument example-dual.pdf im aktuellen Arbeitsverzeichnis zu generieren. Verwenden Sie Google als Standard-Übersetzungsdienst. Weitere unterstützte Übersetzungsdienste finden Sie HIER.

In der folgenden Tabelle listen wir alle erweiterten Optionen zur Referenz auf:

Argumente

GUI-Argumente

⬆️ Zurück zum Anfang

Anleitung zur Ratenbegrenzungskonfiguration

Bei der Verwendung von Übersetzungsdiensten ist eine korrekte Ratenbegrenzungskonfiguration entscheidend, um API-Fehler zu vermeiden und die Leistung zu optimieren. Diese Anleitung erklärt, wie die Parameter --qps und --pool-max-worker basierend auf den verschiedenen Einschränkungen des Upstream-Dienstes konfiguriert werden.

RPM (Anfragen pro Minute) Ratenbegrenzung

Wenn der Upstream-Dienst RPM-Beschränkungen hat, verwenden Sie die folgende Berechnung:

Berechnungsformel: - qps = floor(rpm / 60) - pool_size = qps * 10

Beispiel: Wenn Ihr Übersetzungsdienst eine Begrenzung von 600 RPM hat: - qps = floor(600 / 60) = 10 - pool_size = 10 * 10 = 100

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

Begrenzung gleichzeitiger Verbindungen

Wenn der Upstream-Dienst Einschränkungen bei gleichzeitigen Verbindungen hat (wie der offizielle GLM-Dienst), verwenden Sie diesen Ansatz:

Berechnungsformel: - pool_size = max(floor(0.9 * official_concurrent_limit), official_concurrent_limit - 20) - qps = pool_size

Beispiel: Wenn Ihr Übersetzungsdienst 50 gleichzeitige Verbindungen zulässt: - pool_size = max(floor(0.9 * 50), 50 - 20) = max(45, 30) = 45 - qps = 45

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

Best Practices

⬆️ Zurück zum Anfang

Teilweise Übersetzung

Verwenden Sie den --pages-Parameter, um einen Teil eines Dokuments zu übersetzen.

• Wenn die Seitenzahlen aufeinanderfolgend sind, können Sie es so schreiben:

pdf2zh_next example.pdf --pages 1-3

pdf2zh_next example.pdf --pages 25-

• Wenn die Seiten nicht aufeinanderfolgend sind, können Sie ein Komma , verwenden, um sie zu trennen.

Zum Beispiel, wenn Sie die erste und dritte Seite übersetzen möchten, können Sie den folgenden Befehl verwenden:

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

• Wenn die Seiten sowohl aufeinanderfolgende als auch nicht aufeinanderfolgende Bereiche enthalten, können Sie diese auch mit einem Komma verbinden, wie folgt:

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

Dieser Befehl übersetzt die erste Seite, die dritte Seite, die Seiten 10-20 und alle Seiten von 25 bis zum Ende.

⬆️ Zurück zum Anfang

Quell- und Zielsprachen angeben

Siehe Google Languages Codes, DeepL Languages Codes

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

⬆️ Zurück zum Anfang

Übersetzen mit Ausnahmen

Verwenden Sie reguläre Ausdrücke, um Formelschriften und Zeichen anzugeben, die erhalten bleiben sollen:

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

Standardmäßig werden Latex, Mono, Code, Italic, Symbol und Math Schriftarten beibehalten:

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

⬆️ Zurück zum Anfang

Benutzerdefinierte Eingabeaufforderung

Benutzerdefinierte Systemeingabeaufforderung für die Übersetzung. Sie wird hauptsächlich verwendet, um die '/no_think'-Anweisung von Qwen 3 in die Eingabeaufforderung einzufügen.

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

⬆️ Zurück zum Anfang

Benutzerdefinierte Konfiguration

Es gibt mehrere Möglichkeiten, die Konfigurationsdatei zu ändern und zu importieren.

• Konfiguration über Kommandozeilen-Argumente ändern

In den meisten Fällen können Sie Ihre gewünschten Einstellungen direkt über Kommandozeilen-Argumente übergeben. Weitere Informationen finden Sie unter Kommandozeilen-Argumente.

Beispielsweise können Sie mit dem folgenden Befehl ein GUI-Fenster aktivieren:

pdf2zh_next --gui

• Konfiguration über Umgebungsvariablen anpassen

Sie können das -- in Kommandozeilen-Argumenten durch PDF2ZH_ ersetzen, Parameter mit = verbinden und - durch _ als Umgebungsvariablen ersetzen.

Zum Beispiel, wenn Sie ein GUI-Fenster aktivieren möchten, können Sie den folgenden Befehl verwenden:

PDF2ZH_GUI=TRUE pdf2zh_next

• Benutzerdefinierte Konfigurationsdatei

Sie können eine Konfigurationsdatei mit dem folgenden Kommandozeilen-Argument angeben:

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

Wenn Sie sich über das Format der Konfigurationsdatei unsicher sind, lesen Sie bitte die unten beschriebene Standardkonfigurationsdatei.

• Standardkonfigurationsdatei

Die Standardkonfigurationsdatei befindet sich unter ~/.config/pdf2zh.
Bitte ändern Sie die Konfigurationsdateien im Verzeichnis default nicht.
Es wird dringend empfohlen, sich auf den Inhalt dieser Konfigurationsdatei zu beziehen und Benutzerdefinierte Konfigurationsdatei zu verwenden, um Ihre eigene Konfigurationsdatei zu implementieren.

⬆️ Zurück zum Anfang

Bereinigung überspringen

Wenn dieser Parameter auf True gesetzt wird, wird der Schritt zur PDF-Bereinigung übersprungen, was die Kompatibilität verbessern und einige Probleme bei der Schriftverarbeitung vermeiden kann.

Verwendung:

pdf2zh_next example.pdf --skip-clean

Oder Umgebungsvariablen verwenden:

PDF2ZH_SKIP_CLEAN=TRUE pdf2zh_next example.pdf

Übersetzungscache

PDFMathTranslate speichert übersetzte Texte zwischen, um die Geschwindigkeit zu erhöhen und unnötige API-Aufrufe für dieselben Inhalte zu vermeiden. Sie können die Option --ignore-cache verwenden, um den Übersetzungscache zu ignorieren und eine erneute Übersetzung zu erzwingen.

pdf2zh_next example.pdf --ignore-cache

⬆️ Zurück zum Anfang

Bereitstellung als öffentlicher Dienst

Wenn Sie eine pdf2zh-GUI auf öffentlichen Diensten bereitstellen, sollten Sie die Konfigurationsdatei wie unten beschrieben anpassen.

Eine brauchbare Konfiguration ist wie folgt:

[basic]
gui = true

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

⬆️ Zurück zum Anfang

Authentifizierung und Willkommensseite

Bei Verwendung von Authentifizierung und Willkommensseite, um festzulegen, welcher Benutzer die Web UI nutzen und die Login-Seite anpassen kann:

Beispiel auth.txt Jede Zeile enthält zwei Elemente, Benutzername und Passwort, getrennt durch ein Komma.

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

Beispiel 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>

Eine brauchbare Konfiguration ist wie folgt:

[basic]
gui = true

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

⬆️ Zurück zum Anfang

Glossar-Unterstützung

PDFMathTranslate unterstützt die Glossartabelle. Die Glossartabellendatei sollte eine csv-Datei sein. Die Datei enthält drei Spalten. Hier ist eine Demo-Glossardatei:

Für CLI-Benutzer: Sie können mehrere Dateien für das Glossar verwenden. Und verschiedene Dateien sollten durch , getrennt werden.

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

Für WebUI-Benutzer:

Sie können jetzt Ihre eigene Glossardatei hochladen. Nachdem Sie die Datei hochgeladen haben, können Sie sie überprüfen, indem Sie auf ihren Namen klicken und der Inhalt wird unten angezeigt.

⬆️ Zurück zum Anfang