Como adicionar fontes personalizadas ao Collabora Online CODE Docker

Para disponibilizar uma fonte personalizada no Collabora Online CODE (Collabora Online Development Edition) em execução no Docker, os arquivos de fonte devem estar disponíveis para o próprio contêiner do Collabora. Instalá-los apenas no host do Docker ou em um contêiner Nextcloud separado não os torna disponíveis para o servidor do escritório. Para uma única implantação do Compose, uma montagem de diretório somente leitura geralmente é a opção mais simples; uma imagem personalizada é mais fácil de reproduzir em uma frota gerenciada, enquanto a configuração remota de fontes pode centralizar a distribuição, desde que você consiga operá-la com segurança.

Os diretórios exatos de fontes podem variar de acordo com a imagem e a versão. A implementação atual do Helm upstream da Collabora monta fontes personalizadas em `/usr/local/fonts` /usr/share/fonts/custome `/usr /opt/cool/systemplate/usr/share/fonts/custom/local/fonts`. Essa é uma referência útil para esses dois locais, mas não garante que todos os Dockers independentes estarão presentes. Verifique os caminhos na imagem que você está executando antes de implantar o exemplo abaixo.

Qual método de instalação de fontes é o mais adequado para a sua implementação?

Escolha com base em quantas instâncias do CODE você mantém, como você implementa as atualizações e se você pode operar um servidor de fontes seguro.

MétodoMelhor ajusteTroca
montagem de ligação somente leituraUm host Compose ou uma pequena instalaçãoÉ fácil atualizar sem precisar recompilar, mas cada host precisa dos mesmos arquivos e caminhos de contêiner compatíveis.
Imagem Docker personalizadaCI/CD, implantações repetíveis ou vários hosts gerenciadosAs fontes são versionadas juntamente com a imagem, mas alterar uma fonte significa recompilar e reimplantar o repositório.
Configuração remota de fontesExistem diversos casos que necessitam de um catálogo gerenciado centralmente.A entrega centralizada adiciona uma dependência de serviço e de rede; o uso em produção exige HTTPS e medidas de segurança operacionais reforçadas.

Se você instalar o Collabora com seu gráfico Helm, primeiro verifique as deployment.customFontsconfigurações do gráfico: o gráfico original já oferece uma opção de montagem de fonte personalizada. Para uma configuração independente do Docker Compose, prossiga com uma montagem de diretórios (bind mount) se os caminhos das suas imagens coincidirem.

Analise o modelo de implantação Helm upstream e seus dois locais de montagem de fontes e verifique os valores de fonte personalizada do gráfico .

Antes de alterar o Docker, o que você deve verificar?

  • Formato da fonte: Use arquivos de fonte compatíveis com sua configuração do Collabora. A documentação oficial do projeto Collabora fontserver abrange arquivos TrueType ( .ttf) e OpenType ( )..otf
  • Licença: Confirme se a licença da fonte permite o uso no servidor e a distribuição para seus usuários. Não copie fontes de um sistema operacional de desktop, a menos que a licença permita esse uso.
  • Sobrenome: O nome exibido no menu de fontes vem dos metadados internos da fonte, que podem ser diferentes do nome do arquivo. Faça o teste usando o sobrenome, não apenas o nome do arquivo.
  • Todas as instâncias: Se um proxy encaminhar usuários para vários contêineres do Collabora, instale os mesmos arquivos de fonte em todas as instâncias. Caso contrário, o mesmo documento poderá ser renderizado de forma diferente dependendo do servidor que o abrir.
  • Caminhos exatos das imagens: Verifique os diretórios e a configuração de inicialização da imagem em execução. Não reutilize indiscriminadamente caminhos antigos, como /opt/loolcaminhos de um pacote não relacionado.

Crie um diretório principal ao ./fontslado do seu arquivo Compose e coloque nele os arquivos permitidos .ttf. .otfLimite esse diretório às fontes que você pretende disponibilizar por meio do Collabora.

Um gerenciador de arquivos em /srv/collabora mostrando uma pasta de fontes, dois arquivos de fonte de exemplo e o arquivo docker-compose.yml.
A pasta de fontes do lado do host e o arquivo Compose antes de adicionar o diretório ao serviço Collabora.

Como adicionar fontes com o Docker Compose?

Adicione as duas entradas de volume somente leitura à volumeslista do serviço Collabora existente. Mantenha a imagem, as portas, as variáveis ​​de ambiente e outras configurações atuais do serviço; este é um arquivo Compose adicional, não um arquivo de substituição.

services:
  collabora:
    volumes:
      - ./fonts:/usr/share/fonts/custom:ro
      - ./fonts:/opt/cool/systemplate/usr/share/fonts/custom:ro

O diretório de origem à esquerda está no host Docker. Os caminhos à direita estão dentro do contêiner. O :rosufixo torna os arquivos somente leitura para o contêiner. Esses caminhos de destino seguem o modelo Helm upstream atual da Collabora; para o CODE Docker independente, verifique primeiro a sua tag específica. Se algum dos locais estiver ausente ou se a sua versão usar diretórios diferentes, use os caminhos suportados por essa imagem em vez de forçar este exemplo.

Um editor Compose mostrando duas montagens de fontes somente leitura, uma em /usr/share/fonts/custom e outra no diretório de fontes do sistema.
O exemplo de mapeamento de volume envia o mesmo diretório de fontes do host para ambos os locais de fontes do Collabora upstream.

Aplique a alteração de composição durante um período de baixa atividade, pois recriar o serviço Collabora pode interromper as sessões de edição ativas. Se o seu serviço se chamar collabora, execute:

docker compose up -d collabora

Use o nome real do seu serviço Compose, caso seja diferente. Evite reiniciar toda a pilha, a menos que outros serviços também precisem de uma alteração de configuração.

Como você pode confirmar se o contêiner consegue ver os arquivos?

Primeiro, verifique se os diretórios montados contêm os arquivos de fonte. Substitua `< collaboranome_do_contêiner>` pelo nome do contêiner usado em sua configuração:

docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom
Um terminal exibindo um comando `docker exec` que lista ambos os diretórios de fontes personalizadas dentro de um contêiner Collabora.
Exemplo de comando de verificação: liste os dois caminhos montados no contêiner Collabora em execução.

A visualização dos arquivos confirma as montagens do Docker, mas não comprova que o editor carregou a fonte. Se a imagem incluir as ferramentas Fontconfig, você pode inspecionar os nomes de família detectados com fc-list, por exemplo:

docker exec collabora fc-list : family file

Filtre a saída para a família esperada, usando uma ferramenta disponível no seu contêiner. Se fc-listnão estiver instalada, não adicione pacotes a um contêiner em execução como solução permanente; verifique a configuração de fontes da imagem ou use uma imagem personalizada reproduzível. Se os arquivos estiverem visíveis, mas não forem detectados, verifique as permissões, o formato do arquivo, os metadados internos da família e os dois caminhos de montagem. Em seguida, consulte os logs da imagem e versão exatas que você implantou.

Como testar a fonte no Collabora Online?

  1. Abra ou crie um documento de teste através da integração normal que inicia o seu editor do Collabora.
  2. Abra o menu de famílias de fontes e procure o nome interno da família da fonte.
  3. Selecione-o, digite um pequeno exemplo, salve, feche e abra novamente o documento.
  4. Consulte o mesmo documento a partir de outro usuário ou navegador se sua implantação tiver várias instâncias do Collabora.

O exemplo abaixo ilustra o tipo de verificação esperado: uma família de fontes aparece em um menu do editor. Não se trata de uma captura de tela de uma implementação CODE em produção, e sua barra de ferramentas pode variar de acordo com a versão ou integração.

Um menu ilustrativo de fontes para editor de documentos com a fonte Sample Sans selecionada entre várias famílias de fontes.
Um exemplo da etapa de verificação: confirme se a família de fontes desejada aparece no menu de fontes do editor.

Se a família de fontes aparecer, mas o texto for renderizado em uma fonte substituta, verifique se o estilo e a espessura selecionados existem (por exemplo, regular e negrito) e confirme se a fonte está presente no caminho do diretório do sistema, bem como no diretório geral de fontes. Uma entrada de menu por si só não comprova que todos os estilos ou todos os servidores possuem a fonte.

Quando vale a pena usar um serviço de imagens personalizadas ou fontes remotas?

Crie uma imagem personalizada para garantir a repetibilidade.

Um Dockerfile que copia arquivos de fontes aprovados para os caminhos usados ​​pela sua imagem CODE escolhida facilita a reprodução das implantações: o resumo da imagem identifica tanto a versão do servidor quanto seu conjunto de fontes. O custo é uma nova compilação, verificação e implantação sempre que você atualizar uma fonte ou a imagem base. Verifique novamente os diretórios de destino após atualizações da imagem base e evite tratar uma instrução de cópia de fonte como universal para todas as versões do CODE.

Use a configuração remota de fontes para um catálogo compartilhado.

O projeto fontserver da Collabora descreve a configuração remota de fontes e um catálogo JSON. Seus mantenedores classificam esse repositório como destinado a desenvolvimento e testes, portanto, não considere o servidor de exemplo como um serviço pronto para produção. Para produção, utilize um endpoint HTTPS devidamente mantido, restrinja e valide as fontes que ele serve e leve em conta a disponibilidade da rede e o comportamento de atualização do cache. Essa escolha pode reduzir o gerenciamento de arquivos por host, mas adiciona um serviço cuja falha ou desvio de configuração pode afetar a disponibilidade das fontes.

Consulte o projeto oficial do servidor de fontes Collabora e a documentação de configuração do Collabora para verificar a disponibilidade de fontes remotas antes de optar por essa abordagem.

Qual opção você deve escolher?

Para um contêiner CODE gerenciado com Docker Compose, comece com uma montagem de ligação somente leitura: é simples reverter e não requer uma compilação personalizada. Para uma frota mantida por meio de CI/CD, prefira uma imagem personalizada quando desejar que cada implantação contenha um conjunto de fontes explícito e revisável. Considere a configuração remota de fontes somente quando a distribuição centralizada for um benefício operacional significativo e você puder fornecer um serviço HTTPS seguro e confiável. Em todos os casos, verifique os caminhos e teste a fonte em um documento real após a implantação; a lista de fontes do host, por si só, não confirma se o Collabora a carregou.

Deixar um comentário

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O Microsoft Access é um aplicativo de banco de dados para Windows que permite armazenar registros relacionados, criar consultas, elaborar formulários de entrada de dados e gerar relatórios. Saiba como ele funciona e quando é adequado para você.

Alterar a altura e a largura das linhas de grade no Word 2010

Alterar a altura e a largura das linhas de grade no Word 2010

Aprenda como ajustar a altura e a largura das linhas de grade no Word 2010, alterar a frequência das linhas visíveis e definir o espaçamento horizontal e vertical da grade de desenho subjacente.

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Aprenda como importar um arquivo PST para o Outlook 2010 ou exportar emails, contatos, calendário e tarefas. Siga os menus corretos e evite pastas ausentes ou duplicadas.

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere uma senha esquecida de um arquivo PST do Outlook seguindo os passos atuais do Kernel, incluindo como identificar o arquivo correto, fazer um backup e verificar as limitações da ferramenta.

Como inserir uma página da web em um slide do PowerPoint

Como inserir uma página da web em um slide do PowerPoint

Use o suplemento LiveWeb para inserir um site em um slide do PowerPoint, definir seu tamanho e comportamento de atualização e verificar a compatibilidade antes da apresentação.

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Aprenda como criar e organizar contatos no Outlook 2010, criar um grupo de contatos e selecionar pessoas salvas na Agenda de Endereços ao endereçar um e-mail.

Como criar um campo de hiperlink no Access 2010

Como criar um campo de hiperlink no Access 2010

Crie um campo de Hiperlink no Access 2010 no Modo de Exibição de Design e, em seguida, adicione e teste links para sites, e-mails ou arquivos compartilhados com os detalhes de destino corretos.

Como remover metadados e conteúdo ocultos de um documento do Word

Como remover metadados e conteúdo ocultos de um documento do Word

Use o Inspetor de Documentos do Word para revisar detalhes do autor, comentários, alterações controladas, texto oculto e outros dados antes de compartilhar, e descubra o que a verificação pode não detectar.

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Mova guias personalizadas da Faixa de Opções e comandos da Barra de Ferramentas de Acesso Rápido no Office 2010 com um arquivo .exportedUI e proteja as configurações já existentes no seu computador de destino.

Converter uma planilha do Excel em papel quadriculado imprimível

Converter uma planilha do Excel em papel quadriculado imprimível

Crie papel quadriculado imprimível no Excel ajustando as dimensões das células, definindo uma área de impressão, escolhendo papel A4 e ativando a impressão de linhas de grade no Excel para desktop.