مبدلها
Aspose.Words FOSS for Python از کلاسهای مبدل تخصصی برای تبدیل مدل سند داخلی به فرمتهای خروجی استفاده میکند. ParagraphConverter متن و قالببندی را مدیریت میکند، TableConverter ساختارهای جدول را مدیریت میکند، و ListHandler قالببندی فهرستها را مدیریت میکند.
مبدل پاراگراف
ParagraphConverter پاراگرافهای سند را به قالب خروجی هدف تبدیل میکند. این ویژگی قالببندی پاراگراف، استایلگذاری در سطح ران و محتوای درونخطی را بررسی میکند.
| روش | توضیح |
|---|
ParagraphConverter.get_paragraph_info() | استخراج اطلاعات قالببندی از یک پاراگراف |
ParagraphConverter.get_run_formatting() | دریافت جزئیات قالببندی برای یک بخش متن |
ParagraphConverter.format_text() | اعمال قالببندی بر محتوای متن |
مبدل جدول
TableConverter جداول سند را به قالب هدف (مانند جداول Markdown) تبدیل میکند.
| متد | توضیح |
|---|
TableConverter.convert() | یک عنصر جدول را به فرمت خروجی تبدیل کنید |
مدیر لیست
ListHandler در طول تبدیل سند، وضعیت فهرست را مدیریت میکند و تو در تویی فهرست، نشانگرها و قالببندی را پیگیری مینماید.
| متد | توضیح |
|---|
ListHandler.set_reader() | تنظیم خواننده سند برای زمینهٔ فهرست |
ListHandler.reset() | بازنشانی وضعیت ردیابی فهرست |
ListHandler.get_list_info() | دریافت جزئیات مورد فهرست برای یک پاراگراف |
ListHandler.format_list_item() | قالببندی یک مورد فهرست با نشانگر و تورفتگی |
ListHandler.break_list() | اعلام پایان توالی فهرست |
نکات و بهترین شیوهها
- مبدلها بهصورت داخلی توسط خط لولهٔ خروجی استفاده میشوند — اکثر توسعهدهندگان به جای آن با
Document.save() تعامل دارند ParagraphConverter.format_text() با در نظر گرفتن زمینهٔ بلوک کد، از اعمال قالببندی درونخطی داخل بازههای کد جلوگیری میکندListHandler وضعیت را در پاراگرافهای فهرست متوالی حفظ میکند — هنگام شروع بخش جدید سند، reset() را فراخوانی کنید
مشکلات رایج
| مشکل | دلیل | راهحل |
|---|
| ستونهای جدول نامرتب | جدول ورودی دارای سلولهای ترکیبی است | TableConverter جداول ساده را پردازش میکند؛ سلولهای ترکیبی ممکن است خروجی غیرمنتظرهای تولید کنند |
| شمارهگذاری لیست خراب است | وضعیت لیست بین بخشها بازنشانی نمیشود | در مرزهای بخش ListHandler.reset() را فراخوانی کنید |
خلاصه مرجع API
| Class / Method | Description |
|---|
ParagraphConverter.get_paragraph_info() | استخراج قالببندی پاراگراف |
ParagraphConverter.get_run_formatting() | دریافت قالببندی سطح ران |
ParagraphConverter.format_text() | اعمال قالببندی بر متن |
TableConverter.convert() | تبدیل جدول به فرمت خروجی |
ListHandler.set_reader() | تنظیم زمینه خواننده سند |
ListHandler.get_list_info() | دریافت جزئیات مورد لیست |
ListHandler.format_list_item() | قالببندی یک مورد لیست |
