Dönüştürücüler

Aspose.Words FOSS for Python, iç belge modelini çıktı formatlarına dönüştürmek için özel dönüştürücü sınıfları kullanır. ParagraphConverter metin ve biçimlendirmeyi, TableConverter tablo yapılarını ve ListHandler liste biçimlendirmesini yönetir.

Paragraf Dönüştürücü

ParagraphConverter belge paragraflarını hedef çıktı formatına dönüştürür. Paragraf biçimlendirmesini, satır‑düzeyi stilini ve satır içi içeriği inceler.

Yöntem	Açıklama
`ParagraphConverter.get_paragraph_info()`	Bir paragraftan biçimlendirme bilgilerini çıkar
`ParagraphConverter.get_run_formatting()`	Bir metin çalışması için biçimlendirme ayrıntılarını al
`ParagraphConverter.format_text()`	Metin içeriğine biçimlendirme uygula

Tablo Dönüştürücü

TableConverter belge tablolarını hedef formata (örneğin Markdown tabloları) dönüştürür.

Yöntem	Açıklama
`TableConverter.convert()`	Bir tablo öğesini çıktı formatına dönüştür

Liste İşleyicisi

ListHandler belge dönüştürme sırasında liste durumunu yönetir, liste iç içeliğini, işaretçileri ve biçimlendirmeyi izler.

Yöntem	Açıklama
`ListHandler.set_reader()`	Liste bağlamı için belge okuyucusunu ayarla
`ListHandler.reset()`	Liste izleme durumunu sıfırla
`ListHandler.get_list_info()`	Bir paragraf için liste öğesi ayrıntılarını al
`ListHandler.format_list_item()`	Liste öğesini işaretçi ve girinti ile biçimlendir
`ListHandler.break_list()`	Bir liste dizisinin sonunu işaret et

İpuçları ve En İyi Uygulamalar

Dönüştürücüler, dışa aktarma işlem hattı içinde dahili olarak kullanılır — çoğu geliştirici bunun yerine Document.save() ile etkileşime girer
ParagraphConverter.format_text(), kod bloğu bağlamına saygı göstererek kod aralıkları içinde satır içi biçimlendirme uygulanmasını önler
ListHandler, ardışık liste paragrafları arasında durumu korur — yeni bir belge bölümü başlatırken reset() çağırın

Yaygın Sorunlar

Sorun	Neden	Çözüm
Hizalanmamış tablo sütunları	Girdi tablosunda birleştirilmiş hücreler var	`TableConverter` basit tabloları işler; birleştirilmiş hücreler beklenmeyen çıktı üretebilir
Bozuk liste numaralandırması	Liste durumu bölümler arasında sıfırlanmıyor	Bölüm sınırlarında `ListHandler.reset()` çağırın

API Referans Özeti

Sınıf / Yöntem	Açıklama
`ParagraphConverter.get_paragraph_info()`	Paragraf biçimlendirmesini çıkar
`ParagraphConverter.get_run_formatting()`	Run düzeyinde biçimlendirmeyi al
`ParagraphConverter.format_text()`	Metne biçimlendirme uygula
`TableConverter.convert()`	Bir tabloyu çıktı formatına dönüştür
`ListHandler.set_reader()`	Belge okuyucu bağlamını ayarla
`ListHandler.get_list_info()`	Liste öğesi ayrıntılarını al
`ListHandler.format_list_item()`	Bir liste öğesini biçimlendir