Parsers
Parsers
API ภายใน คลาสในหน้านี้ไม่ใช่ส่วนหนึ่งของ API ที่เปิดเผยและไม่ได้นําออกจากระดับบนสุด
aspose.words_fossPackage. พวกเขาถูกใช้ภายในโดยระบบแปลงเอกสาร Pipeline ส่วนใหญ่ผู้พัฒนาควรใช้อุปกรณ์นี้Document.save()และDocument.get_text()แทนนี้ ดู การบริหารหลัก สําหรับ API ที่เปิดเผย คลาสเหล่านี้เป็นรายละเอียดการนําไปใช้งาน และอาจเปลี่ยนแปลงโดยไม่ต้องแจ้งก่อน.
Aspose.Words FOSS สําหรับ Python รวมถึงเครื่องพารเซอร์เฉพาะที่สกัดข้อมูลโครงสร้างจาก DOCX Internals . NumberingParser รับจัดการคํานิยามการนับเลขรายชื่อ และ StyleParser สลัดรูปแบบเอกสาร.
การนับเลขพาร์เซอร์
NumberingParser อ่านนิยามการนับจากแพ็คเกจ DOCX และเปิดเผยผ่าน API คําถาม. ใช้ parse_numbering_part() เพื่ออัตราการใส่ XML การนับเลข แล้วถามลิสต์ Properties ด้วยวิธีช่วย.
| Method | คําอธิบาย |
|---|---|
NumberingParser.parse_numbering_part() | การพาราชคของตัวเลข DOCX |
NumberingParser.get_list_info() | รับข้อมูลเกี่ยวกับรายการเฉพาะโดยใช้ ID |
NumberingParser.get_level_info() | รับรายละเอียดระดับสำหรับรายการที่ความลึกที่กำหนด |
NumberingParser.is_ordered_list() | ตรวจสอบว่าระดับรายการถูกสั่งหรือมีลูกบอกหรือไม่ |
NumberingParser.get_start_value() | รับหมายเลขเริ่มต้นสำหรับระดับรายการ |
NumberingParser.get_delimiter() | รับสตริงตัวคั่นสำหรับระดับรายการ |
การพาราซอร์สไตล์
StyleParser การพาร์สชื่อแบบเป็นรูปโครงสร้าง ParsedStyle อัตถุ. มันจําแนกหัวข้อ, blockquotes, คอกโค้ด และรายการ paragraf จากชื่อสไตล์ DOCX.
| Method | คําอธิบาย |
|---|---|
StyleParser.parse() | การพัดชื่อสไตล์เป็น a ParsedStyle อัตราสินค้า |
StyleParser.get_style_chain() | การวิเคราะห์โซ่ชื่อสไตล์สําหรับส ไทยที่ได้รับมรดก |
StyleParser.is_setext_heading() | ตรวจสอบว่าสไตล์เป็นหัวข้อแบบ Setext หรือไม่ |
StyleParser.extract_all_styles() | สลัดชื่อสไตล์แต่ละตัวจากโซ่ที่แยกด้วยคอมม่า |
โมเดลข้อมูลการนับเลข
ข้อมูลการนับเลขที่พาราสถูกเก็บในวัตถุที่มีโครงสร้าง:
| Class | คําอธิบาย |
|---|---|
NumberingInfo | คํานิยามการนับเลขด้วย num_id, abstract_num_id,และ levels |
NumberingLevel | การกําหนดระดับด้วย format, start,และ text อสังหาริมทรัพย์ |
ListInfo | ข้อมูลเกี่ยวกับตัวอย่างรายการเฉพาะเจาะจง |
ListLevelInfo | รายละเอียดการจัดรูปแบบเฉพาะระดับ |
คําแนะนํา และ การ ใช้ งาน ที่ ดี ที่ สุด
- Call
parse_numbering_part()ครั้งหนึ่งหลังจากการอุดรธานาลักษณ์รายการทั้งหมด - การใช้งาน
is_ordered_list()เพื่อแยกรายการที่มีเลขจากรายชื่อที่มีลูกบอก - การใช้งาน
get_style_chain()เพื่อพาร์สเชิงรุ่นที่ได้รับมรดกในการเรียกครั้งเดียว - การนับเลขและการสไตล์ parser ใช้ภายในโดยกระบวนการแปลงเอกสาร pipeline
ปัญหาทั่วไป
| Issue | Cause | แก้ไข |
|---|---|---|
| คํานิยามการหมายเลขที่ว่างเปล่า | เอกสารไม่มีรายการ | Check get_list_info() ค่าคืนก่อนเข้าถึงอสังหาริมทรัพย์ |
| สไตล์ที่ขาด | ชื่อสไตล์ไม่รับรู้ | การใช้งาน parse() มีชื่อแบบที่ทราบกัน |
| ระดับรายการที่ไม่ถูกต้อง | ปารามีระดับผิด | ระดับรายการมีอัตราศูนย์ |
สรุปอ้างอิง API
| ประเภท / กลไก | คําอธิบาย |
|---|---|
NumberingParser.parse_numbering_part() | การพาร์ส DOCX คํานิยามการนับเลข |
NumberingParser.get_list_info() | ข้อมูลรายการสอบถามตาม ID |
NumberingParser.is_ordered_list() | ตรวจสอบว่าระดับรายการถูกสั่งซื้อหรือไม่ |
StyleParser.parse() | การพัดชื่อสไตล์เป็นข้อมูลที่มีโครงสร้าง |
StyleParser.get_style_chain() | การวิเคราะห์โซ่ชื่อสไตล์ที่ได้รับมรดก |
NumberingInfo | รูปแบบข้อมูลการกําหนดหมายเลข |
NumberingLevel | การกําหนดระดับด้วยรูปแบบและค่าเริ่มต้น |