在 Linux 和 Docker 中部署 Aspose.Slides 字体

本页内容简介

在 Linux 服务器和 Docker 容器中为 Aspose.Slides for .NET 部署字体：检查哪些字体被替代，在 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 引用了 Aspose.Slides.NET6.CrossPlatform，该包适用于 Debian 和 Ubuntu。它还会将可选的 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 为每个字体名称在幻灯片上添加一个文本框，并通过 LatinFont 属性分配字体。字体名称来源于命令行；如果没有参数，应用程序会检查 Calibri、Arial 和 Times New Roman。它会打印 Aspose.Slides 查找字体的文件夹（FontsLoader.GetFontFolders），将幻灯片渲染为 output/fonts.pdf，并打印 IFontsManager.GetSubstitutions 报告的替代情况。文首的两个可选步骤——加载 fonts 文件夹和读取 DEFAULT_FONT 变量——将在本文后面解释。

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

// 要检查的字体：命令行参数，或三种常见的 Office 字体。
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 字体，因此这三种字体全部被替换为 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 核心字体

ttf-mscorefonts-installer 包会下载并安装微软的 Web 核心字体，其中包括 Arial、Times New Roman、Courier New、Verdana、Georgia 和 Trebuchet MS。这些字体受微软最终用户许可协议 (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/*

重新构建镜像并使用相同的两条命令再次运行检查。 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/*

基于 Ubuntu 的 .NET 10 镜像已经启用 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 文件夹中。以下示例使用了 Carlito 的文件，这是一种与 Calibri 度量相同的字体，您可以从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 绘制，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 核心字体：

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 核心字体，其 EULA 同样适用。 fc-cache 更新字体缓存。

在 Linux 上使用 Aspose.Slides.NET 时，字体配置库（fontconfig）会为缺失的字体选择替代字体，而 GetSubstitutions 并不会报告它，因此 FontCheck 会打印 No font substitutions. 若要查看某个字体名称实际使用的字体，请在容器中查询 fontconfig：

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

安装了 Microsoft 核心字体后，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 在安装包之前未被接受，导致安装程序跳过了字体。在 apt-get install 之前添加 debconf-set-selections 命令，参考Microsoft Core Fonts，然后重新构建镜像。

打开 PDF 的电脑需要这些字体吗？

不需要。在这些示例中，PDF 已嵌入用于绘制文本的字体，因此在任何电脑上显示效果相同。这些字体仅在 Aspose.Slides 渲染演示文稿的环境中需要。

在 Docker 中运行 Aspose.Slides for .NET 安全