Exemplo ilustrativo: Mira está preparando um relatório para a diretoria no LibreOffice Flatpak e precisa usar uma fonte licenciada chamada “Northstar Sans”, fornecida por sua equipe de design. O nome e a situação são hipotéticos. Ela instala a fonte em seu diretório de fontes de usuário, atualiza o cache de fontes e reinicia o LibreOffice. Isso mantém a fonte disponível para seus aplicativos sem alterar o pacote Flatpak ou conceder ao LibreOffice amplo acesso ao seu diretório pessoal.
A documentação atual de integração com desktop do Flatpak explica por que esse método funciona: as fontes do host $XDG_DATA_HOME/fontssão expostas dentro do sandbox em /run/host/user-fonts. O Flatpak também expõe os diretórios de fontes do sistema. Sua documentação observa que os arquivos de configuração fontconfig do host não são expostos, portanto, as regras de fontes específicas do sistema podem não ser transferidas. Consulte a documentação oficial de fontes do Flatpak . O procedimento abaixo se aplica ao ID do aplicativo LibreOffice do Flathub org.libreoffice.LibreOffice.
Instale a fonte para sua conta de usuário.
Primeiro, verifique a licença da fonte e use apenas os arquivos que você tem autorização para instalar. Se a fonte vier em um arquivo ZIP, extraia-o e localize os arquivos da fonte. Os formatos de fonte mais comuns para desktop incluem OpenType ( .otf) e TrueType ( .ttf). Não copie o próprio arquivo ZIP para o diretório de fontes.
O Mira consegue instalar a fonte sem privilégios de administrador. O diretório de fontes padrão por usuário é `/usr/local/fontes` ~/.local/share/fonts, equivalente a `/usr/local/fontes` $XDG_DATA_HOME/fontsquando o diretório de dados XDG padrão está em uso. A documentação do Flatpak recomenda evitar o ~/.fontsdiretório legado.
- Crie o diretório de fontes do usuário, caso ele ainda não exista:
mkdir -p "$HOME/.local/share/fonts"
- Copie os arquivos de fonte autorizados para a pasta. Substitua o nome do arquivo de exemplo pelo nome da fonte que você recebeu:
cp "$HOME/Downloads/NorthstarSans-Regular.otf" "$HOME/.local/share/fonts/"
Se o pacote de fontes incluir arquivos separados para as versões normal, negrito, itálico ou negrito-itálico, instale cada versão necessária. Mantenha os nomes de arquivo originais sempre que possível; não renomeie os arquivos de fonte para imitar uma família ou peso diferente. Para várias famílias de fontes, crie subdiretórios para manter a pasta organizada.
Atualize o cache de fontes
O Fontconfig cria um cache para que os aplicativos possam encontrar as fontes instaladas. Em muitos sistemas Linux, fc-cacheele é fornecido pelo pacote fontconfig do host. Atualize o cache para o diretório específico do usuário:
fc-cache -f "$HOME/.local/share/fonts"
Essa -fopção força uma varredura do diretório especificado. Se o shell informar que o fc-cachediretório não foi encontrado, instale os utilitários fontconfig por meio do gerenciador de pacotes da sua distribuição Linux ou use o utilitário de gerenciamento de fontes para atualizar as informações de fontes. Os nomes dos pacotes e as ferramentas gráficas variam de acordo com a distribuição.
Para verificar se o arquivo fontconfig do host reconhece a família de fontes, execute:
fc-list | grep -i "Northstar Sans"
Substitua o nome pelo sobrenome exibido pela editora da fonte. Uma correspondência bem-sucedida é uma verificação útil, mas não comprova que o LibreOffice já tenha atualizado sua própria lista de fontes.
Reinicie o LibreOffice Flatpak
Salve os documentos abertos e feche todas as janelas do LibreOffice. Inicie o Flatpak novamente a partir do menu de aplicativos ou execute-o a partir de um terminal:
flatpak run org.libreoffice.LibreOffice
O LibreOffice pode ter lido sua lista de fontes ao iniciar, portanto, instalar uma fonte com o Writer aberto pode deixar a lista antiga visível. No exemplo de Mira, ela espera até que o pacote esteja completamente fechado e, em seguida, inicia o Writer novamente. Se a fonte ainda não aparecer, reinicie a sessão da área de trabalho somente após as verificações mais simples abaixo; uma reinicialização completa do sistema geralmente não é a primeira etapa de solução de problemas.
Confirme a fonte no LibreOffice.
Abra o Writer, clique na caixa de seleção da família de fontes na barra de formatação e digite o nome exato da família. Você também pode abrir a lista de fontes e procurá-la alfabeticamente. Crie uma pequena linha de teste, aplique a nova fonte e verifique se as letras são exibidas conforme o esperado. Experimente os estilos normal e negrito separadamente, caso o pacote forneça mais de uma fonte.
Para um teste prático, Mira abre uma cópia do seu modelo de relatório, aplica a fonte Northstar Sans a um título e a um parágrafo, salva uma cópia de teste, fecha o documento e o reabre. Este é apenas um exemplo ilustrativo, não um relatório de um teste real. O objetivo é confirmar se a família de fontes aparece na lista e se o estilo pretendido permanece aplicado após a reabertura do documento.
Por que o caminho de fonte padrão do Flatpak é preferível?
O Flatpak foi projetado para isolar aplicativos, mas disponibiliza as fontes do host por meio de caminhos específicos. O mapeamento de fontes do usuário documentado permite que as fontes $XDG_DATA_HOME/fontssejam descobertas sem conceder a um aplicativo do Office acesso a todo o sistema de arquivos do host. Uma configuração de sobreposição ampla, como a que você mencionou, --filesystem=hostnão é necessária para esse fluxo de trabalho padrão e concede um acesso muito mais amplo do que o exigido pela instalação de fontes.
O Flatpak mapeia fontes de ` <diretório_de_fontes>` /usr/share/fontspara `< diretório_de_fontes>` /run/host/fonts, de `<diretório_de_fontes>` para `<diretório_de_fontes >` e do diretório de fontes de dados do usuário para `< diretório_de_fontes>`. Isso abrange instalações comuns em todo o sistema e por usuário, embora problemas de empacotamento, tempo de execução ou específicos do host ainda possam afetar configurações individuais. Os arquivos de configuração `fontconfig` do host não são expostos ao sandbox; eles são separados dos próprios arquivos de fonte./usr/local/share/fonts/run/host/local-fonts/run/host/user-fonts
Solucionar problemas com uma fonte que ainda está faltando
- Verifique o diretório real: execute
printf '%s\n' "${XDG_DATA_HOME:-$HOME/.local/share}/fonts". Se XDG_DATA_HOMEestiver definido para um local não padrão, coloque a fonte em seu fontssubdiretório em vez de assumir ~/.local/share/fonts.
- Verifique o tipo de arquivo e a extração: certifique-se de que a pasta contenha arquivos utilizáveis
.otfou .ttffontes, e não apenas um arquivo compactado, um PDF de pré-visualização ou um documento de licença.
- Verifique o nome da família: os nomes dos arquivos de fonte nem sempre correspondem ao nome da família exibido no LibreOffice. Use o
fc-listcomando `fontconfig` para inspecionar os nomes detectados.
- Atualize e reinicie: execute novamente o comando
fc-cache -fpara o diretório correto e, em seguida, feche e abra o LibreOffice completamente. As janelas existentes podem manter a lista de fontes anterior.
- Confirme o ID do Flatpak: se o LibreOffice foi instalado a partir de uma fonte diferente ou com outro ID de aplicativo,
flatpak run org.libreoffice.LibreOfficeessa cópia pode não funcionar. Verifique o aplicativo instalado flatpak liste use o ID exibido para a sua instalação.
- Teste outro aplicativo: se a lista de fontes do host também não reconhecer a fonte, corrija primeiro a instalação do host. Se as ferramentas do host reconhecerem a fonte, mas o Flatpak não, verifique o ambiente de execução e a configuração do pacote Flatpak e, em seguida, consulte o rastreador de problemas do pacote Flatpak com o ID do aplicativo e os detalhes do ambiente de execução.
Uma fonte pode estar instalada no seu computador, mas ser diferente na instalação de outra pessoa. Os documentos geralmente se referem às famílias de fontes pelo nome; isso não garante automaticamente que todos os destinatários tenham a mesma fonte instalada. Se o destinatário precisar de uma cópia visual exata e não precisar editar o texto, exporte um PDF e verifique-o antes de compartilhar. Se o arquivo precisar permanecer editável, coordene a disponibilidade e o licenciamento da fonte com os destinatários.
O que esperar após a instalação
O resultado útil é simples: a nova família de fontes aparece no seletor de fontes do LibreOffice, é aplicada ao texto e permanece selecionada quando o documento é reaberto. Caso contrário, verifique o caminho dos dados do usuário e o arquivo de fonte antes de alterar as permissões do sandbox. O mapeamento padrão do Flatpak abrange a localização usual da fonte por usuário; regras personalizadas do fontconfig, caminhos XDG incomuns, um pacote LibreOffice alternativo e restrições de licenciamento de fontes podem exigir tratamento separado.
O relatório hipotético de Mira estará pronto assim que a fonte Northstar Sans aparecer no Writer e a cópia de teste salva mantiver a formatação pretendida. Para outros usuários, as mesmas verificações distinguem a ausência de uma fonte do host de um problema de atualização ou empacotamento do aplicativo, sem comprometer desnecessariamente a segurança do Flatpak.