ONLYOFFICEドキュメントサーバーにカスタムフォントを追加する方法

ONLYOFFICE Docsでカスタムフォントを使用するには、ドキュメントサーバーを実行しているマシンまたはコンテナにフォントファイルをインストールし、サーバーのフォントリストを再生成して、エディターとエクスポートしたドキュメントで結果を確認してください。ファイルの永続化に関する具体的な手順は、サーバーがLinuxに直接インストールされているか、Dockerで実行されているかによって異なります。

変更が成功した場合、エディタのフォント選択画面でフォントファミリー名が表示され、テスト文書で期待どおりに表示されます。メニューに名前が表示されることは最初の確認としては役立ちますが、すべてのスタイル、言語、またはエクスポートパスが正しく機能することを保証するものではありません。本番文書にフォントを使用する前に、標準テキストと太字テキスト、必要な文字セット、およびPDFまたは印刷プレビューを確認してください。

フォントをインストールすると、何が変わりますか？

ONLYOFFICE Docs は、ドキュメント サーバー ホストで使用可能なフォントを使用し、エディター用のフォント メタデータを作成します。ベンダーのインストール ガイドには、TrueType および OpenType ファミリー（、、、および関連フォーマットを含む）と WOFF フォーマットが記載されています。.ttfサポートされているファイル フォーマットは、すべてのフォント ファイルまたはフォント 機能が同じように動作することを保証するものではありません。使用予定の特定のフォントとドキュメントをテストしてください。.otf.ttc

サーバー側でのフォントインストールにより、接続されたエディターはドキュメントサーバー経由でフォントを使用できるようになります。ただし、すべてのユーザーのコンピューターや他のドキュメント処理サーバーにフォントがインストールされるわけではありません。ダウンロードしたファイルや個別に開いたファイルを、フォントがインストールされていないソフトウェアで表示した場合、そのソフトウェアは別のフォントで代替する可能性があります。また、ONLYOFFICEは、サーバーにドキュメントで使用されているフォントがない場合、ドキュメントは最も近い代替フォントで表示されることがあり、その結果、改行やページレイアウトが変わる可能性があると指摘しています。

サーバーへの展開が許可されているフォントファイルを使用してください。特に、フォントにサーバーでの使用、再配布、またはドキュメントへの埋め込みに関する制限がある場合は、ファイルとそのライセンス条項を展開記録とともに保管してください。

適切なインストール方法を選択してください

• Linuxパッケージのインストール：ドキュメントサーバーマシンのシステムフォントディレクトリにフォントファイルをコピーし、ONLYOFFICEのフォント生成スクリプトを実行します。これは、ホストを直接管理する場合に適しています。
• Dockerコンテナ：永続的なホストディレクトリをコンテナのフォントディレクトリにマウントするか、短期間のテストのために実行中のコンテナにフォントをコピーします。コンテナ内でフォントのメタデータを再生成します。バインドマウントはコンテナの再作成後も維持されますが、コンテナへの一時的なコピーは通常維持されません。
• 管理型または統合型のデプロイメント：別のプラットフォームまたはインストールツールがドキュメントサーバーコンテナを管理している場合は、そのデプロイメントの設定を通じて永続マウントを適用してください。実行中のコンテナのみを編集すると、更新または置換時に設定が失われる可能性があります。

ONLYOFFICEが現在公開しているフォントガイドは、LinuxおよびDocker上のCommunity Editionでは同じ手順を示しており、Enterprise EditionについてはLinux版専用のガイドを別途公開しています。パス、権限、コンテナのオーケストレーションはバージョンやインストール方法によって異なる場合があるため、別の環境のサンプルに置き換えるのではなく、既存の構成を使用してください。

Linuxインストールにフォントを追加する

1. フォントファイルを準備してインストールします。

必要なフォントファミリーファイルを入手してください。ファミリーに太字や斜体などのバリエーションが含まれている場合は、それらも入手してください。通常のフォントファミリーは、分かりやすい名前のディレクトリにまとめて保管してください。たとえば、管理者はフォントファミリーを/usr/share/fonts/、ONLYOFFICEのLinux手順で使用されているシステムパスである の下に配置することができます。

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 で管理されるデプロイメントの場合は、既存の Document Server サービスにバインド マウントを追加します。ファイルのホスト ディレクトリを作成し、それをコンテナの 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リポジトリ