نحوه تبدیل اسناد با کلاس‌های مبدل در پایتون

چگونه اسناد را با کلاس‌های مبدل تبدیل کنیم

Aspose.Words FOSS for Python در هنگام خروجی‌گیری سند از کلاس‌های مبدل داخلی استفاده می‌کند. در حالی که اکثر کاربران با Document.save() تعامل دارند، درک کلاس‌های مبدل برای سناریوهای پیشرفته مفید است.

پیش‌نیازها

نصب کتابخانه:

pip install aspose-words-foss>=26.4.0

نیاز به Python 3.10 یا بالاتر دارد.

مبدل پاراگراف

ParagraphConverter پاراگراف‌های سند را به قالب خروجی هدف تبدیل می‌کند. روش‌های کلیدی:

• ParagraphConverter.get_paragraph_info() — استخراج اطلاعات قالب‌بندی از یک پاراگراف
• ParagraphConverter.get_run_formatting() — دریافت قالب‌بندی برای یک بخش متن
• ParagraphConverter.format_text() — اعمال قالب‌بندی بر محتوای متن

TableConverter

TableConverter جداول سند را به قالب هدف تبدیل می‌کند (مانند جداول Markdown):

• TableConverter.convert() — تبدیل یک عنصر جدول به قالب خروجی

ListHandler

ListHandler در طول تبدیل وضعیت لیست را مدیریت می‌کند:

• ListHandler.set_reader() — تنظیم زمینهٔ خواننده سند
• ListHandler.reset() — بازنشانی وضعیت ردیابی فهرست
• ListHandler.get_list_info() — دریافت جزئیات مورد فهرست برای یک پاراگراف
• ListHandler.format_list_item() — قالب‌بندی یک مورد فهرست با نشانگر و تورفتگی
• ListHandler.break_list() — اعلام پایان یک توالی فهرست

مثال سریع تبدیل

برای بیشتر موارد استفاده، Document.save() را به‌صورت مستقیم استفاده کنید — کلاس‌های مبدل به‌صورت خودکار فراخوانی می‌شوند:

import aspose.words_foss as aw

doc = aw.Document("input.docx")
doc.save("output.pdf", aw.SaveFormat.PDF)

خلاصه