Ativar verificação ortográfica multilíngue no Collabora Online CODE

Para verificar a ortografia em mais de um idioma no Collabora Online, adicione o código de cada idioma necessário às dictionariesconfigurações do contêiner CÓDIGO, reinicie o contêiner e atribua o idioma correto a cada trecho de texto. Ambos os lados são importantes: o servidor deve disponibilizar os dicionários e o documento deve marcar o inglês, o francês ou outro trecho com o idioma correspondente. Adicionar um idioma ao contêiner por si só não identifica automaticamente todos os idiomas em um documento.

O que precisa ser configurado?

Existem duas configurações distintas a serem consideradas:

• Dicionários do servidor: A imagem Docker do CODE habilita uma lista limitada de dicionários por padrão. Sua dictionariesvariável de ambiente altera a lista de idiomas do dicionário que o CODE configura. O manual do SDK 25.04 da Collabora documenta códigos de idioma separados por espaço, opcionalmente seguidos por um código de país, e observa que limitar a lista ajuda a evitar o uso desnecessário de recursos e trabalho de inicialização.
• Idioma do documento: O Collabora usa o idioma atribuído ao texto para selecionar o dicionário ortográfico. Um documento pode conter idiomas diferentes em diferentes seleções ou parágrafos, portanto, cada trecho deve ser etiquetado corretamente.

Por exemplo, um documento com trechos em inglês (Estados Unidos) e francês precisa ter ambos os códigos habilitados no servidor, e seu texto em inglês e francês deve conter a configuração de idioma correspondente. O idioma da interface do usuário ou o layout do teclado não substituem nenhuma dessas configurações. Consulte o manual do SDK do Collabora Online 25.04 e o tópico de ajuda do Collabora sobre como selecionar o idioma do documento .

Configure dicionários de idiomas no CODE Docker

Exemplo de Docker Compose

Adicione os códigos de localidade desejados como uma string separada por espaços no ambiente do serviço Collabora. Este exemplo mantém a lista em inglês americano, inglês britânico e francês:

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"

Substitua o padrão de domínio, as credenciais, a tag de imagem e o mapeamento de portas para corresponder à sua implementação. Mantenha as configurações existentes de proxy reverso e conexão com o Nextcloud; este trecho ilustra apenas onde a lista de dicionários deve ser inserida. Se você já usa um arquivo Compose, edite o serviço Collabora existente em vez de criar um segundo contêiner.

Os códigos de idioma acima seguem os códigos documentados pela Collabora, onde uma localidade pode incluir um código de país. Use códigos que correspondam aos idiomas dos documentos que seus usuários precisam. Não presuma que todos os códigos possíveis tenham um dicionário utilizável em todas as imagens do CODE: o manual do SDK descreve como alterar a lista configurada, enquanto a versão instalada e seus dicionários ainda determinam o que está realmente disponível. Consulte a documentação da versão da imagem do CODE que você está usando antes de adicionar localidades menos comuns.

Aplicar a alteração

1. Faça um backup ou confirme o arquivo Compose atual para que você possa reverter a alteração.
2. Atualize o dictionariesvalor apenas com os idiomas que seus usuários precisam. Mantenha as demais variáveis ​​de ambiente do Collabora.
3. Recrie o serviço para que o Docker passe o ambiente atualizado para o contêiner. Para uma implantação com Compose, execute o comando docker compose up -d --force-recreate collaboraa partir do diretório que contém o arquivo Compose.
4. Verifique a saída de inicialização com docker compose logs --tail=100 collabora. Procure por erros de inicialização ou de carregamento de dicionário; não considere o status de sucesso do contêiner como prova de que um determinado dicionário foi instalado.

Se a sua implementação usar docker runum ambiente diferente, atualize o -e dictionaries="en_US en_GB fr_FR"argumento e recrie o contêiner com as mesmas opções de rede, volume, proxy e segurança. Alterar o ambiente em um contêiner em execução não altera o ambiente com o qual ele foi iniciado.

Atribua um idioma a cada trecho.

Após o servidor estar pronto, abra um documento no Nextcloud e selecione o texto cujo idioma você deseja verificar. Nos controles de idioma do Collabora, escolha o idioma para a seleção ou parágrafo; para um documento que esteja todo em um único idioma, use a opção que aplica o idioma a todo o texto. Os rótulos dos comandos podem variar ligeiramente entre versões e layouts de tela, mas o importante é definir o idioma do texto do documento, e não apenas alterar o idioma da interface. A ajuda do Collabora explica que o idioma do documento determina o dicionário usado para verificação ortográfica, dicionário de sinônimos e hifenização.

Para um documento com vários idiomas, aplique o idioma em partes. Por exemplo, selecione o parágrafo em francês e defina o idioma como Francês (França), depois selecione os parágrafos em inglês e defina o idioma como Inglês (Estados Unidos). Se o novo texto herdar o idioma errado, posicione o cursor nesse parágrafo e altere o idioma antes de digitar, ou selecione e redefina o idioma do texto posteriormente. Uma palavra com erro ortográfico pode simplesmente ser um texto marcado com o idioma errado.

A verificação ortográfica também pode ser desativada para uma seleção ou idioma. No menu de idiomas do Collabora, a opção “Nenhum” exclui o texto selecionado da verificação ortográfica e da hifenização. Se o texto estiver no idioma correto, mas não receber nenhuma correção ortográfica, verifique o status da verificação ortográfica para esse idioma e veja se a seleção está excluída. A página de ajuda de idiomas do Collabora descreve as opções de idioma e a opção “Nenhum”.

Verificações rápidas quando falta um idioma

O manual de administração do Nextcloud descreve o URL do servidor Collabora na configuração do Office. Mantenha essa configuração de integração separada da alteração do dicionário; se a conexão já funcionava antes, normalmente não é necessário alterá-la para os idiomas de verificação ortográfica. Consulte a documentação de configuração do Nextcloud Office .

Verifique o resultado em um documento real.

Crie ou abra um documento de teste e digite uma palavra com erro ortográfico proposital em cada idioma habilitado. Defina cada trecho de teste para o idioma desejado e confirme se a verificação ortográfica identifica o erro intencional. Digite também uma palavra com a grafia correta em cada idioma para garantir que ela não esteja sendo tratada como texto estrangeiro. Repita o processo com um segundo usuário caso a disponibilidade de idiomas varie entre contas ou documentos.

Se um idioma ainda apresentar problemas, reduza o teste a uma localidade por vez, verifique os logs do CODE e compare o código com a documentação da versão exata da imagem. A lista de idiomas permitidos pelo dicionário padrão do Collabora e o conteúdo da imagem podem mudar entre as versões; os valores padrão documentados no manual da versão 25.04 não devem ser considerados válidos para todas as tags posteriores. Assim que a correção ortográfica funcionar em cada trecho explicitamente marcado, mantenha a menor lista de idiomas que atenda às necessidades dos seus usuários.