Merge pull request #1835 from syncfusion-content/994279-ug

994279-ug: Added TOC start page number by skipping the cover page

Author: chinnumuniyappan

Document-Processing/PDF/Conversions/HTML-To-PDF/NET/features.md

@@ -807,6 +807,96 @@ padding-left: 5px;
 
 You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/HTML%20to%20PDF/Blink/Create-custom-style-TOC-when-converting-HTML-to-PDF).
 
+## Exclude cover page from TOC
+
+This code snippet shows how to configure the Table of Contents (TOC) to skip the cover page by setting the starting page number. In this example, the cover page is a single page, so the TOC begins at page 1. For documents with multiple cover pages, adjust the starting page number as needed.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" %}
+
+using Syncfusion.Drawing;
+using Syncfusion.HtmlConverter;
+using Syncfusion.Pdf;
+
+// Create an instance of HTML-to-PDF converter
+HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();
+// Configure Blink converter settings
+BlinkConverterSettings blinkConverterSettings = new BlinkConverterSettings()
+{
+    ViewPortSize = new Size(1280, 0), // Set viewport width for rendering
+    EnableToc = true,                 // Enable Table of Contents (TOC)
+};
+// Set TOC starting page number to skip the cover page
+blinkConverterSettings.Toc.StartingPageNumber = 1;
+// Apply the settings to the converter
+htmlConverter.ConverterSettings = blinkConverterSettings;
+// Read the main HTML content and convert it to PDF
+string inputhtml = File.ReadAllText("input.html");
+PdfDocument document = htmlConverter.Convert(inputhtml, "");
+//Create cover page and insert to the 0th index.
+// Apply scaling settings for the cover page
+htmlConverter.ConverterSettings = new BlinkConverterSettings()
+{
+    Scale = 1.5f
+};
+// Convert the cover page HTML to PDF
+string coverimage = File.ReadAllText("coverpage.html");
+PdfDocument coverPage = htmlConverter.Convert(coverimage, "");
+// Insert the cover page at the beginning of the main document
+document.Pages.Insert(0, coverPage.Pages[0]);
+// Save the PDF document
+document.Save("Output.pdf");
+//Dispose the document
+coverPage.Close(true);
+document.Close(true);
+htmlConverter.Close();
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+Imports Syncfusion.Drawing
+Imports Syncfusion.HtmlConverter
+Imports Syncfusion.Pdf
+
+' Create an instance of HTML-to-PDF converter
+Dim htmlConverter As New HtmlToPdfConverter()
+' Configure Blink converter settings
+Dim blinkConverterSettings As New BlinkConverterSettings() With {
+    .ViewPortSize = New Size(1280, 0), ' Set viewport width for rendering
+    .EnableToc = True                  ' Enable Table of Contents (TOC)
+}
+' Set TOC starting page number to skip the cover page
+blinkConverterSettings.Toc.StartingPageNumber = 1
+' Apply the settings to the converter
+htmlConverter.ConverterSettings = blinkConverterSettings
+' Read the main HTML content and convert it to PDF
+Dim inputhtml As String = File.ReadAllText("input.html")
+Dim document As PdfDocument = htmlConverter.Convert(inputhtml, "")
+' Create cover page and insert to the 0th index.
+' Apply scaling settings for the cover page
+htmlConverter.ConverterSettings = New BlinkConverterSettings() With {
+    .Scale = 1.5F
+}
+' Convert the cover page HTML to PDF
+Dim coverimage As String = File.ReadAllText("coverpage.html")
+Dim coverPage As PdfDocument = htmlConverter.Convert(coverimage, "")
+' Insert the cover page at the beginning of the main document
+document.Pages.Insert(0, coverPage.Pages(0))
+' Save the PDF document
+document.Save("Output.pdf")
+' Dispose the documents
+coverPage.Close(True)
+document.Close(True)
+htmlConverter.Close()
+
+{% endhighlight %}
+
+{% endtabs %}
+
+You can download a complete working sample from GitHub.
+
 ## Media Type
 
 The Blink HTML Converter allows selection of media type while converting HTML to PDF. Blink rendering engine supports <b>Screen</b> and <b>Print</b> media types. Refer to the following code snippet to select Print [MediaType](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.BlinkConverterSettings.html#Syncfusion_HtmlConverter_BlinkConverterSettings_MediaType).