ตัวแปลง

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

คลาส / เมธอด	คำอธิบาย
`ParagraphConverter.get_paragraph_info()`	สกัดรูปแบบย่อหน้า
`ParagraphConverter.get_run_formatting()`	ดึงรูปแบบระดับรัน
`ParagraphConverter.format_text()`	ใช้รูปแบบกับข้อความ
`TableConverter.convert()`	แปลงตารางเป็นรูปแบบผลลัพธ์
`ListHandler.set_reader()`	ตั้งค่าบริบทของผู้อ่านเอกสาร
`ListHandler.get_list_info()`	รับรายละเอียดรายการ
`ListHandler.format_list_item()`	จัดรูปแบบรายการ