ONLYOFFICE 문서 서버에 사용자 지정 글꼴을 추가하는 방법

ONLYOFFICE Docs에서 사용자 지정 글꼴을 사용하려면 Document Server가 실행되는 컴퓨터 또는 컨테이너에 해당 글꼴 파일을 설치하고, 서버의 글꼴 목록을 다시 생성한 다음, 편집기와 내보낸 문서에서 결과를 확인하십시오. 정확한 파일 영구 저장 단계는 서버가 Linux에 직접 설치되었는지 또는 Docker에서 실행되는지에 따라 다릅니다.

변경이 성공적이라는 것은 편집기의 글꼴 선택기에서 글꼴 패밀리 이름이 표시되고 테스트 문서에서 예상대로 표시되는 것을 의미합니다. 메뉴에 이름이 나타나는 것은 유용한 첫 번째 확인 사항이지만, 모든 스타일, 언어 또는 내보내기 경로가 제대로 작동하는 것을 보장하는 것은 아닙니다. 일반 텍스트와 굵은 텍스트, 필요한 문자 세트, PDF 또는 인쇄 미리보기를 확인한 후 실제 문서에 글꼴을 사용하십시오.

글꼴을 설치하면 어떤 점이 달라지나요?

ONLYOFFICE Docs는 문서 서버 호스트에서 사용 가능한 글꼴을 사용하고 편집기용 글꼴 메타데이터를 생성합니다. 공급업체의 설치 가이드에는 TrueType 및 OpenType 제품군(예: .ttf, .otf, .ttc, 관련 형식)과 WOFF 형식이 나열되어 있습니다. 지원되는 파일 형식이 모든 글꼴 파일이나 글꼴 기능이 동일하게 작동한다는 것을 보장하지는 않으므로 사용하려는 특정 글꼴과 문서를 테스트해야 합니다.

서버 측 글꼴 설치를 통해 연결된 편집자는 문서 서버를 통해 글꼴을 사용할 수 있습니다. 이 방식은 모든 사용자의 컴퓨터나 다른 문서 처리 서버에 글꼴을 설치하지 않습니다. 다운로드했거나 별도로 연 파일을 해당 글꼴이 없는 소프트웨어에서 열면 소프트웨어에서 다른 글꼴로 대체하여 표시할 수 있습니다. ONLYOFFICE는 또한 서버에 문서에 사용된 글꼴이 없는 경우 가장 유사한 대체 글꼴로 문서가 표시될 수 있으며, 이로 인해 줄 바꿈이나 페이지 레이아웃이 변경될 수 있다고 설명합니다.

서버에 배포할 권한이 있는 글꼴 파일을 사용하십시오. 특히 글꼴에 서버 사용, 재배포 또는 문서에 포함시키는 데 제한이 있는 경우, 파일과 라이선스 약관을 배포 기록과 함께 보관하십시오.

올바른 설치 방법을 선택하십시오.

• Linux 패키지 설치: 글꼴 파일을 문서 서버 컴퓨터의 시스템 글꼴 디렉터리에 복사한 다음 ONLYOFFICE의 글꼴 생성 스크립트를 실행합니다. 이 방법은 호스트를 직접 관리하는 경우에 적합합니다.
• Docker 컨테이너: 호스트의 영구 디렉터리를 컨테이너의 글꼴 디렉터리에 마운트하거나, 실행 중인 컨테이너에 글꼴을 복사하여 단기 테스트를 수행할 수 있습니다. 컨테이너 내부에서 글꼴 메타데이터를 다시 생성합니다. 바인드 마운트는 컨테이너를 다시 생성해도 유지되지만, 컨테이너에 일회성으로 복사하는 것은 일반적으로 유지되지 않습니다.
• 관리형 또는 통합 배포: 다른 플랫폼이나 설치 도구가 문서 서버 컨테이너를 관리하는 경우, 해당 배포의 구성을 통해 영구 마운트를 적용하십시오. 실행 중인 컨테이너를 단독으로 편집하면 업데이트 또는 교체 중에 변경 사항이 손실될 수 있습니다.

ONLYOFFICE에서 현재 게시한 글꼴 가이드는 Linux 및 Docker 환경에서 Community Edition의 기본 설치 과정을 동일하게 보여주며, Enterprise Edition의 경우 별도의 Linux 가이드를 제공합니다. 경로, 권한 및 컨테이너 구성은 버전 및 설치 방법에 따라 다를 수 있으므로 다른 환경의 샘플로 교체하기보다는 기존 배포 환경을 사용하는 것이 좋습니다.

리눅스 설치에 글꼴 추가하기

1. 글꼴 파일을 준비하고 설치합니다.

필요한 글꼴 패밀리 파일을 구하십시오. 패밀리에서 굵게 및 기울임꼴 변형을 제공하는 경우 해당 파일도 포함하십시오. 일반적인 글꼴 패밀리는 명확하게 이름이 지정된 디렉터리에 함께 보관하십시오. 예를 들어 관리자는 /usr/share/fonts/ONLYOFFICE의 Linux 지침에서 사용되는 시스템 위치인 `/font-family` 아래에 글꼴 패밀리를 배치할 수 있습니다.

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

예시 파일 이름을 실제 파일 이름으로 바꾸십시오. 글꼴 파일의 패밀리 이름을 변경하는 방법은 피하십시오. 편집기는 각 글꼴 파일 내에 저장된 메타데이터를 사용합니다. 문서 서버 프로세스가 파일을 읽을 수 있는지 확인하십시오. 패키지 또는 구성 관리 시스템을 통해 글꼴을 관리하는 경우, 유지 관리 후에도 파일이 유지되도록 해당 시스템을 사용하십시오.

2. ONLYOFFICE 글꼴 목록을 다시 생성합니다.

파일을 설치한 후 공급업체에서 제공하는 글꼴 생성 스크립트를 실행하십시오.

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

스크립트 실행이 완료될 때까지 기다린 후 출력 결과를 검토하여 오류가 있는지 확인하십시오. 이 단계는 문서 서버에서 사용하는 글꼴 데이터를 업데이트합니다. 글꼴 파일을 호스트에 복사하는 것만으로는 이미 실행 중인 편집기에 글꼴이 표시되지 않을 수 있습니다. 이 절차를 수행하는 동안 기존 서버 글꼴을 삭제하지 마십시오. 시스템 글꼴을 삭제하면 문서 레이아웃 및 표시 방식에 영향을 미칠 수 있다고 공급업체에서 경고합니다.

Docker 배포에 글꼴 추가

1. 글꼴 디렉토리를 영구적으로 유지하세요

Docker Compose로 관리되는 배포의 경우 기존 문서 서버 서비스에 바인드 마운트를 추가합니다. 파일을 저장할 호스트 디렉터리를 생성한 다음 컨테이너의 custom-font 디렉터리에 매핑합니다. ONLYOFFICE의 Docker 이미지는 해당 디렉터리를 /usr/share/fonts/truetype/custom볼륨으로 선언하며, Docker 글꼴 지침에서도 글꼴을 해당 디렉터리 아래에 복사할 수 있도록 허용합니다 /usr/share/fonts/.

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

이 코드는 기존 Compose 파일에 병합할 코드 조각이며, 전체 구성을 대체하는 것이 아닙니다. 기존 이미지 버전, 네트워크, 환경 변수, 데이터 볼륨, 비밀 키 및 서비스 이름을 그대로 유지하십시오. 호스트에 글꼴 파일을 준비하고 /srv/onlyoffice/fonts컨테이너가 해당 파일을 읽을 수 있는지 확인하십시오.

변경된 Compose 파일을 적용하면 문서 서버 컨테이너가 다시 생성되어 활성 편집 세션이 중단될 수 있습니다. 배포 절차를 확인하고 Compose 구성을 백업한 다음 변경 작업을 적절한 시기에 예약하십시오. 컨테이너가 어플라이언스 또는 통합 솔루션으로 관리되는 경우 생성된 Compose 파일을 편집하는 대신 해당 솔루션에서 지원하는 구성 방법을 사용하십시오.

2. 글꼴 메타데이터를 생성하려면 글꼴을 다시 만들거나 재시작하십시오.

배포를 위한 일반적인 Compose 워크플로를 사용하여 마운트를 적용합니다. 그런 다음 실제 Document Server 컨테이너 내부에서 글꼴 생성 스크립트를 실행합니다. 컨테이너 이름이 인 경우 onlyoffice-documentserver명령은 다음과 같습니다.

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

컨테이너 이름 또는 ID를 사용하세요 docker ps. 설정을 영구적으로 적용하기 전에 글꼴만 확인하려면, 공급업체 문서에 docker cp따르면 글꼴 파일을 실행 중인 컨테이너에 복사한 다음 컨테이너 내부에서 동일한 스크립트를 실행해야 합니다. 이는 테스트 목적으로만 사용하십시오. 컨테이너가 교체될 때 컨테이너에 복사된 파일이 사라질 수 있습니다.

글꼴이 편집기와 출력물에서 제대로 표시되는지 확인하십시오.

1. 이 문서 서버에 연결된 편집기에서 문서를 열고 글꼴 선택기를 엽니다. 메타데이터에 기록된 글꼴 패밀리 이름을 검색합니다.
2. 일반 텍스트, 굵은 텍스트, 그리고 필요한 언어 문자 체계의 문자를 사용하여 간단한 테스트 문서를 만드세요. 합성 스타일이나 대체 스타일이 아닌 올바른 글꼴 두께가 선택되었는지 확인하세요.
3. 테스트 문서를 저장하고 다시 열어서 내보내거나 인쇄 미리보기를 해보세요. 줄 바꿈, 페이지 수, 간격 및 문자 적용 범위를 예상 결과와 비교하세요.
4. 사용자가 실제로 사용하는 문서 편집기 또는 응용 프로그램에서 동일한 검사를 반복하십시오. 서버에서 글꼴을 사용할 수 있다고 해서 관련 없는 로컬 응용 프로그램이나 다른 서버에서도 해당 글꼴을 사용할 수 있다는 보장은 없습니다.

이전 버전의 경우, 브라우저에 캐시된 글꼴 메타데이터로 인해 사용자가 보는 내용이 지연될 수 있습니다. ONLYOFFICE에서 제공하는 가이드에 따르면 버전 8.1.3 이하에서는 글꼴을 추가한 후 브라우저 캐시를 지우고 페이지를 다시 열어야 합니다. 이후 버전에서는 이 단계가 필요하지 않습니다. 먼저 서버 측 파일과 생성된 메타데이터를 확인한 후, 사용 중인 버전에 맞는 경우에만 해당 캐시 관련 권장 사항을 적용하십시오.

글꼴이 누락되었거나 레이아웃이 변경된 경우

• 글꼴 선택기에서 해당 글꼴이 보이지 않습니다. 문서 서버 호스트의 글꼴 디렉터리 또는 올바른 컨테이너 내부에 해당 파일이 있는지, 읽기 권한이 있는지, 지원되는 파일 형식인지 확인하십시오. 글꼴 생성 스크립트를 다시 실행하고 출력 결과를 확인하십시오. Docker 환경에서는 컨테이너 내부에서 마운트 상태를 확인하십시오. 호스트 경로만으로는 볼륨이 활성 서비스에 연결되어 있음을 확인할 수 없습니다.
• 글꼴 패밀리 이름이 다르게 보일 수 있습니다. 글꼴에 내장된 패밀리 메타데이터를 확인하세요. 예를 들어 파일 이름은 BrandSans-Bold.ttf올바르게 설치되었을 수 있지만, 메뉴에는 글꼴 내부에 정의된 패밀리 이름이 표시될 수 있습니다.
• 글꼴은 표시되지만 텍스트가 잘못되었습니다. 글꼴에 필요한 문자와 실제 스타일 파일이 포함되어 있는지 확인하십시오. 글꼴 선택기에는 표시되지만 문서에서 사용하는 글리프나 두께가 없을 수 있습니다.
• 변경 후 문서 레이아웃이 다시 조정됩니다. 변경 전후에 사용된 글꼴 종류와 스타일을 정확히 비교해 보세요. 다른 컴퓨터나 내보내기 서비스에서 원본 글꼴이 없는 경우, 대체 글꼴을 사용하면 레이아웃이 변경될 수 있습니다. 렌더링이 발생하는 모든 위치에 라이선스가 있는 글꼴을 설치하거나, ​​문서에 안전한 대체 글꼴을 사용한 후 페이지를 다시 검토하세요.
• 업데이트 후 글꼴이 사라지는 경우: 설치가 일회용 컨테이너 내에서만 이루어졌는지 확인하십시오. 파일을 영구 호스트 디렉터리로 이동하고 배포 구성을 통해 연결한 후 서비스를 다시 생성하십시오.

사용자 지정 글꼴을 추가하는 것은 공유 문서와 ​​제어된 내보내기에서 동일한 글꼴 패밀리가 필요할 때 가장 유용합니다. 하지만 몇 가지 제한 사항이 있습니다. 서버에 설치한다고 해서 글꼴 사용 권한이 자동으로 부여되는 것은 아니며, 누락된 글리프를 추가해 주거나 다른 글꼴 세트를 사용하는 소프트웨어에서 픽셀 단위로 동일한 렌더링을 보장할 수도 없습니다. 따라서 사용자 지정 글꼴 디렉터리를 버전 관리 또는 구성 관리 시스템으로 관리하고, 문서 서버 버전을 기록해 두며, 업그레이드 후에는 검증 절차를 다시 실행해야 합니다.

공식 참고 자료

• ONLYOFFICE Docs Community Edition: Linux에서 글꼴 추가하기
• ONLYOFFICE Docs Community Edition: Docker에 글꼴 추가하기
• ONLYOFFICE Docs Enterprise Edition: Linux에서 글꼴 추가하기
• ONLYOFFICE Docker-DocumentServer 저장소