Habilitar fuentes personalizadas en Collabora CODE Docker

Para que una fuente personalizada se muestre en Collabora Online CODE ejecutándose en Docker, mantenga los archivos de fuente en el host y monte el mismo directorio tanto en el directorio de fuentes del sistema del contenedor como en su archivo systemplate. El archivo systemplate proporciona archivos a los procesos de documentos aislados; montar las fuentes solo en el archivo systemplate /usr/share/fontspuede hacer que una familia aparezca en el menú de fuentes sin que se muestre en el documento. Esta guía utiliza Docker Compose y la ruta de la imagen CODE actual /opt/cool/systemplate; verifique la ruta si utiliza otra línea de imagen.

Elige una fuente de fuentes que puedas mantener

Un montaje de enlace de solo lectura suele ser la opción más sencilla para un host Docker. Conserva los archivos de fuente cuando se recrea o actualiza el contenedor CODE, y permite revisar con precisión qué archivos puede leer el contenedor. Utilice archivos de fuente que tenga autorización para instalar y redistribuir en el servidor. No copie el directorio de fuentes completo de un sistema de escritorio a menos que haya comprobado sus licencias y necesite esos archivos.

Utilice archivos de fuente sin comprimir en formatos compatibles con su entorno, generalmente TrueType ( .ttf) u OpenType ( .otf). Incluya los estilos que sus documentos necesitan, como normal, negrita, cursiva y negrita cursiva. Mantenga claros los nombres de las familias de fuentes y los nombres de los archivos, y asegúrese de que el usuario del contenedor pueda leer todos los directorios y archivos. Una fuente que contenga un solo estilo puede provocar que Collabora la sustituya por otra cuando un documento solicite negrita o cursiva.

Primero, cree un directorio dedicado para el host y copie en él los archivos autorizados:

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

Sustituye los nombres de archivo de ejemplo por los de tus archivos de fuente reales. El permiso de lectura es importante porque el proceso CODE se ejecuta como una cuenta sin privilegios en las imágenes actuales. Mantén la ruta del directorio estable; los montajes de enlace de Compose la utilizarán.

Montar las fuentes tanto en el árbol de fuentes del host como en la placa del sistema.

En su collaboraservicio existente en docker-compose.yml, agregue estas entradas de volumen. Conserve su imagen, puertos, lista de dominios permitidos, configuración SSL, secretos y política de reinicio existentes; el fragmento a continuación muestra solo los montajes de fuentes.

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

El primer objetivo permite que las fuentes estén disponibles para el descubrimiento de fuentes habitual del contenedor. El segundo objetivo las coloca dentro de la plantilla utilizada para preparar entornos de documentos aislados. El manual del SDK de Collabora documenta este patrón de volumen de dos ubicaciones para Docker. No monte el directorio completo /usr/share/fontsni el directorio systemplate: esto puede ocultar las fuentes que ya proporciona la imagen.

La ruta de la plantilla del sistema depende de la versión. Los metadatos de la imagen actual de CODE 26.04 la identifican /opt/cool/systemplatecomo su ruta de plantilla del sistema, y ​​la documentación actual de Collabora utiliza esa ubicación. Si ejecuta una imagen anterior o una compilación específica del proveedor, revise la documentación o la configuración de inicio de esa imagen antes de editar la ruta de destino.

Recrea el contenedor y confirma la detección de fuentes.

Después de guardar el archivo Compose y colocar los archivos de fuente en el host, vuelva a crear el servicio CODE para que Docker aplique los montajes de enlace:

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

En la salida, busque el nombre de la familia de fuentes o la ruta del archivo montado. Para acotar la lista, pásela greppor el nombre de la familia que informa la propia fuente, por ejemplo:

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

Si el comando no detecta ninguna coincidencia, compruebe la ruta del host, los permisos de archivo, la indentación del montaje y los registros del contenedor. Puede inspeccionar los montajes efectivos en docker inspectel contenedor en ejecución o utilizar docker compose configpara detectar errores de indentación YAML. Normalmente, no es necesario ejecutarlo docker compose downsolo para aplicar el cambio de volumen; basta con recrear el servicio.

Verifica que la fuente se muestre correctamente dentro de un documento real.

Abra un documento de prueba mediante la integración habitual de Nextcloud o WOPI, seleccione un fragmento de texto y elija la fuente personalizada en el selector de fuentes. Escriba una nueva línea con esa fuente, guarde, cierre y vuelva a abrir el archivo. Compruebe el texto normal y en negrita, y compare los saltos de línea o el diseño de página con el documento original. La aparición de una fuente en el menú es solo una comprobación preliminar; el texto visible tras reabrir el archivo es la comprobación de visualización útil.

• La fuente aparece en el menú, pero el texto desaparece o retrocede: confirme que el segundo punto de montaje apunta al directorio de fuentes de la placa del sistema y que contiene los mismos archivos.
• La fuente no aparece en el menú: confirme que los archivos son válidos y legibles, y luego revise fc-listla salida y los registros de inicio del contenedor.
• La fuente funciona hasta que se actualiza la imagen: verifique que ambos puntos de montaje permanezcan en Compose y que su directorio host no esté dentro de una ruta de contenedor temporal.
• Solo se muestran algunos caracteres: es posible que la fuente seleccionada no contenga esos glifos. Añada una fuente con la cobertura de escritura necesaria o utilice una alternativa adecuada.

Un montaje de enlace mantiene las fuentes independientes de la imagen CODE, pero no garantiza una maquetación idéntica en todos los clientes ni en todos los documentos. La sustitución de fuentes, la falta de glifos, las diferentes versiones de fuentes y el formato específico del documento pueden modificar el ajuste de línea. Para obtener más información sobre la configuración, consulte la documentación de instalación de fuentes de Collabora , su guía de imágenes Docker de CODE y el manual del SDK en línea de Collabora . Se recomienda consultar nuevamente el ejemplo de Docker del manual y la documentación de la imagen actual al cambiar de versión de CODE.