در چشم‌انداز دیجیتال امروز، HTML یکی از متداول‌ترین فرمت‌ها برای نمایش و به اشتراک گذاری داده‌های ساختاریافته به صورت آنلاین است. با این حال، زمانی که به بایگانی، توزیع یا دسترسی آفلاین می‌رسد، PDF همچنان فرمت انتخابی است. توسعه‌دهندگان غالباً نیاز به تبدیل HTML به PDF برای ایجاد گزارش‌ها، فاکتورها یا حفظ محتوای وب در یک فرمت سازگار با همه دارند.

این مقاله موضوعات زیر را پوشش می‌دهد:

SDKهای تبدیل HTML به PDF

SDK ابری GroupDocs.Conversion Cloud برای .NET یک راه حل قدرتمند و مقیاس پذیر برای تبدیل فرمت فایل ارائه می‌دهد. در حین استفاده از قابلیت‌های این API، می‌توانید به طور بی‌وقفه HTML را به PDF تبدیل کنید، دقت، ثبات و عملکرد عالی را تضمین کنید—همه این‌ها بدون نیاز به نصب نرم‌افزار اضافی.

شروع کار با تبدیل HTML به PDF

قبل از اینکه شروع کنید، مطمئن شوید که ملزومات زیر را دارید:

  1. یک GroupDocs Cloud account برای به دست آوردن شناسه مشتری و کلید مخفی مشتری شما. برای اطلاعات بیشتر لطفاً به tutorial کوتاه مراجعه کنید.
  2. A sample HTML file or webpage for testing.
  3. یک محیط توسعه .NET پیکربندی شده (مانند Visual Studio یا Rider).

شما می‌توانید SDK را از مدیر بسته NuGet با اجرای دستور زیر نصب کنید:

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. ورودی HTML را به فضای ذخیره‌سازی ابری آپلود کنید.
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. API ConvertDocumentRequest را برای تبدیل HTML به فرمت PDF فراخوانی کنید. پس از تبدیل موفقیت‌آمیز، PDF حاصل در فضای ذخیره‌سازی ابری ذخیره می‌شود.
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

پس از اجرای درخواست، فایل HTML شما به یک PDF با کیفیت بالا تبدیل شده و در پوشه خروجی مشخص شده در فضای ابری شما ذخیره خواهد شد.

تبدیل HTML به PDF با استفاده از cURL

اگر شما ترجیح می‌دهید که تبدیل‌ها را از طریق اسکریپت‌نویسی یا خطوط اتوماسیون انجام دهید، cURL یک جایگزین عالی است. این ابزار به شما امکان می‌دهد تا تماس‌های REST API را مستقیماً از خط فرمان اجرا کنید، که آن را برای آزمایش سریع و پردازش دسته‌ای ایده‌آل می‌کند.

چرا از cURL برای تبدیل HTML به PDF استفاده کنیم؟

  • نیازی به نصب SDK نیست.
  • مناسب برای اسکریپت‌های شل، جریان‌های 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 رایگان را امتحان کنید. اپلیکیشن وبPowered by GroupDocs.Conversion Cloud . این امکان را به شما می‌دهد که هر فایل HTML یا URL را بارگذاری کنید و به‌طور آنی PDF تولید شده را دانلود کنید.

تبدیل html به pdf

پیوندهای مفید

نتیجه‌گیری

تبدیل HTML به PDF با استفاده از API REST .NET به توسعه‌دهندگان راهی قابل اعتماد برای حفظ طرح‌بندی‌ها، سبک‌ها و محتوای صفحات وب در یک فرمت قابل حمل ارائه می‌دهد. با GroupDocs.Conversion Cloud SDK برای .NET، می‌توانید این روند را تنها در چند خط کد خودکار کنید—چه نیاز به تبدیل فایل‌های HTML تکی داشته باشید و چه مجموعه‌های کامل از صفحات وب.

مقالات مرتبط

ما به شدت پیشنهاد می‌کنیم که از لینک‌های زیر دیدن کنید تا اطلاعات بیشتری در مورد:

سؤالات متداول (FAQs)

  1. چگونه می‌توانم HTML را با استفاده از C# .NET به PDF تبدیل کنم؟
  • شما می‌توانید از GroupDocs.Conversion Cloud SDK برای .NET استفاده کنید تا یک فایل HTML را بارگذاری کنید، فرمت خروجی را به PDF تنظیم کنید و متد ConvertDocument() را برای تولید فایل تبدیل شده اجرا کنید.
  1. آیا این API از تبدیل HTML با CSS و تصاویر پشتیبانی می‌کند؟
  • بله. SDK تمام منابع متصل را حفظ می‌کند و اطمینان می‌دهد که PDF تبدیل شده شما، چینش، قلم‌ها، تصاویر و استایل را به دقت حفظ می‌کند.
  1. آیا می‌توانم صفحات وب را مستقیماً از URL ها تبدیل کنم؟
  • بله. شما می‌توانید یک URL وب‌سایت را در مسیر ورودی مشخص کنید و API محتویات HTML را رندر کرده و آن را به یک سند PDF تبدیل کند.
  1. آیا نیاز است که ابزارهای شخص ثالثی مانند Adobe Acrobat را نصب کنم؟
  • خیر. کل فرآیند مبتنی بر Cloud است—هیچ نصب محلی یا نرم‌افزار اضافی موردنیاز نیست.