У сучасному цифровому середовищі HTML є одним з найбільш використовуваних форматів для відображення та обміну структурованими даними онлайн. Однак, коли справа доходить до архівування, розподілу чи офлайн-доступу, PDF залишається форматом вибору. Розробники часто потрібно конвертувати HTML в PDF для створення звітів, рахунків-фактур або збереження веб-контенту в універсально сумісному форматі.

Ця стаття охоплює такі теми:

HTML до PDF Конверсії SDKs

GroupDocs.Conversion Cloud SDK for .NET надає потужне та масштабоване рішення для перетворення файлових форматів. Використовуючи можливості цього API, ви можете безперешкодно конвертувати HTML у PDF, гарантуючи точність, послідовність і відмінну продуктивність — все це без установки додаткового програмного забезпечення.

Початок роботи з конвертацією HTML у PDF

Перед тим, як розпочати, переконайтеся, що у вас є наступні попередні умови:

  1. A GroupDocs Cloud account to obtain your Client ID and Client Secret. For more information, please visit short tutorial.
  2. A sample HTML file or webpage for testing.
  3. Сконфігуроване середовище розробки .NET (таке як Visual Studio або Rider).

Ви можете встановити SDK з NuGet Package Manager, виконавши наступну команду:

Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0

Конвертувати HTML у PDF за допомогою C#

Давайте досліджимо, як виконати конвертацію HTML у PDF програмно, використовуючи C# та GroupDocs Cloud SDK.

  1. Створіть екземпляр класу Configuration, в якому ми передаємо облікові дані клієнта як аргументи.
var configuration = new Configuration
{
    AppSid = "YOUR_CLIENT_ID",
    AppKey = "YOUR_CLIENT_SECRET"
};
  1. Ініціалізуйте екземпляр ConvertApi та FileApi, куди ми передаємо об’єкт Configuration як аргументи.
var convertApi = new ConvertApi(configuration);
var fileApi = new FileApi(configuration);
  1. Upload the input HTML to cloud storage.
using (var stream = File.OpenRead("source.html"))
{
    var uploadRequest = new UploadFileRequest("source.html", stream);
    fileApi.UploadFile(uploadRequest);
}
  1. Створіть екземпляр ConvertSettings, в якому ми вкажемо ім’я для вхідного HTML, вихідний формат як pdf та ім’я отриманого PDF.
var settings = new ConvertSettings
{
    FilePath = "index.html",
    Format = "pdf",
    OutputPath = "converted/html-to-pdf-result.pdf"
};
  1. Викличте ConvertDocumentRequest API для перетворення HTML у формат PDF. Після успішного перетворення отриманий PDF зберігається у хмарному сховищі.
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

Після виконання запиту ваш HTML-файл буде перетворено на високоякісний PDF і збережено в зазначеній вихідній папці у вашому хмарному сховищі.

HTML до PDF Конвертація за допомогою cURL

Якщо ви віддаєте перевагу виконанню конверсій за допомогою скриптів або автоматизованих потоків, cURL є відмінною альтернативою. Він дозволяє виконувати REST API виклики безпосередньо з командного рядка, що робить його ідеальним для швидкого тестування та пакетної обробки.

Чому використовувати cURL для конвертації HTML у PDF?

  • Не потрібна установка SDK.
  • Чудово підходить для shell-скриптів, CI/CD робочих процесів або серверних сервісів.
  • Легкий і простий у автоматизації.

Перед виконанням команди конвертації HTML у PDF, створіть свій маркер доступу JWT на основі облікових даних клієнта. Після того, як маркер буде згенеровано, будь ласка, виконайте наступну команду.

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"Confidential\",      \"FontName\": \"Arial\",      \"FontSize\": 12,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"Red\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

Замініть {ACCESSTOKEN} на згенерований вами JWT токен, а index.html на назву вашого HTML файлу.

Спробуйте безкоштовний конвертер HTML в PDF

Якщо ви хочете дослідити процес конвертації без написання будь-якого коду, спробуйте безкоштовний HTML to PDF Converter веб-додаток працює на GroupDocs.Conversion Cloud. Він дозволяє вам завантажувати будь-який HTML-файл або URL та миттєво завантажувати згенерований PDF.

html to pdf converter

Корисні посилання

Висновок

Перетворення HTML в PDF за допомогою .NET REST API надає розробникам надійний спосіб збереження макетів веб-сторінок, стилів і контенту в портативному форматі. З допомогою GroupDocs.Conversion Cloud SDK для .NET ви можете автоматизувати цей процес всього за кілька рядків коду — незалежно від того, чи потрібно вам конвертувати окремі HTML-файли чи цілі партії веб-сторінок.

Супутні статті

Ми настійно рекомендуємо відвідати наступні посилання, щоб дізнатися більше про:

Часто задавані питання (FAQ)

  1. How can I convert HTML to PDF using C# .NET?
  • Ви можете використовувати GroupDocs.Conversion Cloud SDK для .NET, щоб завантажити HTML-файл, налаштувати формат виходу як PDF і виконати метод ConvertDocument(), щоб згенерувати конвертований файл.
  1. Чи підтримує цей API конвертацію HTML з CSS та зображеннями?
  • Так. SDK підтримує всі пов’язані ресурси, забезпечуючи, що ваш конвертований PDF точно зберігає макет, шрифти, зображення та стилі.
  1. Чи можу я безпосередньо конвертувати веб-сторінки з URL-адрес?
  • Так. Ви можете вказати URL-адресу веб-сторінки в шляху введення, і API відрендерить HTML-контент та конвертує його в PDF-документ.
  1. Чи потрібно мені встановлювати якісь сторонні інструменти, такі як Adobe Acrobat?
  • Ні. Весь процес ґрунтується на хмарі – жодна локальна установка або додаткове програмне забезпечення не є необхідними.