تحويل PDF المستندات إلى HTML صيغة أمر أساسي، خاصة عندما نحتاج إلى عرض المحتوى عبر الإنترنت، مما يُحسن إمكانية الوصول، ويمكّن من إعادة استخدام المحتوى بسهولة في تطبيقات الويب. في هذه المقالة، ستتعلم كيفية تحويل PDF إلى HTML باستخدام GroupDocs.Conversion Cloud SDK لـ .NET، مع الحفاظ على تخطيط المستند، والصور، والتنسيق.
يغطي هذا المقال المواضيع التالية:
واجهة برمجة تطبيقات تحويل PDF إلى HTML
GroupDocs.Conversion Cloud SDK for .NET توفر واجهة برمجة تطبيقات قوية لتحويل مستندات PDF إلى HTML بدقة عالية. يسمح لك بتخصيص HTML الناتج، وتحديد نطاقات الصفحات، والتحكم في جودة الصور، مما يجعله مثالياً لدمج تدفقات العمل من المستندات إلى الويب في تطبيقات .NET الخاصة بك.
تثبيت
قم بتثبيت SDK عبر مدير حزم NuGet:
Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0
أو باستخدام .NET CLI:
dotnet add package GroupDocs.Conversion-Cloud --version 24.2.0
الآن، تحتاج إلى الحصول على معرّف العميل الشخصي وكلمة السر من Aspose Cloud Dashboard للمصادقة على طلبات API.
قم بتحويل PDF إلى HTML في C# (.NET)
إليك مثال خطوة بخطوة بلغة C# لتحويل PDF إلى HTML:
- تكوين بيانات اعتماد واجهة برمجة التطبيقات:
var config = new Configuration
{
ClientId = "YOUR_CLIENT_ID",
ClientSecret = "YOUR_CLIENT_SECRET"
};
var convertApi = new ConvertApi(config);
var fileApi = new FileApi(config);
- رفع ملف PDF إلى تخزين السحابة:
using (var fileStream = File.OpenRead("sample.pdf"))
{
var uploadRequest = new UploadFileRequest("sample.pdf", fileStream);
fileApi.UploadFile(uploadRequest);
}
- Set Conversion Settings:
var settings = new ConvertSettings
{
FilePath = "sample.pdf",
Format = "html",
OutputPath = "converted/resultant.html"
};
- قم بتحويل PDF إلى HTML:
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;
using System.IO;
using GroupDocs.Conversion.Cloud.Sdk.Model;
namespace GroupDocs.Conversion.CSharp
{
// قم بتحويل PDF إلى HTML
class PDFConversion
{
static void Main(string[] args)
{
try
{
// احصل على بيانات اعتماد API الخاصة بك
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test";
// قم بإنشاء مثيل من فئة Configuration مع Client Secret و Client ID.
var configuration = new Configuration(clientId, clientSecret);
// حدد قيمة ApiBaseUrl لتعيين عنوان URL الأساسي لواجهة برمجة التطبيقات.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// قم بتهيئة كائن من فئة ConvertApi باستخدام كائن من فئة Configuration.
var apiInstance = new ConvertApi(configuration);
// إنشاء حالة من فئة ConvertSettings.
var settings = new ConvertSettings
{
FilePath = "sample.pdf",
Format = "html",
OutputPath = "converted/resultant.html"
};
// call the API to trigger PDF to Web page conversion.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
Console.WriteLine("Successfully converted the PDF file to HTML format in C#: " + response[0].Url);
}
catch (Exception e)
{
Console.WriteLine("Exception when calling GroupDocs Api: " + e.Message);
}
}
}
}

صورة:- معاينة لتحويل PDF إلى HTML.
- يمكن تحميل ملف PDF المثال المستخدم في المثال أعلاه من input.pdf.
تحويل PDF إلى صفحة ويب باستخدام cURL
يمكنك أيضًا استخدام GroupDocs.Conversion Cloud API REST مع cURL للتحويل السريع من خلال سطر الأوامر.
- توليد رمز وصول JWT باستخدام بيانات اعتمادك.
- Run the following cURL command:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{resultantFile}\"}"
- نفذ الأمر التالي لحفظ HTML على القرص المحلي:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "{resultantFile}"
- استبدل:
sourceFile
،resultantFile
، وaccessToken
بقيم فعلية.
جرب محول PDF إلى HTML المجاني لدينا
جرب تطبيقنا المجاني PDF to HTML Converter لرؤية جودة التحويل قبل دمجه في تطبيقك.

روابط مفيدة
خاتمة
باستخدام GroupDocs.Conversion Cloud SDK لـ .NET، يمكنك بسهولة دمج تحويل PDF إلى HTML في مشاريعك .NET، مما يتيح إنتاج مخرجات عالية الجودة ومتوافقة مع الويب مع الحفاظ على التنسيق. سواء استخدمت SDK في C# أو قمت بإجراء مكالمات API مباشرة عبر cURL، فإن العملية بسيطة وقابلة للتخصيص بشكل كبير.
المقالات الموصى بها
نوصي بشدة باستكشاف المقالات التالية: