Systemeinstellungen
BabelTranslate enthält einige Systemeinstellungen im babeltranslate-Namensraum.
Diese sind in den MODX Systemeinstellungen verfügbar.
| Key | Name | Description | Default |
|---|---|---|---|
| babeltranslate.debug | Debug | Debug-Informationen im MODX Fehlerprotokoll ausgeben. | Nein |
| babeltranslate.deepl_auth_key | DeepL-API-Authentifizierungsschlüssel | Der DeepL-Authentifizierungsschlüssel für den Zugriff auf das DeepL-API. | - |
| babeltranslate.deepl_text_translation_options | DeepL Textübersetzungsoptionen | [Seit 1.2.3] JSON-kodiertes Objekt der DeepL Textübersetzungsoptionen. Die Optionen können in den DeepL API Docs gefunden werden. @FILE oder @CHUNK Bindungen können verwendet werden. |
- |
| babeltranslate.openai_api_url | OpenAI API Url | [Seit 1.5.0] Die Url des OpenAI-kompatiblen Dienstes | - |
| babeltranslate.openai_auth_key | OpenAI API Authentifizierungsschlüssel | [Seit 1.5.0] Der OpenAI Authentifizierungsschlüssel für den Zugriff auf das OpenAI-API. | - |
| babeltranslate.openai_metadata | OpenAI Chat Metadata | [Seit 1.5.0] Sammlung von 16 Schlüssel-Wert-Paaren, die an ein Objekt angehängt werden können. Dies kann nützlich sein, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern und Objekte über API oder das Dashboard abzufragen. | - |
| babeltranslate.openai_model | OpenAI-Modell | [Seit 1.5.0] Modell-ID, die zur Generierung der Antwort verwendet wird, wie gpt-4o oder o1. OpenAI bietet eine breite Palette von Modellen mit unterschiedlichen Fähigkeiten, Leistungsmerkmalen und Preispunkten an. | - |
| babeltranslate.openai_temperature | Zu verwendende Temperatur | [Seit 1.5.0] Welche Sampling-Temperatur verwendet werden soll, zwischen 0 und 2. Höhere Werte wie 0,8 machen das Ergebnis zufälliger, während niedrigere Werte wie 0,2 es fokussierter und deterministischer machen. | - |
| babeltranslate.openai_text_translation_options | Textübersetzungsanweisungen | [Seit 1.5.0] Die Anweisungen an das Modell, wie es an die Übersetzungsaufgabe herangehen soll. Kann verwendet werden, um Anweisungen zur Formalität, zum Tonfall oder zum bestimmten Vokabular zu geben. @FILE oder @CHUNK Bindungen können verwendet werden. |
- |
| babeltranslate.reverso_api_url | Reverso API Url | [Seit 1.3.0] Die API Url für den Zugriff auf das Reverso-API | - |
| babeltranslate.reverso_password | Reverso Passwort | [Seit 1.3.0] Das Passwort für den Zugriff auf das Reverso-API. | - |
| babeltranslate.reverso_text_translation_options | Reverso Textübersetzungsoptionen | [Seit 1.3.0] JSON kodiertes Objekt der Reverso Textübersetzungsoptionen. @FILE oder @CHUNK Bindungen können verwendet werden. |
- |
| babeltranslate.reverso_username | Reverso Benutzername | [Seit 1.3.0] Der Benutzername für den Zugriff auf das Reverso-API. | - |
| babeltranslate.translate_duplicate | Babel-Duplikat übersetzen | Die duplizierte Babel-Ressource direkt übersetzen. | Nein |
| babeltranslate.translate_resource_cb_fields | ContentBlocks Felder übersetzen | JSON-kodiertes Objekt von ContentBlocks-Feldern, die übersetzt werden sollen. Jeder Datensatz enthält die ContentBlocks-Feld-ID als Schlüssel, der Wert enthält mehrere Optionen: type ist optional (er wird ansonsten durch den ContentBlocks-Feldtyp festgelegt) und kann mit text, single, grid oder repeater gefüllt werden. nested ist optional (es wird ansonsten durch den ContentBlocks-Feldtyp festgelegt) und kann den Schlüssel der verschachtelten Werte im ContentBlocks-Wert enthalten. fields ist optional (es enthält standardmäßig ["value"]) und kann mit einem Array von Feldnamen gefüllt werden, die übersetzt werden. @FILE oder @CHUNK Bindungen können verwendet werden. |
- |
| babeltranslate.translate_resource_fields | Felder übersetzen | Kommagetrennte Liste von Ressourcenfeldern, die übersetzt werden. @FILE oder @CHUNK Bindungen können verwendet werden. |
pagetitle, longtitle, content, alias |
| babeltranslate.translate_resource_tvs | Template Variablen übersetzen | JSON-kodiertes Objekt von Template Variablen, die übersetzt werden sollen. Jeder Datensatz enthält den Namen der Template Variable als Schlüssel, der Wert enthält mehrere Optionen: type ist optional (er wird ansonsten durch den Typ der Vorlagevariable festgelegt) und kann mit text, single, grid oder custom gefüllt werden. fields ist optional (der Standardwert ist ["value"]) und kann mit einem Array von Feldnamen gefüllt werden, die übersetzt werden sollen. @FILE oder @CHUNK Bindungen können verwendet werden. |
- |
| babeltranslate.translator | Übersetzungsdienst | Der Hauptübersetzungsdienst. Standardmäßig wird der erste verfügbare Übersetzungsdienst in der babeltranslate.translators Systemeinstellung verwendet. |
deepl |
| babeltranslate.translators | Übersetzungsdienste | [Since 1.3.1] Kommagetrennte Liste der Übersetzungsdienste (deepl und reverso sind derzeit möglich). Es wird der erste verfügbare Übersetzungsdienst für jede Sprache verwendet. |
deepl |
Beispiele für die Einstellungen babeltranslate.translate_resource_cb_fields
und babeltranslate.translate_resource_tvs finden Sie auf der Seite
Beispiele.
Die Einstellungen babeltranslate.translate_resource_fields,
babeltranslate.translate_resource_tvs und
babeltranslate.translate_resource_cb_fields können @FILE oder @CHUNK
Bindungen verwenden. Pfad-Platzhalter wie {core_path}, {base_path} und
{assets_path} können verwendet werden. Alle Pfade müssen sich aus
Sicherheitsgründen innerhalb des MODX-Basispfades befinden.
Custom template variable translation type
Der custom Typ von babeltranslate.translate_resource_tvs wird durch ein
Plugin in OnBabelTranslateCustomTV bearbeitet. Es existiert ein deaktiviertes
Skeleton-Plugin in der Kategorie BabelTranslate. Duplizieren und bearbeiten Sie
dieses Plugin und fügen Sie Ihre eigenen Übersetzungs-Routinen hinzuzu.
Das Plugin kann die folgenden Event-Eigenschaften verwenden:
| Eigenschaft | Inhalt |
|---|---|
| translator | Die Übersetzerklasse. Das Übersetzen eines Strings erfolgt durch $translator->translate($string, $fromCulture, $toCulture). |
| resource | Die aktuelle übersetzte Ressource. |
| tvname | Der Name der übersetzten Template-Variable. |
| value | Der Wert der übersetzten Template-Variable. |
| fromCulture | Die Kultur, aus der der Wert übersetzt wird. |
| toCulture | Die Kultur, in die der Wert übersetzt wird. |