Parsers
Parsers
API ภายใน คลาสในหน้านี้ไม่ใช่ส่วนหนึ่งของ API ที่เปิดเผยและไม่ได้นําออกจากระดับบนสุด
aspose.words_fossPackage. พวกเขาถูกใช้ภายในโดยระบบแปลงเอกสาร Pipeline ส่วนใหญ่ผู้พัฒนาควรใช้อุปกรณ์นี้Document.save()และDocument.get_text()แทนนี้ ดู การบริหารหลัก สําหรับ API ที่เปิดเผย คลาสเหล่านี้เป็นรายละเอียดการนําไปใช้งาน และอาจเปลี่ยนแปลงโดยไม่ต้องแจ้งก่อน.
Aspose.Words FOSS for Python includes specialized parsers that extract structured data from DOCX internals. The NumberingParser รับจัดการคํานิยามการนับเลขรายชื่อ และ StyleParser สลัดรูปแบบเอกสาร.
การนับเลขพาร์เซอร์
NumberingParser อ่านนิยามการนับจากแพ็คเกจ DOCX และเปิดเผยผ่าน API คําถาม. ใช้ parse_numbering_part() เพื่ออัตราการใส่ XML การนับเลข แล้วถามลิสต์ Properties ด้วยวิธีช่วย.
| Method | Description |
|---|---|
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 | Description |
|---|---|
StyleParser.parse() | การพัดชื่อสไตล์เป็น a ParsedStyle อัตราสินค้า |
StyleParser.get_style_chain() | การวิเคราะห์โซ่ชื่อสไตล์สําหรับส ไทยที่ได้รับมรดก |
StyleParser.is_setext_heading() | ตรวจสอบว่าสไตล์เป็นหัวข้อแบบ Setext หรือไม่ |
StyleParser.extract_all_styles() | สลัดชื่อสไตล์แต่ละตัวจากโซ่ที่แยกด้วยคอมม่า |
โมเดลข้อมูลการนับเลข
ข้อมูลการนับเลขที่พาราสถูกเก็บในวัตถุที่มีโครงสร้าง:
| Class | Description |
|---|---|
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
| ประเภท / กลไก | Description |
|---|---|
NumberingParser.parse_numbering_part() | การพาร์ส DOCX คํานิยามการนับเลข |
NumberingParser.get_list_info() | ข้อมูลรายการสอบถามตาม ID |
NumberingParser.is_ordered_list() | ตรวจสอบว่าระดับรายการถูกสั่งซื้อหรือไม่ |
StyleParser.parse() | การพัดชื่อสไตล์เป็นข้อมูลที่มีโครงสร้าง |
StyleParser.get_style_chain() | การวิเคราะห์โซ่ชื่อสไตล์ที่ได้รับมรดก |
NumberingInfo | รูปแบบข้อมูลการกําหนดหมายเลข |
NumberingLevel | การกําหนดระดับด้วยรูปแบบและค่าเริ่มต้น |