Linux と Docker で Aspose.Slides のフォントをデプロイ

このページの概要

Linux サーバーや Docker コンテナ上で .NET 用 Aspose.Slides のフォントをデプロイします。置き換えられるフォントの確認、Debian、Ubuntu、Alpine へのフォントパッケージのインストール、独自フォントファイルの追加、デフォルトフォントの設定が可能です。

概要

Aspose.Slides は、プレゼンテーションをレンダリングする際に使用可能なフォントでテキストを描画します。たとえばスライドを PDF や画像に変換する場合です。Windows デスクトップには通常、プレゼンテーションが使用するフォントが揃っています。Linux サーバーやコンテナにはフォントがほとんどないか全くないため、Aspose.Slides は代替フォントでテキストを描画します。代替フォントは文字形状や幅が異なるため、行の折り返しが変わったりテキストがシェイプからはみ出したり、代替フォントに存在しない文字は正しく描画されません。フォントがまったくインストールされていない場合、変換はエラーで停止します。

この記事では、Aspose.Slides が置き換えるフォントの確認方法、Debian、Ubuntu、Alpine Linux へのフォントのインストール方法、独自のフォントファイルの追加方法、およびフォントが見つからない場合に使用するフォントの設定方法を示します。例は公式 .NET イメージ上の Docker で実行され、Run Aspose.Slides for .NET in Docker と同様です。パッケージコマンドは Dockerfile の指示です。Linux サーバーでは、同じコマンドを root で実行してください。

フォント API 自体（プレゼンテーションへのフォント埋め込みやフォールバック・置換ルールなど）については、PowerPoint Fonts を参照してください。

置き換えられるフォントの確認

以下のコンソールアプリケーションは、現在の環境で Aspose.Slides が置き換えるフォントを報告します。FontCheck という名前のフォルダーを作成し、以下のファイルをその中に追加してください。

FontCheck.csproj は Debian および Ubuntu 用のパッケージである Aspose.Slides.NET6.CrossPlatform を参照しています。また、オプションの fonts フォルダーのファイルをアプリケーションの出力にコピーします。Load Fonts from the Application Folder セクションで使用します。

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Aspose.Slides.NET6.CrossPlatform" Version="26.9.0" />
    <None Update="fonts/**" CopyToOutputDirectory="PreserveNewest" />
  </ItemGroup>

</Project>

Program.cs はフォント名ごとにスライドにテキストボックスを 1 つ追加し、LatinFont プロパティでフォントを設定します。フォント名はコマンドラインから取得します。引数がない場合、アプリケーションは Calibri、Arial、Times New Roman をチェックします。Aspose.Slides がフォントを検索するフォルダー（FontsLoader.GetFontFolders）を表示し、スライドを output/fonts.pdf にレンダリングし、IFontsManager.GetSubstitutions が報告する置き換えを出力します。冒頭のオプションの 2 つの手順（fonts フォルダーのロードと DEFAULT_FONT 変数の読み取り）については、この記事の後半で説明します。

using System;
using System.IO;
using System.Linq;
using Aspose.Slides;
using Aspose.Slides.Export;

// 確認するフォント: コマンドライン引数、または一般的な Office フォント 3 つ。
var fontNames = args.Length > 0 ? args : new[] { "Calibri", "Arial", "Times New Roman" };

// アプリケーションの隣にある fonts フォルダーからフォントファイルをロードします（存在する場合）。
var appFontFolder = Path.Combine(AppContext.BaseDirectory, "fonts");
if (Directory.Exists(appFontFolder))
{
    FontsLoader.LoadExternalFonts(new[] { appFontFolder });
}

// 環境変数 DEFAULT_FONT に設定されたフォント名を、フォントが見つからないテキストに使用します（設定されている場合）。
var loadOptions = new LoadOptions();
var defaultFont = Environment.GetEnvironmentVariable("DEFAULT_FONT");
if (!string.IsNullOrEmpty(defaultFont))
{
    loadOptions.DefaultRegularFont = defaultFont;
}

var fontFolders = FontsLoader.GetFontFolders().Distinct();
Console.WriteLine($"Font folders: {string.Join(", ", fontFolders)}");

using var presentation = new Presentation(loadOptions);
var slide = presentation.Slides[0];
for (var i = 0; i < fontNames.Length; i++)
{
    var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50 + i * 80, 600, 60);
    shape.TextFrame.Text = $"This text is set in {fontNames[i]}.";
    shape.TextFrame.Paragraphs[0].Portions[0].PortionFormat.LatinFont = new FontData(fontNames[i]);
}

Directory.CreateDirectory("output");
presentation.Save(Path.Combine("output", "fonts.pdf"), SaveFormat.Pdf);

var substitutions = presentation.FontsManager.GetSubstitutions().ToList();
if (substitutions.Count == 0)
{
    Console.WriteLine("No font substitutions.");
}
else
{
    Console.WriteLine("Font substitutions:");
    foreach (var substitution in substitutions)
    {
        Console.WriteLine($"  {substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
    }
}

.dockerignore はローカルのビルド結果をビルドコンテキストから除外します:

bin/
obj/
output/

Dockerfile は .NET SDK イメージでアプリケーションをビルドし、.NET ランタイムイメージで実行します。ランタイムステージでは、Aspose.Slides.NET6.CrossPlatform が必要とする libfontconfig1 と DejaVu フォントをインストールします。Run Aspose.Slides for .NET in Docker が各指示を解説しています。

FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
WORKDIR /src
COPY FontCheck.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish --no-restore -c Release -o /app

FROM mcr.microsoft.com/dotnet/runtime:10.0
RUN apt-get update \
    && apt-get install -y --no-install-recommends libfontconfig1 fonts-dejavu-core \
    && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /app .
RUN mkdir output && chown $APP_UID output
USER $APP_UID
ENTRYPOINT ["dotnet", "FontCheck.dll"]

イメージをビルドし、チェックを実行します:

docker build -t font-check .
docker run --rm font-check

イメージには DejaVu フォントしかないため、3 つのフォントすべてが DejaVu Sans に置き換えられます:

Font folders: /usr/share/fonts, /usr/local/share/fonts, .local/share/fonts, /app/.fonts
Font substitutions:
  Calibri -> DejaVu Sans
  Arial -> DejaVu Sans
  Times New Roman -> DejaVu Sans

自分のプレゼンテーションのフォントを確認するには、フォント名を引数として渡します。例: docker run --rm font-check "Segoe UI" Consolas。コンテナから output/fonts.pdf をコピーするには、Copy the Output to Your Machine のコマンドを使用してください。

Debian と Ubuntu へのフォントのインストール

Microsoft Core Fonts

ttf-mscorefonts-installer パッケージは、Web 用の Microsoft のコアフォント（Arial、Times New Roman、Courier New、Verdana、Georgia、Trebuchet MS など）をダウンロードしてインストールします。これらのフォントは Microsoft のエンドユーザーライセンス契約（EULA）に基づいてライセンスされており、パッケージは EULA が承認された後にのみインストールします。Docker ビルドではプロンプトに答えることができないため、インストーラは EULA を拒否し、フォントはインストールされませんが apt-get install は成功を報告します。パッケージをインストールする前に debconf-set-selections で EULA を承認してください。

Dockerfile では、ランタイムステージでパッケージをインストールする RUN 命令を次のように置き換えます:

RUN echo "ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | debconf-set-selections \
    && apt-get update \
    && apt-get install -y --no-install-recommends libfontconfig1 fonts-dejavu-core ttf-mscorefonts-installer \
    && rm -rf /var/lib/apt/lists/*

イメージをビルドし、同じ 2 つのコマンドでチェックを再実行します。Arial と Times New Roman がインストールされました:

Font folders: /usr/share/fonts, /usr/local/share/fonts, .local/share/fonts, /app/.fonts
Font substitutions:
  Calibri -> Arial

Calibri は Aspose.Slides が作成するプレゼンテーションのデフォルトフォントですが、コアフォントには含まれないため、依然として置き換えられます。Set a Default Font for Missing Fonts を参照してください。

Debian では、パッケージは contrib リポジトリコンポーネントにありますが、Debian イメージでは有効になっていません。デフォルトの .NET 8 と .NET 9 イメージは Debian 12 をベースにしています。同じ命令で contrib を有効にします:

RUN sed -i 's/^Components: main$/Components: main contrib/' /etc/apt/sources.list.d/debian.sources \
    && echo "ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | debconf-set-selections \
    && apt-get update \
    && apt-get install -y --no-install-recommends libfontconfig1 fonts-dejavu-core ttf-mscorefonts-installer \
    && rm -rf /var/lib/apt/lists/*

.NET 10 の Ubuntu ベースイメージはすでに multiverse（パッケージが含まれる Ubuntu コンポーネント）を有効にしています。

その他のフォントパッケージ

Debian と Ubuntu でも、自由に使用できるフォントがパッケージ化されています。例:

パッケージ	フォント
`fonts-dejavu-core`	DejaVu Sans、DejaVu Serif、DejaVu Sans Mono
`fonts-liberation`	Liberation Sans、Serif、Mono（Arial、Times New Roman、Courier New と同じメトリック）
`fonts-crosextra-carlito`	Carlito（Calibri と同じメトリック）
`fonts-crosextra-caladea`	Caladea（Cambria と同じメトリック）

同じ RUN 命令で apt-get install を使用してインストールします。Aspose.Slides.NET6.CrossPlatform は Linux のフォント設定のエイリアスを適用しません。fonts-liberation をインストールしても、Arial のテキストは一般的な代替フォントで描画され、Liberation Sans にはなりません。欠如したフォントの代わりにメトリック互換フォントを使用するには、default font として設定するか、font substitution rule を追加してください。

独自のフォントファイルの追加

ディストリビューションでパッケージ化されていないフォント（組織のフォントやサーバーで使用許諾を受けているその他のフォントなど）は、フォントファイルとして追加できます。フォントファイル（例: .ttf ファイル）を FontCheck フォルダー内の fonts フォルダーに配置します。以下の例では、Calibri と同じメトリックを持つフォントである Carlito のファイルを使用しています。Carlito は Google Fonts からダウンロードできます。

システムフォントフォルダーにフォントをインストール

Aspose.Slides は Font folders 行に表示されるフォルダー内のフォントを読み取ります。イメージ内のすべてのアプリケーションでフォントを使用できるようにするには、ローカルインストール用フォルダーである /usr/local/share/fonts にコピーします。この指示を Dockerfile のランタイムステージに、パッケージをインストールする RUN 命令の後に追加してください:

COPY fonts/ /usr/local/share/fonts/

アプリケーションフォルダーからフォントをロード

イメージにフォントをインストールする代わりに、アプリケーションと一緒にフォントを配布し、FontsLoader.LoadExternalFonts でロードできます。この場合、フォントは Aspose.Slides のみが使用可能で、アプリケーションと共にデプロイされます。FontCheck はこの方法を使用しています。FontCheck.csproj は fonts フォルダーをアプリケーション出力にコピーし、Program.cs はプレゼンテーション作成前にそのフォルダーを LoadExternalFonts に渡します。Custom Font では、メモリからのロードなど、他のフォント提供方法について説明しています。

イメージを再ビルドし、Calibri と Carlito を確認します:

docker build -t font-check .
docker run --rm font-check Calibri Carlito

アプリケーションフォルダーがフォントフォルダーに表示され、Carlito はもはや置き換えられなくなります:

Font folders: /app/fonts, /usr/share/fonts, /usr/local/share/fonts, .local/share/fonts, /app/.fonts
Font substitutions:
  Calibri -> Arial

欠如フォント用デフォルトフォントの設定

フォントが見つからない場合、Aspose.Slides は自動的に代替フォントを使用します。自分で指定したい場合は、LoadOptions の DefaultRegularFont プロパティを設定し、そのオプションを Presentation コンストラクターに渡します。FontCheck は DEFAULT_FONT 環境変数からフォント名を取得します。Carlito をロードした状態で、欠如フォントにそれを使用します:

docker run --rm -e DEFAULT_FONT=Carlito font-check

Calibri は現在 Carlito で描画され、文字幅が Calibri と同じなので、テキストは改行位置を保持します:

Font folders: /app/fonts, /usr/share/fonts, /usr/local/share/fonts, .local/share/fonts, /app/.fonts
Font substitutions:
  Calibri -> Carlito

デフォルトフォントはすべての欠如フォントを置き換えます。個別のフォント（例: Arial を Liberation Sans、Calibri を Carlito にマップ）を設定するには、font substitution rules を使用してください。ルールはレンダリング結果を変えますが、GetSubstitutions には反映されないため、代わりに出力ファイル内のフォントを確認してください。アジア文字の場合は、DefaultAsianFont も設定します。詳しくは Default Font を参照してください。

Alpine Linux へのフォントインストール

Alpine Linux では Aspose.Slides.NET パッケージを使用します。Run on Alpine Linux にプロジェクトの変更点が記載されています。FontCheck でも同様の変更を行います：パッケージ参照を置き換え、Program.cs に SetSwitch 文を追加し、Microsoft Core フォントもインストールするこのランタイムステージを使用します:

FROM mcr.microsoft.com/dotnet/runtime:10.0-alpine
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false
RUN apk add --no-cache icu-libs libgdiplus font-dejavu msttcorefonts-installer \
    && update-ms-fonts \
    && fc-cache -f
WORKDIR /app
COPY --from=build /app .
RUN mkdir output && chown $APP_UID output
USER $APP_UID
ENTRYPOINT ["dotnet", "FontCheck.dll"]

update-ms-fonts は Debian や Ubuntu 用パッケージと同様の Microsoft Core フォントをダウンロードしてインストールし、同じ方法で EULA が適用されます。fc-cache はフォントキャッシュを更新します。

Linux 上で Aspose.Slides.NET を使用すると、フォント設定ライブラリ（fontconfig）が欠如フォントの代替フォントを選択し、GetSubstitutions はそれを報告しないため、FontCheck は No font substitutions. と出力します。コンテナ内で fontconfig に問い合わせると、フォント名に対して使用されるフォントが確認できます:

docker run --rm --entrypoint fc-match font-check Arial

Microsoft Core フォントがインストールされている場合、Arial は Arial として使用されます:

Arial.ttf: "Arial" "Regular"

それらがない場合、RUN 命令で icu-libs libgdiplus font-dejavu のみをインストールすると、同じコマンドは次のように出力します:

DejaVuSans.ttf: "DejaVu Sans" "Book"

よくある質問

サーバーで変換するとプレゼンテーションの見た目が変わるのはなぜですか？

サーバーにはプレゼンテーションで使用されているフォントがないため、Aspose.Slides は文字幅が異なる代替フォントでテキストを描画します。FontCheck をプレゼンテーションのフォント名で実行し、どのフォントが置き換えられているか確認してから、フォントをインストールするかアプリケーションフォルダーからロードしてください。

ビルドで ttf-mscorefonts-installer はインストールされたが、Arial がまだ置き換えられるのはなぜですか？

EULA がパッケージインストール前に受諾されていなかったため、インストーラはフォントのインストールをスキップしました。Microsoft Core Fonts に示すように、apt-get install の前に debconf-set-selections コマンドを追加し、イメージを再ビルドしてください。

PDF を開くコンピューターにフォントは必要ですか？

いいえ。これらの例では、PDF にテキスト描画に使用されたフォントが埋め込まれているため、どのコンピューターでも同じ表示になります。フォントは Aspose.Slides がプレゼンテーションをレンダリングする環境でのみ必要です。

Docker で Aspose.Slides for .NET を実行するセキュリティ