تحويل html إلى pdf

تعرف على كيفية تحويل HTML إلى PDF عبر الإنترنت.

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

تحويل HTML إلى PDF من REST API

Aspose.HTML Cloud SDK for .NET هي أداة قوية تتيح تحويل HTML إلى PDF بسلاسة. توفر SDK واجهة سهلة الاستخدام ومجموعة غنية من الأساليب والخيارات لتخصيص عملية التحويل وفقًا لمتطلبات محددة. لذلك، باستخدام Aspose.HTML Cloud SDK for .NET، يمكن للمطورين دمج إمكانيات تحويل HTML إلى PDF بسهولة في تطبيقات .NET الخاصة بهم، مما يؤدي إلى تبسيط سير العمل وتعزيز إمكانية الوصول إلى محتوى الويب وقابليته للاستخدام.

يمكن تنزيل SDK إما من NuGet أو GitHub. الآن، لتثبيت SDK من خلال NuGet، يرجى تنفيذ الأمر التالي في نافذة المحطة الطرفية:

nuget install Aspose.HTML-Cloud

يمكنك أيضًا تثبيت الحزمة من خلال مدير الحزم NuGet عن طريق تنفيذ الأمر التالي:

PM> Install-Package Aspose.HTML-Cloud

الطريقة الأسهل الأخرى هي تثبيت SDK عبر NuGet Package Manager داخل Visual Studio IDE.

  1. افتح مستكشف الحلول.
  2. قم بتوسيع المشروع ثم انقر بزر الماوس الأيمن فوق مجلد الحزم ضمن الحل الخاص بك.
  3. حدد خيار إدارة حزم NuGet…
  4. انقر فوق علامة التبويب “استعراض” وابحث عن “Aspose.HTML-Cloud”.
  5. انقر فوق الحزمة Aspose.HTML-Cloud، وحدد الإصدار المناسب في علامة التبويب اليمنى وانقر فوق الزر “إضافة الحزمة”.
تحويل HTML إلى PDF

الصورة 1: - واجهة برمجة تطبيقات تحويل HTML إلى PDF في NuGet Package Manager.

الخطوة الرئيسية التالية هي الاشتراك المجاني في خدماتنا السحابية عبر لوحة تحكم Aspose.Cloud باستخدام حساب GitHub أو Google. أو ببساطة إنشاء حساب جديد والحصول على تفاصيل بيانات اعتماد العميل الخاصة بك.

تحويل HTML إلى PDF في C#

يوضح هذا القسم تحويل صفحة الويب إلى PDF. يتم تخزين ملف HTML المدخل بالفعل في التخزين السحابي، وبعد التحويل، يتم تخزين الملف الناتج أيضًا في التخزين السحابي.

  • أولاً، يرجى إنشاء مثيل لـ HtmlApi أثناء تمرير تفاصيل ClientID وClientSecret كوسائط.
  • ثانياً، اقرأ محتوى ملف HTML باستخدام طريقة File.OpenRead(..)
  • ثالثًا، قم بإنشاء مثيل لـ StorageApi واستخدم طريقة UploadFile(…) لتحميل HTML المدخل إلى التخزين السحابي.
  • أخيرًا، قم باستدعاء الطريقة PutConvertDocumentToPdf(…) لإجراء تحويل HTML إلى PDF وحفظ الناتج في التخزين السحابي.
// احصل على معرف العميل من https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// سلسلة عنوان URL الأساسية
const string SERVICE_API_HOST = "https://api.aspose.cloud";

// إنشاء مثيل HtmlApi
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret,SERVICE_API_HOST);

String name = "inputHTML.html";// inpit Document name.
int width = 800; // Resulting image width.
int height = 1000; // Resulting image height.
int leftMargin = 10; // Left resulting image margin.
int rightMargin = 10; // Right resulting image margin.
int topMargin = 10; // Top resulting image margin.
int bottomMargin = 10; // Bottom resulting image margin.

// اسم الملف الناتج
string resultantFile = "Resultant.pdf";

try
{
    // تحميل الملف من محرك الأقراص المحلي
    using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
    {
        // إنشاء مثيل StorageApi
        var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
        
        // تحميل ملف HTML إلى التخزين السحابي
        uploadFileRequest.UploadFile(file, "inputHTML.html");
    }
    
    // قم بإجراء التحويل إلى صيغة PDF
    // حفظ الناتج في التخزين السحابي
    AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
    name, resultantFile, width, height,
    leftMargin, rightMargin, topMargin, bottomMargin);
    
    // طباعة رسالة النجاح إذا كان التحويل ناجحًا
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("HTML successfully converted to PDF !");
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
معاينة التحويل

الصورة 2:- معاينة تحويل HTML إلى PDF.

يمكنك تنزيل ملفات العينة المستخدمة في المثال أعلاه من inputHTML.html وResultant.pdf على التوالي.

تحويل صفحة الويب إلى PDF باستخدام أوامر cURL

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

يرجى اتباع الخطوات الموضحة أدناه لإجراء تحويل HTML إلى PDF.

  1. احصل على معرف العميل والسر الخاص بالعميل من لوحة معلومات السحابة.
  2. احصل على رمز وصول الويب JSON استنادًا إلى بيانات اعتماد العميل.
  3. اتصل بـ PutConvertDocumentToPdf API.

الآن، يرجى تنفيذ أمر cURL التالي لتوليد رمز وصول JWT.

 curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

يرجى تنفيذ الأمر التالي لتحميل ملف HTML المدخل إلى التخزين السحابي:

curl -X PUT "https://api.aspose.cloud/html/storage/file/inputHTML.html" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"File":{}}

الآن، يُرجى تنفيذ الأمر التالي لحفظ صفحة الويب بتنسيق HTML. ثم يتم تخزين الملف الناتج في التخزين السحابي.

curl -X PUT "https://api.aspose.cloud/html/inputHTML.html/convert/pdf?outPath=Converted.pdf&width=800&height=1000&leftMargin=10&rightMargin=10&topMargin=10&bottomMargin=10" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

روابط مفيدة

خاتمة

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

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

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

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