Added new kb article consistent-pdf-font-formatting (#664)

* Added new kb article consistent-pdf-font-formatting

* polished

---------

Co-authored-by: KB Bot <kb-bot@telerik.com>
Co-authored-by: Desislava Yordanova <dyordano@progress.com>

Author: 3 people

knowledge-base/consistent-pdf-font-formatting.md

@@ -0,0 +1,70 @@
+---
+title: Resolving Font Differences Between Client and Server-Side PDF generation in Telerik Document Processing
+description: Resolve font formatting discrepancies between client-side and server-side PDF generation using Telerik Document Processing.
+type: how-to
+page_title: Resolving PDF Formatting Differences Between Client and Server in Telerik Document Processing
+meta_title: Resolving PDF Formatting Differences Between Client and Server in Telerik Document Processing
+slug: consistent-pdf-font-formatting
+tags: pdf, font,telerik, document, processing,formatting,server-side,client-side,export
+res_type: kb
+ticketid: 1700632
+---
+
+## Environment
+
+| Version | Product | Author | 
+| ---- | ---- | ---- | 
+| 2025.3.806| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+This knowledge base article shows how to resolve font differences between server-side and client-side PDF generation.
+
+## Solution
+
+Usually, the main difference between the server and client-side generated PDF documents is the font. To achieve consistent font formatting between the client-side and server-side PDFs, follow these steps:
+
+1. Install the [Telerik.Documents.Fixed]({%slug available-nuget-packages%}) NuGet package.
+2. Specify the font explicitly for text elements in the server-side PDF generation code.
+3. Load the required font file and register it with the `FontsRepository`.
+
+Use one of the following options to set the font for text blocks:
+
+### Option 1: Explicitly Set Font for Blocks
+Register and apply the font as shown in the example below:
+
+```csharp
+byte[] fontData = File.ReadAllBytes(@"C:\Windows\Fonts\calibri.ttf");
+FontFamily fontFamily = new FontFamily("Calibri");
+FontsRepository.RegisterFont(fontFamily, FontStyles.Normal, FontWeights.Normal, fontData);
+
+FontBase calibriFont;
+bool success = FontsRepository.TryCreateFont(fontFamily, FontStyles.Normal, FontWeights.Normal, out calibriFont);
+
+var c0 = row.Cells.AddTableCell();
+c0.PreferredWidth = preferredWidths[0];
+Block block1 = c0.Blocks.AddBlock();
+block1.TextProperties.Font = calibriFont;
+block1.InsertText(reportItem.JobNumber ?? string.Empty);
+```
+
+### Option 2: Use FontFamily for Text Insertion
+Alternatively, utilize the `FontFamily` directly during text insertion:
+
+```csharp
+byte[] fontData = File.ReadAllBytes(@"C:\Windows\Fonts\calibri.ttf");
+FontFamily fontFamily = new FontFamily("Calibri");
+FontsRepository.RegisterFont(fontFamily, FontStyles.Normal, FontWeights.Normal, fontData);
+
+var c10 = row.Cells.AddTableCell();
+c10.PreferredWidth = preferredWidths[10];
+c10.Blocks.AddBlock().InsertText(fontFamily, reportItem.StatusDate?.ToString("dd/MM/yyyy") ?? string.Empty);
+```
+
+Ensure consistent usage of fonts between client-side and server-side export processes. Use the same font family and size as implemented in the client-side export.
+
+## See Also
+
+- [Cross-Platform Fonts]({%slug radpdfprocessing-cross-platform-fonts%})
+- [Registering a Font]({%slug radpdfprocessing-concepts-fonts%}#registering-a-font)
+

libraries/radpdfprocessing/cross-platform/fonts.md

@@ -39,5 +39,6 @@ You can find a detailed **FixedExtensibilityManager** and **FontsProvider** desc
  * [Resolving Missing Content in Exported PDF Files]({%slug missing-content-word-to-pdf-radwordsprocessing%})
  * [Validating Fonts when Using Telerik Document Processing]({%slug validating-fonts-pdf-document-processing%})
  * [Preserving Original Bold, Italic and Regular Fonts When Exporting PDF Documents Using PdfProcessing  in .NET Standard]({%slug pdfprocessing-prevent-font-conversion-embedding-fonts%})
+ * [Resolving Font Differences Between Client and Server-Side PDF generation in Telerik Document Processing]({%slug consistent-pdf-font-formatting%})