Collabora CODE mit Helm auf Kubernetes bereitstellen
Installieren Sie das offizielle Collabora Helm-Chart, konfigurieren Sie den WOPI-Zugriff und die Ingress-Affinität und überprüfen Sie die Bereitstellung auf häufige Einrichtungsfehler.
Um in Collabora Online die Rechtschreibprüfung für mehrere Sprachen durchzuführen, fügen Sie die benötigten Sprachcodes in den dictionariesEinstellungen des CODE-Containers hinzu, starten Sie den Container neu und weisen Sie jedem Textabschnitt die richtige Sprache zu. Beide Seiten sind wichtig: Der Server muss die Wörterbücher bereitstellen, und das Dokument muss englische, französische oder andere Textabschnitte mit der entsprechenden Sprache kennzeichnen. Das Hinzufügen einer Sprache zum Container allein erkennt nicht automatisch alle Sprachen im Dokument.
Es sind zwei unterschiedliche Einstellungen zu berücksichtigen:
dictionariesUmgebungsvariable ändert die Liste der von CODE konfigurierten Wörterbuchsprachen. Das Handbuch zum Collabora SDK 25.04 beschreibt durch Leerzeichen getrennte Sprachcodes, optional gefolgt von einem Ländercode, und weist darauf hin, dass die Einschränkung der Liste unnötigen Ressourcenverbrauch und Startaufwand vermeidet.Beispielsweise müssen in einem Dokument mit englischen (USA) und französischen Passagen beide Sprachcodes auf dem Server aktiviert sein, und der englische und französische Text müssen die entsprechende Spracheinstellung aufweisen. Die Sprache der Benutzeroberfläche oder das Tastaturlayout ersetzen diese Einstellungen nicht. Weitere Informationen finden Sie im Handbuch zum Collabora Online 25.04 SDK und im Collabora-Hilfethema zur Auswahl einer Dokumentsprache .
Fügen Sie die gewünschten Gebietsschemacodes als durch Leerzeichen getrennte Zeichenkette in der Umgebung des Collabora-Dienstes hinzu. In diesem Beispiel bleiben die Listen auf US-Englisch, UK-Englisch und Französisch beschränkt:
services:
collabora:
image: collabora/code
restart: unless-stopped
environment:
dictionaries: "en_US en_GB fr_FR"
domain: "cloud\.example\.com"
username: "collabora_admin"
password: "replace-with-a-long-unique-password"
ports:
- "127.0.0.1:9980:9980"
Ersetzen Sie das Domänenmuster, die Anmeldeinformationen, das Image-Tag und die Portzuordnung entsprechend Ihrer Bereitstellung. Behalten Sie die bestehenden Reverse-Proxy- und Nextcloud-Verbindungseinstellungen bei; dieses Codebeispiel zeigt lediglich, wo die Wörterbuchliste eingefügt werden soll. Wenn Sie bereits eine Compose-Datei verwenden, bearbeiten Sie den bestehenden Collabora-Dienst, anstatt einen zweiten Container zu erstellen.
Die oben genannten Sprachcodes entsprechen den von Collabora dokumentierten Codes, wobei ein Gebietsschema einen Ländercode enthalten kann. Verwenden Sie Codes, die den Dokumentsprachen Ihrer Benutzer entsprechen. Gehen Sie nicht davon aus, dass für jeden möglichen Code in jedem CODE-Image ein verwendbares Wörterbuch vorhanden ist: Das SDK-Handbuch beschreibt zwar die Änderung der konfigurierten Liste, die installierte Version und ihre Wörterbücher bestimmen jedoch weiterhin, welche Sprachen tatsächlich verfügbar sind. Prüfen Sie die Dokumentation der von Ihnen verwendeten CODE-Image-Version, bevor Sie weniger gebräuchliche Gebietsschemas hinzufügen.
dictionariesWert nur mit den Sprachen, die Ihre Benutzer benötigen. Die übrigen Collabora-Umgebungsvariablen bleiben erhalten.docker compose up -d --force-recreate collaboraim Verzeichnis aus, das die Compose-Datei enthält.docker compose logs --tail=100 collabora. Achten Sie auf Start- oder Wörterbuchladefehler; ein erfolgreicher Containerstatus allein ist kein Beweis dafür, dass ein bestimmtes Wörterbuch installiert ist.Wenn Ihre Bereitstellung docker runstattdessen verwendet, aktualisieren Sie deren -e dictionaries="en_US en_GB fr_FR"Argumente und erstellen Sie den Container mit denselben Netzwerk-, Volume-, Proxy- und Sicherheitsoptionen neu. Das Ändern der Umgebung in einem laufenden Container ändert nicht die Umgebung, mit der er gestartet wurde.
Sobald der Server bereit ist, öffnen Sie ein Dokument in Nextcloud und markieren Sie den Text, dessen Sprache Sie überprüfen möchten. Wählen Sie in den Spracheinstellungen von Collabora die Sprache für die Markierung oder den Absatz aus. Bei einem einsprachigen Dokument verwenden Sie die Option, die die Sprache auf den gesamten Text anwendet. Die Befehlsbezeichnungen können je nach Version und Bildschirmdarstellung leicht variieren. Wichtig ist jedoch, die Dokumentsprache festzulegen und nicht nur die Sprache der Benutzeroberfläche. Die Hilfe von Collabora erklärt, dass die Dokumentsprache das Wörterbuch bestimmt, das für die Rechtschreibprüfung, den Thesaurus und die Silbentrennung verwendet wird.
Bei mehrsprachigen Dokumenten sollten Sie die Sprachen abschnittsweise anwenden. Markieren Sie beispielsweise den französischen Absatz und legen Sie die Sprache auf Französisch (Frankreich) fest, anschließend die englischen Absätze und legen Sie die Sprache auf Englisch (USA) fest. Falls neuer Text die falsche Sprache übernimmt, platzieren Sie den Cursor in diesem Absatz und ändern Sie die Sprache, bevor Sie mit dem Schreiben beginnen, oder markieren und taggen Sie den Text anschließend neu. Ein falsch aussehendes Wort kann einfach nur Text sein, der mit der falschen Sprache markiert ist.
Die Rechtschreibprüfung kann für eine Auswahl oder Sprache deaktiviert werden. Im Sprachmenü von Collabora schließt die Option „Keine“ den ausgewählten Text von der Rechtschreibprüfung und Silbentrennung aus. Falls der Text die richtige Sprache enthält, aber keine Rechtschreibzeichen erhält, überprüfen Sie den Status der Rechtschreibprüfung für diese Sprache und prüfen Sie, ob die Auswahl ausgeschlossen ist. Die Hilfeseite zu Collabora-Sprachen beschreibt die Sprachoptionen und die Option „Keine“.
| Was Sie sehen | Was zu überprüfen ist |
|---|---|
| Nur eine Sprache erhält Rechtschreibzeichen | Prüfen Sie, ob alle benötigten Codes vorhanden sind dictionaries, erstellen Sie den CODE neu und testen Sie dann den Text, der explizit mit jeder Sprache gekennzeichnet ist. |
| Eine Sprache ist im Menü verfügbar, aber es sind keine Wörter ausgewählt. | Stellen Sie die Sprache des ausgewählten Textabschnitts ein und vergewissern Sie sich, dass die Rechtschreibprüfung aktiviert und nicht auf „Keine“ eingestellt ist. Die bloße Verfügbarkeit des Menüs beweist nicht, dass das Wörterbuch funktioniert. |
| Änderungen haben nach dem Bearbeiten von Compose keine Auswirkung. | Vergewissern Sie sich, dass Sie den Collabora-Dienst neu erstellt haben und dass der laufende Container derjenige ist, der vom bearbeiteten Compose-Projekt verwaltet wird. |
| Nextcloud kann Dokumente nach dem Neuerstellen nicht öffnen. | Überprüfen Sie die Protokolle des Collabora-Dienstes und des Proxys und stellen Sie sicher, dass die Office-Einstellungen von Nextcloud weiterhin auf die Collabora-Server-URL verweisen. Die Wörterbuchkonfiguration behebt keine Probleme mit einer WOPI- oder Reverse-Proxy-Verbindung. |
Das Nextcloud-Administrationshandbuch beschreibt die Collabora-Server-URL unter den Office-Einstellungen. Diese Integrationseinstellung sollte unabhängig von der Wörterbuchänderung konfiguriert werden. Wenn die Verbindung zuvor bereits funktioniert hat, ist eine Änderung für die Rechtschreibprüfung in der Regel nicht erforderlich. Weitere Informationen finden Sie in der Nextcloud-Dokumentation zur Office-Konfiguration .
Erstellen oder öffnen Sie ein Testdokument und geben Sie in jeder aktivierten Sprache ein absichtlich falsch geschriebenes Wort ein. Stellen Sie jeden Beispieltext auf die gewünschte Sprache ein und überprüfen Sie, ob die Rechtschreibprüfung den absichtlichen Fehler markiert. Geben Sie außerdem in jeder Sprache ein korrekt geschriebenes Wort ein, um sicherzustellen, dass es nicht als Fremdtext behandelt wird. Wiederholen Sie den Vorgang mit einem zweiten Benutzer, falls die Sprachverfügbarkeit je nach Konto oder Dokument variiert.
Falls eine Sprache weiterhin nicht funktioniert, beschränken Sie den Test auf jeweils eine Sprache, überprüfen Sie die CODE-Protokolle und vergleichen Sie den Code mit der Dokumentation der entsprechenden Image-Version. Die Standard-Wörterbuch-Zulassungsliste und die Image-Inhalte von Collabora können sich zwischen den Versionen ändern; die im Handbuch zu Version 25.04 dokumentierten Standardwerte sollten nicht für alle späteren Tags angenommen werden. Sobald die Rechtschreibung in allen explizit getaggten Abschnitten funktioniert, behalten Sie die kleinste Sprachliste bei, die den Bedürfnissen Ihrer Benutzer entspricht.
Installieren Sie das offizielle Collabora Helm-Chart, konfigurieren Sie den WOPI-Zugriff und die Ingress-Affinität und überprüfen Sie die Bereitstellung auf häufige Einrichtungsfehler.
Anhand von Browseranfragen, WOPI-Protokollen und gezielten Proxy-Prüfungen lässt sich herausfinden, warum Collabora ein leeres Dokument öffnet – und eine Lösung auswählen, die zu den Erkenntnissen passt.
Konfigurieren Sie die CODE Docker-Wörterbücher und taggen Sie Dokumentpassagen korrekt, damit Englisch, Französisch und andere unterstützte Sprachen die richtige Rechtschreibprüfung erhalten.
Passen Sie den Inaktivitätsschwellenwert pro Ansicht in coolwsd an und unterscheiden Sie ihn von der Abdunkelung von Hintergrund-Tabs, dem Entladen von Dokumenten, dem automatischen Speichern und dem Ablauf der Anmeldung.
Stoppen Sie die geplanten CODE-Update-Prüfungen, überprüfen Sie optionale Remote-Dienste und verwenden Sie ausgehende Netzwerksteuerungen, ohne die Dokumentbearbeitung zu beeinträchtigen.
Aktivieren Sie die sichere Dokumentenbearbeitung in Seafile, indem Sie die Discovery-URL, HTTPS und den WOPI-Zugriff von Collabora für Ihre Bereitstellung konfigurieren.
Testen Sie die Systemzwischenablage, passen Sie die Browserberechtigungen an und ermitteln Sie, wann eine eingebettete Collabora-Integration eine Änderung der iFrame-Richtlinie erfordert.
Binden Sie Schriftartdateien in Docker und Collaboras Systemplate ein, damit benutzerdefinierte Schriftarten im Editor angezeigt und in Dokumenten korrekt dargestellt werden.
Sichern Sie die Datei coolwsd.xml und ihre Bereitstellungsquellen, stellen Sie sie sicher wieder her und überprüfen Sie den CODE, bevor die Benutzer die Bearbeitung wieder aufnehmen.
Erlauben Sie den genauen Ursprung von Nextcloud oder einer anderen WOPI-Instanz im CODE, überprüfen Sie dann die aktive Host-Zulassungsliste und unterscheiden Sie diese von der Quell-IP-Beschränkung von Nextcloud.