Penukar

Internal API — Kelas pada halaman ini digunakan secara dalaman oleh paip eksport. Kebanyakan pembangun berinteraksi dengan Document.save() sebaliknya. Lihat Core Management untuk API awam.

Aspose.Words FOSS for Python menggunakan kelas penukar khusus untuk menukar model dokumen dalaman ke format output. ParagraphConverter mengendalikan teks dan pemformatan, TableConverter mengendalikan struktur jadual, dan ListHandler mengurus pemformatan senarai.

Penukar Perenggan

ParagraphConverter menukar perenggan dokumen ke dalam format output sasaran. Ia memeriksa pemformatan perenggan, gaya pada peringkat run, dan kandungan dalam talian.

Kaedah	Keterangan
`ParagraphConverter.get_paragraph_info()`	Ekstrak maklumat pemformatan daripada perenggan
`ParagraphConverter.get_run_formatting()`	Dapatkan butiran pemformatan untuk jaluran teks
`ParagraphConverter.format_text()`	Terapkan pemformatan pada kandungan teks

Penukar Jadual

TableConverter menukar jadual dokumen ke dalam format sasaran (seperti jadual Markdown).

Kaedah	Penerangan
`TableConverter.convert()`	Tukar elemen jadual kepada format output

Pengendali Senarai

ListHandler mengurus keadaan senarai semasa penukaran dokumen, menjejaki penyusunan senarai, penanda, dan pemformatan.

Kaedah	Keterangan
`ListHandler.set_reader()`	Tetapkan pembaca dokumen untuk konteks senarai
`ListHandler.reset()`	Tetapkan semula keadaan penjejakan senarai
`ListHandler.get_list_info()`	Dapatkan butiran item senarai untuk perenggan
`ListHandler.format_list_item()`	Formatkan item senarai dengan penanda dan penjarakan
`ListHandler.break_list()`	Isyaratkan akhir urutan senarai

Petua dan Amalan Terbaik

Penukar digunakan secara dalaman oleh paip eksport — kebanyakan pembangun berinteraksi dengan Document.save() sebaliknya
ParagraphConverter.format_text() menghormati konteks blok kod untuk mengelakkan penggunaan pemformatan dalam barisan kod
ListHandler mengekalkan keadaan merentasi perenggan senarai berturutan — panggil reset() apabila memulakan bahagian dokumen baru

Isu Umum

Issue	Cause	Fix
Lajur jadual tidak selari	Jadual input mempunyai sel yang digabungkan	`TableConverter` mengendalikan jadual mudah; sel yang digabungkan mungkin menghasilkan output yang tidak dijangka
Penomboran senarai rosak	Keadaan senarai tidak direset antara bahagian	Panggil `ListHandler.reset()` pada sempadan bahagian

Ringkasan Rujukan API

Kelas / Kaedah	Penerangan
`ParagraphConverter.get_paragraph_info()`	Ekstrak pemformatan perenggan
`ParagraphConverter.get_run_formatting()`	Dapatkan pemformatan aras run
`ParagraphConverter.format_text()`	Terapkan pemformatan pada teks
`TableConverter.convert()`	Tukar jadual ke format output
`ListHandler.set_reader()`	Tetapkan konteks pembaca dokumen
`ListHandler.get_list_info()`	Dapatkan butiran item senarai
`ListHandler.format_list_item()`	Formatkan item senarai