HTML إلى PDF

تحويل HTML إلى PDF باستخدام .NET REST API.

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

في هذه المقالة، سوف نستكشف العديد من الفوائد التي تأتي مع استخدام Aspose.PDF Cloud SDK لتحويل HTML إلى PDF. سنتعرف على كيفية تمكينك من تحسين قدرات معالجة المستندات لديك وتبسيط سير العمل وتقديم تجربة مستخدم استثنائية.

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

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

الآن، للبدء في استخدام هذا الأسلوب، نحتاج أولاً إلى إضافة مرجع SDK في مشروعنا. لذلك، يرجى البحث عن “Aspose.PDF-Cloud” في مدير حزم NuGet داخل Visual Studio IDE وانقر فوق الزر “إضافة حزمة”. تحتاج أيضًا إلى الحصول على بيانات اعتماد العميل الخاصة بك من cloud Dashboard. في حالة عدم وجود حساب حالي لديك، ما عليك سوى إنشاء حساب مجاني باتباع الإرشادات المحددة في البدء السريع.

صفحة ويب إلى PDF باستخدام C# .NET

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

// لمزيد من الأمثلة، https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet/tree/master/Examples

// احصل على بيانات اعتماد العميل من https://dashboard.aspose.cloud/
string clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
string clientID = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";

// إنشاء مثيل لـ PdfApi
PdfApi pdfApi = new PdfApi(clientSecret, clientID);

// إدخال اسم ملف HTML
String inputHTML = "input1.html";

// اتصل بواجهة برمجة التطبيقات (API) لتحويل HTML الموجود في أرشيف .zip على التخزين السحابي
//  لقد حددنا أيضًا اسم ملف HTML المطلوب تحويله وكذلك تفاصيل الهامش
var result = pdfApi.GetHtmlInStorageToPdf("inputHTML.zip",htmlFileName: inputHTML, 
    height: 1000, width: 800, isLandscape: false,
    marginLeft: 10, marginRight: 10, marginTop: 10, marginBottom: 10);
    
// طريقة الاتصال لحفظ الإخراج على محرك الأقراص المحلي
saveToDisk(result, "/Users/nayyer/Downloads/Converted.pdf");

// طريقة لحفظ محتوى الدفق إلى ملف على محرك الأقراص المحلي
public static void saveToDisk(Stream responseStream, String resultantFile)
{
    var fileStream = File.Create(resultantFile);
    responseStream.Seek(0, SeekOrigin.Begin);
    responseStream.CopyTo(fileStream);
    fileStream.Close();
}
HTML إلى PDF

معاينة تحويل HTML إلى PDF.

فيما يلي التفاصيل المتعلقة بمقتطف الشفرة المذكور أعلاه.

PdfApi pdfApi = new PdfApi(clientSecret, clientID);

أولاً، قم بإنشاء كائن من فئة PdfApi أثناء تمرير بيانات اعتماد العميل كوسيطات إدخال.

var result = pdfApi.GetHtmlInStorageToPdf("converted.zip", htmlFileName: "converted6.html", 
        height: 1000, width: 800, isLandscape: false,
        marginLeft: 10, marginRight: 10, marginTop: 10, marginBottom: 10);

اتصل بواجهة برمجة التطبيقات (API) لتحويل HTML إلى PDF. كوسيطة، نقوم بتمرير اسم أرشيف .zip الذي يحتوي على ملف HTML، واسم ملف HTML المطلوب تحويله، وأبعاد PDF الناتجة وتفاصيل الهامش.

saveToDisk(result, "/Users/nayyer/Downloads/htmlOutput.pdf");

أخيرًا، نطلق على الطريقة حفظ ملف PDF الناتج على محرك أقراص محلي.

في حالة احتياجنا إلى إجراء التحويل وحفظ الملف الناتج في وحدة التخزين السحابية، يرجى الاتصال بواجهة برمجة التطبيقات PutHtmlInStorageToPdf.

HTML إلى PDF عبر الإنترنت باستخدام أوامر cURL

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

الخطوة الأولى في هذا النهج هي إنشاء رمز وصول JWT. لذا يرجى تنفيذ الأمر التالي:

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

بمجرد إنشاء رمز JWT، يرجى تنفيذ الأمر التالي لتحويل ملف HTML المتوفر في التخزين السحابي إلى تنسيق PDF وتحميل الإخراج الناتج إلى نفس التخزين السحابي:

curl -v "https://api.aspose.cloud/v3.0/pdf/{resultantFile}/create/html?srcPath=converted.zip&htmlFileName={sourceHTML}" \
-X PUT \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-d {} -v

استبدل “sourceHTML” باسم مستند HTML المُدخل المتوفر في التخزين السحابي، و"resultantFile" باسم مستند PDF الناتج الذي سيتم تخزينه في التخزين السحابي.

في حال كان لدينا متطلبات لتحويل ملف HTML إلى تنسيق PDF وحفظ الإخراج على محرك الأقراص المحلي، يرجى تنفيذ الأمر التالي:

curl -v "https://api.aspose.cloud/v3.0/pdf/create/html?srcPath=sourceFolder.zip&htmlFileName=source.html&height=1000&width=800&isLandscape=false&marginLeft=10&marginBottom=10&marginRight=10&marginTop=10" \
-X GET \
-H "accept: multipart/form-data" \
-H "authorization: Bearer {accessToken}" \
-o "Converted.pdf"

قد تفكر في تنزيل نماذج الملفات المستخدمة في المثال أعلاه من inputHTML.html وhtmlOutput.pdf.

خاتمة

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

روابط مفيدة

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

نوصي بشدة بزيارة المدونات التالية: