في المشهد الرقمي اليوم، HTML هو أحد أكثر الصيغ استخدامًا لعرض ومشاركة البيانات المنظمة عبر الإنترنت. ومع ذلك، عندما يتعلق الأمر بالأرشفة أو التوزيع أو الوصول دون اتصال، تظل PDF هي صيغة الخيار. يحتاج المطورون غالبًا إلى تحويل HTML إلى PDF لإنشاء التقارير أو الفواتير أو للحفاظ على محتوى الويب في صيغة متوافقة عالميًا.

تغطي هذه المقالة المواضيع التالية:

SDKs تحويل HTML إلى PDF

توفر GroupDocs.Conversion Cloud SDK for .NET حلاً قويًا وقابلًا للتطوير لتحويل تنسيقات الملفات. أثناء استخدام ميزات واجهة برمجة التطبيقات هذه، يمكنك تحويل HTML إلى PDF بسلاسة، مما يضمن الدقة والاتساق والأداء المتميز - وكل ذلك دون الحاجة إلى تثبيت برامج إضافية.

البدء في تحويل HTML إلى PDF

قبل أن تبدأ، تأكد من أن لديك المتطلبات الأساسية التالية:

  1. حساب GroupDocs Cloud account للحصول على معرف العميل و secretaria العميل. لمزيد من المعلومات، يرجى زيارة 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 حيث نقوم بتمرير كائن التكوين كوسائط.
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 لتحويل HTML إلى تنسيق PDF. بعد التحويل الناجح، يتم تخزين ملف PDF الناتج في التخزين السحابي.
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

بمجرد تنفيذ الطلب، سيتم تحويل ملف HTML الخاص بك إلى PDF عالي الجودة وتخزينه في مجلد الإخراج المحدد داخل مساحة التخزين السحابية الخاصة بك.

تحويل HTML إلى PDF باستخدام cURL

إذا كنت تفضل إجراء التحويلات من خلال البرمجة النصية أو خطوط أنابيب الأتمتة، فإن cURL هو بديل ممتاز. يتيح لك تنفيذ مكالمات REST API مباشرة من سطر الأوامر، مما يجعله مثاليًا للاختبار السريع والمعالجة الجماعية.

Why Use cURL for HTML to PDF Conversion?

  • لا حاجة لتثبيت 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 المجاني. تطبيق ويب مدعوم بواسطة GroupDocs.Conversion Cloud. إنه يتيح لك رفع أي ملف HTML أو عنوان URL وتنزيل PDF الناتجة على الفور.

html to pdf converter

روابط مفيدة

استنتاج

تحويل HTML إلى PDF باستخدام واجهة REST API في .NET يوفر للمطورين وسيلة موثوقة للحفاظ على تخطيطات صفحات الويب، والأساليب، والمحتوى في تنسيق قابل للنقل. مع مجموعة GroupDocs.Conversion Cloud SDK لـ .NET، يمكنك أتمتة هذه العملية في بضع سطور فقط من التعليمات البرمجية—سواء كنت بحاجة إلى تحويل ملفات HTML فردية أو دفعات كاملة من صفحات الويب.

مقالات ذات صلة

نوصي بشدة بزيارة الروابط التالية لمعرفة المزيد حول:

الأسئلة الشائعة (FAQs)

  1. كيف يمكنني تحويل HTML إلى PDF باستخدام C# .NET؟
  • يمكنك استخدام GroupDocs.Conversion Cloud SDK لـ .NET لتحميل ملف HTML، وتكوين تنسيق الإخراج كـ PDF، وتنفيذ طريقة ConvertDocument() لإنشاء الملف المحول.
  1. هل تدعم هذه واجهة برمجة التطبيقات تحويل HTML مع CSS وصور؟
  • نعم. تحافظ مجموعة أدوات البرمجة (SDK) على جميع الموارد المرتبطة، مما يضمن أن ملف PDF المحول يحتفظ بالتخطيط والخطوط والصور والتنسيق بدقة.
  1. هل يمكنني تحويل صفحات الويب مباشرة من عناوين URL؟
  • نعم. يمكنك تحديد عنوان URL لصفحة الويب في مسار الإدخال، وسيرسم API محتوى HTML ويحوّله إلى مستند PDF.
  1. هل أحتاج إلى تثبيت أي أدوات طرف ثالث مثل Adobe Acrobat؟
  • لا. العملية بأكملها تعتمد على السحابة - لا يتطلب الأمر تثبيت محلي أو برامج إضافية.