Cómo agregar fuentes personalizadas a Collabora Online CODE Docker

Para que una tipografía personalizada esté disponible en Collabora Online CODE (Collabora Online Development Edition) que se ejecuta en Docker, los archivos de fuente deben estar disponibles para el propio contenedor de Collabora. Instalarlos solo en el host de Docker o en un contenedor Nextcloud independiente no los hace disponibles para el servidor de Office. Para una única implementación de Compose, un montaje de enlace de solo lectura suele ser la opción más sencilla; una imagen personalizada es más fácil de reproducir en un entorno gestionado, mientras que la configuración remota de fuentes puede centralizar la entrega si se puede operar de forma segura.

Los directorios de fuentes exactos pueden variar según la imagen y la versión. La implementación actual de Helm de Collabora monta las fuentes personalizadas en ambas /usr/share/fonts/customubicaciones /opt/cool/systemplate/usr/share/fonts/custom. Esto sirve como referencia para ambas ubicaciones, pero no garantiza que funcione para todas las etiquetas Docker independientes. Verifique las rutas en la imagen que ejecute antes de implementar el ejemplo a continuación.

¿Qué método de instalación de fuentes se ajusta mejor a su implementación?

Elige en función de cuántas instancias de CODE mantengas, cómo implementes las actualizaciones y si puedes operar un servidor de fuentes seguro.

MétodoMejor ajusteCompensación
Montaje de enlace de solo lecturaUn host Compose o una instalación pequeñaEs fácil de actualizar sin necesidad de reconstruir, pero cada host necesita los mismos archivos y rutas de contenedor compatibles.
Imagen Docker personalizadaCI/CD, despliegues repetibles o varios hosts gestionadosLas fuentes se versionan junto con la imagen, pero cambiar una fuente implica reconstruirla y volver a implementarla.
Configuración remota de fuentesVarios casos que requieren un catálogo gestionado centralmente.La entrega centralizada añade una dependencia de servicio y de red; el uso en producción requiere HTTPS y refuerzo operativo.

Si instalas Collabora con su gráfico Helm, primero verifica la deployment.customFontsconfiguración del gráfico: el gráfico original ya proporciona una opción de montaje de fuente personalizada. Para una configuración independiente de Docker Compose, continúa con un montaje de enlace si las rutas de tus imágenes coinciden.

Revise la plantilla de implementación de Helm ascendente y sus dos ubicaciones de montaje de fuentes , y verifique los valores de fuente personalizada del gráfico .

Antes de cambiar de Docker, ¿qué deberías comprobar?

  • Formato de fuente: Utilice archivos de fuente compatibles con su configuración de Collabora. El proyecto oficial de servidor de fuentes de Collabora documenta los archivos TrueType ( .ttf) y OpenType ( .otf).
  • Licencia: Confirme que la licencia de la fuente permite su uso en el servidor y su distribución a los usuarios. No copie fuentes desde un sistema operativo de escritorio a menos que la licencia lo permita.
  • Nombre de la familia: El nombre que aparece en el menú de fuentes proviene de los metadatos internos de la fuente, que pueden diferir del nombre del archivo. Pruebe utilizando el nombre de la familia, no solo el nombre del archivo.
  • En todos los casos: Si un proxy redirige a los usuarios a varios contenedores de Collabora, instale los mismos archivos de fuente en cada instancia. De lo contrario, el mismo documento podría mostrarse de forma diferente según el servidor que lo abra.
  • Rutas exactas de las imágenes: Verifique los directorios y la configuración de inicio de la imagen en ejecución. No reutilice rutas antiguas sin más, como /opt/loolrutas de paquetes no relacionados.

Crea un directorio host, por ejemplo, ./fontsjunto a tu archivo Compose, y coloca allí los archivos permitidos .ttf. .otfLimita el directorio a las fuentes que tengas previsto exponer a través de Collabora.

Un gestor de archivos en /srv/collabora que muestra una carpeta de fuentes, dos archivos de fuentes de ejemplo y el archivo docker-compose.yml.
La carpeta de fuentes del host y el archivo Compose antes de agregar el directorio al servicio Collabora.

¿Cómo se añaden fuentes con Docker Compose?

Agregue las dos entradas de volumen de solo lectura a la volumeslista del servicio Collabora existente. Mantenga la imagen, los puertos, las variables de entorno y demás configuraciones actuales del servicio; se trata de una adición, no de un archivo Compose de reemplazo.

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

El directorio de origen de la izquierda se encuentra en el host de Docker. Las rutas de la derecha están dentro del contenedor. El :rosufijo hace que los archivos sean de solo lectura para el contenedor. Estas rutas de destino siguen la plantilla Helm actual de Collabora; para Docker CODE independiente, primero revise su etiqueta exacta. Si alguna de las ubicaciones no está presente o su versión utiliza directorios diferentes, utilice las rutas compatibles con esa imagen en lugar de forzar este ejemplo.

Un editor Compose que muestra dos montajes de enlace de fuentes de solo lectura, uno en /usr/share/fonts/custom y otro en el directorio de fuentes de la placa del sistema.
El ejemplo de asignación de volumen envía el mismo directorio de fuentes del host a ambas ubicaciones de fuentes de Collabora ascendentes.

Aplique el cambio de Compose durante un período de inactividad, ya que recrear el servicio Collabora puede interrumpir las sesiones de edición activas. Si su servicio se llama collabora, ejecute:

docker compose up -d collabora

Si el nombre de tu servicio Compose es diferente, utiliza el nombre real. Evita reiniciar todo el sistema a menos que otros servicios también necesiten un cambio de configuración.

¿Cómo se puede confirmar que el contenedor puede ver los archivos?

Primero, compruebe que los directorios montados contienen los archivos de fuente. Reemplace collaboracon el nombre del contenedor utilizado en su configuración:

docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom
Una terminal que muestra un comando docker exec que lista ambos directorios custom-font dentro de un contenedor Collabora.
Ejemplo de comando de verificación: listar ambas rutas montadas en el contenedor Collabora en ejecución.

Ver los archivos confirma que Docker está montado, pero no prueba que el editor haya cargado la fuente. Si la imagen incluye utilidades de Fontconfig, puede inspeccionar los nombres de las familias detectadas con fc-list, por ejemplo:

docker exec collabora fc-list : family file

Filtre la salida para la familia que espera, utilizando una herramienta disponible en su contenedor. Si fc-listno está instalada, no agregue paquetes a un contenedor en ejecución como solución permanente; verifique la configuración de fuentes de la imagen o utilice una imagen personalizada reproducible. Si los archivos son visibles pero no se detectan, verifique los permisos, el formato de archivo, los metadatos internos de la familia y ambas rutas de montaje. Luego, consulte los registros para la imagen y la versión exactas que implementó.

¿Cómo se prueba la fuente en Collabora Online?

  1. Abra o cree un documento de prueba mediante la integración habitual que inicia su editor de Collabora.
  2. Abre el menú de la familia de fuentes y busca el nombre interno de la familia de fuentes.
  3. Selecciónelo, escriba un breve fragmento, guarde, cierre y vuelva a abrir el documento.
  4. Si su implementación tiene varias instancias de Collabora, consulte el mismo documento desde otro usuario o navegador.

El siguiente ejemplo ilustra el tipo de comprobación esperado: una familia de fuentes aparece en el menú del editor. No se trata de una captura de una implementación real de CODE, y su barra de herramientas puede variar según la versión o la integración.

Un menú ilustrativo de fuentes del editor de documentos con Sample Sans seleccionado entre varias familias de fuentes.
Un ejemplo del paso de verificación: confirmar que la familia tipográfica deseada aparece en el menú de fuentes del editor.

Si la familia tipográfica aparece, pero el texto se muestra con una fuente alternativa, asegúrese de que existan la variante y el grosor seleccionados (por ejemplo, regular y negrita), y confirme que la fuente esté presente tanto en la ruta de la placa del sistema como en el directorio general de fuentes. Una entrada en el menú por sí sola no garantiza que todos los estilos o todos los servidores tengan la fuente.

¿Cuándo merece la pena contratar un servicio de imágenes personalizadas o de fuentes remotas?

Crea una imagen personalizada para garantizar la repetibilidad.

Un Dockerfile que copia los archivos de fuente aprobados en las rutas utilizadas por la imagen CODE elegida facilita la reproducción de las implementaciones: el resumen de la imagen identifica tanto la compilación del servidor como su conjunto de fuentes. El costo es reconstruir, escanear e implementar cada vez que actualice una fuente o la imagen base. Vuelva a verificar los directorios de destino después de actualizar la imagen base y evite considerar una instrucción de copia de fuentes como universal para todas las versiones de CODE.

Utilice la configuración remota de fuentes para un catálogo compartido.

El proyecto fontserver de Collabora describe la configuración remota de fuentes y un catálogo JSON. Sus responsables lo catalogan como un repositorio para desarrollo y pruebas, por lo que no se debe considerar el servidor de ejemplo como un servicio listo para producción. Para producción, utilice un punto final HTTPS con el mantenimiento adecuado, restrinja y valide las fuentes que sirve, y tenga en cuenta la disponibilidad de la red y el comportamiento de actualización de la caché. Esta opción puede reducir la gestión de archivos por host, pero añade un servicio cuyo fallo o desviación de la configuración puede afectar la disponibilidad de las fuentes.

Consulte el proyecto oficial del servidor de fuentes de Collabora y la documentación de configuración de Collabora para obtener información sobre la disponibilidad de fuentes remotas antes de optar por este método.

¿Qué opción debería elegir?

Para un contenedor CODE gestionado con Docker Compose, comience con un montaje de enlace de solo lectura: es fácil revertirlo y no requiere una compilación personalizada. Para un conjunto mantenido mediante CI/CD, prefiera una imagen personalizada cuando desee que cada implementación incluya un conjunto de fuentes explícito y revisable. Considere la configuración remota de fuentes solo cuando la distribución centralizada represente una ventaja operativa significativa y pueda proporcionar un servicio HTTPS seguro y confiable. En todos los casos, verifique las rutas y pruebe la fuente en un documento real después de la implementación; la lista de fuentes del host por sí sola no puede confirmar que Collabora la haya cargado.

Dejar un comentario

Cómo desactivar la telemetría y la recopilación de datos en LibreOffice

Cómo desactivar la telemetría y la recopilación de datos en LibreOffice

Aprende a desactivar los informes de errores de LibreOffice, los datos del agente de usuario de Actualización en línea y las comprobaciones de actualización automáticas opcionales, además de cómo verificar la configuración.

Cómo instalar ONLYOFFICE Docs Enterprise con Docker Compose

Cómo instalar ONLYOFFICE Docs Enterprise con Docker Compose

Instale ONLYOFFICE Docs Enterprise con el archivo Docker Compose oficial, configure JWT y el almacenamiento persistente, agregue su licencia y verifique el servicio.

Cómo usar expresiones regulares en la función Buscar y reemplazar de LibreOffice para edición avanzada

Cómo usar expresiones regulares en la función Buscar y reemplazar de LibreOffice para edición avanzada

Aprende a usar expresiones regulares en la función Buscar y reemplazar de LibreOffice para limpiar texto, capturar y reordenar datos, controlar el alcance y elegir alternativas más seguras.

Cómo usar las macros de ONLYOFFICE para automatizar la limpieza de hojas de cálculo

Cómo usar las macros de ONLYOFFICE para automatizar la limpieza de hojas de cálculo

Crea una macro segura de JavaScript para ONLYOFFICE que limpie el texto de las hojas de cálculo, conserve las fórmulas y los números, y verifique cada cambio antes de guardar el libro de trabajo.

Collabora Online vs ONLYOFFICE: Prueba de uso de recursos y latencia

Collabora Online vs ONLYOFFICE: Prueba de uso de recursos y latencia

Compara Collabora Online y ONLYOFFICE Docs con las directrices oficiales de dimensionamiento y una prueba repetible para CPU, memoria, tiempo de apertura, latencia de coedición y guardado.

Cómo agregar fuentes personalizadas a Collabora Online CODE Docker

Cómo agregar fuentes personalizadas a Collabora Online CODE Docker

Agregue fuentes personalizadas a Collabora Online CODE en Docker, compare los puntos de montaje, las imágenes personalizadas y la configuración de fuentes remotas, y luego verifique las fuentes en un documento.

Solucionar el problema por el que el menú desplegable de tamaño de fuente de Collabora Online no se muestra correctamente.

Solucionar el problema por el que el menú desplegable de tamaño de fuente de Collabora Online no se muestra correctamente.

Solucione problemas con el menú desplegable de tamaño de fuente de Collabora Online que aparece recortado, estirado o que no responde. Restablezca el zoom de la página, introduzca un tamaño manualmente y compruebe las correcciones de la versión de CODE.

Solucionar el error “LibreOffice requiere un entorno de ejecución de Java (JRE)”

Solucionar el error “LibreOffice requiere un entorno de ejecución de Java (JRE)”

Solucione la advertencia de LibreOffice JRE decidiendo si necesita las funciones de Java, instalando un entorno de ejecución compatible y seleccionándolo en las opciones avanzadas.

Cómo integrar ONLYOFFICE Docs con una aplicación PHP personalizada

Cómo integrar ONLYOFFICE Docs con una aplicación PHP personalizada

Conecte ONLYOFFICE Docs a una aplicación PHP personalizada con una URL de documento segura, una configuración de editor firmada, una API de JavaScript y una función de devolución de llamada para guardar.

Cómo configurar la contraseña de la consola de administración de Collabora Online

Cómo configurar la contraseña de la consola de administración de Collabora Online

Establezca una contraseña para la consola de administración en línea de Collabora para un paquete de Linux o una implementación de Docker de CODE, luego verifique el inicio de sesión y proteja el punto final de administración.