Inicio
» MS OFFICE
»
Cómo agregar fuentes personalizadas a Collabora Online CODE Docker
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étodo
Mejor ajuste
Compensación
Montaje de enlace de solo lectura
Un host Compose o una instalación pequeña
Es fácil de actualizar sin necesidad de reconstruir, pero cada host necesita los mismos archivos y rutas de contenedor compatibles.
Imagen Docker personalizada
CI/CD, despliegues repetibles o varios hosts gestionados
Las fuentes se versionan junto con la imagen, pero cambiar una fuente implica reconstruirla y volver a implementarla.
Configuración remota de fuentes
Varios 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.
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.
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.
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.
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
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?
Abra o cree un documento de prueba mediante la integración habitual que inicia su editor de Collabora.
Abre el menú de la familia de fuentes y busca el nombre interno de la familia de fuentes.
Selecciónelo, escriba un breve fragmento, guarde, cierre y vuelva a abrir el documento.
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 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.
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.