Как установить папку со шрифтами – C#

Пользовательский шрифт – почему шрифт важен

Шрифты играют важную роль в формировании внешнего вида, доступности, эстетической привлекательности и эмоционального воздействия текста. Таким образом, выбор правильного шрифта может иметь решающее значение для достижения конкретных целей, будь то сделать текст более визуально привлекательным, читабельным или узнаваемым. В некоторых случаях вам может понадобиться установить пользовательские шрифты, которые вы разработали, купили или приобрели из внешнего источника.

В этой статье описывается, как установить папки шрифтов, чтобы их можно было использовать при отображении HTML-документов.

Установить шрифт – добавить папку пользовательского шрифта на С#

Aspose.HTML for .NET – мощная библиотека для работы с HTML-документами. Она позволяет разработчикам получать доступ и управлять HTML DOM на C# и других языках .NET. Она также предоставляет возможность устанавливать папки шрифтов для рендеринга HTML-документов в определенные форматы.

По умолчанию Aspose.HTML for .NET ищет шрифты, установленные в системе. С помощью класса FontsSettings задаются папки, в которых Aspose.HTML ищет шрифты при рендеринге документов.

Примеры C# в этой статье продемонстрируют, как установить папку шрифта для рендеринга HTML-документа в форматы PDF и Image. Мы рассмотрим методы SetFontsLookupFolder(), которые используются в библиотеке Aspose.HTML for .NET для указания папки, в которой находятся пользовательские шрифты. Но прежде чем начать:

Найдите файлы пользовательских шрифтов, которые вы хотите использовать.
Создайте папку, в которой вы будете хранить пользовательские шрифты.
Скопируйте пользовательские шрифты в папку шрифтов.

Установите папку шрифтов для рендеринга HTML в PDF

Например, при преобразовании HTML-документа в PDF-файл важно убедиться, что пользовательские шрифты, используемые в HTML-документе, доступны для механизма визуализации. По умолчанию Aspose.HTML ищет шрифты в системной папке шрифтов. Однако, если вы используете пользовательские шрифты, вам нужно будет вызвать метод SetFontsLookupFolder(fontsFolder) и указать, где их найти.

Вот пример того, как установить пользовательский шрифт для преобразования HTML-документа в PDF с помощью библиотеки Aspose.HTML C#:

 1// Prepare HTML code and save it to a file
 2var code = "<h1>FontsSettings property</h1>\r\n" +
 3           "<p>The FontsSettings property is used for configuration of fonts handling.</p>\r\n";
 4
 5File.WriteAllText(Path.Combine(OutputDir, "user-agent-fontsetting.html"), code);
 6
 7// Create an instance of Configuration
 8using (var configuration = new Configuration())
 9{
10    // Get the IUserAgentService
11    var userAgentService = configuration.GetService<IUserAgentService>();
12
13    // Set the custom style parameters for the <h1> and <p> elements
14    userAgentService.UserStyleSheet = "h1 { color:#a52a2a; }\r\n" +
15                                      "p { color:grey; }\r\n";
16              
17    // Set a custom font folder path
18    userAgentService.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "fonts"));
19
20    // Initialize the HTML document with specified configuration
21    using (var document = new HTMLDocument(Path.Combine(OutputDir, "user-agent-fontsetting.html"), configuration))
22    {
23        // Convert HTML to PDF
24        Converter.ConvertHTML(document, new PdfSaveOptions(), Path.Combine(OutputDir, "user-agent-fontsetting_out.pdf"));
25    }
26}

view raw Example-UserAgentServiceFontSetting hosted with ❤ by GitHub

Давайте рассмотрим пример C#, как установить папку пользовательского шрифта. Вы должны выполнить несколько шагов:

Создайте экземпляр класса Configuration, используя конструктор Configuration().
Вызовите метод GetService для объекта конфигурации, чтобы получить экземпляр IUserAgentService.
Используйте метод SetFontsLookupFolder(fontsFolder) класса FontsSettings и передайте ему путь к папке пользовательского шрифта. Этот метод позволяет библиотеке искать шрифты в указанной папке при создании документа PDF. Если какие-либо пользовательские шрифты не находятся в этой папке, они не будут доступны для использования в документе PDF.
Инициализируйте документ HTML с указанной конфигурацией, используя конструктор HTMLDocument().
Вызовите метод ConvertHTML() для преобразования HTML в PDF.

Вы можете загрузить файлы данных и полные примеры C#, демонстрирующие, как установить папку шрифта из GitHub.

Установите папку шрифтов для рендеринга HTML в изображение

Давайте рассмотрим пример C#, как использовать библиотеку Aspose.HTML for .NET для преобразования HTML-документа в формат изображения, а также установить папку для пользовательских шрифтов:

 1// Prepare a path to a source HTML file
 2string documentPath = Path.Combine(DataDir, "file.html");
 3
 4// Prepare a path to save the converted file 
 5string savePath = Path.Combine(OutputDir, "file-output.png");
 6
 7// Create an instance of the Configuration class
 8using var configuration = new Configuration();
 9
10// Get the IUserAgentService
11var userAgentService = configuration.GetService<IUserAgentService>();
12
13// Use the SetFontsLookupFolder() method to set a directory which will act as a new fontsFolder
14// Pass "true" as the recursive parameter to use all nested directories
15userAgentService.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "font"), true);
16
17// Initialize the HTML document with specified configuration
18using (var document = new HTMLDocument(documentPath, configuration))
19{
20    // Convert HTML to Image
21    Converter.ConvertHTML(document, new ImageSaveOptions(), savePath);
22}

view raw Example-SetFontFolderToRenderHTMLtoImage hosted with ❤ by GitHub

Чтобы преобразовать HTML в изображение с использованием пользовательских шрифтов, выполните несколько шагов:

Создайте объект конфигурации и используйте метод GetService, чтобы получить ссылку на IUserAgentService.
Вызовите метод SetFontsLookupFolder(fontsFolder, recursive), чтобы установить папку шрифта. Этот метод принимает два параметра: путь к папке, в которой расположены шрифты, и логическое значение, указывающее, следует ли включать вложенные папки или нет. Установив true в качестве параметра recursive, метод включает все вложенные папки указанной папки в поиск шрифтов.
Инициализируйте документ HTML с указанной конфигурацией.
Вызовите метод ConvertHTML(), чтобы преобразовать HTML в изображение.

Таким образом, установив папку шрифтов с помощью методов SetFontsLookupFolder(), библиотека Aspose.HTML будет использовать пользовательские шрифты, расположенные в указанной папке, для преобразования документа HTML в различные форматы вывода, такие как PDF или изображения, гарантируя, что документы отображаются, как задумано, с нужными шрифтами.

Aspose.HTML предлагает бесплатные Веб-приложения HTML, которые представляют собой онлайн-коллекцию конвертеров, слияний, загрузчиков, инструментов SEO, генераторов HTML-кода и многое другое. Приложения работают в любой операционной системе с веб-браузером и не требуют установки дополнительного программного обеспечения. Это быстрый и простой способ эффективно и действенно решать ваши задачи, связанные с HTML.

Как использовать XPath для выбора узлов XML Cериализация HTML формы