Cómo agregar fuentes personalizadas al servidor de documentos ONLYOFFICE

Para que una tipografía personalizada esté disponible en ONLYOFFICE Docs, instale sus archivos de fuente en la máquina o contenedor donde se ejecuta Document Server, regenere la lista de fuentes del servidor y compruebe el resultado en un editor y en un documento exportado. El procedimiento exacto para la persistencia de archivos depende de si el servidor está instalado directamente en Linux o se ejecuta en Docker.

Un cambio exitoso significa que la fuente aparece con su nombre de familia en el selector de fuentes del editor y se muestra correctamente en un documento de prueba. Ver el nombre en el menú es una primera comprobación útil, pero no garantiza que todos los estilos, idiomas o rutas de exportación funcionen. Antes de usar la fuente en documentos de producción, verifique el texto normal y en negrita, los conjuntos de caracteres necesarios y la vista previa en PDF o para impresión.

¿Qué cambia al instalar una fuente?

ONLYOFFICE Docs utiliza las fuentes disponibles en el servidor de documentos y genera metadatos de fuente para sus editores. Las guías de instalación del proveedor enumeran las familias TrueType y OpenType, incluidos formatos relacionados, así como formatos WOFF. Los tipos de archivo compatibles no garantizan que todos los archivos de fuente o funciones .ttfde fuente se comporten de la misma manera; pruebe la fuente y el documento específicos que planea usar..otf.ttc

La instalación de la fuente en el servidor permite a los editores conectados usarla a través de Document Server. No instala la tipografía en el equipo de cada usuario ni en otros servidores de procesamiento de documentos. Si un archivo descargado o abierto por separado se visualiza en un software que no dispone de la fuente, este podría sustituirla por otra. ONLYOFFICE también indica que, si el servidor no dispone de la fuente utilizada en el documento, se puede mostrar con una fuente similar, lo que puede modificar los saltos de línea o el diseño de página.

Utilice archivos de fuentes que tenga autorización para implementar en un servidor. Conserve los archivos y sus términos de licencia junto con sus registros de implementación, especialmente si la fuente tiene restricciones de uso en el servidor, redistribución o incrustación en documentos.

Elija el método de instalación correcto.

• Instalación del paquete en Linux: copie los archivos de fuente en el directorio de fuentes del sistema en el servidor de documentos y, a continuación, ejecute el script de generación de fuentes de ONLYOFFICE. Esto es apropiado si administra el host directamente.
• Contenedor Docker: monta un directorio persistente del host en el directorio de fuentes del contenedor, o copia las fuentes en un contenedor en ejecución para una prueba breve. Regenera los metadatos de la fuente dentro del contenedor. Un montaje de enlace se conserva tras la recreación del contenedor; una copia única en el contenedor generalmente no.
• Implementación gestionada o integrada: si otra plataforma o herramienta de instalación gestiona el contenedor del servidor de documentos, aplique el montaje persistente a través de la configuración de dicha implementación. La edición de un contenedor en ejecución puede provocar la pérdida de los cambios durante una actualización o sustitución.

Las guías de fuentes publicadas actualmente por ONLYOFFICE muestran el mismo flujo principal para la edición Community en Linux y Docker, y publican una guía independiente para Linux en la edición Enterprise. Las rutas, los permisos y la orquestación de contenedores pueden variar según la versión y el método de instalación, por lo que se recomienda usar la configuración existente de la implementación en lugar de reemplazarla con un ejemplo de otro entorno.

Agregar fuentes en una instalación de Linux

1. Prepara e instala los archivos de fuente.

Obtenga los archivos de familia necesarios, incluidas las variantes en negrita y cursiva si la familia las proporciona. Mantenga una familia regular junta en un directorio con un nombre claro. Por ejemplo, un administrador podría colocar una familia de fuentes en /usr/share/fonts/, la ubicación del sistema utilizada en las instrucciones de ONLYOFFICE para Linux:

sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/

Sustituya los nombres de archivo de ejemplo por los que realmente tenga. Evite cambiar el nombre de los archivos de fuente para modificar su nombre de familia; los editores utilizan los metadatos almacenados en cada archivo de fuente. Asegúrese de que los procesos del servidor de documentos puedan leer los archivos. Si gestiona las fuentes mediante un sistema de gestión de paquetes o configuración, utilice dicho sistema para que los archivos permanezcan disponibles tras el mantenimiento.

2. Regenerar la lista de fuentes de ONLYOFFICE

Ejecute el script de generación de fuentes del proveedor después de instalar los archivos:

sudo /usr/bin/documentserver-generate-allfonts.sh

Permita que el script finalice y revise su resultado en busca de errores. Este paso actualiza los datos de fuente utilizados por Document Server; simplemente copiar un archivo de fuente al host podría no hacer que aparezca en un editor que ya esté en ejecución. No elimine las fuentes del servidor existentes durante este procedimiento. El proveedor advierte que eliminar las fuentes del sistema puede afectar el diseño y la visualización del documento.

Agregar fuentes a una implementación de Docker

1. Haz que el directorio de fuentes sea persistente.

Para una implementación administrada con Docker Compose, agregue un montaje de enlace al servicio Document Server existente. Cree un directorio host para los archivos y luego asígnelo al directorio custom-font del contenedor. La imagen Docker de ONLYOFFICE se declara /usr/share/fonts/truetype/customcomo un volumen, y sus instrucciones de fuente Docker también permiten copiar fuentes en /usr/share/fonts/.

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:<your-pinned-version>
    volumes:
      - /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom

Este es un fragmento para integrar en tu archivo Compose actual, no una configuración de reemplazo completa. Conserva la versión de la imagen, las redes, las variables de entorno, los volúmenes de datos, los secretos y el nombre del servicio existentes. Prepara los archivos de fuente en el host /srv/onlyoffice/fontsy asegúrate de que el contenedor pueda leerlos.

Aplicar un archivo Compose modificado puede recrear el contenedor del servidor de documentos e interrumpir las sesiones de edición activas. Revise su procedimiento de implementación, realice una copia de seguridad de la configuración de Compose y programe el cambio adecuadamente. Si el contenedor está administrado por un dispositivo o una integración, utilice su método de configuración compatible en lugar de editar un archivo Compose generado.

2. Recrear o reiniciar, luego generar metadatos de fuente.

Aplique el montaje utilizando el flujo de trabajo de Compose normal para su implementación. Luego, ejecute el script de generación de fuentes dentro del contenedor del servidor de documentos. Para un contenedor llamado onlyoffice-documentserver, el comando es:

docker exec onlyoffice-documentserver   /usr/bin/documentserver-generate-allfonts.sh

Utilice el nombre o ID del contenedor que se muestra docker ps. Si solo desea comprobar una fuente antes de que la configuración sea permanente, el proveedor documenta cómo copiar archivos de fuente en un contenedor en ejecución con docker cp, seguido de la ejecución del mismo script dentro del contenedor. Considere esto como una prueba: los archivos copiados en un contenedor pueden desaparecer cuando se reemplaza el contenedor.

Verifique la fuente en un editor y en la salida.

1. Abra un documento en un editor conectado a este servidor de documentos y abra el selector de fuentes. Busque el nombre de la familia de la fuente tal como aparece en sus metadatos.
2. Crea un documento de prueba breve con texto normal, texto en negrita y caracteres de los alfabetos que necesites. Confirma que se haya seleccionado el grosor correcto y no un estilo sintético o sustituido.
3. Guarde, vuelva a abrir y exporte o previsualice la impresión del documento de prueba. Compare los saltos de línea, el número de páginas, el espaciado y la cobertura de glifos con el resultado esperado.
4. Repita la comprobación en el editor de documentos o en la aplicación que sus usuarios utilizan habitualmente. Que una fuente esté disponible en el servidor no garantiza que una aplicación local independiente u otro servidor la tenga.

En instalaciones antiguas, los metadatos de fuentes almacenados en caché en el navegador pueden retrasar la visualización de las fuentes. Las guías publicadas por ONLYOFFICE indican que, para la versión 8.1.3 o anterior, se debe borrar la caché del navegador y volver a abrir la página después de agregar las fuentes; para versiones posteriores, este paso no es necesario. Primero, verifique los archivos del servidor y los metadatos generados, y luego siga esta recomendación sobre la caché solo si coincide con su versión.

Si falta la fuente o cambia el diseño

• La fuente no aparece en el selector: confirme que el archivo se encuentra en el directorio de fuentes del servidor de documentos o dentro del contenedor correcto, que es legible y que tiene un tipo de archivo compatible. Ejecute de nuevo el script de generación de fuentes y lea su resultado. En Docker, compruebe el montaje desde dentro del contenedor; una ruta de host por sí sola no demuestra que el volumen esté conectado al servicio activo.
• El nombre de la familia tipográfica puede ser diferente: compruebe los metadatos de la familia integrados en la fuente. Un nombre de archivo como este BrandSans-Bold.ttfpuede estar instalado correctamente, aunque el menú muestre el nombre de la familia definido dentro de la fuente.
• La fuente aparece, pero el texto es incorrecto: compruebe si la fuente incluye los caracteres necesarios y los archivos de estilo correspondientes. Una fuente puede aparecer en el selector, pero carecer de un glifo o grosor utilizado por el documento.
• Tras el cambio, los documentos se reorganizan: compare la familia tipográfica y el estilo exactos utilizados antes y después. Si la fuente original no está disponible en otro equipo o servicio de exportación, puede utilizar una fuente sustituta para modificar el diseño. Instale la fuente con licencia donde se procese la renderización o utilice una alternativa compatible con el documento y revise las páginas nuevamente.
• La fuente desaparece tras una actualización: compruebe si la instalación se realizó únicamente dentro de un contenedor desechable. Mueva los archivos a un directorio persistente del host y adjúntelo a través de la configuración de despliegue antes de recrear el servicio.

Agregar fuentes personalizadas es especialmente útil cuando se necesita la misma familia tipográfica en documentos compartidos y exportaciones controladas. Sin embargo, tiene limitaciones: la instalación en el servidor no otorga derechos de uso de la fuente, no agrega glifos faltantes ni garantiza una representación idéntica píxel a píxel en software que utiliza un conjunto de fuentes diferente. Mantenga el directorio de fuentes personalizadas bajo control de versiones o administración de configuración, documente la versión del servidor de documentos y vuelva a ejecutar las comprobaciones de verificación después de las actualizaciones.

Referencias oficiales

• ONLYOFFICE Docs Community Edition: Cómo añadir fuentes en Linux
• ONLYOFFICE Docs Community Edition: Cómo añadir fuentes en Docker
• ONLYOFFICE Docs Enterprise Edition: Cómo añadir fuentes en Linux
• Repositorio de ONLYOFFICE para Docker-DocumentServer