Schakel meertalige spellingcontrole in Collabora Online in met CODE

Om in Collabora Online meerdere talen te controleren op spelfouten, voegt u voor elke gewenste taalcode de code toe aan de dictionariesinstellingen van de CODE-container, start u de container opnieuw en wijst u de juiste taal toe aan elk tekstfragment. Beide partijen zijn belangrijk: de server moet de woordenboeken beschikbaar stellen en het document moet Engels, Frans of een andere tekstpassage markeren met de bijbehorende taal. Het toevoegen van een taal aan de container alleen zorgt er niet automatisch voor dat elke taal in een document wordt herkend.

Wat moet er geconfigureerd worden?

Er zijn twee afzonderlijke instellingen waarmee rekening moet worden gehouden:

• Serverwoordenboeken: De CODE Docker-image maakt standaard een beperkte lijst met woordenboeken mogelijk. De dictionariesomgevingsvariabele wijzigt de lijst met woordenboektalen die CODE configureert. De SDK-handleiding van Collabora 25.04 beschrijft taalcodes gescheiden door spaties, eventueel gevolgd door een landcode, en merkt op dat het beperken van de lijst helpt om onnodig resourcegebruik en opstartwerk te voorkomen.
• Documenttaal: Collabora gebruikt de aan de tekst toegewezen taal om het spellingswoordenboek te selecteren. Een document kan verschillende talen bevatten in verschillende selecties of alinea's, dus elke passage moet correct worden getagd.

Een document met bijvoorbeeld passages in het Engels (Verenigde Staten) en Frans vereist dat beide talen op de server zijn ingeschakeld, en de Engelse en Franse tekst moeten de bijbehorende taalinstelling hebben. Een gebruikersinterfacetaal of toetsenbordindeling is geen vervanging voor een van beide instellingen. Zie de handleiding van de Collabora Online 25.04 SDK en het helponderwerp van Collabora over het selecteren van een documenttaal .

Configureer taalwoordenboeken in CODE Docker.

Docker Compose-voorbeeld

Voeg de gewenste landcodes toe als een door spaties gescheiden tekenreeks in de omgevingsvariabelen van de Collabora-service. In dit voorbeeld wordt de lijst beperkt tot Amerikaans Engels, Brits Engels en Frans:

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"

Vervang het domeinpatroon, de inloggegevens, de imagetag en de poorttoewijzing zodat deze overeenkomen met uw implementatie. Behoud de bestaande reverse proxy- en Nextcloud-verbindingsinstellingen; dit fragment illustreert alleen waar de woordenlijst thuishoort. Als u al een Compose-bestand gebruikt, bewerk dan de bestaande Collabora-service in plaats van een tweede container aan te maken.

De bovenstaande taalcodes volgen de codes die door Collabora zijn gedocumenteerd, waarbij een landcode een landcode kan bevatten. Gebruik codes die overeenkomen met de documenttalen die uw gebruikers nodig hebben. Ga er niet van uit dat elke mogelijke code een bruikbaar woordenboek heeft in elke CODE-image: de SDK-handleiding beschrijft het wijzigen van de geconfigureerde lijst, terwijl de geïnstalleerde build en de bijbehorende woordenboeken nog steeds bepalen wat er daadwerkelijk beschikbaar is. Raadpleeg de documentatie voor de CODE-imageversie die u gebruikt voordat u minder gangbare landcodes toevoegt.

De wijziging toepassen

1. Maak een back-up van het huidige Compose-bestand of sla het op, zodat je de wijziging kunt terugdraaien.
2. Werk de dictionarieswaarde bij met alleen de talen die uw gebruikers nodig hebben. Behoud de andere Collabora-omgevingsvariabelen.
3. Maak de service opnieuw aan, zodat Docker de bijgewerkte omgeving doorgeeft aan de container. Voor een Compose-implementatie voert u dit uit docker compose up -d --force-recreate collaboravanuit de map waarin het Compose-bestand zich bevindt.
4. Controleer de opstartoutput met docker compose logs --tail=100 collabora. Zoek naar opstartfouten of fouten bij het laden van woordenboeken; beschouw een succesvolle containerstatus op zich niet als bewijs dat een bepaald woordenboek is geïnstalleerd.

Als uw implementatie docker runin plaats daarvan gebruikmaakt van een andere configuratie, werk dan het -e dictionaries="en_US en_GB fr_FR"argument bij en maak die container opnieuw aan met dezelfde netwerk-, volume-, proxy- en beveiligingsopties. Het wijzigen van de omgeving op een draaiende container verandert niet de omgeving waarmee deze is gestart.

Wijs aan elke passage een taal toe.

Nadat de server gereed is, opent u een document in Nextcloud en selecteert u de tekst waarvan u de taal wilt controleren. Kies in de taalinstellingen van Collabora de taal voor de selectie of alinea; voor een document dat volledig in één taal is, gebruikt u de optie die de taal op alle tekst toepast. De labels van de opdrachten kunnen per versie en schermindeling enigszins verschillen, maar het belangrijkste is dat u de taal van de documenttekst instelt en niet alleen de interfacetaal wijzigt. De helpfunctie van Collabora legt uit dat de documenttaal bepaalt welk woordenboek wordt gebruikt voor spellingcontrole, thesaurus en woordafbreking.

Voor een document met meerdere talen kunt u de taal in delen toepassen. Selecteer bijvoorbeeld de Franse alinea en stel deze in op Frans (Frankrijk), selecteer vervolgens de Engelse alinea's en stel deze in op Engels (Verenigde Staten). Als nieuwe tekst de verkeerde taal overneemt, plaatst u de cursor in die alinea en wijzigt u de taal voordat u typt, of selecteert u de tekst en past u de taal aan nadat u deze hebt ingevoerd. Een woord dat er verkeerd gespeld uitziet, kan simpelweg tekst zijn die met de verkeerde taal is gemarkeerd.

De spellingcontrole kan ook worden uitgeschakeld voor een selectie of taal. In het taalmenu van Collabora sluit de optie 'Geen' de geselecteerde tekst uit van spellingcontrole en woordafbreking. Als de tekst de juiste taal heeft, maar geen spellingsmarkeringen krijgt, controleer dan de status van de spellingcontrole voor die taal en kijk of de selectie is uitgesloten. De help-pagina van Collabora over talen beschrijft de taalopties en de optie 'Geen'.

Snelle controles wanneer een taal ontbreekt

In de beheerdershandleiding van Nextcloud wordt de URL van de Collabora-server beschreven onder de Office-configuratie. Houd deze integratie-instelling gescheiden van de wijziging van het woordenboek; als de verbinding eerder al werkte, hoeft u deze normaal gesproken niet te wijzigen voor talen met spellingcontrole. Raadpleeg de documentatie over de Nextcloud Office-configuratie .

Controleer het resultaat in een echt document.

Maak een testdocument aan of open een bestaand document en typ een opzettelijk verkeerd gespeld woord in elke beschikbare taal. Stel elke voorbeeldtekst in op de gewenste taal en controleer of de spellingscontrole de opzettelijke fout markeert. Typ ook een correct gespeld woord in elke taal om er zeker van te zijn dat het niet als vreemde tekst wordt behandeld. Herhaal dit met een tweede gebruiker als de beschikbaarheid van talen verschilt per account of document.

Als een taal nog steeds niet werkt, beperk de test dan tot één taal tegelijk, controleer de CODE-logboeken en vergelijk de code met de documentatie voor de exacte imageversie. De standaardlijst met toegestane talen in het woordenboek van Collabora en de inhoud van de afbeeldingen kunnen tussen releases veranderen; de in de handleiding van versie 25.04 beschreven standaardwaarden mogen niet voor elke latere tag worden aangenomen. Zodra de spelling in elke expliciet getagde passage correct is, behoud dan de kleinste lijst met talen die aan de behoeften van uw gebruikers voldoet.