Disponibilize fontes personalizadas no Collabora CODE Docker.

Para que uma fonte personalizada seja renderizada no Collabora Online CODE em execução no Docker, mantenha os arquivos de fonte no host e monte o mesmo diretório tanto no diretório de fontes do sistema do contêiner quanto no diretório de fontes do sistema do documento. O diretório de fontes do sistema fornece arquivos para processos de documentos isolados; montar as fontes apenas nele /usr/share/fontspode fazer com que uma família apareça no menu de fontes sem que ela seja renderizada no documento. Este guia usa o Docker Compose e o caminho da imagem CODE atual /opt/cool/systemplate; verifique o caminho se você usar uma linha de imagem diferente.

Escolha uma fonte que você possa manter.

Uma montagem de diretório somente leitura geralmente é a opção mais simples para um host Docker. Ela preserva os arquivos de fonte quando o contêiner CODE é recriado ou atualizado, e você pode verificar exatamente quais arquivos o contêiner pode ler. Use arquivos de fonte que você tenha autorização para instalar e redistribuir para o servidor. Não copie todo o diretório de fontes de um sistema operacional desktop, a menos que você tenha verificado as licenças e realmente precise desses arquivos.

Use arquivos de fontes não compactados em formatos compatíveis com seu ambiente, geralmente TrueType ( .ttf) ou OpenType ( .otf). Inclua os estilos necessários para seus documentos, como normal, negrito, itálico e negrito itálico. Mantenha os nomes das famílias e dos arquivos claros e certifique-se de que o usuário do contêiner possa ler todos os diretórios e arquivos. Uma fonte que contenha apenas um estilo pode fazer com que o Collabora substitua a fonte por outra quando um documento solicitar negrito ou itálico.

Primeiro, crie um diretório de host dedicado e copie os arquivos autorizados para ele:

sudo mkdir -p /srv/collabora/fonts
sudo cp BrandSans-Regular.ttf BrandSans-Bold.ttf /srv/collabora/fonts/
sudo chmod -R a+rX /srv/collabora/fonts

Substitua os nomes de arquivo de exemplo pelos seus arquivos de fonte reais. A permissão de leitura é importante porque o processo CODE é executado como uma conta sem privilégios nas imagens atuais. Mantenha o caminho do diretório estável; os pontos de montagem do Compose farão referência a ele.

Inclua as fontes tanto na árvore de fontes do host quanto na placa do sistema.

No seu collaboraserviço existente docker-compose.yml, adicione estas entradas de volume. Mantenha sua imagem, portas, lista de permissões de domínio, configurações SSL, segredos e política de reinicialização existentes; o trecho abaixo mostra apenas as montagens de fonte.

services:
  collabora:
    volumes:
      - /srv/collabora/fonts:/usr/share/fonts/truetype/more:ro
      - /srv/collabora/fonts:/opt/cool/systemplate/usr/share/fonts/truetype/more:ro

O primeiro destino disponibiliza as fontes para a descoberta de fontes padrão do contêiner. O segundo destino as coloca dentro do modelo usado para preparar ambientes de documentos isolados. O manual do SDK da Collabora documenta esse padrão de volume de dois locais para o Docker. Não monte sobre o /usr/share/fontsdiretório `systemplate` inteiro: isso pode ocultar as fontes já fornecidas pela imagem.

O caminho do modelo do sistema é sensível à versão. Os metadados da imagem CODE 26.04 identificam /opt/cool/systemplateesse caminho como o caminho do modelo do sistema, e a documentação atual da Collabora usa esse local. Se você estiver executando uma imagem mais antiga ou uma versão específica do fornecedor, verifique a documentação ou a configuração de inicialização dessa imagem antes de editar o caminho de destino.

Recrie o contêiner e confirme a descoberta da fonte.

Após salvar o arquivo Compose e colocar os arquivos de fonte no host, recrie o serviço CODE para que o Docker aplique as montagens de diretório:

docker compose up -d --force-recreate collabora
docker compose exec -T collabora fc-list

Na saída, procure o nome da família da fonte ou o caminho do arquivo montado. Para refinar a lista, utilize a função `filter` grepcom o nome da família da fonte informado por ela, por exemplo:

docker compose exec -T collabora fc-list | grep -i "Brand Sans"

Se o comando não reportar nenhuma correspondência, verifique o caminho do host, as permissões de arquivo, a indentação da montagem e os logs do contêiner. Você pode inspecionar as montagens efetivas no docker inspectcontêiner em execução ou usar o comando docker compose configpara detectar erros de indentação no YAML. docker compose downNormalmente, não é necessário executar o comando apenas para aplicar a alteração de volume; recriar o serviço é suficiente.

Verifique se a fonte é exibida corretamente em um documento real.

Abra um documento de teste através da integração normal com o Nextcloud ou WOPI, selecione um pequeno trecho de texto e escolha a família de fontes personalizada no seletor de fontes. Digite uma nova linha com essa fonte, salve, feche e abra o arquivo novamente. Verifique o texto normal e em negrito e compare as quebras de linha ou o layout da página com o documento original. A presença de uma família de fontes no menu é apenas uma verificação inicial; o texto visível após a reabertura do arquivo é a verificação de renderização útil.

• A fonte aparece no menu, mas o texto desaparece ou volta ao formato original: confirme se a segunda montagem tem como alvo o diretório de fontes do systemplate e se ele contém os mesmos arquivos.
• A fonte está faltando no menu: confirme se os arquivos são válidos e legíveis e, em seguida, inspecione fc-lista saída e os logs de inicialização do contêiner.
• A fonte funciona até que uma atualização de imagem seja realizada: verifique se ambos os pontos de montagem permanecem no Compose e se o diretório do host não está dentro de um caminho de contêiner temporário.
• Apenas alguns caracteres são exibidos: a fonte selecionada pode não conter esses glifos. Adicione uma fonte com a cobertura de caracteres necessária ou use uma fonte alternativa adequada.

Um bind mount mantém as fontes independentes da imagem do CODE, mas não garante um layout idêntico em todos os clientes ou em todos os documentos. Substituição de fontes, glifos ausentes, versões diferentes de fontes e formatação específica do documento ainda podem afetar a quebra de linha. Para obter detalhes adicionais sobre a configuração, consulte a documentação de instalação de fontes da Collabora , o guia da imagem Docker do CODE e o manual do SDK do Collabora Online . O exemplo do Docker no manual e a documentação da imagem atual devem ser consultados novamente ao alterar as versões do CODE.