# Einstellungen

Drei Angaben, und das Modul ist einsatzbereit. Zu finden über **Übersetzen →
Einstellungen**.

<!-- TODO Screenshot: images/einrichtung-einstellungen.png -->

## Die Felder

| Feld | Inhalt |
| ------------------- | ------------------------------------------------ |
| **API Schlüssel** | der Authentifizierungsschlüssel aus dem DeepL-Konto |
| **API Typ** | `Free` oder `Pro` — muss zum Schlüssel passen |
| **Glossar** | optional; ein bei DeepL angelegtes Glossar |

Siehe [Das DeepL-Konto](https://wiki.dako-it.com/books/finntranslate/page/das-deepl-konto).

<p class="callout danger">Der API Typ gehört zum Schlüssel. Passt beides nicht zusammen, lehnt DeepL die Anmeldung ab. Free-Schlüssel enden auf <code>:fx</code>.</p>

## Nach dem Speichern lädt die Seite neu

**Speichern** meldet den Erfolg und lädt die Oberfläche kurz darauf neu.

<p class="callout info">Das ist gewollt: Erst danach werden die Glossare von DeepL geholt, und erst danach lässt die Startseite eine Übersetzung zu. Bis dahin wäre der neue Schlüssel nur halb wirksam.</p>

## Das Glossar-Feld bleibt gesperrt

Solange kein API-Schlüssel eingetragen ist, ist die Auswahl **Glossar** nicht bedienbar; im
Hinweis darunter steht *Konfigurieren Sie die API um Glossare anzuzeigen*.

<p class="callout success">Der Grund: Die Glossare kommen von DeepL selbst. Ohne Schlüssel gibt es nichts anzuzeigen. Also erst Schlüssel und API Typ eintragen, speichern — und dann das Glossar wählen.</p>

Siehe [Glossare](https://wiki.dako-it.com/books/finntranslate/page/glossare).

## Ohne Schlüssel geht es nicht weiter

Wird **Artikel übersetzen** ohne eingetragenen Schlüssel aufgerufen, erscheint der Hinweis
*Bitte API Schlüssel in den Einstellungen setzen*, und die Oberfläche wechselt selbst in
die Einstellungen.

<p class="callout info">Das ist kein Fehler, sondern der eingebaute Wegweiser: Ohne Schlüssel kann die Startseite nichts anbieten.</p>

## Wo die Angaben gespeichert werden

In der Konfiguration von FINN.ghost, unter `translate`. Der Schlüssel wird dabei
verschlüsselt abgelegt.

Siehe [Anpassungen über die config.json](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/anpassungen-uber-die-configjson)
im Systemhandbuch.

## Nächster Schritt

[Glossare](https://wiki.dako-it.com/books/finntranslate/page/glossare)