使用 GroupDocs.Viewer .NET 掌握文件渲染：嵌入字體並轉換為 HTML

介紹

在數位時代，對於需要在各種平台上動態呈現內容的企業來說，無縫的文件渲染至關重要。無論您是開發跨平台應用程式的開發人員，還是管理內部文件工作流程的開發人員，確保一致的字體渲染和高效的文件轉換都可能充滿挑戰。本教學透過使用 GroupDocs.Viewer .NET 根據作業系統偵測字體路徑、配置字體來源以及將文件渲染為包含嵌入資源的 HTML 格式，解決了這些挑戰。

在本指南中，您將學習如何：

偵測並設定適合不同作業系統平台的字型路徑
使用 GroupDocs.Viewer .NET 設定字型來源
將文件渲染為 HTML 格式，並嵌入所有必要的資源

在本教學結束時，您將對如何在 .NET 應用程式中有效地設定和使用這些功能有深入的了解。讓我們先來看看所需的先決條件。

先決條件

在繼續之前，請確保您具有以下條件：

庫和依賴項GroupDocs.Viewer for .NET 版本 25.3.0
環境設定：安裝了.NET的開發環境（最好是.NET Core或更高版本）
知識庫：對 C# 程式設計有基本的了解，熟悉檔案系統操作

為 .NET 設定 GroupDocs.Viewer

首先，您需要安裝 GroupDocs.Viewer 程式庫。您可以透過 NuGet 套件管理器控制台或使用 .NET CLI 執行此操作：

NuGet 套件管理器控制台

Install-Package GroupDocs.Viewer -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Viewer --version 25.3.0

許可證獲取

免費試用：首先從下載免費試用版 GroupDocs 網站.
臨時執照：申請臨時許可證以存取完整功能，不受限制 GroupDocs 臨時許可證頁面.
購買：如需長期使用，請考慮從 GroupDocs 購買頁面.

基本初始化

以下是如何在 C# 應用程式中初始化 GroupDocs.Viewer：

using GroupDocs.Viewer;

// 使用文檔路徑初始化檢視器對象
using (Viewer viewer = new Viewer("sample.docx"))
{
    // 設定步驟請點擊此處
}

實施指南

在本節中，我們將逐步探索每個功能。我們將重點介紹檢測字體路徑、配置字體以及渲染文件。

根據作業系統平台偵測字體路徑

概述

此功能會根據您在 Windows 還是非 Windows 平台上執行應用程序，自動決定字型檔案的路徑。這對於確保在不同環境中準確呈現文字至關重要。

逐步實施

1.檢查作業系統

using System;
using System.IO;
using System.Runtime.InteropServices;

public static string GetFontsPath()
{
    // 確定作業系統平台並相應地設定字體路徑
    if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
    {
        return Utils.FontsPath;  // Windows 平台的預設路徑
    }
    else
    {
        var assembly = System.Reflection.Assembly.GetEntryAssembly();
        var entryAssemblyDirectory = Path.GetDirectoryName(assembly.Location);
        return Path.Combine(entryAssemblyDirectory, Utils.FontsPath);  // 非 Windows 的派生路徑
    }
}

解釋：此方法使用 RuntimeInformation.IsOSPlatform 檢查應用程式是否在 Windows 上執行。如果是，則傳回預先定義的字型路徑 (Utils.FontsPath對於其他平台，則透過入口組件目錄和字型路徑組合來建立路徑。

設定文檔渲染的字體來源

概述

一旦我們確定了正確的字體路徑，下一步就是在 GroupDocs.Viewer 中配置這些路徑，以便它可以在文件渲染期間使用它們。

2.配置字體路徑

using GroupDocs.Viewer.Fonts;

public static void ConfigureFontSources(string fontsPath)
{
    // 將包含字體的資料夾設定為渲染來源
    FontSettings.SetFontSources(new FolderFontSource(fontsPath, Fonts.SearchOption.TopFolderOnly));
}

解釋：此方法建立一個實例 FolderFontSource 使用確定的字型路徑。然後使用 SetFontSources，確保 GroupDocs.Viewer 在呈現文件時使用這些字體。

使用嵌入資源將文件渲染為 HTML

概述

最後一步是將您的文件轉換為網路友善格式，確保所有資源都直接嵌入到輸出檔案中，以便於分發和檢視。

3.渲染為HTML

using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;

public static void RenderDocumentToHtml(string documentPath, string outputDirectory)
{
    // 定義每個 HTML 頁面的儲存方式
    string pageFilePathFormat = Path.Combine(outputDirectory, "page_{0}.html");

    using (Viewer viewer = new Viewer(documentPath))
    {
        HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources(pageFilePathFormat);
        viewer.View(options);  // 使用嵌入的資源渲染文檔
    }
}

解釋：此程式碼初始化一個 Viewer 物件並設定 HTML 視圖選項，以便將所有必要的資源（例如字體、圖像）直接包含在輸出 HTML 檔案中。 ForEmbeddedResources 方法確保這些都是自包含的。

故障排除提示

字體顯示不正確？ 確保每個平台的字體路徑都正確設定。
效能問題： 考慮優化檔案大小並儘可能減少嵌入資源。
渲染錯誤： 驗證文件路徑並確保應用程式可以存取它。

實際應用

內部文件管理：使用此設定將內部文件呈現為網頁，方便不同部門更輕鬆地存取。
客戶示範：將客戶提案或合約轉換為 HTML，以便透過電子郵件或內部網路輕鬆共享。
入口網站：將文件直接嵌入到 Web 應用程式中，無需額外下載。

性能考慮

優化字型路徑：使用相對路徑來最大限度地減少載入時間並確保在不同環境中正確存取字體。
資源管理：定期檢查 HTML 文件中嵌入的資源，以防止膨脹，這會降低渲染速度。
記憶體優化：利用 using 語句透過在使用後及時處置物件來有效地管理記憶體使用。

結論

透過將 GroupDocs.Viewer for .NET 整合到您的應用程式中，您將獲得一套強大的文件管理和簡報工具。本教學將幫助您掌握如何根據作業系統檢測字體路徑、配置字體來源以及如何有效地將文件渲染為包含嵌入式資源的 HTML 格式。

接下來，您可以考慮探索 GroupDocs.Viewer 提供的更多進階功能，或將其整合到更大的專案中。您可以隨時嘗試不同的配置，找到最適合您需求的配置。

常見問題部分

如何處理非標準字體？
- 確保它們包含在字體來源目錄中，並在 Utils。FontsPath.
如果我的應用程式在基於 Unix 的系統上運行會怎樣？
- 程式碼已經透過從入口組件目錄派生路徑來處理這個問題。