تحويل مستند إلى HTML أو MHTML أو EPUB
المستندات بتنسيقات تخطيط التدفق HTML و MHTML تحظى أيضا بشعبية كبيرة ويمكن استخدامها على أي منصة ويب. لهذا السبب، يعد تحويل المستندات إلى HTML و MHTML ميزة مهمة في Aspose.Words.
EPUB (اختصار لـ" النشر الإلكتروني") هو تنسيق قائم على HTML شائع الاستخدام لتوزيع الكتب الإلكترونية. هذا التنسيق مدعوم بالكامل في Aspose.Words لتصدير الكتب الإلكترونية المتوافقة مع معظم أجهزة القراءة.
تحويل مستند
للتحويل البسيط إلى HTML أو MHTML أو EPUB، يتم استخدام أحد الأحمال الزائدة لطريقة Save. يمكنك حفظ المستند في ملف أو دفق وتعيين تنسيق حفظ مستند الإخراج بشكل صريح أو تعريفه من امتداد اسم الملف.
يوضح المثال التالي كيفية تحويل DOCX إلى HTML مع تحديد تنسيق حفظ:
لتحويل مستند إلى MHTML أو EPUB، استخدم SaveFormat.Mhtml أو SaveFormat.Epub على التوالي.
تحويل مستند بمعلومات ذهابا وإيابا
لا يدعم تنسيق HTML العديد من ميزات Microsoft Word، وإذا احتجنا إلى استعادة نموذج مستند بالقرب من الأصل قدر الإمكان، فنحن بحاجة إلى حفظ بعض المعلومات الإضافية داخل ملف HTML. وتسمى هذه المعلومات أيضا “معلومات ذهابا وإيابا”. لهذا الغرض، يوفر Aspose.Words القدرة على تصدير معلومات ذهابا وإيابا عند الحفظ إلى HTML أو MHTML أو EPUB باستخدام خاصية ExportRoundtripInformation. يسمح حفظ معلومات الرحلة ذهابا وإيابا باستعادة خصائص المستند مثل علامات التبويب والتعليقات والرؤوس والتذييلات أثناء تحميل مستندات التنسيقات المدرجة مرة أخرى في كائن Document.
القيمة الافتراضية هي true لـ HTML و false لـ MHTML و EPUB:
- عندما true، يتم تصدير المعلومات ذهابا وإيابا كما-فصيل عبد الواحد - * CSS خصائص HTML العناصر المقابلة
- عندما false، لا توجد معلومات ذهابا وإيابا ليتم إخراجها في الملفات المنتجة
يوضح مثال الكود التالي كيفية تصدير معلومات ذهابا وإيابا عند تحويل مستند من DOCX إلى HTML:
حدد خيارات الحفظ عند التحويل إلى HTML
Aspose.Words يسمح بتحويل مستند ورد إلى HTML باستخدام خيارات الحفظ الافتراضية أو المخصصة. يتم وصف بعض الأمثلة على خيارات الحفظ المخصصة أدناه.
حدد مجلدا لحفظ الموارد
باستخدام Aspose.Words يمكننا تحديد مجلد فعلي حيث يتم حفظ جميع الموارد، مثل الصور والخطوط والخارجية CSS، عند تحويل مستند إلى HTML. بشكل افتراضي، هذه سلسلة فارغة.
تحديد الخاصية ResourceFolder هو أبسط طريقة لتعيين المجلد حيث يجب كتابة جميع الموارد. يمكننا استخدام الخصائص الفردية، مثل FontsFolder الذي يحفظ الخطوط إلى المجلد المحدد و ImagesFolder الذي يحفظ الصور إلى مجلد محدد. عند تحديد مسار نسبي، FontsFolder و ImagesFolder الرجوع إلى المجلد حيث يوجد تجميع التعليمات البرمجية، ResourceFolder و CssStyleSheetFileName الرجوع إلى مجلد الإخراج حيث يوجد المستند HTML.
في هذا المثال، ResourceFolder يحدد المسار النسبي. يشير هذا المسار إلى مجلد الإخراج حيث يتم حفظ المستند HTML. يتم استخدام قيمة الخاصية ResourceFolderAlias لإنشاء URLs لجميع الموارد.
يوضح مثال التعليمات البرمجية التالية كيفية العمل مع هذه الخصائص:
باستخدام خاصية ResourceFolderAlias، يمكننا أيضا تحديد اسم المجلد المستخدم لإنشاء URIs من جميع الموارد المكتوبة في مستند HTML. هذه هي أبسط طريقة لتحديد كيفية إنشاء URIs لجميع ملفات الموارد. يمكن تحديد نفس المعلومات للصور والخطوط بشكل منفصل عبر خصائص ImagesFolderAlias و FontsFolderAlias، على التوالي.
ومع ذلك، لا توجد خاصية فردية لـ CSS. سلوك FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias و CssStyleSheetFileName لا يتم تغيير الخصائص. لاحظ أنه يتم استخدام الخاصية CssStyleSheetFileName لتحديد اسم المجلد واسم الملف.
- ResourceFolder له أولوية أقل من المجلدات المحددة عبر FontsFolder و ImagesFolder و CssStyleSheetFileName. إذا كان المجلد المحدد في ResourceFolder غير موجود، فسيتم إنشاؤه تلقائيا.
- ResourceFolderAlias له أولوية أقل من FontsFolderAlias و ImagesFolderAlias. إذا كانت ResourceFolderAlias فارغة، فسيتم استخدام قيمة الخاصية ResourceFolder لإنشاء مورد URIs. إذا تم تعيين ResourceFolderAlias إلى “.” (نقطة)، فسيحتوي المورد URIs على أسماء الملفات فقط دون تحديد مسار.
تصدير قاعدة 64 ترميز موارد الخطوط
Aspose.Words يوفر القدرة على تحديد ما إذا كان يجب تضمين موارد الخط في HTML في ترميزات القاعدة 64. لتنفيذ ذلك، استخدم خاصية ExportFontsAsBase64 – هذا امتداد لخاصية ExportFontResources. بشكل افتراضي، تكون قيمته false، ويتم كتابة الخطوط في ملفات منفصلة. ولكن إذا تم تعيين هذا الخيار على true، فسيتم تضمين الخطوط في CSS للمستند في ترميز القاعدة 64. تؤثر الخاصية ExportFontsAsBase64 فقط على تنسيق HTML ولا تؤثر على EPUB و MHTML.
يوضح مثال الكود التالي كيفية تصدير الخطوط المشفرة 64 إلى HTML:
حدد خيارات الحفظ عند التحويل إلى EPUB
Aspose.Words يسمح بتحويل مستند ورد إلى تنسيق EPUB باستخدام خيارات الحفظ الافتراضية أو المخصصة. يمكنك تحديد عدد من الخيارات عن طريق تمرير مثيل HtmlSaveOptions إلى طريقة Save.
يوضح مثال الكود التالي كيفية تحويل مستند ورد إلى EPUB مع تحديد بعض خيارات الحفظ المخصصة: