Konverter

API Internal — Kelas‑kelas pada halaman ini digunakan secara internal oleh pipeline ekspor. Sebagian besar pengembang berinteraksi dengan Document.save() sebagai gantinya. Lihat Core Management untuk API publik.

Aspose.Words FOSS for Python menggunakan kelas konverter khusus untuk mengubah model dokumen internal menjadi format output. ParagraphConverter menangani teks dan pemformatan, TableConverter menangani struktur tabel, dan ListHandler mengelola pemformatan daftar.

Pengonversi Paragraf

ParagraphConverter mengubah paragraf dokumen menjadi format output target. Ia memeriksa pemformatan paragraf, gaya pada tingkat run, dan konten inline.

Metode	Deskripsi
`ParagraphConverter.get_paragraph_info()`	Ekstrak informasi pemformatan dari sebuah paragraf
`ParagraphConverter.get_run_formatting()`	Dapatkan detail pemformatan untuk sebuah rangkaian teks
`ParagraphConverter.format_text()`	Terapkan pemformatan pada konten teks

Pengonversi Tabel

TableConverter mengonversi tabel dokumen ke format target (seperti tabel Markdown).

Metode	Deskripsi
`TableConverter.convert()`	Mengonversi elemen tabel ke format output

Penangani Daftar

ListHandler mengelola status daftar selama konversi dokumen, melacak penumpukan daftar, penanda, dan pemformatan.

Metode	Deskripsi
`ListHandler.set_reader()`	Atur pembaca dokumen untuk konteks daftar
`ListHandler.reset()`	Setel ulang status pelacakan daftar
`ListHandler.get_list_info()`	Dapatkan detail item daftar untuk paragraf
`ListHandler.format_list_item()`	Format item daftar dengan penanda dan indentasi
`ListHandler.break_list()`	Berikan sinyal akhir urutan daftar

Tips dan Praktik Terbaik

Konverter digunakan secara internal oleh pipeline ekspor — kebanyakan pengembang berinteraksi dengan Document.save() sebagai gantinya
ParagraphConverter.format_text() menghormati konteks blok kode untuk menghindari penerapan pemformatan inline di dalam rentang kode
ListHandler mempertahankan status di seluruh paragraf daftar berurutan — panggil reset() saat memulai bagian dokumen baru

Masalah Umum

Masalah	Penyebab	Perbaikan
Kolom tabel tidak sejajar	Tabel masukan memiliki sel yang digabung	`TableConverter` menangani tabel sederhana; sel yang digabung dapat menghasilkan output yang tidak terduga
Penomoran daftar rusak	Status daftar tidak direset antara bagian	Panggil `ListHandler.reset()` pada batas bagian

Ringkasan Referensi API

Kelas / Metode	Deskripsi
`ParagraphConverter.get_paragraph_info()`	Ekstrak format paragraf
`ParagraphConverter.get_run_formatting()`	Dapatkan format tingkat run
`ParagraphConverter.format_text()`	Terapkan format ke teks
`TableConverter.convert()`	Konversi tabel ke format output
`ListHandler.set_reader()`	Atur konteks pembaca dokumen
`ListHandler.get_list_info()`	Dapatkan detail item daftar
`ListHandler.format_list_item()`	Format item daftar